Updating private connection parameters

Written by

Yandex Cloud

Improved by

Danila N.

Updated at June 24, 2026

View in Markdown

Warning

To request access to this function, contact support.

Note

You need the cic.editor role to run this operation.

To update a private connection:

Management console

CLI

In the management console, click or in the top panel and select the folder.
Navigate to Cloud Interconnect.
In the left-hand panel, select Private connections.
In the row with the private connection, click and select Edit. In the window that opens:
1. Optionally, update the trunk the private connection belongs to. Do it by putting the cursor in the Trunk connection ID field and selecting the trunk.
  
  Optionally, click Create to create a new trunk.
2. Optionally, in the VLAN ID field, change VLAN ID of the private connection in the 802.1Q trunk, e.g., 123.
  
  This value must be different from the VLAN-ID values of other private connections in this trunk.
3. Optionally, in the Peering subnet field, change the CIDR of the point-to-point subnet for BGP peering, e.g., 192.168.1.0/31. For more information, see Point-to-point subnet.
4. Optionally, in the Peer IP field, change the IP address from the point-to-point (peering) subnet on the customer’s hardware, e.g., 192.168.1.0.
5. Optionally, in the Cloud IP field, change the IP address from the point-to-point (peering) subnet on the Yandex Cloud hardware, e.g., 192.168.1.1.
6. Optionally, in the BGP ASN field, change the BGP ASN on the customer’s hardware in ASPlain format, e.g., 64513. For more information, see BGP ASN.
7. Optionally, in the BGP Key field, change the encrypted BGP session key value.
8. Optionally, in the IPv4 StaticRoute prefix field, change destination CIDR prefixes of static routes announced in the network on the customer’s infrastructure side. You can announce multiple static routes in a single private connection:
  - To add a new static route, click Add prefix and specify the prefix you need.
  - To delete an existing static route, click next to the route.
9. Optionally, under General information, change the following:
  - Private connection Name. The naming requirements are as follows:
    - Length: between 3 and 63 characters.
    - It can only contain lowercase Latin letters, numbers, and hyphens.
    - It must start with a letter and cannot end with a hyphen.
    If you do not specify a name, the private connection name will be identical to its ID.
  - Private connection Description.
  - Labels assigned to the private connection.
10. Click Save.

You can update a private connection using these commands:

yc cic private-connection update: Allows changing all private connection parameters, which includes full replacement of its static route list with a new one.
yc cic private-connection upsert-static-routes: Allows adding new static routes to a private connection in addition to existing ones.
yc cic private-connection remove-static-routes: Allows deleting some static routes from a private connection while preserving others.

yc cic private-connection update

See the description of the CLI command for updating a private connection:
```
yc cic private-connection update --help
```

Update the vlan-id value and the static route list of the private connection:

yc cic private-connection update cf3r5ke20fo0******** \
  --vlan-id 201 \
  --ipv4-static-routes "192.168.12.0/24,192.168.13.0/28" \
  --async

Expected result:

id: bd60h5qtn90s********
description: private connection update
created_at: "2025-04-08T21:21:33.106772882Z"
created_by: ajeol2afu1js********
modified_at: "2025-04-08T21:21:33.106772882Z"
metadata:
  '@type': type.googleapis.com/yandex.cloud.cic.v1.UpdatePrivateConnectionMetadata
  private_connection_id: cf3r5ke20fo0********

Check the updated parameter value after the operation is complete:
```
yc cic private-connection get cf3r5ke20fo0********
```

yc cic private-connection upsert-static-routes

See the description of the CLI command for adding new static routes to a private connection:
```
yc cic private-connection upsert-static-routes --help
```

Add static routes to a private connection:

yc cic private-connection upsert-static-routes cf3dcodot14p******** \
  --ipv4-static-routes "10.0.0.0/8,192.168.100.0/24" \
  --async

yc cic private-connection remove-static-routes

See the description of the CLI command for removing static routes from a private connection:
```
yc cic private-connection remove-static-routes --help
```

Remove static routes from your private connection:

yc cic private-connection remove-static-routes cf3dcodot14p******** \
  --ipv4-static-routes "10.0.0.0/8,192.168.100.0/24" \
  --async

Updating private connection parameters

Was the article helpful?