调用ListTransitRouterRouteTables接口查询企业版转发路由器的路由表信息。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListTransitRouterRouteTables

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

MaxResults Integer 否 20

分批次查询时，每次显示的条目数。取值范围：1~100，默认值：20。

NextToken String 否 dd20****

是否拥有下一次查询的令牌（Token）。取值：

  • 第一次查询和没有下一次查询时，均无需填写。
  • 如果有下一次查询，取值为上一次API调用返回的NextToken值。
TransitRouterRouteTableType String 否 Custom

路由表的类型。取值：

  • Custom：自定义路由表。
  • System：系统默认路由表。
TransitRouterId String 是 tr-uf654ttymmljlvh2x****

企业版转发路由器实例ID。
TransitRouterRouteTableStatus String 否 Active

路由表的状态。取值：

  • Creating：创建中。
  • Deleting：删除中。
  • Active：可用。
TransitRouterRouteTableNames.N String 否 testname

路由表的名称。

您可以一次查询多个路由表的信息，N的最大值为20。

说明 如果您同时通过TransitRouterRouteTableNames.N和TransitRouterRouteTableIds.N查询路由表的信息时，路由表的名称和路由表的ID需保持一致。
TransitRouterRouteTableIds.N String 否 vtb-bp1dudbh2d5na6b50****

路由表的ID。

您可以一次查询多个路由表的信息，N的最大值为20。

返回数据

名称 类型 示例值 描述
NextToken String dd20****

是否拥有下一次查询的令牌（Token）。取值：

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值，该取值表示下一次查询开始的令牌。
RequestId String 82678F4A-C9F7-4CC1-8BF0-D619A63BFC57

请求ID。
TotalCount Integer 1

总条目数。
MaxResults Integer 20

分批次查询时，每次显示的条目数。
TransitRouterRouteTables Array of TransitRouterRouteTable

路由表信息列表。
TransitRouterRouteTableStatus String Active

路由表的状态。

  • Creating：创建中。
  • Deleting：删除中。
  • Active：可用。
TransitRouterRouteTableType String System

路由表的类型。

  • Custom：自定义路由表。
  • System：系统默认路由表。
CreateTime String 2021-03-15T09:39Z

路由表的创建时间。

时间按照ISO8601标准表示，并使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。
TransitRouterRouteTableId String vtb-bp1dudbh2d5na6b50****

路由表ID。
TransitRouterRouteTableName String testname

路由表的名称。
TransitRouterRouteTableDescription String testdesc

路由表的描述信息。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterRouteTables
&MaxResults=1
&NextToken=dd20****
&TransitRouterRouteTableType=Custom
&TransitRouterId=tr-uf654ttymmljlvh2x****
&TransitRouterRouteTableStatus=Active
&TransitRouterRouteTableNames=["testname"]
&TransitRouterRouteTableIds=["vtb-bp1dudbh2d5na6b50****"]
&公共请求参数

正常返回示例

XML格式 

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

<ListTransitRouterRouteTablesResponse>
    <NextToken>dd20****</NextToken>
    <RequestId>82678F4A-C9F7-4CC1-8BF0-D619A63BFC57</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>1</MaxResults>
    <TransitRouterRouteTables>
        <TransitRouterRouteTableStatus>Active</TransitRouterRouteTableStatus>
        <TransitRouterRouteTableType>System</TransitRouterRouteTableType>
        <CreateTime>2021-03-15T09:39Z</CreateTime>
        <TransitRouterRouteTableId>vtb-bp1dudbh2d5na6b50****</TransitRouterRouteTableId>
        <TransitRouterRouteTableName>testname</TransitRouterRouteTableName>
        <TransitRouterRouteTableDescription>testdesc</TransitRouterRouteTableDescription>
    </TransitRouterRouteTables>
</ListTransitRouterRouteTablesResponse>

JSON格式 

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

{
  "NextToken" : "dd20****",
  "RequestId" : "82678F4A-C9F7-4CC1-8BF0-D619A63BFC57",
  "TotalCount" : 1,
  "MaxResults" : 1,
  "TransitRouterRouteTables" : [ {
    "TransitRouterRouteTableStatus" : "Active",
    "TransitRouterRouteTableType" : "System",
    "CreateTime" : "2021-03-15T09:39Z",
    "TransitRouterRouteTableId" : "vtb-bp1dudbh2d5na6b50****",
    "TransitRouterRouteTableName" : "testname",
    "TransitRouterRouteTableDescription" : "testdesc"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidTransitRouterId.NotFound TransitRouterId is not found. 转发路由实例ID不存在。

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