AWS CDK Reference

Appearance

v2.274.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 ​

allocationIdoptionalstringallocation_idoptionalstrallocationIdoptionalStringAllocationIdoptionalstringAllocationIdoptional*string#
The allocation ID of the Elastic IP address to use for this NAT gateway.

Default: A new EIP is automatically allocated

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

availabilityZoneAddressesoptionalAvailabilityZoneAddress[]availability_zone_addressesoptionaltyping.List[AvailabilityZoneAddress]availabilityZoneAddressesoptionalList<AvailabilityZoneAddress>AvailabilityZoneAddressesoptionalAvailabilityZoneAddress[]AvailabilityZoneAddressesoptional*[]AvailabilityZoneAddress#
Specifies which Availability Zones you want the NAT gateway to support and the Elastic IP addresses to use in each AZ.

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

notes

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.

eipoptionalIEIPRefeipoptionalIEIPRefeipoptionalIEIPRefEipoptionalIEIPRefEipoptionalIEIPRef#
Reference to an existing EIP to use for this NAT gateway.

Default: A new EIP is automatically allocated

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

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