Updated on 2025-12-23 GMT+08:00

Querying a VPC Route

Function

This API is used to query details about a route.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

  • If you are using role/policy-based authorization, see the required permissions in Permissions and Supported Actions.
  • If you are using identity policy-based authorization, no identity policy-based permissions are required for calling this API.

URI

GET /v2.0/vpc/routes/{route_id}

Table 1 describes the parameters.
Table 1 Parameter description

Parameter

Mandatory

Type

Description

route_id

Yes

String

Specifies the route ID, which uniquely identifies the route.

Request Parameters

None

Example Request

GET https://{Endpoint}/v2.0/vpc/routes/60c809cb-6731-45d0-ace8-3bf5626421a9

Response Parameters

Table 2 Response parameter

Parameter

Type

Description

route

route object

Specifies the route. For details, see Table 3.

Table 3 route objects

Parameter

Type

Description

id

String

Specifies the route ID.

destination

String

Specifies the destination address in the CIDR notation format, for example, 192.168.200.0/24.

nexthop

String

Specifies the next hop. If the route type is peering, enter the VPC peering connection ID.

type

String

Specifies the route type. Currently, the value can only be peering.

vpc_id

String

Specifies the VPC of the route. Set this parameter to the existing VPC ID.

tenant_id

String

Specifies the project ID.

Example Response

{
    "route": { 
        "type": "peering",  
        "nexthop": "60c809cb-6731-45d0-ace8-3bf5626421a9",  
        "destination": "192.168.200.0/24",  
        "vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff",  
        "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
        "id": "3d42a0d4-a980-4613-ae76-a2cddecff054" 
    }
}

Status Code

See Status Codes.

Error Code

See Error Codes.