Skip to content
v2.277.0

Experimental

@aws-cdk/aws-ec2-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.

EgressOnlyInternetGatewayOptions Struct ​

Options to define EgressOnlyInternetGateway for VPC.

Example ​

ts
const stack = new Stack();
const myVpc = new VpcV2(this, 'Vpc',{
      primaryAddressBlock: IpAddresses.ipv4('10.1.0.0/16'),
      secondaryAddressBlocks: [IpAddresses.amazonProvidedIpv6({
      cidrBlockName: 'AmazonProvided',
    })]
    });
const routeTable = new RouteTable(this, 'RouteTable', {
  vpc: myVpc,
});
const subnet = new SubnetV2(this, 'Subnet', {
  vpc: myVpc,
  availabilityZone: 'eu-west-2a',
  ipv4CidrBlock: new IpCidr('10.0.0.0/24'),
  ipv6CidrBlock: new IpCidr('2001:db8:1::/64'),
  subnetType: SubnetType.PRIVATE });

myVpc.addEgressOnlyInternetGateway({
  subnets: [{subnetType: SubnetType.PRIVATE}],
  destination: '::/60',
})
python
stack = Stack()
my_vpc = VpcV2(self, "Vpc",
    primary_address_block=IpAddresses.ipv4("10.1.0.0/16"),
    secondary_address_blocks=[IpAddresses.amazon_provided_ipv6(
        cidr_block_name="AmazonProvided"
    )]
)
route_table = RouteTable(self, "RouteTable",
    vpc=my_vpc
)
subnet = SubnetV2(self, "Subnet",
    vpc=my_vpc,
    availability_zone="eu-west-2a",
    ipv4_cidr_block=IpCidr("10.0.0.0/24"),
    ipv6_cidr_block=IpCidr("2001:db8:1::/64"),
    subnet_type=SubnetType.PRIVATE
)

my_vpc.add_egress_only_internet_gateway(
    subnets=[ec2.SubnetSelection(subnet_type=SubnetType.PRIVATE)],
    destination="::/60"
)
java
Stack stack = new Stack();
VpcV2 myVpc = VpcV2.Builder.create(this, "Vpc")
        .primaryAddressBlock(IpAddresses.ipv4("10.1.0.0/16"))
        .secondaryAddressBlocks(List.of(IpAddresses.amazonProvidedIpv6(SecondaryAddressProps.builder()
                .cidrBlockName("AmazonProvided")
                .build())))
        .build();
RouteTable routeTable = RouteTable.Builder.create(this, "RouteTable")
        .vpc(myVpc)
        .build();
SubnetV2 subnet = SubnetV2.Builder.create(this, "Subnet")
        .vpc(myVpc)
        .availabilityZone("eu-west-2a")
        .ipv4CidrBlock(new IpCidr("10.0.0.0/24"))
        .ipv6CidrBlock(new IpCidr("2001:db8:1::/64"))
        .subnetType(SubnetType.PRIVATE)
        .build();

myVpc.addEgressOnlyInternetGateway(EgressOnlyInternetGatewayOptions.builder()
        .subnets(List.of(SubnetSelection.builder().subnetType(SubnetType.PRIVATE).build()))
        .destination("::/60")
        .build());
csharp
// Install: dotnet add package Amazon.CDK.AWS.ec2.Alpha
var stack = new Stack();
var myVpc = new VpcV2(this, "Vpc", new VpcV2Props {
    PrimaryAddressBlock = IpAddresses.Ipv4("10.1.0.0/16"),
    SecondaryAddressBlocks = new [] { IpAddresses.AmazonProvidedIpv6(new SecondaryAddressProps {
        CidrBlockName = "AmazonProvided"
    }) }
});
var routeTable = new RouteTable(this, "RouteTable", new RouteTableProps {
    Vpc = myVpc
});
var subnet = new SubnetV2(this, "Subnet", new SubnetV2Props {
    Vpc = myVpc,
    AvailabilityZone = "eu-west-2a",
    Ipv4CidrBlock = new IpCidr("10.0.0.0/24"),
    Ipv6CidrBlock = new IpCidr("2001:db8:1::/64"),
    SubnetType = SubnetType.PRIVATE
});

myVpc.AddEgressOnlyInternetGateway(new EgressOnlyInternetGatewayOptions {
    Subnets = new [] { new SubnetSelection { SubnetType = SubnetType.PRIVATE } },
    Destination = "::/60"
});
go
// Install: go get github.com/aws/aws-cdk-go/awsec2alpha/v2
stack := awscdk.Newstack()
myVpc := awsec2alpha.NewVpcV2(this, jsii.String("Vpc"), &VpcV2Props{
	PrimaryAddressBlock: awsec2alpha.IpAddresses_Ipv4(jsii.String("10.1.0.0/16")),
	SecondaryAddressBlocks: []IIpAddresses{
		awsec2alpha.IpAddresses_AmazonProvidedIpv6(&SecondaryAddressProps{
			CidrBlockName: jsii.String("AmazonProvided"),
		}),
	},
})
routeTable := awsec2alpha.NewRouteTable(this, jsii.String("RouteTable"), &RouteTableProps{
	Vpc: myVpc,
})
subnet := awsec2alpha.NewSubnetV2(this, jsii.String("Subnet"), &SubnetV2Props{
	Vpc: myVpc,
	AvailabilityZone: jsii.String("eu-west-2a"),
	Ipv4CidrBlock: awsec2alpha.NewIpCidr(jsii.String("10.0.0.0/24")),
	Ipv6CidrBlock: awsec2alpha.NewIpCidr(jsii.String("2001:db8:1::/64")),
	SubnetType: awscdk.SubnetType_PRIVATE,
})

myVpc.AddEgressOnlyInternetGateway(&EgressOnlyInternetGatewayOptions{
	Subnets: []SubnetSelection{
		&SubnetSelection{
			SubnetType: awscdk.SubnetType_PRIVATE,
		},
	},
	Destination: jsii.String("::/60"),
})

Properties ​

destinationoptionalstringdestinationoptionalstrdestinationoptionalStringDestinationoptionalstringDestinationoptional*string #
Destination Ipv6 address for EGW route.

Default: '::/0' all Ipv6 traffic

egressOnlyInternetGatewayNameoptionalstringegress_only_internet_gateway_nameoptionalstregressOnlyInternetGatewayNameoptionalStringEgressOnlyInternetGatewayNameoptionalstringEgressOnlyInternetGatewayNameoptional*string #
The resource name of the egress-only internet gateway.

Default: no name tag associated and provisioned without a resource name

Provided name will be used for tagging

subnetsoptionalSubnetSelection[]subnetsoptionaltyping.List[SubnetSelection]subnetsoptionalList<SubnetSelection>SubnetsoptionalSubnetSelection[]Subnetsoptional*[]SubnetSelection #
List of subnets where route to EGW will be added.

Default: no route created