Skip to content

aws.ec2.describe_vpc_peering_connections

Example SQL Queries

SELECT * FROM
aws.ec2.describe_vpc_peering_connections;

Description

Describes your VPC peering connections. The default is to describe all your VPC peering connections. Alternatively, you can specify specific VPC peering connection IDs or filter the results to include only the VPC peering connections that match specific criteria.

Table Definition

Column NameColumn Data Type
dry_run Input Column

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

BOOLEAN
filters Input Column

The filters.

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

  • accepter-vpc-info.owner-id - The ID of the Amazon Web Services account that owns the accepter VPC.

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

  • expiration-time - The expiration date and time for the VPC peering connection.

  • requester-vpc-info.cidr-block - The IPv4 CIDR block of the requester's VPC.

  • requester-vpc-info.owner-id - The ID of the Amazon Web Services account that owns the requester VPC.

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

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

  • status-message - A message that provides more information about the status of the VPC peering connection, if applicable.

  • tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.

  • tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.

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

STRUCT(
"name" VARCHAR,
"values" VARCHAR[]
)[]
Show child fields
filters[]
Show child fields
filters[].name

The name of the filter. Filter names are case-sensitive.

filters[].values[]
vpc_peering_connection_ids Input Column

The IDs of the VPC peering connections.

Default: Describes all your VPC peering connections.

VARCHAR[]
Show child fields
vpc_peering_connection_ids[]
_aws_profile Input Column

The AWS profile defines the AWS identity used. It can be defined via credentials or by assuming a IAM role.

STRUCT(
"type" VARCHAR,
"name" VARCHAR,
"account_id" VARCHAR,
"via_profile_name" VARCHAR,
"assumed_role_arn" VARCHAR,
"organization" STRUCT(
"account_name" VARCHAR,
"id" VARCHAR,
"tags" STRUCT(
"key" VARCHAR,
"value" VARCHAR
)[],
"master_account" STRUCT(
"id" VARCHAR,
"email" VARCHAR
),
"parents" STRUCT(
"type" VARCHAR,
"id" VARCHAR,
"name" VARCHAR,
"tags" STRUCT(
"key" VARCHAR,
"value" VARCHAR
)[]
)[]
)
)
Show child fields
_aws_profile.account_id

The AWS account id

_aws_profile.assumed_role_arn

The ARN of the assumed role

_aws_profile.name

The unique name of the profile.

_aws_profile.organization

Information about this profile's membership in the AWS organization.

Show child fields
_aws_profile.organization.account_name

The name of account speciifed by the organization

_aws_profile.organization.id

The organization id

_aws_profile.organization.master_account
Show child fields
_aws_profile.organization.master_account.email

The organization master account email address

_aws_profile.organization.master_account.id

The organization master account id

_aws_profile.organization.parents[]
Show child fields
_aws_profile.organization.parents[].id

The id of the parent

_aws_profile.organization.parents[].name

The name of the parent

_aws_profile.organization.parents[].tags[]
Show child fields
_aws_profile.organization.parents[].tags[].key
_aws_profile.organization.parents[].tags[].value
_aws_profile.organization.parents[].type

The type of parent can be an organization unit or a root

_aws_profile.organization.tags[]
Show child fields
_aws_profile.organization.tags[].key
_aws_profile.organization.tags[].value
_aws_profile.type

The type of profile, either 'credentials' or 'assumed_role'

_aws_profile.via_profile_name

This IAM role for this profile is assumed by first utilizing another profile with this name to obtain credentials.

_aws_region Input Column

The AWS region to use.

VARCHAR
accepter_vpc_info

Information about the accepter VPC. CIDR block information is only returned when describing an active VPC peering connection.

STRUCT(
"cidr_block" VARCHAR,
"ipv6_cidr_block_set" STRUCT(
"ipv6_cidr_block" VARCHAR
)[],
"cidr_block_set" STRUCT(
"cidr_block" VARCHAR
)[],
"owner_id" VARCHAR,
"peering_options" STRUCT(
"allow_dns_resolution_from_remote_vpc" BOOLEAN,
"allow_egress_from_local_classic_link_to_remote_vpc" BOOLEAN,
"allow_egress_from_local_vpc_to_remote_classic_link" BOOLEAN
),
"vpc_id" VARCHAR,
"region" VARCHAR
)
Show child fields
accepter_vpc_info.cidr_block

