更新时间：2024-10-11 GMT+08:00
查询VPC路由列表
功能介绍
查询提交请求的租户的所有路由列表，并根据过滤条件进行过滤。分页查询响应格式请参考分页查询。
URI
GET /v2.0/vpc/routes
样例：
样例：
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}
参数说明请参见表1。
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
id |
否 |
String |
按照routes_id过滤查询 |
|
tenant_id |
否 |
String |
按照tenant_id过滤查询 |
|
vpc_id |
否 |
String |
按照vpc_id过滤查询 |
|
destination |
否 |
String |
按照路由目的地址CIDR过滤查询 |
|
type |
否 |
String |
按照type进行过滤查询，目前只支持peering |
|
marker |
否 |
String |
分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用：
|
|
limit |
否 |
Integer |
分页查询每页返回的记录个数，取值范围为0~intmax（2^31-1），默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。 默认值为2000。 |
请求参数
无
请求示例
GET https://{Endpoint}/v2.0/vpc/routes?vpc_id=ab78be2d-782f-42a5-aa72-35879f6890ff
响应参数
|
参数名称 |
类型 |
说明 |
|---|---|---|
|
routes |
Array of route objects |
route对象列表，参见表3。 |
|
routes_links |
Array of routes_link objects |
routes_link对象列表，参见表4。 只有在使用limit过滤，并且资源个数超过limit或者资源个数超过2000时（limit默认值），该参数的rel和href取值才会显示为next和其对应的link。 |
响应示例
{
"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"
}
]
}
状态码
请参见状态码。
错误码
请参考错误码。
父主题： VPC路由
