Связаться с намиПопробовать бесплатно

Управлять сетями и IP-префиксами в Routing Instance

Статья создана
Обновлена 25 декабря 2025 г.

Важно

Чтобы запросить доступ к данной функции, обратитесь в техническую поддержку.

Изменить сети и IP-префиксы в Routing Instance

Команда Yandex Cloud CLI yc cloudrouter routing-instance update-networks позволяет одновременно управлять набором анонсированных IP-префиксов облачных сетей Yandex Virtual Private Cloud, добавленных в Routing Instance, а также добавлять новые сети в Routing Instance и удалять имеющиеся.

Примечание

Чтобы управлять сетями и IP-префиксами в Routing Instance, необходима роль cloud-router.editor.

Добавить новую облачную сеть в Routing Instance

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  1. Посмотрите описание команды для управления сетями и IP-префиксами в Routing Instance:

    yc cloudrouter routing-instance update-networks --help

  2. Посмотрите список всех Routing Instance, имеющихся в каталоге:

    yc cloudrouter routing-instance list \
  --folder-id <идентификатор_каталога>

    Где --folder-id — идентификатор каталога, в котором находится нужный Routing Instance.

    Результат:

    +----------------------+------+----------+--------------------------------+
|          ID          | NAME |  STATUS  |     PRIVATE CONNECTION ID      |
+----------------------+------+----------+--------------------------------+
| c3lgk007olse******** | ri1  | UPDATING | cf3or586ln29********,          |
|                      |      |          | cf3uj9uph7b6********           |
+----------------------+------+----------+--------------------------------+

  3. Посмотрите информацию о Routing Instance, указав его идентификатор:

    yc cloudrouter routing-instance get c3lgk007olse******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3lgk007olse********
name: ri1
description: Routing instance 1
folder_id: b1gt6g8ht345********
region_id: ru-central1
vpc_info:
  - vpc_network_id: enpcfncr6uld********
    az_infos:
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 192.168.7.0/24
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.2.0/24
      - manual_info:
          az_id: ru-central1-b
          prefixes:
            - 192.168.15.0/24
  - vpc_network_id: enpt8ok6snlp********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.45.0/24
            - 192.168.46.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3or586ln29********
  - cic_private_connection_id: cf3uj9uph7b6********
status: UPDATING
created_at: "2025-12-23T07:30:19Z"

  4. Добавьте в Routing Instance новую сеть с анонсированным IP-префиксом, указав идентификатор этой сети в поле id параметра --add-vpc-net:

    yc cloudrouter routing-instance update-networks \
  --folder-id <идентификатор_каталога> \
  --id c3lgk007olse******** \
  --add-vpc-net id=enpvt41bh5gk********,zone=ru-central1-a,ipv4-prefixes=192.168.100.0/24,192.168.101.0/24 \
  --async

    Результат:

    id: foku4jbrp07i********
description: routing instance update prefix mask
created_at: "2025-12-23T08:35:04.852963002Z"
created_by: ajeol2afu1js********
modified_at: "2025-12-23T08:35:04.852963002Z"
metadata:
  '@type': type.googleapis.com/yandex.cloud.cloudrouter.v1.UpdateRoutingInstanceMetadata
  routing_instance_id: c3lgk007olse********

    Где:

    • id — идентификатор операции, выполняемой с Routing Instance.
    • description — описание выполняемой операции
    • created_by — идентификатор субъекта, который выполняет операцию.
    • async — выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.

  5. Дождитесь завершения операции и убедитесь в том, что конфигурация Routing Instance изменилась:

    yc cloudrouter routing-instance get c3lgk007olse******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3lgk007olse********
name: ri1
description: Routing instance 1
folder_id: b1gt6g8ht345********
region_id: ru-central1
vpc_info:
  - vpc_network_id: enpcfncr6uldme5e5929
    az_infos:
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 192.168.7.0/24
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.2.0/24
      - manual_info:
          az_id: ru-central1-b
          prefixes:
            - 192.168.15.0/24
  - vpc_network_id: enpt8ok6snlp********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.45.0/24
            - 192.168.46.0/24
  - vpc_network_id: enpvt41bh5gk********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.100.0/24
            - 192.168.101.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3or586ln29********
  - cic_private_connection_id: cf3uj9uph7b6********
