modify_vpc_peering_connection_options

EC2.Client.modify_vpc_peering_connection_options(**kwargs)

Note

We are retiring EC2-Classic. We recommend that you migrate from EC2-Classic to a VPC. For more information, see Migrate from EC2-Classic to a VPC in the Amazon Elastic Compute Cloud User Guide .

Modifies the VPC peering connection options on one side of a VPC peering connection. You can do the following:

  • Enable/disable communication over the peering connection between an EC2-Classic instance that's linked to your VPC (using ClassicLink) and instances in the peer VPC.
  • Enable/disable communication over the peering connection between instances in your VPC and an EC2-Classic instance that's linked to the peer VPC.
  • Enable/disable the ability to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

If the peered VPCs are in the same Amazon Web Services account, you can enable DNS resolution for queries from the local VPC. This ensures that queries from the local VPC resolve to private IP addresses in the peer VPC. This option is not available if the peered VPCs are in different Amazon Web Services accounts or different Regions. For peered VPCs in different Amazon Web Services accounts, each Amazon Web Services account owner must initiate a separate request to modify the peering connection options. For inter-region peering connections, you must use the Region for the requester VPC to modify the requester VPC peering options and the Region for the accepter VPC to modify the accepter VPC peering options. To verify which VPCs are the accepter and the requester for a VPC peering connection, use the DescribeVpcPeeringConnections command.

See also: AWS API Documentation

Request Syntax

response = client.modify_vpc_peering_connection_options(
    AccepterPeeringConnectionOptions={
        'AllowDnsResolutionFromRemoteVpc': True|False,
        'AllowEgressFromLocalClassicLinkToRemoteVpc': True|False,
        'AllowEgressFromLocalVpcToRemoteClassicLink': True|False
    },
    DryRun=True|False,
    RequesterPeeringConnectionOptions={
        'AllowDnsResolutionFromRemoteVpc': True|False,
        'AllowEgressFromLocalClassicLinkToRemoteVpc': True|False,
        'AllowEgressFromLocalVpcToRemoteClassicLink': True|False
    },
    VpcPeeringConnectionId='string'
)
Parameters
  • AccepterPeeringConnectionOptions (dict) --

    The VPC peering connection options for the accepter VPC.

    • AllowDnsResolutionFromRemoteVpc (boolean) --

      If true, enables a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

    • AllowEgressFromLocalClassicLinkToRemoteVpc (boolean) --

      If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC using ClassicLink to instances in a peer VPC.

    • AllowEgressFromLocalVpcToRemoteClassicLink (boolean) --

      If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC using ClassicLink.

  • DryRun (boolean) -- 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 .
  • RequesterPeeringConnectionOptions (dict) --

    The VPC peering connection options for the requester VPC.

    • AllowDnsResolutionFromRemoteVpc (boolean) --

      If true, enables a local VPC to resolve public DNS hostnames to private IP addresses when queried from instances in the peer VPC.

    • AllowEgressFromLocalClassicLinkToRemoteVpc (boolean) --

      If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC using ClassicLink to instances in a peer VPC.

    • AllowEgressFromLocalVpcToRemoteClassicLink (boolean) --

      If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC using ClassicLink.

  • VpcPeeringConnectionId (string) --

    [REQUIRED]

    The ID of the VPC peering connection.

Return type

dict

Returns

Response Syntax

{
    'AccepterPeeringConnectionOptions': {
        'AllowDnsResolutionFromRemoteVpc': True|False,
        'AllowEgressFromLocalClassicLinkToRemoteVpc': True|False,
        'AllowEgressFromLocalVpcToRemoteClassicLink': True|False
    },
    'RequesterPeeringConnectionOptions': {
        'AllowDnsResolutionFromRemoteVpc': True|False,
        'AllowEgressFromLocalClassicLinkToRemoteVpc': True|False,
        'AllowEgressFromLocalVpcToRemoteClassicLink': True|False
    }
}

Response Structure

  • (dict) --

    • AccepterPeeringConnectionOptions (dict) --

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

      • AllowDnsResolutionFromRemoteVpc (boolean) --

        If true, the public DNS hostnames of instances in the specified VPC resolve to private IP addresses when queried from instances in the peer VPC.

      • AllowEgressFromLocalClassicLinkToRemoteVpc (boolean) --

        If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC using ClassicLink to instances in a peer VPC.

      • AllowEgressFromLocalVpcToRemoteClassicLink (boolean) --

        If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC using ClassicLink.

    • RequesterPeeringConnectionOptions (dict) --

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

      • AllowDnsResolutionFromRemoteVpc (boolean) --

        If true, the public DNS hostnames of instances in the specified VPC resolve to private IP addresses when queried from instances in the peer VPC.

      • AllowEgressFromLocalClassicLinkToRemoteVpc (boolean) --

        If true, enables outbound communication from an EC2-Classic instance that's linked to a local VPC using ClassicLink to instances in a peer VPC.

      • AllowEgressFromLocalVpcToRemoteClassicLink (boolean) --

        If true, enables outbound communication from instances in a local VPC to an EC2-Classic instance that's linked to a peer VPC using ClassicLink.