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

使用说明

您可以通过以下两种方式查询企业版转发路由器下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 FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

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

返回数据

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

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
RequestId String C97FF53F-3EF8-4883-B459-60E171924B23

请求ID。

TotalCount Integer 1

总条目数。

MaxResults Integer 20

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

TransitRouterAttachments Array of TransitRouterAttachment

VPC连接信息列表。

CreationTime String 2021-06-15T02:14Z

VPC连接的创建时间。

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

Status String Attached

VPC连接的状态。

  • Attached:已加载。
  • Attaching:加载中。
  • Detaching:卸载中。
  • Detached:已卸载。
VpcId String vpc-bp1h8vbrbcgohcju5****

VPC实例ID。

TransitRouterAttachmentId String tr-attach-nls9fzkfat8934****

VPC连接ID。

TransitRouterId String tr-bp1su1ytdxtataupl****

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

ResourceType String VPC

连接所属的资源类型。

仅取值:VPC,表示专有网络实例。

TransitRouterAttachmentDescription String testdesc

VPC连接的描述信息。

VpcOwnerId Long 1250123456123456

VPC实例所属账号ID。

VpcRegionId String cn-hangzhou

VPC实例所属地域ID。

TransitRouterAttachmentName String testname

VPC连接的名称。

ZoneMappings Array of ZoneMapping

VPC连接的可用区信息及其关联的VPC实例的交换机和弹性网卡的信息。

ZoneId String cn-hangzhou-h

可用区ID。

VSwitchId String vsw-bp1a214sbus8z3b54****

交换机ID。

NetworkInterfaceId String eni-bp149hmyaqegerml****

企业版转发路由器在交换机中创建的弹性网卡的ID。

ChargeType String POSTPAY

VPC连接的付费类型。

仅取值:POSTPAY,表示按使用量后付费。

示例

请求示例

http(s)://[Endpoint]/?Action=ListTransitRouterVpcAttachments
&CenId=cen-j3jzhw1zpau2km****
&RegionId=cn-hangzhou
&TransitRouterAttachmentId=tr-attach-nls9fzkfat8934****
&TransitRouterId=tr-bp1su1ytdxtataupl****
&MaxResults=20
&公共请求参数

正常返回示例

XML格式

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

<ListTransitRouterVpcAttachmentsResponse>
    <RequestId>C97FF53F-3EF8-4883-B459-60E171924B23</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>20</MaxResults>
    <TransitRouterAttachments>
        <CreationTime>2021-06-15T02:14Z</CreationTime>
        <Status>Attached</Status>
        <VpcId>vpc-bp1h8vbrbcgohcju5****</VpcId>
        <TransitRouterAttachmentId>tr-attach-nls9fzkfat8934****</TransitRouterAttachmentId>
        <TransitRouterId>tr-bp1su1ytdxtataupl****</TransitRouterId>
        <ResourceType>VPC</ResourceType>
        <TransitRouterAttachmentDescription>testdesc</TransitRouterAttachmentDescription>
        <VpcOwnerId>1250123456123456</VpcOwnerId>
        <VpcRegionId>cn-hangzhou</VpcRegionId>
        <TransitRouterAttachmentName>testname</TransitRouterAttachmentName>
        <ZoneMappings>
            <ZoneId>cn-hangzhou-h</ZoneId>
            <VSwitchId>vsw-bp1a214sbus8z3b54****</VSwitchId>
            <NetworkInterfaceId>eni-bp149hmyaqegerml****</NetworkInterfaceId>
        </ZoneMappings>
        <ChargeType>POSTPAY</ChargeType>
    </TransitRouterAttachments>
</ListTransitRouterVpcAttachmentsResponse>

JSON格式

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

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

错误码

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

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