查询路由表列表 - ListRouteTables

功能介绍

查询路由表列表。

调试

您可以在API Explorer中调试该接口。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

vpc:routeTables:list

List

routeTable *

-

-

-

-

g:EnterpriseProjectId

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
vpc:routeTables:list	List	routeTable *	-	-	-
-	g:EnterpriseProjectId

URI

GET /v1/{project_id}/routetables

样例：

GET https://{Endpoint}/v1/{project_id}/routetables?limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d&vpc_id=3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85&subnet_id=9873b33f-ac1c-4630-ad1c-7dba1ed79r78

参数说明请参见表1。

表1 参数说明
名称	是否必选	参数类型	说明
project_id	是	String	项目ID，请参见获取项目ID。
limit	否	Integer	分页查询每页返回的记录个数，取值范围为0~2000，默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。
marker	否	String	分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用：若不传入marker和limit参数，查询结果返回第一页全部资源记录。若不传入marker参数，limit为10，查询结果返回第1~10条资源记录。若marker为第10条记录的资源ID，limit为10，查询结果返回第11~20条资源记录。若marker为第10条记录的资源ID，不传入limit参数，查询结果返回第11~2000条（limit默认值2000）资源记录。
id	否	String	按照路由表ID过滤查询，可过滤对应ID的路由表。
vpc_id	否	String	按照路由表所属VPC的UUID过滤查询。
subnet_id	否	String	按照路由表所关联子网的UUID过滤查询。如果您使用管理控制台，此值即为子网详情中的“网络ID”参数值。

请求参数

无

请求示例

GET https://{Endpoint}/v1/{project_id}/routetables?limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d&vpc_id=3ec3b33f-ac1c-4630-ad1c-7dba1ed79d85&subnet_id=9873b33f-ac1c-4630-ad1c-7dba1ed79r78

响应参数

表2 响应参数
名称	参数类型	说明
routetables	Array of routetable objects	路由表列表对象，参见表3。

表3 routetable字段说明
名称	参数类型	说明
id	String	功能说明：路由表唯一标识。取值范围：标准UUID。
name	String	功能说明：路由表名称。取值范围：0-64个字符，支持数字、字母、中文字符、_(下划线)、-（中划线）、.（点）。
default	Boolean	功能说明：是否为默认路由表。取值范围：true表示默认路由表；false表示自定义路由表。
subnets	Array of subnet objects	功能说明：路由表所关联的子网，参见表4。约束：只能关联路由表所属VPC下的子网。
tenant_id	String	功能说明：项目ID。
vpc_id	String	功能说明：路由表所属VPC的ID。
description	String	路由表的描述信息。取值范围：0-255个字符，不能包含“<”和“>”。
created_at	String	功能说明：资源创建时间，UTC时间。格式：yyyy-MM-ddTHH:mm:ss。
updated_at	String	功能说明：资源更新时间，UTC时间。格式：yyyy-MM-ddTHH:mm:ss。

表4 subnet字段说明
名称	参数类型	说明
id	String	路由表关联的子网ID。

响应示例

{
    "routetables": [
        {
            "id": "3d42a0d4-a980-4613-ae76-a2cddecff054",
            "name": "routetable-1234",
            "vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff",
            "subnets": [
                {
                    "id": "8d4ce32f-d68a-4c4c-9f18-c68d8a5c7f2f"
                }
            ],
            "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
            "description": "abc",
            "created_at": "2022-12-15T02:56:40",
            "updated_at": "2022-12-15T02:56:40"
        },
        {
            "id": "3d42a0d4-a980-4613-ae76-a2cddecfff89",
            "name": "routetable-5678",
            "vpc_id": "ab78be2d-782f-42a5-aa72-35879f667809",
            "subnets": [
                {
                    "id": "8d4ce32f-d68a-4c4c-9f18-c68d8a5c7f2f"
                }
            ],
            "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
            "description": "abc",
            "created_at": "2022-12-15T02:59:03",
            "updated_at": "2022-12-15T02:59:03"
        }
    ]
}