DescribeAddresses
Description
Lists elastic IP addresses assigned to your account or provides information about a specific address.
Request Parameters
| Name | Description | Required |
|---|---|---|
|
Type: |
Ancestor: None
Children: publicIpsSet
publicIpsSet
Set of elastic IP addresses.
Type: DescribeAddressesInfoType
Ancestor: DescribeAddressesType
Children: item
Yes, but can be empty
item
Information for one elastic IP address.
Type: DescribeAddressesItemType
Ancestor: publicIpsSet
Children: publicIp
publicIp
Elastic IP address to describe.
Type: xsd:string
Default: None
Ancestor: item
Children: None
Yes, but can be empty
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeAddressesResponseType Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
The set of IP addresses. Type: DescribeAddressesResponseInfoType Ancestor: Children: |
|
Information about an instance. Type: DescribeAddressesResponseItemType Ancestor: Children: |
|
The public IP address. Type: xsd:string Ancestor: Children: None |
|
The ID of the instance. Type: xsd:string Ancestor: Children: None |
Examples
Example Request
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.
<DescribeAddresses xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
<publicIpsSet>
<item>
<publicIp>67.202.55.255</publicIp>
</item>
<item>
<publicIp>67.202.55.233</publicIp>
</item>
</publicIpsSet>
</DescribeAddresses>
Example Response
<DescribeAddressesResponse xmlns="http://ec2.amazonaws.com/doc/2009-08-15/">
<addressesSet>
<item>
<instanceId>i-f15ebb98</instanceId>
<publicIp>67.202.55.255</publicIp>
</item>
<item>
<publicIp>67.202.55.233</publicIp>
</item>
</addressesSet>
</DescribeAddressesResponse>