本接口用于获取路由表的列表。
下表列出了接口特定的请求参数以及公共请求参数 Action 和 Version。 其他公共参数,请参见公共参数。
参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | ListRouteTables | 接口名称。当前 API 的名称为 ListRouteTables。 |
Version | String | 是 | 2021-04-30 | 接口版本。当前 API 的版本为 2021-04-30。 |
route_table_list | String[] | 是 | route-table-7fs74n**** | 路由表 ID 列表。ID 之间用半角逗号(,)分隔。 |
status_list | String[] | 是 | updating,running | 路由表状态列表。路由表状态之间用半角逗号(,)分隔。取值范围:
|
type_list | String[] | 是 | default | 路由表类型列表。路由表类型之间用半角逗号(,)分隔。取值范围:
|
cluster_name_list | String[] | 否 | zj**-test01 | 节点列表。节点之间用半角逗号(,)分隔。 |
projects | String[] | 否 | default | 项目列表。项目之间用半角逗号(,)分隔。 |
TagFilters.N.Key | String[] | 否 | env | 标签键。 |
TagFilters.N.Values.N | String[] | 否 | prod | 标签值。 |
with_tag_info | Boolean | 否 | false | 是否返回标签信息。取值范围:
|
page | Integer | 否 | 1 | 路由表列表的页码。 默认值:1。 |
limit | Integer | 否 | 10 | 分页查询时设置的每页行数。 默认值:1000。 |
order_by | Integer | 否 | 1 | 查询出来的路由表的排列顺序,按照创建时间排序。取值范围:
|
下表仅列出本接口特有的返回参数。更多信息请参见返回结果。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
route_table_instances | Object[] | - | 路由表列表。 |
count | Integer | 1 | 路由表个数。 |
GET https://veenedge.volcengineapi.com/?Action=ListRouteTables&Version=2021-04-30 &<其他公共参数>
{ "ResponseMetadata": { "RequestId": "20230522172457278922232F61C893****", "Action": "ListRouteTables", "Version": "2021-04-30", "Service": "veenedge", "Region": "cn-north-1" }, "Result": { "route_table_instances": [ { "account_identity": 210000****, "user_identity": 0, "route_table_identity": "route-table-djxn57***", "route_table_name": "vpc-djxn57****-默认路由表", "type": "default", "status": "running", "vpc_identity": "vpc-djxn57****", "vpc_name": "**移动01-默认VPC", "desc": "vpc-djxn57****-默认路由表", "associated_subnet_count": 2, "create_time": 1682665425, "update_time": 1682665425 } ], "count": 1 } }
如果响应正文中包含 Error 字段,则表示 API 请求失败。关于错误码的更多信息,参见错误码。