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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RouterType String 否 VRouter

要查询的路由表所属的路由器的类型。取值：

  • VRouter（默认值）：VPC路由器。
  • VBR：边界路由器。
RouterId String 否 vrt-bp1lhl0taikrteen8****

要查询的路由表所属路由器的ID。
VpcId String 否 vpc-bp15zckdt37pq72****

要查询的路由表所属的VPC的ID。

指定该参数后，RouterType参数的值自动设置为VRouter。

RouteTableId String 否 vtb-bp145q7glnuzdvzu2****

要查询的路由表的ID。

RouteTableName String 否 doctest

要查询的路由表的名称。
PageNumber Integer 否 1

列表的页码，默认值为1。

PageSize Integer 否 10

分页查询时每页的行数，最大值为50，默认值为10。

ResourceGroupId String 否 rg-acfmxazb4ph****

要查询的路由表所属资源组的ID。
Action String 是 DescribeRouteTableList

系统规定参数。取值：DescribeRouteTableList。

RegionId String 是 ap-southeast-6

要查询的路由表所属的VPC的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

返回数据

名称 类型 示例值 描述
RequestId String DC668356-BCB4-42FD-9BC3-FA2B2E04B634

请求ID。
PageSize Integer 10

每页包含的条目数。
PageNumber Integer 1

当前页码。
TotalCount Integer 1

列表条目数。
RouterTableList Array of RouterTableListType

路由表列表详细信息。
RouterTableListType
VpcId String vpc-bp15zckdt37pq72****

路由表所属的VPC的ID。
CreationTime String 2021-08-22T10:40:25Z

路由表的创建时间。
Status String Available

路由表的状态。取值：

  • Pending：创建中。
  • Available：可用。
  • Deleting：删除中。
RouterId String vrt-bp1lhl0taikrteen8****

路由表所属的路由器ID。
AssociateType String VSwitch

路由表绑定的云资源类型。取值：

  • VSwitch：交换机。
  • Gateway：IPv4网关。
RouteTableId String vtb-bp145q7glnuzdvzu2****

路由表的ID。
OwnerId Long 253460731706911258

路由表所属阿里云账号ID。
Description String This is Route Table.

路由表的描述。
RouteTableType String System

路由表的类型。取值：

  • Custom：自定义路由表。
  • System：系统路由表。
ResourceGroupId String rg-acfmxazb4ph****

路由表所属资源组的ID。
RouterType String VRouter

路由表所属路由器的类型。取值：

  • VRouter：VPC路由器。
  • VBR：边界路由器。
RouteTableName String doctest

路由表的名称。
Tags Array of Tag

路由表的标签。
Tag
Key String type

路由表绑定的标签键。
Value String ingress

路由表绑定的标签键对应的值。
VSwitchIds Array of String vsw-bp12mw1f8k3jgygk9****

交换机ID。
GatewayIds Array of String ipv4gw-5tsnc6s4ogsedtp3k****

IPv4网关详细信息。

示例

请求示例

http(s)://[Endpoint]/?RouterType=VRouter
&RouterId=vrt-bp1lhl0taikrteen8****
&VpcId=vpc-bp15zckdt37pq72****
&RouteTableId=vtb-bp145q7glnuzdvzu2****
&RouteTableName=doctest
&PageNumber=1
&PageSize=10
&ResourceGroupId=rg-acfmxazb4ph****
&Action=DescribeRouteTableList
&RegionId=ap-southeast-6
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "DC668356-BCB4-42FD-9BC3-FA2B2E04B634",
  "PageSize" : 10,
  "PageNumber" : 1,
  "TotalCount" : 1,
  "RouterTableList" : [ {
    "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" : [ {
      "Key" : "type",
      "Value" : "ingress"
    } ],
    "VSwitchIds" : [ "vsw-bp12mw1f8k3jgygk9****" ],
    "GatewayIds" : [ "ipv4gw-5tsnc6s4ogsedtp3k****" ]
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidTagKey The tag keys are not valid. 无效的标签索引
400 InvalidTagValue The tag values are not valid. 无效的标签值
403 Forbbiden User not authorized to operate on the specified resource. 您没有权限操作该资源，请您申请操作权限后再试。

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