AWS CDK Reference

Appearance

v2.273.0

RegionalNatGatewayProviderProps Struct ​

Properties for a Regional NAT Gateway Provider.

Regional NAT Gateways provide automatic multi-AZ redundancy with a single gateway that scales across availability zones.

Source
aws-ec2/lib/nat.ts
Type last changed
v2.272.0 · 30 Sep 2026

Example ​

ts
const eip = new ec2.CfnEIP(this, 'NatEip');

new ec2.Vpc(this, 'Vpc1', {
  natGatewayProvider: ec2.NatProvider.regionalGateway({
    eip,
  }),
});

new ec2.Vpc(this, 'Vpc2', {
  natGatewayProvider: ec2.NatProvider.regionalGateway({
    allocationId: eip.attrAllocationId,
  }),
});

Properties ​

allocationIdstringallocation_idstrallocationIdStringAllocationIdstringAllocationId*string= A new EIP is automatically alloc…#
The allocation ID of the Elastic IP address to use for this NAT gateway.

Cannot be specified together with eip. Ignored when availabilityZoneAddresses is specified.

default

Default: A new EIP is automatically allocated

availabilityZoneAddressesAvailabilityZoneAddress[]availability_zone_addressestyping.List[AvailabilityZoneAddress]availabilityZoneAddressesList<AvailabilityZoneAddress>AvailabilityZoneAddressesAvailabilityZoneAddress[]AvailabilityZoneAddresses*[]AvailabilityZoneAddress= Automatic mode: AWS manages AZ c…#
Specifies which Availability Zones you want the NAT gateway to support and the Elastic IP addresses to use in each AZ.
notes · default

When specified, allocationId and eip are ignored. This enables manual mode for Regional NAT Gateway where you control EIP allocation per AZ.

In manual mode the gateway only serves the listed Availability Zones and does not expand to other zones automatically, so every Availability Zone that contains a private subnet routed through this gateway must be listed. When the zone names are known at synthesis time, a private subnet in an unlisted zone is rejected with an error. Entries that use availabilityZoneId or unresolved tokens cannot be checked and are assumed to be correct.

Default: Automatic mode: AWS manages AZ coverage and EIP allocation

eipIEIPRefeipIEIPRefeipIEIPRefEipIEIPRefEipIEIPRef= A new EIP is automatically alloc…#
Reference to an existing EIP to use for this NAT gateway.

Cannot be specified together with allocationId. Ignored when availabilityZoneAddresses is specified.

default

Default: A new EIP is automatically allocated

maxDrainDurationDurationmax_drain_durationDurationmaxDrainDurationDurationMaxDrainDurationDurationMaxDrainDurationDuration= Duration.seconds(350)#
Maximum amount of time to wait before forcibly releasing IP addresses if connections are still in progress.

Used as props by ​