Updating the list of IP prefixes in a routing instance

Written by

Yandex Cloud

Updated at June 10, 2025

Warning

To request access to this function, contact support.

Note

You need the cloud-router.editor role to run this operation.

CLI

See the description of the CLI command for updating a list of IP prefixes in a routing instance:
```
yc cloudrouter routing-instance upsert-prefixes --help
```

Checking the routing instance configuration and the list of IP prefixes:

yc cloudrouter routing-instance get c3l87**********1dpin

Expected result:

id: c3l87**********1dpin
name: ri1
description: Routing instance 1
folder_id: b1gqf**********jiz2w
region_id: ru-central1
vpc_info:
  - vpc_network_id: c64ck**********jtr7b
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 10.128.0.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3td**********nufvr
status: ACTIVE
created_at: "2025-03-19T13:35:56Z"

Adding prefixes to the list of IP prefixes in the routing instance:

yc cloudrouter routing-instance upsert-prefixes c3l87**********1dpin \
  --vpc-net id=c64ck**********jtr7b,zone=ru-central1-b,ipv4-prefixes=10.129.0.0/24 \
  --vpc-net id=c64ck**********jtr7b,zone=ru-central1-d,ipv4-prefixes=172.16.1.0/24 \
  --async

Expected result:

 id: al457**********njn6p
 description: routing instance upsert prefixes
 created_at: "2025-03-24T15:24:15.817401507Z"
 created_by: bfbud**********v7dfn
 modified_at: "2025-03-24T15:24:15.817401507Z"
 metadata:
   '@type': type.googleapis.com/yandex.cloud.cloudrouter.v1.UpdateRoutingInstanceMetadata
   routing_instance_id: c3l87**********1dpin

Where:

id: ID of the operation performed with a routing instance.
description: Description of the operation in progress.
created_by: ID of the subject running the operation.
async: Running the operation in asynchronous mode. This is the recommended mode for all operations that involve changes to resources.

Check the modified routing instance configuration after the changes:

yc cloudrouter routing-instance get c3l87**********1dpin

Expected result:

id: c3l87**********1dpin
name: ri1
description: Routing instance 1
folder_id: b1gqf**********jiz2w
region_id: ru-central1
vpc_info:
  - vpc_network_id: c64ck**********jtr7b
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 10.128.0.0/24
      - manual_info:
          az_id: ru-central1-b
          prefixes:
            - 10.129.0.0/24
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 172.16.1.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3td**********nufvr
status: ACTIVE
created_at: "2025-03-19T13:35:56Z"

Where:

id: Routing instance ID.
name: Routing instance name.
description: Routing instance description.
folder_id: ID of the cloud folder the routing instance was created in.
region_id: Cloud region the routing instance was created in.
vpc_info: List of IP prefixes by availability zone. For each zone, prefixes are shown separately.
cic_private_connection_info: List of private connections connected to the routing instance.
status: Resource state. Target state: ACTIVE. When being updated, it may be in the UPDATING state.
created_at: Date and time of resource creation.

Updating the list of IP prefixes in a routing instance

Was the article helpful?