import * as pulumi from "@pulumi/pulumi"; import * as inputs from "../types/input"; import * as outputs from "../types/output"; /** * Provides a resource to manage a VPC peering connection. * * > **Note:** Modifying the VPC Peering Connection options requires peering to be active. An automatic activation * can be done using the `autoAccept` attribute. Alternatively, the VPC Peering * Connection has to be made active manually using other means. See notes below for * more information. * * > **NOTE on VPC Peering Connections and VPC Peering Connection Options:** This provider provides * both a standalone VPC Peering Connection Options and a VPC Peering Connection * resource with `accepter` and `requester` attributes. Do not manage options for the same VPC peering * connection in both a VPC Peering Connection resource and a VPC Peering Connection Options resource. * Doing so will cause a conflict of options and will overwrite the options. * Using a VPC Peering Connection Options resource decouples management of the connection options from * management of the VPC Peering Connection and allows options to be set correctly in cross-account scenarios. * * > **Note:** For cross-account (requester's AWS account differs from the accepter's AWS account) or inter-region * VPC Peering Connections use the `aws.ec2.VpcPeeringConnection` resource to manage the requester's side of the * connection and use the `aws.ec2.VpcPeeringConnectionAccepter` resource to manage the accepter's side of the connection. * * > **Note:** Creating multiple `aws.ec2.VpcPeeringConnection` resources with the same `peerVpcId` and `vpcId` will not produce an error. Instead, AWS will return the connection `id` that already exists, resulting in multiple `aws.ec2.VpcPeeringConnection` resources with the same `id`. * * ## Example Usage * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const foo = new aws.ec2.VpcPeeringConnection("foo", { * peerOwnerId: peerOwnerId, * peerVpcId: bar.id, * vpcId: fooAwsVpc.id, * }); * ``` * * Basic usage with connection options: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const foo = new aws.ec2.VpcPeeringConnection("foo", { * accepter: { * allowRemoteVpcDnsResolution: true, * }, * requester: { * allowRemoteVpcDnsResolution: true, * }, * peerOwnerId: peerOwnerId, * peerVpcId: bar.id, * vpcId: fooAwsVpc.id, * }); * ``` * * Basic usage with tags: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const fooVpc = new aws.ec2.Vpc("foo", {cidrBlock: "10.1.0.0/16"}); * const bar = new aws.ec2.Vpc("bar", {cidrBlock: "10.2.0.0/16"}); * const foo = new aws.ec2.VpcPeeringConnection("foo", { * peerOwnerId: peerOwnerId, * peerVpcId: bar.id, * vpcId: fooVpc.id, * autoAccept: true, * tags: { * Name: "VPC Peering between foo and bar", * }, * }); * ``` * * Basic usage with region: * * ```typescript * import * as pulumi from "@pulumi/pulumi"; * import * as aws from "@pulumi/aws"; * * const fooVpc = new aws.ec2.Vpc("foo", {cidrBlock: "10.1.0.0/16"}); * const bar = new aws.ec2.Vpc("bar", {cidrBlock: "10.2.0.0/16"}); * const foo = new aws.ec2.VpcPeeringConnection("foo", { * peerOwnerId: peerOwnerId, * peerVpcId: bar.id, * vpcId: fooVpc.id, * peerRegion: "us-east-1", * }); * ``` * * ## Import * * Using `pulumi import`, import VPC Peering resources using the VPC peering `id`. For example: * * ```sh * $ pulumi import aws:ec2/vpcPeeringConnection:VpcPeeringConnection test_connection pcx-111aaa111 * ``` */ export declare class VpcPeeringConnection extends pulumi.CustomResource { /** * Get an existing VpcPeeringConnection resource's state with the given name, ID, and optional extra * properties used to qualify the lookup. * * @param name The _unique_ name of the resulting resource. * @param id The _unique_ provider ID of the resource to lookup. * @param state Any extra arguments used during the lookup. * @param opts Optional settings to control the behavior of the CustomResource. */ static get(name: string, id: pulumi.Input, state?: VpcPeeringConnectionState, opts?: pulumi.CustomResourceOptions): VpcPeeringConnection; /** * Returns true if the given object is an instance of VpcPeeringConnection. This is designed to work even * when multiple copies of the Pulumi SDK have been loaded into the same process. */ static isInstance(obj: any): obj is VpcPeeringConnection; /** * The status of the VPC Peering Connection request. */ readonly acceptStatus: pulumi.Output; /** * An optional configuration block that allows for [VPC Peering Connection](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html) options to be set for the VPC that accepts * the peering connection (a maximum of one). */ readonly accepter: pulumi.Output; /** * Accept the peering (both VPCs need to be in the same AWS account and region). */ readonly autoAccept: pulumi.Output; /** * The AWS account ID of the target peer VPC. * Defaults to the account ID the AWS provider is currently connected to, so must be managed if connecting cross-account. */ readonly peerOwnerId: pulumi.Output; /** * The region of the accepter VPC of the VPC Peering Connection. `autoAccept` must be `false`, * and use the `aws.ec2.VpcPeeringConnectionAccepter` to manage the accepter side. */ readonly peerRegion: pulumi.Output; /** * The ID of the target VPC with which you are creating the VPC Peering Connection. */ readonly peerVpcId: pulumi.Output; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ readonly region: pulumi.Output; /** * A optional configuration block that allows for [VPC Peering Connection](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html) options to be set for the VPC that requests * the peering connection (a maximum of one). */ readonly requester: pulumi.Output; /** * A map of tags to assign to the resource. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ readonly tags: pulumi.Output<{ [key: string]: string; } | undefined>; /** * A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ readonly tagsAll: pulumi.Output<{ [key: string]: string; }>; /** * The ID of the requester VPC. */ readonly vpcId: pulumi.Output; /** * Create a VpcPeeringConnection resource with the given unique name, arguments, and options. * * @param name The _unique_ name of the resource. * @param args The arguments to use to populate this resource's properties. * @param opts A bag of options that control this resource's behavior. */ constructor(name: string, args: VpcPeeringConnectionArgs, opts?: pulumi.CustomResourceOptions); } /** * Input properties used for looking up and filtering VpcPeeringConnection resources. */ export interface VpcPeeringConnectionState { /** * The status of the VPC Peering Connection request. */ acceptStatus?: pulumi.Input; /** * An optional configuration block that allows for [VPC Peering Connection](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html) options to be set for the VPC that accepts * the peering connection (a maximum of one). */ accepter?: pulumi.Input; /** * Accept the peering (both VPCs need to be in the same AWS account and region). */ autoAccept?: pulumi.Input; /** * The AWS account ID of the target peer VPC. * Defaults to the account ID the AWS provider is currently connected to, so must be managed if connecting cross-account. */ peerOwnerId?: pulumi.Input; /** * The region of the accepter VPC of the VPC Peering Connection. `autoAccept` must be `false`, * and use the `aws.ec2.VpcPeeringConnectionAccepter` to manage the accepter side. */ peerRegion?: pulumi.Input; /** * The ID of the target VPC with which you are creating the VPC Peering Connection. */ peerVpcId?: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * A optional configuration block that allows for [VPC Peering Connection](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html) options to be set for the VPC that requests * the peering connection (a maximum of one). */ requester?: pulumi.Input; /** * A map of tags to assign to the resource. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block. */ tagsAll?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The ID of the requester VPC. */ vpcId?: pulumi.Input; } /** * The set of arguments for constructing a VpcPeeringConnection resource. */ export interface VpcPeeringConnectionArgs { /** * An optional configuration block that allows for [VPC Peering Connection](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html) options to be set for the VPC that accepts * the peering connection (a maximum of one). */ accepter?: pulumi.Input; /** * Accept the peering (both VPCs need to be in the same AWS account and region). */ autoAccept?: pulumi.Input; /** * The AWS account ID of the target peer VPC. * Defaults to the account ID the AWS provider is currently connected to, so must be managed if connecting cross-account. */ peerOwnerId?: pulumi.Input; /** * The region of the accepter VPC of the VPC Peering Connection. `autoAccept` must be `false`, * and use the `aws.ec2.VpcPeeringConnectionAccepter` to manage the accepter side. */ peerRegion?: pulumi.Input; /** * The ID of the target VPC with which you are creating the VPC Peering Connection. */ peerVpcId: pulumi.Input; /** * Region where this resource will be [managed](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints). Defaults to the Region set in the provider configuration. */ region?: pulumi.Input; /** * A optional configuration block that allows for [VPC Peering Connection](https://docs.aws.amazon.com/vpc/latest/peering/what-is-vpc-peering.html) options to be set for the VPC that requests * the peering connection (a maximum of one). */ requester?: pulumi.Input; /** * A map of tags to assign to the resource. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level. */ tags?: pulumi.Input<{ [key: string]: pulumi.Input; } | undefined>; /** * The ID of the requester VPC. */ vpcId: pulumi.Input; } //# sourceMappingURL=vpcPeeringConnection.d.ts.map