status: ACTIVE
created_at: "2025-12-23T08:35:07Z"
    • id — идентификатор Routing Instance.
    • name — имя Routing Instance.
    • description — описание Routing Instance.
    • folder_id — идентификатор каталога, в котором был создан Routing Instance.
    • region_id — регион облака, в котором был создан Routing Instance.
    • vpc_info — список IP-префиксов, распределенный по зонам доступности. Для каждой зоны доступности префиксы указываются отдельно.
    • cic_private_connection_info — список приватных соединений, подключенных к Routing Instance.
    • status — состояние ресурса. Целевое состояние — ACTIVE. При изменении может находиться в состоянии UPDATING.
    • created_at — дата и время создания ресурса.

Удалить имеющуюся облачную сеть из Routing Instance

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  1. Посмотрите описание команды для управления сетями и IP-префиксами в Routing Instance:

    yc cloudrouter routing-instance update-networks --help

  2. Посмотрите список всех Routing Instance, имеющихся в каталоге:

    yc cloudrouter routing-instance list \
  --folder-id <идентификатор_каталога>

    Где --folder-id — идентификатор каталога, в котором находится нужный Routing Instance.

    Результат:

    +----------------------+------+----------+--------------------------------+
|          ID          | NAME |  STATUS  |     PRIVATE CONNECTION ID      |
+----------------------+------+----------+--------------------------------+
| c3lgk007olse******** | ri1  | UPDATING | cf3or586ln29********,          |
|                      |      |          | cf3uj9uph7b6********           |
+----------------------+------+----------+--------------------------------+

  3. Посмотрите информацию о Routing Instance, указав его идентификатор:

    yc cloudrouter routing-instance get c3lgk007olse******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3lgk007olse********
name: ri1
description: Routing instance 1
folder_id: b1gt6g8ht345********
region_id: ru-central1
vpc_info:
  - vpc_network_id: enpcfncr6uld********
    az_infos:
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 192.168.7.0/24
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.2.0/24
      - manual_info:
          az_id: ru-central1-b
          prefixes:
            - 192.168.15.0/24
  - vpc_network_id: enpt8ok6snlp********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.45.0/24
            - 192.168.46.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3or586ln29********
  - cic_private_connection_id: cf3uj9uph7b6********
status: UPDATING
created_at: "2025-12-23T07:30:19Z"

  4. Удалите из Routing Instance имеющуюся сеть:

    yc cloudrouter routing-instance update-networks \
  --folder-id <идентификатор_каталога> \
  --id c3lgk007olse******** \
  --delete-vpc-net-id id=enpt8ok6snlp******** \
  --async

    Результат:

    id: fokg66rcqie1********
description: routing instance update prefix mask
created_at: "2025-12-23T08:53:09.626102995Z"
created_by: ajeol2afu1js********
modified_at: "2025-12-23T08:53:09.626102995Z"
metadata:
  '@type': type.googleapis.com/yandex.cloud.cloudrouter.v1.UpdateRoutingInstanceMetadata
  routing_instance_id: c3lgk007olse********

    Где:

    • id — идентификатор операции, выполняемой с Routing Instance.
    • description — описание выполняемой операции
    • created_by — идентификатор субъекта, который выполняет операцию.
    • async — выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.

  5. Дождитесь завершения операции и убедитесь в том, что конфигурация Routing Instance изменилась:

    yc cloudrouter routing-instance get c3lgk007olse******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3lgk007olse********
name: ri1
description: Routing instance 1
folder_id: b1gt6g8ht345********
region_id: ru-central1
vpc_info:
  - vpc_network_id: enpcfncr6uldme5e5929
    az_infos:
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 192.168.7.0/24
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.2.0/24
      - manual_info:
          az_id: ru-central1-b
          prefixes:
            - 192.168.15.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3or586ln29********
  - cic_private_connection_id: cf3uj9uph7b6********
