DescribeVpcPeeringConnections

GET /?Action=DescribeVpcPeeringConnections
Description

Describes one or more peering connections between two Virtual Private Clouds (VPCs).
You can use the Filter.N parameter to filter the described VPC peering connections on the following properties:

  • accepter-vpc-info.cidr-block: The CIDR block of the peer VPC.

  • accepter-vpc-info.owner-id: The account ID of the owner of the peer VPC.

  • accepter-vpc-info.vpc-id: The ID of the peer VPC.

  • expiration-time: The date after which the connection expires.

  • requester-vpc-info.cidr-block: The CIDR block of the requester VPC.

  • requester-vpc-info.owner-id: The ID of the owner of the requester VPC.

  • requester-vpc-info.vpc-id: The ID of the requester VPC.

  • status-code: The state of the VPC peering connection (pending-acceptance | active | rejected | failed | expired | deleted).

  • status-message: Additional information about the state of the VPC peering connection.

  • vpc-peering-connection-id: The ID of the VPC peering connection.

  • tag-key: The key of a tag associated with the resource.

  • tag-value: The value of a tag associated with the resource.

  • tag:XXXX: The value of a tag associated with the resource, where XXXX is the key of the tag.

Note

If you exceed the number of identical requests allowed for a configured time period, the RequestLimitExceeded error message is returned.
Body parameter

Required: false
Name: DescribeVpcPeeringConnectionsRequest

Name Description Required Schema Default Example

Filter.N

One or more filters. Example:
osc-cli fcu DescribeVpcPeeringConnections \
  --Filter.1.Name "tag:KEYOFTHETAG" \
  --Filter.1.Value.1 "VALUEOFTHETAG"

false

Filter

VpcPeeringConnectionId.N

One or more VPC peering connection IDs.

false

string
Responses
HTTP Code 200
HTTP Code Description Schema

200

DescribeVpcPeeringConnectionsResult

Response 200

Response 200

Name Description Required Schema Default Example

requestId

The ID of the request.

false

string

vpcPeeringConnectionSet.N

Information about one or more VPC peering connections.

false

VpcPeeringConnection