Queries the list of route tables.

Make the API call

You can use OpenAPI Explorer to make API calls, search for API calls, perform debugging, and generate SDK example code.

Request parameters

Parameter Type Required? Example value Description
Action String Yes DescribeRouteTableList

The name of this action. Value: DescribeRouteTableList.

RegionId String Yes cn-hangzhou

The region ID of the VPC to which the route table belongs. To query the region ID, call DescribeRegions.

PageNumber Integer No 1

The page number. Default value: 1.

PageSize Integer No 10

The number of rows per page. Maximum value: 50. Default value: 10.

ResourceGroupId String No rg-acfmxazb4ph****

The ID of the resource group to which the route table belongs.

RouteTableId String No vtb-bp145q7glnuzdvzu2****

The ID of the route table.

RouteTableName String No doctest

The name of the route table.

RouterId String No vrt-bp1lhl0taikrteen8****

The ID of the VRouter to which the route table belongs.

RouterType String No VBR

The type of the VRouter to which the route table belongs. Valid values:

  • VRouter (default): VRouter.
  • VBR: Virtual Border Router (VBR).
VpcId String No vpc-bp15zckdt37pq72****

The ID of the VRouter to which the route table belongs.

The value of the RouterType parameter is set to VRouter automatically when this parameter is specified.

Response parameters

Parameter Type Example value Description
PageNumber Integer 1

The current page number.

PageSize Integer 10

The number of entries per page.

RequestId String DC668356-BCB4-42FD-9BC3-FA2B2E04B634

The ID of the request.

RouterTableList Array

The list of route tables.

RouterTableListType

The list of route tables.

CreationTime String 2017-08-22T10:40:25Z

The creation time of the route table.

Description String This is Route Table.

The description of the route table.

ResourceGroupId String rg-acfmxazb4ph****

The ID of the resource group to which the route table belongs.

RouteTableId String vtb-bp145q7glnuzdvzu2****

The ID of the route table.

RouteTableName String doctest

The name of the route table.

RouteTableType String System

The type of the route table.

  • Custom: Custom route table.
  • System: System route table.
RouterId String vrt-bp1lhl0taikrteen8****

The ID of the router to which the route table belongs.

RouterType String VBR

The type of the router to which the route table belongs.

  • VRouter: VRouter
  • VBR: VBR
Status String Available

The status of the route table.

  • Pending: The route table is being configured.
  • Available: The route table is available.
Tags Array

The list of route table tags.

Tag

The list of route table tags.

Key String type

The key of the tag associated with the route table.

Value String ingress

The value that matches the tag key associated with the route table.

VSwitchIds List vsw-bp12mw1f8k3jgygk9****

The list of VSwitches in the VPC.

VSwitchId

The list of VSwitches in the VPC.

VpcId String vpc-bp15zckdt37pq72****

The region ID of the VPC to which the route table belongs.

TotalCount Integer 1

The total number of entries.

Examples

Request example


https://vpc.aliyuncs.com/?Action=DescribeRouteTableList
&RegionId=cn-hangzhou
&<CommonParameters>

Response example

XML format

<DescribeRouteTableListResponse>
  <Code>200</Code>
  <Message>successful</Message>
  <PageNumber>1</PageNumber>
  <PageSize>10</PageSize>
  <RequestId>87261511-FEB9-4BEC-85BF-70XXXXXXXXX</RequestId>
  <RouterTableList>
        <RouterTableListType>
              <CreationTime>2018-08-03T08:14:54Z</CreationTime>
              <Description>ddd</Description>
              <RouteTableId>vtb-m5evbtbptnx2bcdfv****</RouteTableId>
              <RouteTableName>aaa1111</RouteTableName>
              <RouteTableType>Custom</RouteTableType>
              <RouterId>vrt-m5egeuhgj52xgnhyg****</RouterId>
              <RouterType>VRouter</RouterType>
              <VSwitchIds>
                    <VSwitchId>vsw-m5e3r57pxkgijcdvfcdvf****</VSwitchId>
              </VSwitchIds>
              <VpcId>vpc-bp15zckdt37pq72****</VpcId>
        </RouterTableListType>
  </RouterTableList>
  <Success>true</Success>
  <TotalCount>1</TotalCount>
</DescribeRouteTableListResponse>

JSON format

{
	"PageNumber":1,
	"TotalCount":1,
	"RouterTableList":{
		"RouterTableListType":[
			{
				"CreationTime":"2018-08-03T08:14:54Z",
				"RouterType":"VRouter",
				"Description":"ddd",
				"VSwitchIds":{
					"VSwitchId":[
						"vsw-m5e3r57pxkgijcdvfcdvf****"
					]
				},
				"RouterId":"vrt-m5egeuhgj52xgnhyg****",
				"RouteTableId":"vtb-m5evbtbptnx2bcdfv****",
				"RouteTableName":"aaa1111",
				"VpcId":"vpc-bp15zckdt37pq72****",
				"RouteTableType":"Custom"
			}
		]
	},
	"Message":"successful",
	"PageSize":10,
	"RequestId":"87261511-FEB9-4BEC-85BF-70XXXXXXXXX",
	"Success":true,
	"Code":"200"
}

Errors

HTTP status code Error code Error message Description
403 Forbbiden User not authorized to operate on the specified resource. You are not authorized to operate on this resource.

For a list of error codes, visit the API Error Center.