The IPv4 CIDR block for the VPC.

accepter_vpc_info.cidr_block_set[]
Show child fields
accepter_vpc_info.cidr_block_set[].cidr_block

The IPv4 CIDR block.

accepter_vpc_info.ipv6_cidr_block_set[]
Show child fields
accepter_vpc_info.ipv6_cidr_block_set[].ipv6_cidr_block

The IPv6 CIDR block.

accepter_vpc_info.owner_id

The ID of the Amazon Web Services account that owns the VPC.

accepter_vpc_info.peering_options

Information about the VPC peering connection options for the accepter or requester VPC.

Show child fields
accepter_vpc_info.peering_options.allow_dns_resolution_from_remote_vpc

Indicates whether a local VPC can resolve public DNS hostnames to private IP addresses when queried from instances in a peer VPC.

accepter_vpc_info.peering_options.allow_egress_from_local_classic_link_to_remote_vpc

Deprecated.

accepter_vpc_info.peering_options.allow_egress_from_local_vpc_to_remote_classic_link

Deprecated.

accepter_vpc_info.region

The Region in which the VPC is located.

accepter_vpc_info.vpc_id

The ID of the VPC.

expiration_time

The time that an unaccepted VPC peering connection will expire.

TIMESTAMP_S
requester_vpc_info

Information about the requester VPC. CIDR block information is only returned when describing an active VPC peering connection.

STRUCT(
"cidr_block" VARCHAR,
"ipv6_cidr_block_set" STRUCT(
"ipv6_cidr_block" VARCHAR
)[],
"cidr_block_set" STRUCT(
"cidr_block" VARCHAR
)[],
"owner_id" VARCHAR,
"peering_options" STRUCT(
"allow_dns_resolution_from_remote_vpc" BOOLEAN,
"allow_egress_from_local_classic_link_to_remote_vpc" BOOLEAN,
"allow_egress_from_local_vpc_to_remote_classic_link" BOOLEAN
),
"vpc_id" VARCHAR,
"region" VARCHAR
)
Show child fields
requester_vpc_info.cidr_block

The IPv4 CIDR block for the VPC.

requester_vpc_info.cidr_block_set[]
Show child fields
requester_vpc_info.cidr_block_set[].cidr_block

The IPv4 CIDR block.

requester_vpc_info.ipv6_cidr_block_set[]
Show child fields
requester_vpc_info.ipv6_cidr_block_set[].ipv6_cidr_block

The IPv6 CIDR block.

requester_vpc_info.owner_id

The ID of the Amazon Web Services account that owns the VPC.

requester_vpc_info.peering_options

Information about the VPC peering connection options for the accepter or requester VPC.

Show child fields
requester_vpc_info.peering_options.allow_dns_resolution_from_remote_vpc

Indicates whether a local VPC can resolve public DNS hostnames to private IP addresses when queried from instances in a peer VPC.

requester_vpc_info.peering_options.allow_egress_from_local_classic_link_to_remote_vpc

Deprecated.

requester_vpc_info.peering_options.allow_egress_from_local_vpc_to_remote_classic_link

Deprecated.

requester_vpc_info.region

The Region in which the VPC is located.

requester_vpc_info.vpc_id

The ID of the VPC.

status

The status of the VPC peering connection.

STRUCT(
"code" VARCHAR,
"message" VARCHAR
)
Show child fields
status.code

The status of the VPC peering connection.

status.message

A message that provides more information about the status, if applicable.

tags

Any tags assigned to the resource.

STRUCT(
"key" VARCHAR,
"value" VARCHAR
)[]
Show child fields
tags[]
Show child fields
tags[].key

The key of the tag.

Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:.

tags[].value

The value of the tag.

Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.

vpc_peering_connection_id

The ID of the VPC peering connection.

VARCHAR