调用ListVpcPeerConnections接口查询VPC对等连接的详细信息。

调试

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

请求参数

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

系统规定参数。取值:ListVpcPeerConnections

RegionId String cn-hangzhou

需要查询详细信息的VPC对等连接的地域ID。

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

InstanceId String pcc-lnk0m24khwvtkm****

需要查询详细信息的VPC对等连接实例ID。

VpcId Array of String vpc-bp1gsk7h12ew7oegk****

需要查询详细信息的VPC对等连接的发起端或者接收端VPC的实例ID。

Name String vpcpeer

需要查询详细信息的VPC对等连接的名称。

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

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

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

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

返回数据

名称 类型 示例值 描述
RequestId String 0ED8D006-F706-4D23-88ED-E11ED39DCAC0

请求ID。

TotalCount Integer 1

列表条目数。

MaxResults Integer 20

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

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

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

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。
VpcPeerConnects Array of VpcPeerConnects

查询的VPC对等连接的详细信息列表。

InstanceId String pcc-lnk0m24khwvtkm****

VPC对等连接的实例ID。

GmtCreate String 2022-04-24T09:02:36Z

VPC对等连接的创建时间。

GmtModified String 2022-04-24T19:20:45Z

VPC对等连接的修改时间。

Name String vpcpeer

VPC对等连接的名称。

Description String test

VPC对等连接的描述信息。

OwnerId Integer 253460731706911258

VPC对等连接发起端的阿里云账号ID。

AcceptingOwnerUid Integer 253460731706911258

VPC对等连接接收端的阿里云账号ID。

RegionId String cn-hangzhou

VPC对等连接发起端的地域ID。

AcceptingRegionId String cn-hangzhou

VPC对等连接接收端的地域ID。

Bandwidth Integer 1024

VPC对等连接的带宽,单位:Mbps。取值:

  • 跨地域VPC对等连接的带宽值为1024 Mbps。
  • 同地域VPC对等连接的带宽值为5120 Mbps。
Status String Activated

VPC对等连接的状态。取值:

  • Creating:创建中。
  • Accepting:接收中。
  • Updating:更新中。
  • Rejected:已拒绝。
  • Expired:已过期。
  • Activated:已激活。
  • Deleting:删除中。
  • Deleted:已删除。

关于VPC对等连接状态的更多信息,请参见VPC对等连接概述

BizStatus String Normal

VPC对等连接的商业状态。取值:

  • Normal:正常。
  • FinancialLocked:欠费锁定。
GmtExpired String 2022-05-01T09:02:36Z

VPC对等连接的过期时间。

只有当VPC对等连接的Status(状态)为Accepting(接收中)或Expired(已过期)时,才会返回具体的过期时间;VPC对等连接处于其余状态时,返回值为null

Vpc Object

发起端VPC实例详细信息。

VpcId String vpc-bp1gsk7h12ew7oegk****

发起端VPC实例ID。

Ipv4Cidrs Array of String 192.168.0.0/16

发起端网段信息。

Ipv6Cidrs Array of String 2408:XXXX:3c5:6e00::/56

发起端IPv6网段信息。

AcceptingVpc Object

接收端VPC实例详细信息。

VpcId String vpc-bp1vzjkp2q1xgnind****

接收端VPC实例ID。

Ipv4Cidrs Array of String 10.0.0.0/16

接收端网段信息。

Ipv6Cidrs Array of String 2408:XXXX:3b8:3a00::/56

接收端IPv6网段信息。

示例

请求示例

http(s)://[Endpoint]/?Action=ListVpcPeerConnections
&RegionId=cn-hangzhou
&InstanceId=pcc-lnk0m24khwvtkm****
&VpcId=["vpc-bp1gsk7h12ew7oegk****"]
&Name=vpcpeer
&NextToken=FFmyTO70tTpLG6I3FmYAXGKPd****
&MaxResults=20
&公共请求参数

正常返回示例

XML格式

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

<ListVpcPeerConnectionsResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED39DCAC0</RequestId>
    <TotalCount>1</TotalCount>
    <MaxResults>20</MaxResults>
    <NextToken>FFmyTO70tTpLG6I3FmYAXGKPd****</NextToken>
    <VpcPeerConnects>
        <InstanceId>pcc-lnk0m24khwvtkm****</InstanceId>
        <GmtCreate>2022-04-24T09:02:36Z</GmtCreate>
        <GmtModified>2022-04-24T19:20:45Z</GmtModified>
        <Name>vpcpeer</Name>
        <Description>test</Description>
        <RegionId>cn-hangzhou</RegionId>
        <AcceptingRegionId>cn-hangzhou</AcceptingRegionId>
        <Bandwidth>1024</Bandwidth>
        <Status>Activated</Status>
        <BizStatus>Normal</BizStatus>
        <GmtExpired>2022-05-01T09:02:36Z</GmtExpired>
        <Vpc>
            <VpcId>vpc-bp1gsk7h12ew7oegk****</VpcId>
            <Ipv4Cidrs>192.168.0.0/16</Ipv4Cidrs>
            <Ipv6Cidrs>2408:XXXX:3c5:6e00::/56</Ipv6Cidrs>
        </Vpc>
        <AcceptingVpc>
            <VpcId>vpc-bp1vzjkp2q1xgnind****</VpcId>
            <Ipv4Cidrs>10.0.0.0/16</Ipv4Cidrs>
            <Ipv6Cidrs>2408:XXXX:3b8:3a00::/56</Ipv6Cidrs>
        </AcceptingVpc>
    </VpcPeerConnects>
</ListVpcPeerConnectionsResponse>

JSON格式

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

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED39DCAC0",
  "TotalCount" : 1,
  "MaxResults" : 20,
  "NextToken" : "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "VpcPeerConnects" : [ {
    "InstanceId" : "pcc-lnk0m24khwvtkm****",
    "GmtCreate" : "2022-04-24T09:02:36Z",
    "GmtModified" : "2022-04-24T19:20:45Z",
    "Name" : "vpcpeer",
    "Description" : "test",
    "RegionId" : "cn-hangzhou",
    "AcceptingRegionId" : "cn-hangzhou",
    "Bandwidth" : 1024,
    "Status" : "Activated",
    "BizStatus" : "Normal",
    "GmtExpired" : "2022-05-01T09:02:36Z",
    "Vpc" : {
      "VpcId" : "vpc-bp1gsk7h12ew7oegk****",
      "Ipv4Cidrs" : [ "192.168.0.0/16" ],
      "Ipv6Cidrs" : [ "2408:XXXX:3c5:6e00::/56" ]
    },
    "AcceptingVpc" : {
      "VpcId" : "vpc-bp1vzjkp2q1xgnind****",
      "Ipv4Cidrs" : [ "10.0.0.0/16" ],
      "Ipv6Cidrs" : [ "2408:XXXX:3b8:3a00::/56" ]
    }
  } ]
}

错误码

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