status: ACTIVE
created_at: "2025-12-23T08:35:07Z"
    • id — идентификатор Routing Instance.
    • name — имя Routing Instance.
    • description — описание Routing Instance.
    • folder_id — идентификатор каталога, в котором был создан Routing Instance.
    • region_id — регион облака, в котором был создан Routing Instance.
    • vpc_info — список IP-префиксов, распределенный по зонам доступности. Для каждой зоны доступности префиксы указываются отдельно.
    • cic_private_connection_info — список приватных соединений, подключенных к Routing Instance.
    • status — состояние ресурса. Целевое состояние — ACTIVE. При изменении может находиться в состоянии UPDATING.
    • created_at — дата и время создания ресурса.

Обновить IP-префиксы имеющихся облачных сетей в Routing Instance

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  1. Посмотрите описание команды для управления сетями и IP-префиксами в Routing Instance:

    yc cloudrouter routing-instance update-networks --help

  2. Посмотрите список всех Routing Instance, имеющихся в каталоге:

    yc cloudrouter routing-instance list \
  --folder-id <идентификатор_каталога>

    Где --folder-id — идентификатор каталога, в котором находится нужный Routing Instance.

    Результат:

    +----------------------+------+----------+--------------------------------+
|          ID          | NAME |  STATUS  |     PRIVATE CONNECTION ID      |
+----------------------+------+----------+--------------------------------+
| c3lgk007olse******** | ri1  | UPDATING | cf3or586ln29********,          |
|                      |      |          | cf3uj9uph7b6********           |
+----------------------+------+----------+--------------------------------+

  3. Посмотрите информацию о Routing Instance, указав его идентификатор:

    yc cloudrouter routing-instance get c3lgk007olse******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3lgk007olse********
name: ri1
description: Routing instance 1
folder_id: b1gt6g8ht345********
region_id: ru-central1
vpc_info:
  - vpc_network_id: enpcfncr6uld********
    az_infos:
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 192.168.7.0/24
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.2.0/24
      - manual_info:
          az_id: ru-central1-b
          prefixes:
            - 192.168.15.0/24
  - vpc_network_id: enpt8ok6snlp********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.45.0/24
            - 192.168.46.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3or586ln29********
  - cic_private_connection_id: cf3uj9uph7b6********
status: UPDATING
created_at: "2025-12-23T07:30:19Z"

  4. Обновите анонсированные IP-префиксы в Routing Instance:

    yc cloudrouter routing-instance update-networks \
  --folder-id <идентификатор_каталога> \
  --id c3lgk007olse******** \
  --update-vpc-net id=enpcfncr6uld********,zone=ru-central1-a,ipv4-prefixes=192.168.2.0/28 \
  --update-vpc-net id=enpcfncr6uld********,zone=ru-central1-b,ipv4-prefixes=192.168.15.0/24 \
  --update-vpc-net id=enpcfncr6uld********,zone=ru-central1-d,ipv4-prefixes=192.168.7.0/24 \
  --update-vpc-net id=enpt8ok6snlp********,zone=ru-central1-d,ipv4-prefixes=192.168.47.0/28 \
  --async

    Результат:

    id: fokr80vgdskp********
description: routing instance update prefix mask
created_at: "2025-12-23T09:56:40.259684884Z"
created_by: ajeol2afu1js********
modified_at: "2025-12-23T09:56:40.259684884Z"
metadata:
  '@type': type.googleapis.com/yandex.cloud.cloudrouter.v1.UpdateRoutingInstanceMetadata
  routing_instance_id: c3lgk007olse********

    Где:

    • id — идентификатор операции, выполняемой с Routing Instance.
    • description — описание выполняемой операции
    • created_by — идентификатор субъекта, который выполняет операцию.
    • async — выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.

  5. Дождитесь завершения операции и убедитесь в том, что конфигурация Routing Instance изменилась:

    yc cloudrouter routing-instance get c3lgk007olse******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3lgk007olse********
name: ri1
description: Routing instance 1
folder_id: b1gt6g8ht345********
region_id: ru-central1
vpc_info:
  - vpc_network_id: enpcfncr6uld********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.2.0/28
      - manual_info:
          az_id: ru-central1-b
          prefixes:
            - 192.168.15.0/24
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 192.168.7.0/24
  - vpc_network_id: enpt8ok6snlp********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 192.168.47.0/28
cic_private_connection_info:
  - cic_private_connection_id: cf3or586ln29********
  - cic_private_connection_id: cf3uj9uph7b6********
