DescribeAddresses
GET /?Action=DescribeAddresses
Description
Describes one or more External IP addresses (EIPs) allocated to your account.
By default, this action returns information about all your EIPs: available, associated with an instance or network interface, or used for a NAT gateway.
You can use the Filter.N
parameter to filter your EIPs on the following properties:
-
domain
: Whether the EIP is for use in the public Cloud or in a VPC. -
instance-id
: The ID of the instance the address is associated with (if any). -
public-ip
: The EIP. -
allocation-id
: The allocation ID for the EIP. -
association-id
: The association ID for the EIP. -
network-interface-id
: The ID of the network interface the address is associated with (if any). -
network-interface-owner-id
: The account ID of the owner. -
private-ip-address
: The private IP address associated with the EIP.
Note
|
If you exceed the number of identical requests allowed for a configured time period, the |
Body parameter
Required: false
Name: DescribeAddressesRequest
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
AllocationId.N |
One ore more allocation IDs. |
false |
string |
||
Filter.N |
One or more filters. |
false |
|||
PublicIp.N |
One or more External IP addresses. |
false |
string |
Responses
HTTP Code 200
HTTP Code | Description | Schema |
---|---|---|
200 |
DescribeAddressesResult |
Response 200
Name | Description | Required | Schema | Default | Example |
---|---|---|---|---|---|
addressesSet.N |
Information about one or more External IP addresses. |
false |
|||
requestId |
The ID of the request. |
false |
string |