AmazonEC2Client.CreateNatGateway Method (CreateNatGatewayRequest)

Creates a NAT gateway in the specified subnet. This action creates a network interface in the specified subnet with a private IP address from the IP address range of the subnet. You can create either a public NAT gateway or a private NAT gateway.

With a public NAT gateway, internet-bound traffic from a private subnet can be routed to the NAT gateway, so that instances in a private subnet can connect to the internet.

With a private NAT gateway, private communication is routed across VPCs and on-premises networks through a transit gateway or virtual private gateway. Common use cases include running large workloads behind a small pool of allowlisted IPv4 addresses, preserving private IPv4 addresses, and communicating between overlapping networks.

For more information, see NAT gateways in the Amazon VPC User Guide.

When you create a public NAT gateway and assign it an EIP or secondary EIPs, the network border group of the EIPs must match the network border group of the Availability Zone (AZ) that the public NAT gateway is in. If it's not the same, the NAT gateway will fail to launch. You can see the network border group for the subnet's AZ by viewing the details of the subnet. Similarly, you can view the network border group of an EIP by viewing the details of the EIP address. For more information about network border groups and EIPs, see Allocate an Elastic IP address in the Amazon VPC User Guide.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to CreateNatGatewayAsync.

Namespace: Amazon.EC2
Assembly: AWSSDK.EC2.dll
Version: 3.x.y.z

Syntax

public virtual CreateNatGatewayResponse CreateNatGateway(
         CreateNatGatewayRequest request
)

Parameters

request: Type: Amazon.EC2.Model.CreateNatGatewayRequest

Container for the necessary parameters to execute the CreateNatGateway service method.

Return Value

Type: CreateNatGatewayResponse

The response from the CreateNatGateway service method, as returned by EC2.

Examples

This example creates a NAT gateway in subnet subnet-1a2b3c4d and associates an Elastic IP address with the allocation ID eipalloc-37fc1a52 with the NAT gateway.

To create a NAT gateway


var client = new AmazonEC2Client();
var response = client.CreateNatGateway(new CreateNatGatewayRequest 
{
    AllocationId = "eipalloc-37fc1a52",
    SubnetId = "subnet-1a2b3c4d"
});

NatGateway natGateway = response.NatGateway;

Version Information

.NET Framework:
Supported in: 4.5 and newer, 3.5

AmazonEC2Client.CreateNatGateway (CreateNatGatewayRequest)