调用DescribeRouteTableList查询路由表_专有网络VPC(VPC)-阿里云帮助中心

调用DescribeRouteTableList接口查询路由表列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
vpc:DescribeRouteTableList	list	RouteTable `acs:vpc:{#regionId}:{#accountId}:routetable/`	vpc:VRouter vpc:VBR	无

请求参数

名称	类型	必填	描述	示例值
RouterType	string	否	要查询的路由表所属的路由器的类型。取值： VRouter（默认值）：VPC 路由器。 VBR：边界路由器。	VRouter
RouterId	string	否	要查询的路由表所属路由器的 ID。	vrt-bp1lhl0taikrteen8****
VpcId	string	否	要查询的路由表所属的 VPC 的 ID。指定该参数后，RouterType 参数的值自动设置为 VRouter。	vpc-bp15zckdt37pq72****
RouteTableId	string	否	要查询的路由表的 ID。	vtb-bp145q7glnuzdvzu2****
RouteTableName	string	否	要查询的路由表的名称。	doctest
PageNumber	integer	否	列表的页码，默认值为 1。	1
PageSize	integer	否	分页查询时每页的行数，最大值为 50，默认值为 10。	10
ResourceGroupId	string	否	要查询的路由表所属资源组的 ID。	rg-acfmxazb4ph****
RegionId	string	是	要查询的路由表所属的 VPC 的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	ap-southeast-6
Tag	array<object>	否	资源的标签。
	object	否	标签。
Key	string	否	资源的标签键。最多支持输入 20 个标签键。如需传入该值，则不能输入空字符串。一个标签键最多支持 128 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。	FinanceDept
Value	string	否	资源的标签值。最多支持输入 20 个标签值。如需传入该值，可以输入空字符串。最多支持 128 个字符，不能以`aliyun`和`acs:`开头，不能包含`http://`或者`https://`。	FinanceJoshua
RouteTableType	string	否	路由表的类型。 System：系统路由表。 Custom：自定义路由表。	System

返回参数

名称	类型	描述	示例值
	object	查询的路由表详细信息。
RequestId	string	请求 ID。	DC668356-BCB4-42FD-9BC3-FA2B2E04B634
PageSize	integer	每页包含的条目数。	10
PageNumber	integer	当前页码。	1
TotalCount	integer	列表条目数。	1
RouterTableList	array<object>	路由表列表详细信息。
RouterTableListType	object	路由表列表详细信息
VpcId	string	路由表所属的 VPC 的 ID。	vpc-bp15zckdt37pq72****
CreationTime	string	路由表的创建时间。	2021-08-22T10:40:25Z
Status	string	路由表的状态。取值： Pending：创建中。 Available：可用。 Deleting：删除中。	Available
RouterId	string	路由表所属的路由器 ID。	vrt-bp1lhl0taikrteen8****
AssociateType	string	路由表绑定的云资源类型。取值： VSwitch：交换机。 Gateway：IPv4 网关。	VSwitch
RouteTableId	string	路由表的 ID。	vtb-bp145q7glnuzdvzu2****
OwnerId	long	路由表所属阿里云账号 ID。	253460731706911258
Description	string	路由表的描述。	This is Route Table.
RouteTableType	string	路由表的类型。取值： Custom：自定义路由表。 System：系统路由表。	System
ResourceGroupId	string	路由表所属资源组的 ID。	rg-acfmxazb4ph****
RouterType	string	路由表所属路由器的类型。取值： VRouter：VPC 路由器。 VBR：边界路由器。	VRouter
RouteTableName	string	路由表的名称。	doctest
Tags	array<object>	路由表的标签。
Tag	object	路由表的标签。
Key	string	路由表绑定的标签键。	type
Value	string	路由表绑定的标签键对应的值。	ingress
VSwitchIds	array	交换机列表信息。
VSwitchId	string	交换机 ID。	vsw-bp12mw1f8k3jgygk9****
GatewayIds	array	IPv4 网关详细信息。
GatewayIds	string	IPv4 网关详细信息。	ipv4gw-5tsnc6s4ogsedtp3k****
RoutePropagationEnable	boolean	路由表是否接收传播路由。取值： true：路由表接收。 false：路由表不接收。	true

示例

正常返回示例

JSON格式

{
  "RequestId": "DC668356-BCB4-42FD-9BC3-FA2B2E04B634",
  "PageSize": 10,
  "PageNumber": 1,
  "TotalCount": 1,
  "RouterTableList": {
    "RouterTableListType": [
      {
        "VpcId": "vpc-bp15zckdt37pq72****",
        "CreationTime": "2021-08-22T10:40:25Z",
        "Status": "Available",
        "RouterId": "vrt-bp1lhl0taikrteen8****",
        "AssociateType": "VSwitch",
        "RouteTableId": "vtb-bp145q7glnuzdvzu2****",
        "OwnerId": 253460731706911260,
        "Description": "This is Route Table.",
        "RouteTableType": "System",
        "ResourceGroupId": "rg-acfmxazb4ph****",
        "RouterType": "VRouter",
        "RouteTableName": "doctest",
        "Tags": {
          "Tag": [
            {
              "Key": "type",
              "Value": "ingress"
            }
          ]
        },
        "VSwitchIds": {
          "VSwitchId": [
            "vsw-bp12mw1f8k3jgygk9****"
          ]
        },
        "GatewayIds": {
          "GatewayIds": [
            "ipv4gw-5tsnc6s4ogsedtp3k****"
          ]
        },
        "RoutePropagationEnable": true
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidTagKey	The tag keys are not valid.	无效的标签索引
400	InvalidTagValue	The tag values are not valid.	无效的标签值
400	IellgalParameter.OwnerAccount	The specified parameter OwnerAccount is not valid.	指定参数 OwnerAccount 不合法
403	Forbbiden	User not authorized to operate on the specified resource.	用户没有权限操作指定的资源。
403	Abs.InvalidPayType	Specified pay type is not valid.	-
403	Abs.InstanceNotExist	Specified instance not exist.	-
403	Abs.Forbidden	Specified instance cannot change pay type.	-
403	Abs.InvalidPayPeriod	Specified pay period not valid.	-

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2024-01-05	OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更	查看变更详情
2023-11-27	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2023-08-14	OpenAPI 错误码发生变更	查看变更详情
2023-08-03	OpenAPI 描述信息更新、OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情