Queries the details of a virtual private cloud (VPC) peering connection.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes GetVpcPeerConnectionAttribute

The operation that you want to perform. Set the value to GetVpcPeerConnectionAttribute.

InstanceId String Yes pcc-lnk0m24khwvtkm****

The ID of the VPC peering connection that you want to query.

Response parameters

Parameter Type Example Description
RequestId String 473469C7-AA6F-4DC5-B3DB-A3AC0DE3C83E

The ID of the request.

InstanceId String pcc-lnk0m24khwvtkm****

The ID of the VPC peering connection.

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

The time when the VPC peering connection was created. The time is displayed in YYYY-MM-DDThh:mm:ssZ format in UTC.

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

The time when the VPC peering connection was modified. The time is displayed in YYYY-MM-DDThh:mm:ssZ format in UTC.

Name String vpcpeer

The name of the VPC peering connection.

Description String test

The description of the VPC peering connection.

OwnerId Long 253460731706911258

The ID of the Alibaba Cloud account to which the requester VPC belongs.

AcceptingOwnerUid Long 283117732402483989

The ID of the Alibaba Cloud account to which the acceptor VPC belongs.

RegionId String cn-hangzhou

The region ID of the requester VPC.

AcceptingRegionId String cn-hangzhou

The region ID of the acceptor VPC.

Bandwidth Integer 1024

The bandwidth of the VPC peering connection. Unit: Mbit/s. The value must be an integer greater than 0.

Note If the value is set to -1, it indicates that no limit is imposed on the bandwidth.

Default value:

  • The default bandwidth of an inter-region VPC peering connection is 1024 Mbit/s.
  • The default bandwidth of an intra-region VPC peering connection is -1 Mbit/s.
Status String Activated

The status of the VPC peering connection. Valid values:

  • Creating
  • Accepting
  • updating
  • Rejected
  • Expired
  • Activated
  • Deleting
  • Deleted

For more information about the status of VPC peering connections, see Overview of VPC peering connections.

BizStatus String Normal

The business status of the VPC peering connection. Valid values:

  • Normal: running as expected
  • FinancialLocked: locked due to overdue payments
GmtExpired String 2022-05-01T09:02:36Z

The expiration time of the VPC peering connection.

The expiration time is returned only when the Status of the VPC peering connection is Accepting or Expired. Otherwise, null is returned.

Vpc Object

The details of the requester VPC.

VpcId String vpc-bp1gsk7h12ew7oegk****

The ID of the requester VPC.

Ipv4Cidrs Array of String 192.168.0.0/16

The CIDR block of the requester VPC.

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

The IPv6 CIDR block of the requester VPC.

AcceptingVpc Object

The details of the acceptor VPC.

VpcId String vpc-bp1vzjkp2q1xgnind****

The ID of the acceptor VPC.

Ipv4Cidrs Array of String 10.0.0.0/16

The CIDR block of the acceptor VPC.

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

The IPv6 CIDR block of the acceptor VPC.

Tags Array of Tags

The list of tags.

Key String FinanceDept

The tag key.

Value String FinanceJoshua

The tag value.

Examples

Sample requests

http(s)://[Endpoint]/?Action=GetVpcPeerConnectionAttribute
&InstanceId=pcc-lnk0m24khwvtkm****
&Common request parameters

Sample success responses

XML format

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

<GetVpcPeerConnectionAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3AC0DE3C83E</RequestId>
    <InstanceId>pcc-lnk0m24khwvtkm****</InstanceId>
    <GmtCreate>2022-04-24T09:02:36Z</GmtCreate>
    <GmtModified>2022-04-24T19:20:45Z</GmtModified>
    <Name>vpcpeer</Name>
    <Description>test</Description>
    <OwnerId>253460731706911260</OwnerId>
    <AcceptingOwnerUid>283117732402484000</AcceptingOwnerUid>
    <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>
    <Tags>
        <Key>FinanceDept</Key>
        <Value>FinanceJoshua</Value>
    </Tags>
</GetVpcPeerConnectionAttributeResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3AC0DE3C83E",
  "InstanceId" : "pcc-lnk0m24khwvtkm****",
  "GmtCreate" : "2022-04-24T09:02:36Z",
  "GmtModified" : "2022-04-24T19:20:45Z",
  "Name" : "vpcpeer",
  "Description" : "test",
  "OwnerId" : 253460731706911260,
  "AcceptingOwnerUid" : 283117732402484000,
  "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" ]
  },
  "Tags" : [ {
    "Key" : "FinanceDept",
    "Value" : "FinanceJoshua"
  } ]
}

Error codes

HttpCode Error code Error message Description
400 ResourceNotFound.InstanceId The specified resource of %s is not found. The error message returned because the specified instance is not found and cannot be deleted.

For a list of error codes, see Service error codes.