ec2-release-address

Amazon Elastic Compute Cloud: 2009-10-31

previous page next page

ec2-release-address

Description

Releases an elastic IP address associated with your account.

If you run this operation on an elastic IP address that is already released, the address might be assigned to another account which will cause Amazon EC2 to return an error.

[Note] Note

Releasing an IP address automatically disassociates it from any instance with which it is associated. To disassociate an IP address without releasing it, use the DisassociateAddress operation.

[Important] Important

After releasing an elastic IP address, it is released to the IP address pool and might no longer be available to your account. Make sure to update your DNS records and any servers or devices that communicate with the address.

Syntax

ec2-release-address ip_address

Options

Name Description Required

ip_address

The IP address that you are releasing from your account.

Type: String

Default: None

Example: 67.202.55.255

Yes

Output

The command returns a table that contains the following information:

  • Output type identifier ("ADDRESS")

  • Elastic IP address that you are releasing

Amazon EC2 displays errors on stderr.

Examples

Example Request

This example releases an elastic IP address associated with the account.

PROMPT> ec2-release-address 67.202.55.255
ADDRESS 67.202.55.255

ec2-allocate-address

  • ec2-describe-addresses

  • ec2-associate-address

  • ec2-disassociate-address

    • previous page start next page