status: ACTIVE
created_at: "2025-12-23T10:46:55Z"
    • id — идентификатор Routing Instance.
    • name — имя Routing Instance.
    • description — описание Routing Instance.
    • folder_id — идентификатор каталога, в котором был создан Routing Instance.
    • region_id — регион облака, в котором был создан Routing Instance.
    • vpc_info — список IP-префиксов, распределенный по зонам доступности. Для каждой зоны доступности префиксы указываются отдельно.
    • cic_private_connection_info — список приватных соединений, подключенных к Routing Instance.
    • status — состояние ресурса. Целевое состояние — ACTIVE. При изменении может находиться в состоянии UPDATING.
    • created_at — дата и время создания ресурса.

Добавить IP-префиксы в Routing Instance

Команда Yandex Cloud CLI yc cloudrouter routing-instance upsert-prefixes позволяет анонсировать новые IP-префиксы в Routing Instance.

Совет

Если вам необходимо добавить в Routing Instance новые IP-префиксы с одновременным удалением всех или части имеющихся в нем префиксов, воспользуйтесь командой yc cloudrouter routing-instance update-networks.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  1. Посмотрите описание команды CLI для изменения списка IP-префиксов в Routing Instance:

    yc cloudrouter routing-instance upsert-prefixes --help

  2. Посмотрите конфигурацию Routing Instance и состав IP-префиксов:

    yc cloudrouter routing-instance get c3l871dpin4f******** \
  --folder-id <идентификатор_каталога>

    Где --folder-id — идентификатор каталога, в котором находится нужный Routing Instance.

    Результат:

    id: c3l871dpin4f********
name: ri1
description: Routing instance 1
folder_id: b1gqfjiz2wda********
region_id: ru-central1
vpc_info:
  - vpc_network_id: c64ckjtr7b3l********
    az_infos:
      - manual_info:
          az_id: ru-central1-a
          prefixes:
            - 10.128.0.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3td2nufvr5********
status: ACTIVE
created_at: "2025-03-19T13:35:56Z"

  3. Добавьте дополнительные префиксы в список IP-префиксов Routing Instance:

    Примечание

    Чтобы управлять сетями и IP-префиксами в Routing Instance, необходима роль cloud-router.editor.

    yc cloudrouter routing-instance upsert-prefixes c3l871dpin4f******** \
  --folder-id <идентификатор_каталога> \
  --vpc-net id=c64ckjtr7b3l********,zone=ru-central1-b,ipv4-prefixes=10.129.0.0/24 \
  --vpc-net id=c64ckjtr7b3l********,zone=ru-central1-d,ipv4-prefixes=172.16.1.0/24 \
  --async

    Результат:

    id: al457njn6pj1********
description: routing instance upsert prefixes
created_at: "2025-03-24T15:24:15.817401507Z"
created_by: bfbudv7dfn22********
modified_at: "2025-03-24T15:24:15.817401507Z"
metadata:
  '@type': type.googleapis.com/yandex.cloud.cloudrouter.v1.UpdateRoutingInstanceMetadata
  routing_instance_id: c3l871dpin4f********

    Где:

    • id — идентификатор операции, выполняемой с Routing Instance.
    • description — описание выполняемой операции
    • created_by — идентификатор субъекта, который выполняет операцию.
    • async — выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.

  4. Дождитесь завершения операции и убедитесь в том, что конфигурация Routing Instance изменилась:

    yc cloudrouter routing-instance get c3l871dpin4f******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3l871dpin4f********
name: ri1
description: Routing instance 1
folder_id: b1gqfjiz2wda********
region_id: ru-central1
vpc_info:
  - vpc_network_id: c64ckjtr7b3l********
    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: cf3td2nufvr5********
status: ACTIVE
created_at: "2025-03-19T13:35:56Z"

    Где:

    • id — идентификатор Routing Instance.
    • name — имя Routing Instance.
    • description — описание Routing Instance.
    • folder_id — идентификатор каталога, в котором был создан Routing Instance.
    • region_id — регион облака, в котором был создан Routing Instance.
    • vpc_info — список IP-префиксов, распределенный по зонам доступности. Для каждой зоны доступности префиксы указываются отдельно.
    • cic_private_connection_info — список приватных соединений, подключенных к Routing Instance.
    • status — состояние ресурса. Целевое состояние — ACTIVE. При изменении может находиться в состоянии UPDATING.
    • created_at — дата и время создания ресурса.

