Updating virtual router settings
Written by
Updated at September 18, 2026
Note
You need the cloud-router.editor role to run this operation.
Management console
CLI
- In the management console
, select the folder containing the virtual router. - Navigate
to Cloud Router. - In the virtual router row, click
and select Edit. - Enter a new name and description for your virtual router.
- Add or delete labels.
- Enable or disable Deletion protection to protect your virtual router from accidental deletion.
- Add or delete private connections in the Private connections field.
- In the Networks field, add or delete networks and IP prefixes.
With the CLI, you can edit the following virtual router parameters:
- Name (
--new-name). - Description (
--description). - Labels (
--labels).
If you use --labels, the current labels will be completely overwritten.
Use separate commands to change the announced IP prefixes and add or remove private connections.
For example, to update the virtual router description, follow the steps below:
-
View the description of the CLI command for updating a virtual router:
yc cloudrouter routing-instance update --help -
Provide a new
descriptionfor the virtual router:yc cloudrouter routing-instance update c3l87**********1dpin \ --description "My new RI description" \ --asyncExpected result:
id: al4r9**********4613n description: routing instance update created_at: "2025-04-08T21:21:33.106772882Z" created_by: bfbud**********v7dfn modified_at: "2025-04-08T21:21:33.106772882Z" metadata: '@type': type.googleapis.com/yandex.cloud.cloudrouter.v1.UpdateRoutingInstanceMetadata routing_instance_id: c3l87**********1dpin -
Check the updated parameter value after the operation is complete:
yc cloudrouter routing-instance get c3l87**********1dpin