CfnNatGatewayMixinProps

class aws_cdk.mixins_preview.aws_ec2.mixins.CfnNatGatewayMixinProps(*, allocation_id=None, availability_mode=None, availability_zone_addresses=None, connectivity_type=None, max_drain_duration_seconds=None, private_ip_address=None, secondary_allocation_ids=None, secondary_private_ip_address_count=None, secondary_private_ip_addresses=None, subnet_id=None, tags=None, vpc_id=None)

Bases: object

Properties for CfnNatGatewayPropsMixin.

Parameters:
  • allocation_id (Optional[str]) – [Public NAT gateway only] The allocation ID of the Elastic IP address that’s associated with the NAT gateway. This property is required for a public NAT gateway and cannot be specified with a private NAT gateway.

  • availability_mode (Optional[str]) – Indicates whether this is a zonal (single-AZ) or regional (multi-AZ) NAT gateway. A zonal NAT gateway is a NAT Gateway that provides redundancy and scalability within a single availability zone. A regional NAT gateway is a single NAT Gateway that works across multiple availability zones (AZs) in your VPC, providing redundancy, scalability and availability across all the AZs in a Region. For more information, see Regional NAT gateways for automatic multi-AZ expansion in the Amazon VPC User Guide .

  • availability_zone_addresses (Union[IResolvable, Sequence[Union[IResolvable, AvailabilityZoneAddressProperty, Dict[str, Any]]], None]) –

    For regional NAT gateways only: Specifies which Availability Zones you want the NAT gateway to support and the Elastic IP addresses (EIPs) to use in each AZ. The regional NAT gateway uses these EIPs to handle outbound NAT traffic from their respective AZs. If not specified, the NAT gateway will automatically expand to new AZs and associate EIPs upon detection of an elastic network interface. If you specify this parameter, auto-expansion is disabled and you must manually manage AZ coverage. A regional NAT gateway is a single NAT Gateway that works across multiple availability zones (AZs) in your VPC, providing redundancy, scalability and availability across all the AZs in a Region. For more information, see Regional NAT gateways for automatic multi-AZ expansion in the Amazon VPC User Guide .

  • connectivity_type (Optional[str]) – Indicates whether the NAT gateway supports public or private connectivity. The default is public connectivity.

  • max_drain_duration_seconds (Union[int, float, None]) – The maximum amount of time to wait (in seconds) before forcibly releasing the IP addresses if connections are still in progress. Default value is 350 seconds.

  • private_ip_address (Optional[str]) – The private IPv4 address to assign to the NAT gateway. If you don’t provide an address, a private IPv4 address will be automatically assigned.

  • secondary_allocation_ids (Optional[Sequence[str]]) – Secondary EIP allocation IDs. For more information, see Create a NAT gateway in the Amazon VPC User Guide .

  • secondary_private_ip_address_count (Union[int, float, None]) –

    [Private NAT gateway only] The number of secondary private IPv4 addresses you want to assign to the NAT gateway. For more information about secondary addresses, see Create a NAT gateway in the Amazon Virtual Private Cloud User Guide . SecondaryPrivateIpAddressCount and SecondaryPrivateIpAddresses cannot be set at the same time.

  • secondary_private_ip_addresses (Optional[Sequence[str]]) –

    Secondary private IPv4 addresses. For more information about secondary addresses, see Create a NAT gateway in the Amazon Virtual Private Cloud User Guide . SecondaryPrivateIpAddressCount and SecondaryPrivateIpAddresses cannot be set at the same time.

  • subnet_id (Optional[str]) – The ID of the subnet in which the NAT gateway is located.

  • tags (Optional[Sequence[Union[CfnTag, Dict[str, Any]]]]) – The tags for the NAT gateway.

  • vpc_id (Optional[str]) – The ID of the VPC in which the NAT gateway is located.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ec2 import mixins as ec2_mixins

