51 lines
1.4 KiB
Markdown
51 lines
1.4 KiB
Markdown
|
---
|
||
|
layout: "aws"
|
||
|
page_title: "AWS: aws_eip"
|
||
|
sidebar_current: "docs-aws-datasource-eip"
|
||
|
description: |-
|
||
|
Provides details about a specific Elastic IP
|
||
|
---
|
||
|
|
||
|
# aws\_eip
|
||
|
|
||
|
`aws_eip` provides details about a specific Elastic IP.
|
||
|
|
||
|
This resource can prove useful when a module accepts an allocation ID or
|
||
|
public IP as an input variable and needs to determine the other.
|
||
|
|
||
|
## Example Usage
|
||
|
|
||
|
The following example shows how one might accept a public IP as a variable
|
||
|
and use this data source to obtain the allocation ID.
|
||
|
|
||
|
```
|
||
|
variable "instance_id" {}
|
||
|
variable "public_ip" {}
|
||
|
|
||
|
data "aws_eip" "proxy_ip" {
|
||
|
public_ip = "${var.public_ip}"
|
||
|
}
|
||
|
|
||
|
aws_eip_association "proxy_eip" {
|
||
|
instance_id = "${var.instance_id}"
|
||
|
allocation_id = "${data.aws_eip.proxy_ip.id}"
|
||
|
}
|
||
|
```
|
||
|
|
||
|
## Argument Reference
|
||
|
|
||
|
The arguments of this data source act as filters for querying the available
|
||
|
Elastic IPs in the current region. The given filters must match exactly one
|
||
|
Elastic IP whose data will be exported as attributes.
|
||
|
|
||
|
* `id` - (Optional) The allocation id of the specific EIP to retrieve.
|
||
|
|
||
|
* `public_ip` - (Optional) The public IP of the specific EIP to retrieve.
|
||
|
|
||
|
## Attributes Reference
|
||
|
|
||
|
All of the argument attributes are also exported as result attributes. This
|
||
|
data source will complete the data by populating any fields that are not
|
||
|
included in the configuration with the data for the selected Elastic IP.
|
||
|
|