mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-05-10 15:02:33 -04:00
8380a7b03e
When calling AssociateAddress, the PrivateIpAddress parameter must be used to select which private IP the EIP should associate with, otherwise the EIP always associates with the _first_ private IP. Without this parameter, multiple EIPs couldn't be assigned to a single ENI. Includes covering test and docs update. Fixes #2997
2.0 KiB
2.0 KiB
layout, page_title, sidebar_current, description
| layout | page_title | sidebar_current | description |
|---|---|---|---|
| aws | AWS: aws_eip | docs-aws-resource-eip | Provides an Elastic IP resource. |
aws_eip
Provides an Elastic IP resource.
Example Usage
Single EIP associated with an instance:
resource "aws_eip" "lb" {
instance = "${aws_instance.web.id}"
vpc = true
}
Muliple EIPs associated with a single network interface:
resource "aws_network_interface" "multi-ip" {
subnet_id = "${aws_subnet.main.id}"
private_ips = ["10.0.0.10", "10.0.0.11"]
}
resource "aws_eip" "one" {
vpc = true
network_interface = "${aws_network_interface.multi-ip.id}"
private_ip = "10.0.0.10"
}
resource "aws_eip" "two" {
vpc = true
network_interface = "${aws_network_interface.multi-ip.id}"
private_ip = "10.0.0.11"
}
Argument Reference
The following arguments are supported:
vpc- (Optional) Boolean if the EIP is in a VPC or not.instance- (Optional) EC2 instance ID.network_interface- (Optional) Network interface ID to associate with.private_ip- (Optional) The primary or secondary private IP address to associate with the Elastic IP address. If no private IP address is specified, the Elastic IP address is associated with the primary private IP address.
~> NOTE: You can specify either the instance ID or the network_interface ID,
but not both. Including both will not return an error from the AWS API, but will
have undefined behavior. See the relevant AssociateAddress API Call for
more information.
Attributes Reference
The following attributes are exported:
id- Contains the EIP allocation ID.private_ip- Contains the private IP address (if in VPC).public_ip- Contains the public IP address.instance- Contains the ID of the attached instance.network_interface- Contains the ID of the attached network interface.