调用ListTransitRouterRouteTableAssociations接口查询企业版转发路由器路由表或网络实例连接已创建的关联转发关系。

使用说明

调用ListTransitRouterRouteTableAssociations接口时，请求参数TransitRouterRouteTableId和TransitRouterAttachmentId需至少输入一个：

  • 如果仅指定了TransitRouterRouteTableId参数的值，则表示您要查询与企业版转发路由器路由表创建关联转发关系的网络实例连接的信息。
  • 如果仅指定了TransitRouterAttachmentId参数的值，则表示您要查询与网络实例连接创建关联转发关系的企业版转发路由器路由表的信息。
  • 如果同时指定了TransitRouterRouteTableId和TransitRouterAttachmentId参数的值，则表示您要查询网络实例连接与企业版转发路由器路由表之间的关联转发关系。
    • 如果网络实例连接和企业版转发路由器路由表之间存在关联转发关系，则系统正常返回关联转发关系的信息。
    • 如果网络实例连接和企业版转发路由器路由表之间不存在关联转发关系，则TransitRouterAssociations数组返回为空值。

调试

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

请求参数

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

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

MaxResults Integer 否 50

分批次查询时每次显示的条目数。默认值：50。

NextToken String 否 a415****

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

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

企业版转发路由器路由表ID。
TransitRouterAttachmentId String 否 tr-attach-nls9fzkfat8934****

网络实例连接ID。

返回数据

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

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

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值，该取值表示下一次查询开始的令牌。
RequestId String F6B1D9AB-176D-4399-801D-8BC576F4EB0D

请求ID。
TotalCount Integer 1

列表条目数。
MaxResults Integer 50

分批次查询时每次显示的条目数。
TransitRouterAssociations Array of TransitRouterAssociation

关联转发关系信息列表。
TransitRouterAttachmentId String tr-attach-nls9fzkfat8934****

网络实例连接ID。
Status String Associating

关联转发的状态。

  • Active：可用。
  • Associating：加载中。
  • Dissociating：卸载中。
  • Deleted：已卸载。
ResourceType String VPC

下一跳资源类型。

  • VPC：专有网络实例。
  • VBR：边界路由器实例。
  • TR：转发路由器实例。
  • VPN：IPsec连接。
ResourceId String vpc-bp1h8vbrbcgohcju5****

下一跳资源ID。
TransitRouterRouteTableId String vtb-bp1dudbh2d5na6b50****

企业版转发路由器路由表ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterRouteTableAssociations
&MaxResults=50
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&TransitRouterAttachmentId=tr-attach-nls9fzkfat8934****
&公共请求参数

正常返回示例

XML格式 

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

<ListTransitRouterRouteTableAssociationsResponse>
    <RequestId>F6B1D9AB-176D-4399-801D-8BC576F4EB0D</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>50</MaxResults>
    <TransitRouterAssociations>
        <TransitRouterAttachmentId>tr-attach-nls9fzkfat8934****</TransitRouterAttachmentId>
        <Status>Associating</Status>
        <ResourceType>VPC</ResourceType>
        <ResourceId>vpc-bp1h8vbrbcgohcju5****</ResourceId>
        <TransitRouterRouteTableId>vtb-bp1dudbh2d5na6b50****</TransitRouterRouteTableId>
    </TransitRouterAssociations>
</ListTransitRouterRouteTableAssociationsResponse>

JSON格式 

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

{
  "RequestId" : "F6B1D9AB-176D-4399-801D-8BC576F4EB0D",
  "TotalCount" : 1,
  "MaxResults" : 50,
  "TransitRouterAssociations" : [ {
    "TransitRouterAttachmentId" : "tr-attach-nls9fzkfat8934****",
    "Status" : "Associating",
    "ResourceType" : "VPC",
    "ResourceId" : "vpc-bp1h8vbrbcgohcju5****",
    "TransitRouterRouteTableId" : "vtb-bp1dudbh2d5na6b50****"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 IllegalParam.NextToken The parameter NextToken is invalid. 指定的NextToken无效。请检查参数约束，并在修改后重试。

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