Удалить IP-префиксы из Routing Instance

Команда Yandex Cloud CLI yc cloudrouter routing-instance remove-prefixes позволяет удалить анонсированные IP-префиксы из Routing Instance.

Совет

Если вам необходимо удалить имеющиеся IP-префиксы из Routing Instance с одновременным добавлением в него новых префиксов, воспользуйтесь командой yc cloudrouter routing-instance update-networks.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

  1. Посмотрите описание команды CLI для удаления IP-префиксов из Routing Instance:

    yc cloudrouter routing-instance remove-prefixes --help

  2. Посмотрите конфигурацию Routing Instance и состав IP-префиксов:

    yc cloudrouter routing-instance get c3l871dpin4f******** \
  --folder-id <идентификатор_каталога>

    Где --folder-id — идентификатор каталога, в котором находится нужный Routing Instance.

    Результат:

    id: c3l871dpin4f********
name: ri1
description: Routing instance 1
folder_id: b1gqfjiz2wda********
region_id: ru-central1
vpc_info:
  - vpc_network_id: c64ckjtr7b3l********
    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: cf3td2nufvr5********
status: ACTIVE
created_at: "2025-03-19T13:35:56Z"

  3. Удалите IP-префиксы из Routing Instance:

    Примечание

    Чтобы управлять сетями и IP-префиксами в Routing Instance, необходима роль cloud-router.editor.

    yc cloudrouter routing-instance remove-prefixes c3l871dpin4f******** \
  --folder-id <идентификатор_каталога> \
  --vpc-net id=c64ckjtr7b3l********,zone=ru-central1-b,ipv4-prefixes=10.128.0.0/24 \
  --vpc-net id=c64ckjtr7b3l********,zone=ru-central1-d,ipv4-prefixes=10.129.0.0/24 \
  --async

    Результат:

    id: al457njn6pj1********
description: routing instance remove prefixes
created_at: "2025-03-24T15:24:15.817401507Z"
created_by: bfbudv7dfn22********
modified_at: "2025-03-24T15:24:15.817401507Z"
metadata:
  '@type': type.googleapis.com/yandex.cloud.cloudrouter.v1.UpdateRoutingInstanceMetadata
  routing_instance_id: c3l871dpin4f********

    Где:

    • id — идентификатор операции, выполняемой с Routing Instance.
    • description — описание выполняемой операции
    • created_by — идентификатор субъекта, который выполняет операцию.
    • async — выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.

  4. Дождитесь завершения операции и убедитесь в том, что конфигурация Routing Instance изменилась:

    yc cloudrouter routing-instance get c3l871dpin4f******** \
  --folder-id <идентификатор_каталога>

    Результат:

    id: c3l871dpin4f********
name: ri1
description: Routing instance 1
folder_id: b1gqfjiz2wda********
region_id: ru-central1
vpc_info:
  - vpc_network_id: c64ckjtr7b3l********
    az_infos:
      - manual_info:
          az_id: ru-central1-d
          prefixes:
            - 172.16.1.0/24
cic_private_connection_info:
  - cic_private_connection_id: cf3td2nufvr5********
status: ACTIVE
created_at: "2025-03-19T13:35:56Z"

    Где:

    • id — идентификатор Routing Instance.
    • name — имя Routing Instance.
    • description — описание Routing Instance.
    • folder_id — идентификатор каталога, в котором был создан Routing Instance.
    • region_id — регион облака, в котором был создан Routing Instance.
    • vpc_info — список IP-префиксов, распределенный по зонам доступности. Для каждой зоны доступности префиксы указываются отдельно.
    • cic_private_connection_info — список приватных соединений, подключенных к Routing Instance.
    • status — состояние ресурса. Целевое состояние — ACTIVE. При изменении может находиться в состоянии UPDATING.
    • created_at — дата и время создания ресурса.
Предыдущая
Изменить параметры Routing Instance
Следующая
Добавить приватное соединение в Routing Instance