调用ListTransitRouterVpcAttachments接口查询企业版转发路由器下专有网络VPC(Virtual Private Cloud)连接的信息。

API描述

您可以通过以下两种方式查询企业版转发路由器下VPC连接的信息:

  • 通过企业版转发路由器实例ID查询该实例下所有VPC连接的信息。
  • 通过云企业网实例ID和企业版转发路由器实例所属地域ID查询该企业版转发路由器实例下所有VPC连接的信息。

调试

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

请求参数

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

要执行的操作。取值:ListTransitRouterVpcAttachments

CenId String cen-j3jzhw1zpau2km****

云企业网实例ID。

RegionId String cn-hangzhou

企业版转发路由器实例所属地域ID。

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

TransitRouterAttachmentId String tr-attach-nls9fzkfat8934****

VPC连接ID。

TransitRouterId String tr-bp1su1ytdxtataupl****

企业版转发路由器实例ID。

MaxResults Integer 20

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

NextToken String dd20****

分批次查询时,下一次查询的Token。

返回数据

名称 类型 示例值 描述
MaxResults Integer 20

分批次查询时每次显示的条目数。

NextToken String dd20****

分批次查询时,下一次查询的Token。

RequestId String C97FF53F-3EF8-4883-B459-60E171924B23

请求ID。

TotalCount Integer 1

总条目数。

TransitRouterAttachments Array of TransitRouterAttachment

VPC连接信息。

CreationTime String 2021-06-15T02:14Z

VPC连接的创建时间。

时间按照ISO8601标准表示,并使用UTC时间。格式为:YYYY-MM-DDThh:mmZ。

ResourceType String VPC

连接所属的资源类型。

  • VPC:专有网络实例。
  • CCN:云连接网实例。
  • VBR:边界路由器实例。
  • TR:转发路由器实例。
Status String Attached

VPC连接的状态。

  • Attached:已加载。
  • Attaching:加载中。
  • Detaching:卸载中。
  • Detached:已卸载。
TransitRouterAttachmentDescription String testdesc

VPC连接的描述信息。

TransitRouterAttachmentId String tr-attach-nls9fzkfat8934****

VPC连接ID。

TransitRouterAttachmentName String testname

VPC连接的名称。

TransitRouterId String tr-bp1su1ytdxtataupl****

企业版转发路由器实例ID。

VpcId String vpc-bp1h8vbrbcgohcju5****

VPC实例ID。

VpcOwnerId Long 1688111111111111

VPC实例所属账号ID。

VpcRegionId String cn-hangzhou

VPC实例所属地域ID。

ZoneMappings Array of ZoneMapping

VPC连接的主备可用区信息及其关联的VPC实例的交换机信息。

VSwitchId String vsw-bp1a214sbus8z3b54****

交换机ID。

ZoneId String cn-hangzhou-h

可用区ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterVpcAttachments
&<公共请求参数>

正常返回示例

XML格式

<TotalCount>1</TotalCount>
<RequestId>C97FF53F-3EF8-4883-B459-60E171924B23</RequestId>
<MaxResults>20</MaxResults>
<TransitRouterAttachments>
    <TransitRouterAttachmentId>tr-attach-nls9fzkfat8934****</TransitRouterAttachmentId>
    <Status>Attached</Status>
    <VpcId>vpc-bp1h8vbrbcgohcju5****</VpcId>
    <CreationTime>2021-06-15T02:14Z</CreationTime>
    <VpcRegionId>cn-hangzhou</VpcRegionId>
    <TransitRouterAttachmentName>test1</TransitRouterAttachmentName>
    <ResourceType>VPC</ResourceType>
    <ZoneMappings>
        <ZoneId>cn-hangzhou-h</ZoneId>
        <VSwitchId>vsw-bp1a214sbus8z3b54****</VSwitchId>
    </ZoneMappings>
    <ZoneMappings>
        <ZoneId>cn-hangzhou-i</ZoneId>
        <VSwitchId>vsw-bp1w4ve8ikmzml84g****</VSwitchId>
    </ZoneMappings>
    <VpcOwnerId>1688111111111111</VpcOwnerId>
    <TransitRouterId>tr-bp1su1ytdxtataupl****</TransitRouterId>
</TransitRouterAttachments>

JSON格式

{
  "TotalCount": 1,
  "RequestId": "C97FF53F-3EF8-4883-B459-60E171924B23",
  "MaxResults": 20,
  "TransitRouterAttachments": [
    {
      "TransitRouterAttachmentId": "tr-attach-nls9fzkfat8934****",
      "Status": "Attached",
      "VpcId": "vpc-bp1h8vbrbcgohcju5****",
      "CreationTime": "2021-06-15T02:14Z",
      "VpcRegionId": "cn-hangzhou",
      "TransitRouterAttachmentName": "test1",
      "ResourceType": "VPC",
      "ZoneMappings": [
        {
          "ZoneId": "cn-hangzhou-h",
          "VSwitchId": "vsw-bp1a214sbus8z3b54****"
        },
        {
          "ZoneId": "cn-hangzhou-i",
          "VSwitchId": "vsw-bp1w4ve8ikmzml84g****"
        }
      ],
      "VpcOwnerId": "1688111111111111",
      "TransitRouterId": "tr-bp1su1ytdxtataupl****"
    }
  ]
}

错误码

HttpCode 错误码 错误信息 描述
400 IllegalParam.NextToken The specified NextToken is invalid. NextToken是无效的。
400 IllegalParam.TrInstance The specified TransitRouter is invalid. TransitRouter是无效的。

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