更新时间:2024-01-02 GMT+08:00
分享

查询路由列表

功能介绍

查询路由列表

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/routetables/{routetable_id}/routes

表1 路径参数

参数

是否必选

参数类型

描述

routetable_id

String

路由表ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

routes

Array of Route objects

路由列表

表4 Route

参数

参数类型

描述

type

String

路由的类型

取值范围: 1)ecs:弹性云服务器 2)vip:虚拟IP 3)local:系统路由,不可修改和删除

destination

String

路由的目的网段

约束:合法的CIDR格式

nexthop

String

路由下一跳对象的ID

取值范围: 1)当type为ecs时,传入ecs实例ID; 2)当type为vip时,取值为vip对应的IP地址;

description

String

路由的描述信息

取值范围:0-255个字符,不能包含“<”和“>”

请求示例

GET https://{{endpoint}}/v1/routetables/97d08984-d346-410e-bc0e-f466dfbd1f24/routes

响应示例

状态码: 200

OK

{
  "routes" : [ {
    "type" : "local",
    "destination" : "172.16.0.0/26",
    "nexthop" : "-",
    "description" : ""
  }, {
    "type" : "local",
    "destination" : "198.19.128.0/20",
    "nexthop" : "-",
    "description" : ""
  }, {
    "type" : "local",
    "destination" : "127.0.0.0/8",
    "nexthop" : "-",
    "description" : ""
  }, {
    "type" : "local",
    "destination" : "100.64.0.0/10",
    "nexthop" : "-",
    "description" : ""
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档