View a markdown version of this page

NatGatewayCreateMapping - Amazon Network Firewall
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

NatGatewayCreateMapping

A NAT gateway that Network Firewall creates for a proxy mode firewall in one Availability Zone. You use this in CreateFirewall and AssociateSubnets.

To create a public NAT gateway, specify AllocationIds, and one PrivateIps address for each Elastic IP address. To create a private NAT gateway, specify only PrivateIps. You must specify at least one of them. Each Elastic IP address and private IP address can appear only once in a request.

The NAT gateway is a resource in your account. To change its IP addresses, use Amazon EC2 NAT gateway actions.

Contents

SubnetId

The ID of the subnet where Network Firewall creates the NAT gateway. The subnet must be in the firewall's VPC and can't be one of the firewall endpoint subnets. Each mapping must be in a different Availability Zone.

Type: String

Required: Yes

AllocationIds

The allocation IDs of the Elastic IP addresses for a public NAT gateway, from 1 to 8. For each allocation ID, specify one address in PrivateIps. If you don't specify this, Network Firewall creates a private NAT gateway.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 32 items.

Required: No

PrivateIps

The private IPv4 addresses of the NAT gateway. The addresses must be in the subnet that you specify and can't be the subnet's reserved addresses.

For a public NAT gateway, you must specify exactly one address for each Elastic IP address in AllocationIds, even if you specify only one. For a private NAT gateway, specify from 1 to 8 addresses. The first address is the primary address.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 32 items.

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: