Управлять сетями и IP-префиксами в виртуальном маршрутизаторе
Изменить сети и IP-префиксы в виртуальном маршрутизаторе
Примечание
Чтобы управлять сетями и IP-префиксами в Routing Instance, необходима роль cloud-router.editor.
Добавить новую облачную сеть в виртуальный маршрутизатор
- В консоли управления
выберите каталог, в котором находится виртуальный маршрутизатор. - Перейдите
в сервис Cloud Router. - В строке с виртуальным маршрутизатором нажмите значок
и выберите Редактировать. - В блоке Маршрутизируемые сети и префиксы раскройте выпадающий список и выберите сеть, которую нужно добавить. При необходимости воспользуйтесь поиском.
- Нажмите кнопку Сохранить.
Команда Yandex Cloud CLI yc cloudrouter routing-instance update-networks позволяет одновременно управлять набором анонсированных IP-префиксов облачных сетей Yandex Virtual Private Cloud, добавленных в виртуальный маршрутизатор, а также добавлять новые сети в виртуальный маршрутизатор и удалять имеющиеся.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
-
Посмотрите описание команды для управления сетями и IP-префиксами в Routing Instance:
yc cloudrouter routing-instance update-networks --help -
Посмотрите список всех Routing Instance, имеющихся в каталоге:
yc cloudrouter routing-instance list \ --folder-id <идентификатор_каталога>Где
--folder-id— идентификатор каталога, в котором находится нужный Routing Instance.Результат:
+----------------------+------+----------+--------------------------------+ | ID | NAME | STATUS | PRIVATE CONNECTION ID | +----------------------+------+----------+--------------------------------+ | c3lgk007olse******** | ri1 | UPDATING | cf3or586ln29********, | | | | | cf3uj9uph7b6******** | +----------------------+------+----------+--------------------------------+ -
Посмотрите информацию о Routing Instance, указав его идентификатор:
yc cloudrouter routing-instance get c3lgk007olse******** \ --folder-id <идентификатор_каталога>Результат:
id: c3lgk007olse******** name: ri1 description: Routing instance 1 folder_id: b1gt6g8ht345******** region_id: kz1 vpc_info: - vpc_network_id: enpcfncr6uld******** az_infos: - manual_info: az_id: kz1-a prefixes: - 192.168.2.0/24 - vpc_network_id: enpt8ok6snlp******** az_infos: - manual_info: az_id: kz1-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" -
Добавьте в виртуальный маршрутизатор новую сеть с анонсированным IP-префиксом, указав идентификатор этой сети в поле
idпараметра--add-vpc-net:yc cloudrouter routing-instance update-networks \ --folder-id <идентификатор_каталога> \ --id c3lgk007olse******** \ --add-vpc-net id=enpvt41bh5gk********,zone=kz1-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— выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.
-
Дождитесь завершения операции и убедитесь в том, что конфигурация виртуального маршрутизатора изменилась:
yc cloudrouter routing-instance get c3lgk007olse******** \ --folder-id <идентификатор_каталога>Результат:
id: c3lgk007olse******** name: ri1 description: Routing instance 1 folder_id: b1gt6g8ht345******** region_id: kz1 vpc_info: - vpc_network_id: enpcfncr6uldme5e5929 az_infos: - manual_info: az_id: kz1-a prefixes: - 192.168.2.0/24 - vpc_network_id: enpt8ok6snlp******** az_infos: - manual_info: az_id: kz1-a prefixes: - 192.168.45.0/24 - 192.168.46.0/24 - vpc_network_id: enpvt41bh5gk******** az_infos: - manual_info: az_id: kz1-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— дата и время создания ресурса.
Удалить имеющуюся облачную сеть из виртуального маршрутизатора
- В консоли управления
выберите каталог, в котором находится виртуальный маршрутизатор. - Перейдите
в сервис Cloud Router. - Выберите виртуальный маршрутизатор.
- В блоке Маршрутизируемые сети и префиксы рядом с облачной сетью нажмите значок
и выберите Удалить. - В открывшемся окне подтвердите удаление.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
-
Посмотрите описание команды для управления сетями и IP-префиксами в Routing Instance:
yc cloudrouter routing-instance update-networks --help -
Посмотрите список всех Routing Instance, имеющихся в каталоге:
yc cloudrouter routing-instance list \ --folder-id <идентификатор_каталога>Где
--folder-id— идентификатор каталога, в котором находится нужный Routing Instance.Результат:
+----------------------+------+----------+--------------------------------+ | ID | NAME | STATUS | PRIVATE CONNECTION ID | +----------------------+------+----------+--------------------------------+ | c3lgk007olse******** | ri1 | UPDATING | cf3or586ln29********, | | | | | cf3uj9uph7b6******** | +----------------------+------+----------+--------------------------------+ -
Посмотрите информацию о Routing Instance, указав его идентификатор:
yc cloudrouter routing-instance get c3lgk007olse******** \ --folder-id <идентификатор_каталога>Результат:
id: c3lgk007olse******** name: ri1 description: Routing instance 1 folder_id: b1gt6g8ht345******** region_id: kz1 vpc_info: - vpc_network_id: enpcfncr6uld******** az_infos: - manual_info: az_id: kz1-a prefixes: - 192.168.2.0/24 - vpc_network_id: enpt8ok6snlp******** az_infos: - manual_info: az_id: kz1-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" -
Удалите из виртуального маршрутизатора имеющуюся сеть:
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— выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.
-
Дождитесь завершения операции и убедитесь в том, что конфигурация виртуального маршрутизатора изменилась:
yc cloudrouter routing-instance get c3lgk007olse******** \ --folder-id <идентификатор_каталога>Результат:
id: c3lgk007olse******** name: ri1 description: Routing instance 1 folder_id: b1gt6g8ht345******** region_id: kz1 vpc_info: - vpc_network_id: enpcfncr6uldme5e5929 az_infos: - manual_info: az_id: kz1-a prefixes: - 192.168.2.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-префиксы имеющихся облачных сетей в виртуальном маршрутизаторе
-
В консоли управления
выберите каталог, в котором находится виртуальный маршрутизатор. -
Перейдите
в сервис Cloud Router. -
Выберите виртуальный маршрутизатор.
-
В блоке Маршрутизируемые сети и префиксы рядом с облачной сетью нажмите значок
и выберите Редактировать. В открывшемся окне:- Отметьте подсети, в которых вы хотите изменить IP-префиксы.
- Измените необходимые IP-префиксы.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
-
Посмотрите описание команды для управления сетями и IP-префиксами в Routing Instance:
yc cloudrouter routing-instance update-networks --help -
Посмотрите список всех Routing Instance, имеющихся в каталоге:
yc cloudrouter routing-instance list \ --folder-id <идентификатор_каталога>Где
--folder-id— идентификатор каталога, в котором находится нужный Routing Instance.Результат:
+----------------------+------+----------+--------------------------------+ | ID | NAME | STATUS | PRIVATE CONNECTION ID | +----------------------+------+----------+--------------------------------+ | c3lgk007olse******** | ri1 | UPDATING | cf3or586ln29********, | | | | | cf3uj9uph7b6******** | +----------------------+------+----------+--------------------------------+ -
Посмотрите информацию о Routing Instance, указав его идентификатор:
yc cloudrouter routing-instance get c3lgk007olse******** \ --folder-id <идентификатор_каталога>Результат:
id: c3lgk007olse******** name: ri1 description: Routing instance 1 folder_id: b1gt6g8ht345******** region_id: kz1 vpc_info: - vpc_network_id: enpcfncr6uld******** az_infos: - manual_info: az_id: kz1-a prefixes: - 192.168.2.0/24 - vpc_network_id: enpt8ok6snlp******** az_infos: - manual_info: az_id: kz1-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" -
Обновите анонсированные IP-префиксы в виртуальном маршрутизаторе:
yc cloudrouter routing-instance update-networks \ --folder-id <идентификатор_каталога> \ --id c3lgk007olse******** \ --update-vpc-net id=enpcfncr6uld********,zone=kz1-a,ipv4-prefixes=192.168.2.0/28 \ --update-vpc-net id=enpt8ok6snlp********,zone=kz1-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— выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.
-
Дождитесь завершения операции и убедитесь в том, что конфигурация виртуального маршрутизатора изменилась:
yc cloudrouter routing-instance get c3lgk007olse******** \ --folder-id <идентификатор_каталога>Результат:
id: c3lgk007olse******** name: ri1 description: Routing instance 1 folder_id: b1gt6g8ht345******** region_id: kz1 vpc_info: - vpc_network_id: enpcfncr6uld******** az_infos: - manual_info: az_id: kz1-a prefixes: - 192.168.2.0/28 - vpc_network_id: enpt8ok6snlp******** az_infos: - manual_info: az_id: kz1-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-префиксы в виртуальный маршрутизатор
-
В консоли управления
выберите каталог, в котором находится виртуальный маршрутизатор. -
Перейдите
в сервис Cloud Router. -
Выберите виртуальный маршрутизатор.
-
В блоке Маршрутизируемые сети и префиксы рядом с облачной сетью нажмите значок
и выберите Редактировать. В открывшемся окне:- Отметьте блоки с подсетями, в которых вы хотите добавить IP-префиксы.
- Введите необходимые IP-префиксы.
- Нажмите кнопку Сохранить.
Команда Yandex Cloud CLI yc cloudrouter routing-instance upsert-prefixes позволяет анонсировать новые IP-префиксы в виртуальном маршрутизаторе.
Совет
Если вам необходимо добавить в виртуальный маршрутизатор новые IP-префиксы с одновременным удалением всех или части имеющихся в нем префиксов, воспользуйтесь командой yc cloudrouter routing-instance update-networks.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
-
Посмотрите описание команды CLI для изменения списка IP-префиксов в виртуальном маршрутизаторе:
yc cloudrouter routing-instance upsert-prefixes --help -
Посмотрите конфигурацию виртуального маршрутизатора и состав IP-префиксов:
yc cloudrouter routing-instance get c3l871dpin4f******** \ --folder-id <идентификатор_каталога>Где
--folder-id— идентификатор каталога, в котором находится нужный виртуальный маршрутизатор.Результат:
id: c3l871dpin4f******** name: ri1 description: Routing instance 1 folder_id: b1gqfjiz2wda******** region_id: kz1 vpc_info: - vpc_network_id: c64ckjtr7b3l******** az_infos: - manual_info: az_id: kz1-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" -
Добавьте дополнительные префиксы в список IP-префиксов виртуального маршрутизатора:
Примечание
Чтобы управлять сетями и IP-префиксами в Routing Instance, необходима роль
cloud-router.editor.yc cloudrouter routing-instance upsert-prefixes c3l871dpin4f******** \ --folder-id <идентификатор_каталога> \ --vpc-net id=c64ckjtr7b3l********,zone=kz1-a,ipv4-prefixes=10.129.0.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— выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.
-
Дождитесь завершения операции и убедитесь в том, что конфигурация виртуального маршрутизатора изменилась:
yc cloudrouter routing-instance get c3l871dpin4f******** \ --folder-id <идентификатор_каталога>Результат:
id: c3l871dpin4f******** name: ri1 description: Routing instance 1 folder_id: b1gqfjiz2wda******** region_id: kz1 vpc_info: - vpc_network_id: c64ckjtr7b3l******** az_infos: - manual_info: az_id: kz1-a prefixes: - 10.128.0.0/24 - 10.129.0.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-префиксы из виртуального маршрутизатора
-
В консоли управления
выберите каталог, в котором находится виртуальный маршрутизатор. -
Перейдите
в сервис Cloud Router. -
Выберите виртуальный маршрутизатор.
-
В блоке Маршрутизируемые сети и префиксы рядом с облачной сетью нажмите значок
и выберите Редактировать. В открывшемся окне:- Отметьте блоки с подсетями, из которых вы хотите удалить IP-префиксы.
- Нажмите значок
рядом с префиксами, которые вы хотите удалить. - Нажмите кнопку Сохранить.
Команда Yandex Cloud CLI yc cloudrouter routing-instance remove-prefixes позволяет удалить анонсированные IP-префиксы из виртуального маршрутизатора.
Совет
Если вам необходимо удалить имеющиеся IP-префиксы из виртуального маршрутизатора с одновременным добавлением в него новых префиксов, воспользуйтесь командой yc cloudrouter routing-instance update-networks.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
-
Посмотрите описание команды CLI для удаления IP-префиксов из виртуального маршрутизатора:
yc cloudrouter routing-instance remove-prefixes --help -
Посмотрите конфигурацию виртуального маршрутизатора и состав IP-префиксов:
yc cloudrouter routing-instance get c3l871dpin4f******** \ --folder-id <идентификатор_каталога>Где
--folder-id— идентификатор каталога, в котором находится нужный виртуальный маршрутизатор.Результат:
id: c3l871dpin4f******** name: ri1 description: Routing instance 1 folder_id: b1gqfjiz2wda******** region_id: kz1 vpc_info: - vpc_network_id: c64ckjtr7b3l******** az_infos: - manual_info: az_id: kz1-a prefixes: - 10.128.0.0/24 - 10.129.0.0/24 cic_private_connection_info: - cic_private_connection_id: cf3td2nufvr5******** status: ACTIVE created_at: "2025-03-19T13:35:56Z" -
Удалите IP-префиксы из виртуального маршрутизатора:
Примечание
Чтобы управлять сетями и IP-префиксами в Routing Instance, необходима роль
cloud-router.editor.yc cloudrouter routing-instance remove-prefixes c3l871dpin4f******** \ --folder-id <идентификатор_каталога> \ --vpc-net id=c64ckjtr7b3l********,zone=kz1-a,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— выполнение операции в асинхронном режиме. Рекомендуем все операции с изменением ресурсов выполнять в этом режиме.
-
Дождитесь завершения операции и убедитесь в том, что конфигурация виртуального маршрутизатора изменилась:
yc cloudrouter routing-instance get c3l871dpin4f******** \ --folder-id <идентификатор_каталога>Результат:
id: c3l871dpin4f******** name: ri1 description: Routing instance 1 folder_id: b1gqfjiz2wda******** region_id: kz1 vpc_info: - vpc_network_id: c64ckjtr7b3l******** az_infos: - manual_info: az_id: kz1-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"Где:
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— дата и время создания ресурса.