Try AWS Native preview for resources not in the classic version.
aws.directconnect.GatewayAssociation
Explore with Pulumi AI
Try AWS Native preview for resources not in the classic version.
Associates a Direct Connect Gateway with a VGW or transit gateway.
To create a cross-account association, create an aws.directconnect.GatewayAssociationProposal
resource
in the AWS account that owns the VGW or transit gateway and then accept the proposal in the AWS account that owns the Direct Connect Gateway
by creating an aws.directconnect.GatewayAssociation
resource with the proposal_id
and associated_gateway_owner_account_id
attributes set.
Example Usage
VPN Gateway Association
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var exampleGateway = new Aws.DirectConnect.Gateway("exampleGateway", new()
{
AmazonSideAsn = "64512",
});
var exampleVpc = new Aws.Ec2.Vpc("exampleVpc", new()
{
CidrBlock = "10.255.255.0/28",
});
var exampleVpnGateway = new Aws.Ec2.VpnGateway("exampleVpnGateway", new()
{
VpcId = exampleVpc.Id,
});
var exampleGatewayAssociation = new Aws.DirectConnect.GatewayAssociation("exampleGatewayAssociation", new()
{
DxGatewayId = exampleGateway.Id,
AssociatedGatewayId = exampleVpnGateway.Id,
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/directconnect"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
exampleGateway, err := directconnect.NewGateway(ctx, "exampleGateway", &directconnect.GatewayArgs{
AmazonSideAsn: pulumi.String("64512"),
})
if err != nil {
return err
}
exampleVpc, err := ec2.NewVpc(ctx, "exampleVpc", &ec2.VpcArgs{
CidrBlock: pulumi.String("10.255.255.0/28"),
})
if err != nil {
return err
}
exampleVpnGateway, err := ec2.NewVpnGateway(ctx, "exampleVpnGateway", &ec2.VpnGatewayArgs{
VpcId: exampleVpc.ID(),
})
if err != nil {
return err
}
_, err = directconnect.NewGatewayAssociation(ctx, "exampleGatewayAssociation", &directconnect.GatewayAssociationArgs{
DxGatewayId: exampleGateway.ID(),
AssociatedGatewayId: exampleVpnGateway.ID(),
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.directconnect.Gateway;
import com.pulumi.aws.directconnect.GatewayArgs;
import com.pulumi.aws.ec2.Vpc;
import com.pulumi.aws.ec2.VpcArgs;
import com.pulumi.aws.ec2.VpnGateway;
import com.pulumi.aws.ec2.VpnGatewayArgs;
import com.pulumi.aws.directconnect.GatewayAssociation;
import com.pulumi.aws.directconnect.GatewayAssociationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var exampleGateway = new Gateway("exampleGateway", GatewayArgs.builder()
.amazonSideAsn("64512")
.build());
var exampleVpc = new Vpc("exampleVpc", VpcArgs.builder()
.cidrBlock("10.255.255.0/28")
.build());
var exampleVpnGateway = new VpnGateway("exampleVpnGateway", VpnGatewayArgs.builder()
.vpcId(exampleVpc.id())
.build());
var exampleGatewayAssociation = new GatewayAssociation("exampleGatewayAssociation", GatewayAssociationArgs.builder()
.dxGatewayId(exampleGateway.id())
.associatedGatewayId(exampleVpnGateway.id())
.build());
}
}
import pulumi
import pulumi_aws as aws
example_gateway = aws.directconnect.Gateway("exampleGateway", amazon_side_asn="64512")
example_vpc = aws.ec2.Vpc("exampleVpc", cidr_block="10.255.255.0/28")
example_vpn_gateway = aws.ec2.VpnGateway("exampleVpnGateway", vpc_id=example_vpc.id)
example_gateway_association = aws.directconnect.GatewayAssociation("exampleGatewayAssociation",
dx_gateway_id=example_gateway.id,
associated_gateway_id=example_vpn_gateway.id)
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const exampleGateway = new aws.directconnect.Gateway("exampleGateway", {amazonSideAsn: "64512"});
const exampleVpc = new aws.ec2.Vpc("exampleVpc", {cidrBlock: "10.255.255.0/28"});
const exampleVpnGateway = new aws.ec2.VpnGateway("exampleVpnGateway", {vpcId: exampleVpc.id});
const exampleGatewayAssociation = new aws.directconnect.GatewayAssociation("exampleGatewayAssociation", {
dxGatewayId: exampleGateway.id,
associatedGatewayId: exampleVpnGateway.id,
});
resources:
exampleGateway:
type: aws:directconnect:Gateway
properties:
amazonSideAsn: '64512'
exampleVpc:
type: aws:ec2:Vpc
properties:
cidrBlock: 10.255.255.0/28
exampleVpnGateway:
type: aws:ec2:VpnGateway
properties:
vpcId: ${exampleVpc.id}
exampleGatewayAssociation:
type: aws:directconnect:GatewayAssociation
properties:
dxGatewayId: ${exampleGateway.id}
associatedGatewayId: ${exampleVpnGateway.id}
Transit Gateway Association
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var exampleGateway = new Aws.DirectConnect.Gateway("exampleGateway", new()
{
AmazonSideAsn = "64512",
});
var exampleTransitGateway = new Aws.Ec2TransitGateway.TransitGateway("exampleTransitGateway");
var exampleGatewayAssociation = new Aws.DirectConnect.GatewayAssociation("exampleGatewayAssociation", new()
{
DxGatewayId = exampleGateway.Id,
AssociatedGatewayId = exampleTransitGateway.Id,
AllowedPrefixes = new[]
{
"10.255.255.0/30",
"10.255.255.8/30",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/directconnect"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2transitgateway"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
exampleGateway, err := directconnect.NewGateway(ctx, "exampleGateway", &directconnect.GatewayArgs{
AmazonSideAsn: pulumi.String("64512"),
})
if err != nil {
return err
}
exampleTransitGateway, err := ec2transitgateway.NewTransitGateway(ctx, "exampleTransitGateway", nil)
if err != nil {
return err
}
_, err = directconnect.NewGatewayAssociation(ctx, "exampleGatewayAssociation", &directconnect.GatewayAssociationArgs{
DxGatewayId: exampleGateway.ID(),
AssociatedGatewayId: exampleTransitGateway.ID(),
AllowedPrefixes: pulumi.StringArray{
pulumi.String("10.255.255.0/30"),
pulumi.String("10.255.255.8/30"),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.directconnect.Gateway;
import com.pulumi.aws.directconnect.GatewayArgs;
import com.pulumi.aws.ec2transitgateway.TransitGateway;
import com.pulumi.aws.directconnect.GatewayAssociation;
import com.pulumi.aws.directconnect.GatewayAssociationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var exampleGateway = new Gateway("exampleGateway", GatewayArgs.builder()
.amazonSideAsn("64512")
.build());
var exampleTransitGateway = new TransitGateway("exampleTransitGateway");
var exampleGatewayAssociation = new GatewayAssociation("exampleGatewayAssociation", GatewayAssociationArgs.builder()
.dxGatewayId(exampleGateway.id())
.associatedGatewayId(exampleTransitGateway.id())
.allowedPrefixes(
"10.255.255.0/30",
"10.255.255.8/30")
.build());
}
}
import pulumi
import pulumi_aws as aws
example_gateway = aws.directconnect.Gateway("exampleGateway", amazon_side_asn="64512")
example_transit_gateway = aws.ec2transitgateway.TransitGateway("exampleTransitGateway")
example_gateway_association = aws.directconnect.GatewayAssociation("exampleGatewayAssociation",
dx_gateway_id=example_gateway.id,
associated_gateway_id=example_transit_gateway.id,
allowed_prefixes=[
"10.255.255.0/30",
"10.255.255.8/30",
])
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const exampleGateway = new aws.directconnect.Gateway("exampleGateway", {amazonSideAsn: "64512"});
const exampleTransitGateway = new aws.ec2transitgateway.TransitGateway("exampleTransitGateway", {});
const exampleGatewayAssociation = new aws.directconnect.GatewayAssociation("exampleGatewayAssociation", {
dxGatewayId: exampleGateway.id,
associatedGatewayId: exampleTransitGateway.id,
allowedPrefixes: [
"10.255.255.0/30",
"10.255.255.8/30",
],
});
resources:
exampleGateway:
type: aws:directconnect:Gateway
properties:
amazonSideAsn: '64512'
exampleTransitGateway:
type: aws:ec2transitgateway:TransitGateway
exampleGatewayAssociation:
type: aws:directconnect:GatewayAssociation
properties:
dxGatewayId: ${exampleGateway.id}
associatedGatewayId: ${exampleTransitGateway.id}
allowedPrefixes:
- 10.255.255.0/30
- 10.255.255.8/30
Allowed Prefixes
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var exampleGateway = new Aws.DirectConnect.Gateway("exampleGateway", new()
{
AmazonSideAsn = "64512",
});
var exampleVpc = new Aws.Ec2.Vpc("exampleVpc", new()
{
CidrBlock = "10.255.255.0/28",
});
var exampleVpnGateway = new Aws.Ec2.VpnGateway("exampleVpnGateway", new()
{
VpcId = exampleVpc.Id,
});
var exampleGatewayAssociation = new Aws.DirectConnect.GatewayAssociation("exampleGatewayAssociation", new()
{
DxGatewayId = exampleGateway.Id,
AssociatedGatewayId = exampleVpnGateway.Id,
AllowedPrefixes = new[]
{
"210.52.109.0/24",
"175.45.176.0/22",
},
});
});
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/directconnect"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
exampleGateway, err := directconnect.NewGateway(ctx, "exampleGateway", &directconnect.GatewayArgs{
AmazonSideAsn: pulumi.String("64512"),
})
if err != nil {
return err
}
exampleVpc, err := ec2.NewVpc(ctx, "exampleVpc", &ec2.VpcArgs{
CidrBlock: pulumi.String("10.255.255.0/28"),
})
if err != nil {
return err
}
exampleVpnGateway, err := ec2.NewVpnGateway(ctx, "exampleVpnGateway", &ec2.VpnGatewayArgs{
VpcId: exampleVpc.ID(),
})
if err != nil {
return err
}
_, err = directconnect.NewGatewayAssociation(ctx, "exampleGatewayAssociation", &directconnect.GatewayAssociationArgs{
DxGatewayId: exampleGateway.ID(),
AssociatedGatewayId: exampleVpnGateway.ID(),
AllowedPrefixes: pulumi.StringArray{
pulumi.String("210.52.109.0/24"),
pulumi.String("175.45.176.0/22"),
},
})
if err != nil {
return err
}
return nil
})
}
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.directconnect.Gateway;
import com.pulumi.aws.directconnect.GatewayArgs;
import com.pulumi.aws.ec2.Vpc;
import com.pulumi.aws.ec2.VpcArgs;
import com.pulumi.aws.ec2.VpnGateway;
import com.pulumi.aws.ec2.VpnGatewayArgs;
import com.pulumi.aws.directconnect.GatewayAssociation;
import com.pulumi.aws.directconnect.GatewayAssociationArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var exampleGateway = new Gateway("exampleGateway", GatewayArgs.builder()
.amazonSideAsn("64512")
.build());
var exampleVpc = new Vpc("exampleVpc", VpcArgs.builder()
.cidrBlock("10.255.255.0/28")
.build());
var exampleVpnGateway = new VpnGateway("exampleVpnGateway", VpnGatewayArgs.builder()
.vpcId(exampleVpc.id())
.build());
var exampleGatewayAssociation = new GatewayAssociation("exampleGatewayAssociation", GatewayAssociationArgs.builder()
.dxGatewayId(exampleGateway.id())
.associatedGatewayId(exampleVpnGateway.id())
.allowedPrefixes(
"210.52.109.0/24",
"175.45.176.0/22")
.build());
}
}
import pulumi
import pulumi_aws as aws
example_gateway = aws.directconnect.Gateway("exampleGateway", amazon_side_asn="64512")
example_vpc = aws.ec2.Vpc("exampleVpc", cidr_block="10.255.255.0/28")
example_vpn_gateway = aws.ec2.VpnGateway("exampleVpnGateway", vpc_id=example_vpc.id)
example_gateway_association = aws.directconnect.GatewayAssociation("exampleGatewayAssociation",
dx_gateway_id=example_gateway.id,
associated_gateway_id=example_vpn_gateway.id,
allowed_prefixes=[
"210.52.109.0/24",
"175.45.176.0/22",
])
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const exampleGateway = new aws.directconnect.Gateway("exampleGateway", {amazonSideAsn: "64512"});
const exampleVpc = new aws.ec2.Vpc("exampleVpc", {cidrBlock: "10.255.255.0/28"});
const exampleVpnGateway = new aws.ec2.VpnGateway("exampleVpnGateway", {vpcId: exampleVpc.id});
const exampleGatewayAssociation = new aws.directconnect.GatewayAssociation("exampleGatewayAssociation", {
dxGatewayId: exampleGateway.id,
associatedGatewayId: exampleVpnGateway.id,
allowedPrefixes: [
"210.52.109.0/24",
"175.45.176.0/22",
],
});
resources:
exampleGateway:
type: aws:directconnect:Gateway
properties:
amazonSideAsn: '64512'
exampleVpc:
type: aws:ec2:Vpc
properties:
cidrBlock: 10.255.255.0/28
exampleVpnGateway:
type: aws:ec2:VpnGateway
properties:
vpcId: ${exampleVpc.id}
exampleGatewayAssociation:
type: aws:directconnect:GatewayAssociation
properties:
dxGatewayId: ${exampleGateway.id}
associatedGatewayId: ${exampleVpnGateway.id}
allowedPrefixes:
- 210.52.109.0/24
- 175.45.176.0/22
Create GatewayAssociation Resource
new GatewayAssociation(name: string, args: GatewayAssociationArgs, opts?: CustomResourceOptions);
@overload
def GatewayAssociation(resource_name: str,
opts: Optional[ResourceOptions] = None,
allowed_prefixes: Optional[Sequence[str]] = None,
associated_gateway_id: Optional[str] = None,
associated_gateway_owner_account_id: Optional[str] = None,
dx_gateway_id: Optional[str] = None,
proposal_id: Optional[str] = None,
vpn_gateway_id: Optional[str] = None)
@overload
def GatewayAssociation(resource_name: str,
args: GatewayAssociationArgs,
opts: Optional[ResourceOptions] = None)
func NewGatewayAssociation(ctx *Context, name string, args GatewayAssociationArgs, opts ...ResourceOption) (*GatewayAssociation, error)
public GatewayAssociation(string name, GatewayAssociationArgs args, CustomResourceOptions? opts = null)
public GatewayAssociation(String name, GatewayAssociationArgs args)
public GatewayAssociation(String name, GatewayAssociationArgs args, CustomResourceOptions options)
type: aws:directconnect:GatewayAssociation
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args GatewayAssociationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args GatewayAssociationArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args GatewayAssociationArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args GatewayAssociationArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args GatewayAssociationArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
GatewayAssociation Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The GatewayAssociation resource accepts the following input properties:
- Dx
Gateway stringId The ID of the Direct Connect gateway.
- Allowed
Prefixes List<string> VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- Associated
Gateway stringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- Associated
Gateway stringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- Proposal
Id string The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- Vpn
Gateway stringId use 'associated_gateway_id' argument instead
- Dx
Gateway stringId The ID of the Direct Connect gateway.
- Allowed
Prefixes []string VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- Associated
Gateway stringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- Associated
Gateway stringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- Proposal
Id string The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- Vpn
Gateway stringId use 'associated_gateway_id' argument instead
- dx
Gateway StringId The ID of the Direct Connect gateway.
- allowed
Prefixes List<String> VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated
Gateway StringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated
Gateway StringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- proposal
Id String The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn
Gateway StringId use 'associated_gateway_id' argument instead
- dx
Gateway stringId The ID of the Direct Connect gateway.
- allowed
Prefixes string[] VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated
Gateway stringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated
Gateway stringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- proposal
Id string The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn
Gateway stringId use 'associated_gateway_id' argument instead
- dx_
gateway_ strid The ID of the Direct Connect gateway.
- allowed_
prefixes Sequence[str] VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated_
gateway_ strid The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated_
gateway_ strowner_ account_ id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- proposal_
id str The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn_
gateway_ strid use 'associated_gateway_id' argument instead
- dx
Gateway StringId The ID of the Direct Connect gateway.
- allowed
Prefixes List<String> VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated
Gateway StringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated
Gateway StringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- proposal
Id String The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn
Gateway StringId use 'associated_gateway_id' argument instead
Outputs
All input properties are implicitly available as output properties. Additionally, the GatewayAssociation resource produces the following output properties:
- Associated
Gateway stringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- Dx
Gateway stringAssociation Id The ID of the Direct Connect gateway association.
- Dx
Gateway stringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- Id string
The provider-assigned unique ID for this managed resource.
- Associated
Gateway stringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- Dx
Gateway stringAssociation Id The ID of the Direct Connect gateway association.
- Dx
Gateway stringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- Id string
The provider-assigned unique ID for this managed resource.
- associated
Gateway StringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx
Gateway StringAssociation Id The ID of the Direct Connect gateway association.
- dx
Gateway StringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- id String
The provider-assigned unique ID for this managed resource.
- associated
Gateway stringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx
Gateway stringAssociation Id The ID of the Direct Connect gateway association.
- dx
Gateway stringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- id string
The provider-assigned unique ID for this managed resource.
- associated_
gateway_ strtype The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx_
gateway_ strassociation_ id The ID of the Direct Connect gateway association.
- dx_
gateway_ strowner_ account_ id The ID of the AWS account that owns the Direct Connect gateway.
- id str
The provider-assigned unique ID for this managed resource.
- associated
Gateway StringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx
Gateway StringAssociation Id The ID of the Direct Connect gateway association.
- dx
Gateway StringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- id String
The provider-assigned unique ID for this managed resource.
Look up Existing GatewayAssociation Resource
Get an existing GatewayAssociation resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: GatewayAssociationState, opts?: CustomResourceOptions): GatewayAssociation
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
allowed_prefixes: Optional[Sequence[str]] = None,
associated_gateway_id: Optional[str] = None,
associated_gateway_owner_account_id: Optional[str] = None,
associated_gateway_type: Optional[str] = None,
dx_gateway_association_id: Optional[str] = None,
dx_gateway_id: Optional[str] = None,
dx_gateway_owner_account_id: Optional[str] = None,
proposal_id: Optional[str] = None,
vpn_gateway_id: Optional[str] = None) -> GatewayAssociation
func GetGatewayAssociation(ctx *Context, name string, id IDInput, state *GatewayAssociationState, opts ...ResourceOption) (*GatewayAssociation, error)
public static GatewayAssociation Get(string name, Input<string> id, GatewayAssociationState? state, CustomResourceOptions? opts = null)
public static GatewayAssociation get(String name, Output<String> id, GatewayAssociationState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Allowed
Prefixes List<string> VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- Associated
Gateway stringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- Associated
Gateway stringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- Associated
Gateway stringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- Dx
Gateway stringAssociation Id The ID of the Direct Connect gateway association.
- Dx
Gateway stringId The ID of the Direct Connect gateway.
- Dx
Gateway stringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- Proposal
Id string The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- Vpn
Gateway stringId use 'associated_gateway_id' argument instead
- Allowed
Prefixes []string VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- Associated
Gateway stringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- Associated
Gateway stringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- Associated
Gateway stringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- Dx
Gateway stringAssociation Id The ID of the Direct Connect gateway association.
- Dx
Gateway stringId The ID of the Direct Connect gateway.
- Dx
Gateway stringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- Proposal
Id string The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- Vpn
Gateway stringId use 'associated_gateway_id' argument instead
- allowed
Prefixes List<String> VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated
Gateway StringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated
Gateway StringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- associated
Gateway StringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx
Gateway StringAssociation Id The ID of the Direct Connect gateway association.
- dx
Gateway StringId The ID of the Direct Connect gateway.
- dx
Gateway StringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- proposal
Id String The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn
Gateway StringId use 'associated_gateway_id' argument instead
- allowed
Prefixes string[] VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated
Gateway stringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated
Gateway stringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- associated
Gateway stringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx
Gateway stringAssociation Id The ID of the Direct Connect gateway association.
- dx
Gateway stringId The ID of the Direct Connect gateway.
- dx
Gateway stringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- proposal
Id string The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn
Gateway stringId use 'associated_gateway_id' argument instead
- allowed_
prefixes Sequence[str] VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated_
gateway_ strid The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated_
gateway_ strowner_ account_ id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- associated_
gateway_ strtype The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx_
gateway_ strassociation_ id The ID of the Direct Connect gateway association.
- dx_
gateway_ strid The ID of the Direct Connect gateway.
- dx_
gateway_ strowner_ account_ id The ID of the AWS account that owns the Direct Connect gateway.
- proposal_
id str The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn_
gateway_ strid use 'associated_gateway_id' argument instead
- allowed
Prefixes List<String> VPC prefixes (CIDRs) to advertise to the Direct Connect gateway. Defaults to the CIDR block of the VPC associated with the Virtual Gateway. To enable drift detection, must be configured.
- associated
Gateway StringId The ID of the VGW or transit gateway with which to associate the Direct Connect gateway. Used for single account Direct Connect gateway associations.
- associated
Gateway StringOwner Account Id The ID of the AWS account that owns the VGW or transit gateway with which to associate the Direct Connect gateway. Used for cross-account Direct Connect gateway associations.
- associated
Gateway StringType The type of the associated gateway,
transitGateway
orvirtualPrivateGateway
.- dx
Gateway StringAssociation Id The ID of the Direct Connect gateway association.
- dx
Gateway StringId The ID of the Direct Connect gateway.
- dx
Gateway StringOwner Account Id The ID of the AWS account that owns the Direct Connect gateway.
- proposal
Id String The ID of the Direct Connect gateway association proposal. Used for cross-account Direct Connect gateway associations.
- vpn
Gateway StringId use 'associated_gateway_id' argument instead
Import
Using pulumi import
, import Direct Connect gateway associations using dx_gateway_id
together with associated_gateway_id
. For example:
$ pulumi import aws:directconnect/gatewayAssociation:GatewayAssociation example 345508c3-7215-4aef-9832-07c125d5bd0f/vgw-98765432
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
This Pulumi package is based on the
aws
Terraform Provider.
Try AWS Native preview for resources not in the classic version.