class NatInstanceProviderV2

Language	Type name
.NET	Amazon.CDK.AWS.EC2.NatInstanceProviderV2
Go	github.com/aws/aws-cdk-go/awscdk/v2/awsec2#NatInstanceProviderV2
Java	software.amazon.awscdk.services.ec2.NatInstanceProviderV2
Python	aws_cdk.aws_ec2.NatInstanceProviderV2
TypeScript (source)	aws-cdk-lib » aws_ec2 » NatInstanceProviderV2

Implements IConnectable

Extends NatProvider

Modern NAT provider which uses NAT Instances.

The instance uses Amazon Linux 2023 as the operating system.

Example

const natGatewayProvider = ec2.NatProvider.instanceV2({
  instanceType: new ec2.InstanceType('t3.small'),
  defaultAllowedTraffic: ec2.NatTrafficDirection.NONE,
});
const vpc = new ec2.Vpc(this, 'Vpc', { natGatewayProvider });

const securityGroup = new ec2.SecurityGroup(this, 'SecurityGroup', {
  vpc,
  allowAllOutbound: false,
});
securityGroup.addEgressRule(ec2.Peer.anyIpv4(), ec2.Port.tcp(443));
for (const gatewayInstance of natGatewayProvider.gatewayInstances) {
   gatewayInstance.addSecurityGroup(securityGroup);
}

Initializer

new NatInstanceProviderV2(props: NatInstanceProps)

Parameters

• props NatInstanceProps

Properties

Name	Type	Description
configuredGateways	GatewayConfig[]	Return list of gateways spawned by the provider.
connections	Connections	Manage the Security Groups associated with the NAT instances.
gatewayInstances	Instance[]	Array of gateway instances spawned by the provider after internal configuration.
securityGroup	ISecurityGroup	The Security Group associated with the NAT instances.
static DEFAULT_USER_DATA_COMMANDS	string[]	Amazon Linux 2023 NAT instance user data commands Enable iptables on the instance, enable persistent IP forwarding, configure NAT on instance.

---

configuredGateways

Type: GatewayConfig[]

Return list of gateways spawned by the provider.

---

connections

Type: Connections

Manage the Security Groups associated with the NAT instances.

---

gatewayInstances

Type: Instance[]

Array of gateway instances spawned by the provider after internal configuration.

---

securityGroup

Type: ISecurityGroup

The Security Group associated with the NAT instances.

---

static DEFAULT_USER_DATA_COMMANDS

Type: string[]

Amazon Linux 2023 NAT instance user data commands Enable iptables on the instance, enable persistent IP forwarding, configure NAT on instance.

See also: https://docs.aws.amazon.com/vpc/latest/userguide/VPC_NAT_Instance.html#create-nat-ami

Methods

Name	Description
configureNat(options)	Called by the VPC to configure NAT.
configureSubnet(subnet)	Configures subnet with the gateway.

---

configureNat(options)

public configureNat(options: ConfigureNatOptions): void

Parameters

• options ConfigureNatOptions

Called by the VPC to configure NAT.

Don't call this directly, the VPC will call it automatically.

---

configureSubnet(subnet)

public configureSubnet(subnet: PrivateSubnet): void

Parameters

• subnet PrivateSubnet

Configures subnet with the gateway.

Don't call this directly, the VPC will call it automatically.