cfn_nat_gateway_mixin_props = ec2_mixins.CfnNatGatewayMixinProps(
    allocation_id="allocationId",
    availability_mode="availabilityMode",
    availability_zone_addresses=[ec2_mixins.CfnNatGatewayPropsMixin.AvailabilityZoneAddressProperty(
        allocation_ids=["allocationIds"],
        availability_zone="availabilityZone",
        availability_zone_id="availabilityZoneId"
    )],
    connectivity_type="connectivityType",
    max_drain_duration_seconds=123,
    private_ip_address="privateIpAddress",
    secondary_allocation_ids=["secondaryAllocationIds"],
    secondary_private_ip_address_count=123,
    secondary_private_ip_addresses=["secondaryPrivateIpAddresses"],
    subnet_id="subnetId",
    tags=[CfnTag(
        key="key",
        value="value"
    )],
    vpc_id="vpcId"
)

Attributes

allocation_id

[Public NAT gateway only] The allocation ID of the Elastic IP address that’s associated with the NAT gateway.

This property is required for a public NAT gateway and cannot be specified with a private NAT gateway.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-allocationid

availability_mode

Indicates whether this is a zonal (single-AZ) or regional (multi-AZ) NAT gateway.

A zonal NAT gateway is a NAT Gateway that provides redundancy and scalability within a single availability zone. A regional NAT gateway is a single NAT Gateway that works across multiple availability zones (AZs) in your VPC, providing redundancy, scalability and availability across all the AZs in a Region.

For more information, see Regional NAT gateways for automatic multi-AZ expansion in the Amazon VPC User Guide .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-availabilitymode

availability_zone_addresses

Specifies which Availability Zones you want the NAT gateway to support and the Elastic IP addresses (EIPs) to use in each AZ.

The regional NAT gateway uses these EIPs to handle outbound NAT traffic from their respective AZs. If not specified, the NAT gateway will automatically expand to new AZs and associate EIPs upon detection of an elastic network interface. If you specify this parameter, auto-expansion is disabled and you must manually manage AZ coverage.

A regional NAT gateway is a single NAT Gateway that works across multiple availability zones (AZs) in your VPC, providing redundancy, scalability and availability across all the AZs in a Region.

For more information, see Regional NAT gateways for automatic multi-AZ expansion in the Amazon VPC User Guide .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-availabilityzoneaddresses

Type:

For regional NAT gateways only

connectivity_type

Indicates whether the NAT gateway supports public or private connectivity.

The default is public connectivity.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-connectivitytype

max_drain_duration_seconds

The maximum amount of time to wait (in seconds) before forcibly releasing the IP addresses if connections are still in progress.

Default value is 350 seconds.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-maxdraindurationseconds

private_ip_address

The private IPv4 address to assign to the NAT gateway.

If you don’t provide an address, a private IPv4 address will be automatically assigned.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-privateipaddress

secondary_allocation_ids

Secondary EIP allocation IDs.

For more information, see Create a NAT gateway in the Amazon VPC User Guide .

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-secondaryallocationids

secondary_private_ip_address_count

[Private NAT gateway only] The number of secondary private IPv4 addresses you want to assign to the NAT gateway.

For more information about secondary addresses, see Create a NAT gateway in the Amazon Virtual Private Cloud User Guide .

SecondaryPrivateIpAddressCount and SecondaryPrivateIpAddresses cannot be set at the same time.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-secondaryprivateipaddresscount

secondary_private_ip_addresses

Secondary private IPv4 addresses.

For more information about secondary addresses, see Create a NAT gateway in the Amazon Virtual Private Cloud User Guide .

SecondaryPrivateIpAddressCount and SecondaryPrivateIpAddresses cannot be set at the same time.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-secondaryprivateipaddresses

subnet_id

The ID of the subnet in which the NAT gateway is located.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-subnetid

tags

The tags for the NAT gateway.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-tags

vpc_id

The ID of the VPC in which the NAT gateway is located.

See:

http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-natgateway.html#cfn-ec2-natgateway-vpcid