52 lines
1.4 KiB
Markdown
52 lines
1.4 KiB
Markdown
|
---
|
||
|
|
layout: "aws"
|
||
|
|
page_title: "AWS: aws_nat_gateway"
|
||
|
|
sidebar_current: "docs-aws-resource-nat-gateway"
|
||
|
|
description: |-
|
||
|
|
Provides a resource to create a VPC NAT Gateway.
|
||
|
|
---
|
||
|
|
|
||
|
|
# aws\_nat\_gateway
|
||
|
|
|
||
|
|
Provides a resource to create a VPC NAT Gateway.
|
||
|
|
|
||
|
|
## Example Usage
|
||
|
|
|
||
|
|
```
|
||
|
|
resource "aws_nat_gateway" "gw" {
|
||
|
|
allocation_id = "${aws_eip.nat.id}"
|
||
|
|
subnet_id = "${aws_subnet.public.id}"
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Argument Reference
|
||
|
|
|
||
|
|
The following arguments are supported:
|
||
|
|
|
||
|
|
* `allocation_id` - (Required) The Allocation ID of the Elastic IP address for the gateway.
|
||
|
|
* `subnet_id` - (Required) The Subnet ID of the subnet in which to place the gateway.
|
||
|
|
|
||
|
|
-> **Note:** It's recommended to denote that the NAT Gateway depends on the Internet Gateway for the VPC in which the NAT Gateway's subnet is located. For example:
|
||
|
|
|
||
|
|
resource "aws_internet_gateway" "gw" {
|
||
|
|
vpc_id = "${aws_vpc.main.id}"
|
||
|
|
}
|
||
|
|
|
||
|
|
resource "aws_nat_gateway" "gw" {
|
||
|
|
//other arguments
|
||
|
|
|
||
|
|
depends_on = ["aws_internet_gateway.gw"]
|
||
|
|
}
|
||
|
|
|
||
|
|
|
||
|
|
## Attributes Reference
|
||
|
|
|
||
|
|
The following attributes are exported:
|
||
|
|
|
||
|
|
* `id` - The ID of the NAT Gateway.
|
||
|
|
* `allocation_id` - The Allocation ID of the Elastic IP address for the gateway.
|
||
|
|
* `subnet_id` - The Subnet ID of the subnet in which the NAT gateway is placed.
|
||
|
|
* `network_interface_id` - The ENI ID of the network interface created by the NAT gateway.
|
||
|
|
* `private_ip` - The private IP address of the NAT Gateway.
|
||
|
|
* `public_ip` - The public IP address of the NAT Gateway.
|