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:
objectProperties 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 .
SecondaryPrivateIpAddressCountandSecondaryPrivateIpAddressescannot 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 .
SecondaryPrivateIpAddressCountandSecondaryPrivateIpAddressescannot 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.
- 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 .
- 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:
- Type:
For regional NAT gateways only
- connectivity_type
Indicates whether the NAT gateway supports public or private connectivity.
The default is public connectivity.
- 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.
- 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.
- secondary_allocation_ids
Secondary EIP allocation IDs.
For more information, see Create a NAT gateway in the Amazon VPC User Guide .
- 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 .
SecondaryPrivateIpAddressCountandSecondaryPrivateIpAddressescannot be set at the same time.
- 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 .
SecondaryPrivateIpAddressCountandSecondaryPrivateIpAddressescannot be set at the same time.
- subnet_id
The ID of the subnet in which the NAT gateway is located.
- tags
The tags for the NAT gateway.
- vpc_id
The ID of the VPC in which the NAT gateway is located.