Getting information about a virtual router

You can view information about a virtual router using the following commands:

• yc cloudrouter routing-instance get: Get information about a virtual router by its name or ID.
• yc cloudrouter routing-instance get-by-cic-private-connection-id: Get information about a virtual router using the ID of the Yandex Cloud Interconnect private connection to the virtual router.
• yc cloudrouter routing-instance get-by-vpc-network-id: Get information about a virtual router using the ID of the cloud network the virtual router ensures connectivity with.

yc cloudrouter routing-instance get

1. See the description of the CLI command for getting virtual router info:

   yc cloudrouter routing-instance get --help
   

2. Get a list of virtual routers in a given folder:

   yc cloudrouter routing-instance list \
     --folder-id <folder_ID>
   

   Result:

   +----------------------+--------------------+--------+-----------------------+
   |          ID          |        NAME        | STATUS | PRIVATE CONNECTION ID |
   +----------------------+--------------------+--------+-----------------------+
   | cf3jqdc4gjpx******** | routing-instance   | ACTIVE | euuiog88zphg********, |
   |                      |                    |        | euucr7p47329********  |
   +----------------------+--------------------+--------+-----------------------+
   

3. Get information about a virtual router by providing its ID obtained in the previous step:

   yc cloudrouter routing-instance get cf3jqdc4gjpx********
   
   Result:

   Where:

   • id: Routing instance ID.
   • name: RI name.
   • description: RI description.
   • folder_id: ID of the cloud folder the RI was created in.
   • region_id: ID of the region the RI was created in.
   • vpc_info: Information about virtual networks and their IP prefixes with the prefixes grouped by availability zone. A routing instance may have one or more connected virtual networks.
   • cic_private_connection_info: Information about private connections to the RI.
   • status: RI state. It may take the following values:
     • ACTIVE: RI is active.
     • CREATING: RI is being created.
     • UPDATING: RI is being updated.
     • DELETING: RI is being deleted.

yc cloudrouter routing-instance get-by-cic-private-connection-id

1. See the description of the CLI command for getting virtual router info:

   yc cloudrouter routing-instance get-by-cic-private-connection-id --help
   

2. Get the list of private connections in the specified folder:

   yc cic private-connection list \
     --folder-id <folder_ID>
   

   Result:

   +----------------------+------+----------------------+
   |          ID          | NAME | TRUNK CONNECTION ID  |
   +----------------------+------+----------------------+
   | cf3r5ke20fo0******** |      | cf3dcodot14p******** |
   | cf3r3mfr4bm5******** |      | cf3dcodot14p******** |
   +----------------------+------+----------------------+
   

3. Get information about a virtual router by providing the ID of the private connection made to it:

   yc cloudrouter routing-instance get-by-cic-private-connection-id \
     --cic-prc-id cf3r5ke20fo0********
   
   Result:

   Where:

   • id: Routing instance ID.
   • name: RI name.
   • description: RI description.
   • folder_id: ID of the cloud folder the RI was created in.
   • region_id: ID of the region the RI was created in.
   • vpc_info: Information about virtual networks and their IP prefixes with the prefixes grouped by availability zone. A routing instance may have one or more connected virtual networks.
   • cic_private_connection_info: Information about private connections to the RI.
   • status: RI state. It may take the following values:
     • ACTIVE: RI is active.
     • CREATING: RI is being created.
     • UPDATING: RI is being updated.
     • DELETING: RI is being deleted.

yc cloudrouter routing-instance get-by-vpc-network-id

1. See the description of the CLI command for getting virtual router info:

   yc cloudrouter routing-instance get-by-vpc-network-id --help
   

2. Get the list of cloud networks in the specified folder:

   yc vpc network list \
     --folder-id <folder_ID>
   

   Result:

   +----------------------+-------------+
   |          ID          |    NAME     |
   +----------------------+-------------+
   | enpcfncr6uld******** | my-network1 |
   | enpcuntrql7d******** | my-network2 |
   +----------------------+-------------+
   

3. Get information about a virtual router by specifying the ID of the cloud network to which it provides network connectivity:

   yc cloudrouter routing-instance get-by-vpc-network-id \
     --vpc-id enpcfncr6uld********
   
   Result:

   Where:

   • id: Routing instance ID.
   • name: RI name.
   • description: RI description.
   • folder_id: ID of the cloud folder the RI was created in.
   • region_id: ID of the region the RI was created in.
   • vpc_info: Information about virtual networks and their IP prefixes with the prefixes grouped by availability zone. A routing instance may have one or more connected virtual networks.
   • cic_private_connection_info: Information about private connections to the RI.
   • status: RI state. It may take the following values:
     • ACTIVE: RI is active.
     • CREATING: RI is being created.
     • UPDATING: RI is being updated.
     • DELETING: RI is being deleted.