 | Documentation Feedback |  |
Lists elastic IP addresses assigned to your account or provides information about a specific address.
You can filter the results to return information only about elastic IP addresses that match criteria you specify. For example, you could get information only about addresses tagged with a certain value. You can specify multiple values for a filter. An address must match at least one of the specified values for it to be included in the results.
You can specify multiple filters (e.g., the address is a particular value, and is tagged with a certain value). The result includes information for an address only if it matches all your filters. If there's no match, no special message is returned; the response is simply empty.
You can use wildcards with the filter values: * matches zero or more characters, and ? matches exactly one character. You can escape special characters using a backslash before the character. For example, a value of \*amazon\?\\ searches for the literal string *amazon?\.
The following table shows the available filters.
| Filter Name | Description |
|---|---|
|
|
Instance the address is associated with (if any). Type: String |
|
|
The elastic IP address. Type: String |
| Name | Description | Required |
|---|---|---|
|
|
One or more Elastic IP addresses. Type: String Default: None |
No |
|
|
Name of a filter. See the preceding table for a list of allowed filter names. Type: String Default: None |
No |
|
|
A value for the filter. See the preceding table for a list of allowed values for each filter. Type: String Default: None |
No |
The elements in the following table come wrapped in a
DescribeAddressesResponse structure.
| Name | Description |
|---|---|
|
|
The ID of the request. Type: xsd:string |
|
|
A list of IP addresses. Each IP address's information is
wrapped in an |
This example describes elastic IP addresses assigned to the account. Amazon EC2 returns 67.202.55.255, which is assigned to instance i-f15ebb98, and 67.202.55.233, which is not assigned to an instance.
https://ec2.amazonaws.com/?Action=DescribeAddresses &PublicIp.1=67.202.55.255 &PublicIp.2=67.202.55.233 &AuthParams
<DescribeAddressesResponse xmlns="http://ec2.amazonaws.com/doc/2010-08-31/">
<requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId>
<addressesSet>
<item>
<publicIp>67.202.55.255</publicIp>
<instanceId>i-f15ebb98</instanceId>
</item>
<item>
<publicIp>67.202.55.233</publicIp>
<instanceId/>
</item>
</addressesSet>
</DescribeAddressesResponse>