调用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.NTransitRouterRouteTableIds.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不存在。

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