DescribeAddresses#

Description#

The request for a list of allocated external Elastic IP addresses.

Request Parameters#

  • AllocationId.N – Allocation IDs of Elastic IPs. If the parameter is not specified, all Elastic IPs are returned.

    • Type: Array of strings

    • Required: No

  • Filter.N — One or more filters.

    • Type: List of Filter objects

    • Required: No

  • PublicIp.N — Elastic IP addresses.

    • Type: Array of strings

    • Required: No

Supported Filters#

  • allocation-id — The ID of an allocated Elastic IP address.

  • association-id — The ID of an Elastic IP address association.

  • domain — Indicates whether the address is for use in a VPC.

  • network-instance-id — The ID of the network interface associated with an Elastic IP address.

  • private-ip-address — The private IP address of the interface associated with the Elastic IP address.

  • public-ip — Elastic IP address.

  • tag-key — Tag key. This filter allows you to get resources matching the specified key-value pair.

Response Elements#

  • addressesSet — List of Elastic IP addresses.

  • requestId — The request ID.

    • Type: String

Examples#

c2-ec2 DescribeAddresses

c2-ec2 DescribeAddresses PublicIp.0 1.2.3.4

c2-ec2 DescribeAddresses AllocationId.0 eipalloc-00000001 AllocationId.0 eipalloc-00000002

c2-ec2 DescribeAddresses Filter.0.Name private-ip-address Filter.0.Value 1.2.3.4