Querying VPC Routes

Function

This API is used to query all routes of the tenant submitting the request. The routes are filtered based on the filtering condition. For details about the response format of pagination query, see section Pagination.

URI

GET /v2.0/vpc/routes

Example:

Example:
GET https://{Endpoint}/v2.0/vpc/routes?id={id}&vpc_id={vpc_id}&tenant_id={tenant_id}&destination={destination}&type={type}&limit={limit}&marker={marker}

Table 1 describes the parameters.

**Table 1** Parameter description
Name	Mandatory	Type	Description
id	No	String	Specifies that the route ID is used as the filtering condition.
tenant_id	No	String	Specifies that the tenant ID is used as the filtering condition.
vpc_id	No	String	Specifies that the VPC ID is used as the filtering condition.
destination	No	String	Specifies that the route destination address (CIDR) is used as the filtering condition.
type	No	String	Specifies that the type is used as the filtering condition. Currently, the value can only be peering.
marker	No	String	Specifies the start resource ID of pagination query. If the parameter is left blank, only resources on the first page are queried.
limit	No	Integer	Specifies the number of records returned on each page. The value ranges from 0 to intmax. The default value is 2000.

Request Message

Request parameter
None

Example request

GET https://{Endpoint}/v2.0/vpc/routes?vpc_id=ab78be2d-782f-42a5-aa72-35879f6890ff

Response Message

Response parameter

**Table 2** Response parameter
Parameter	Type	Description
routes	Array of route objects	Specifies the route object list. For details, see Table 3.
routes_links	Array of routes_link objects	Specifies the route object list. For details, see Table 4.

**Table 3** **route** objects
Attribute	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.

**Table 4** **routes_link** object
Name	Type	Description
href	String	Specifies the API link.
rel	String	Specifies the relationship between the API link and the API version.

Example response

{ 
  "routes": [ 
    { 
      "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" 
    }
  ] 
}