         | Did this page help you? Yes No Tell us about it... |
ec2-release-address
Description
Releases an Elastic IP address allocated to your account.
This command applies to both EC2 Elastic IP addresses and VPC Elastic IP addresses. For information about VPC addresses and how they differ from EC2 addresses, go to the Elastic IP Addresses in the Amazon Virtual Private Cloud User Guide.
If you run this action 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 (AuthFailure).
![[Note]](http://docs.amazonwebservices.com/docs-common/images/note.png) | Note |
|---|---|
For EC2 addresses only: Releasing an IP address automatically disassociates it from any instance it's associated with. To
disassociate an IP address without releasing it, use the If you try to release a VPC address that's associated with an instance, Amazon EC2 returns an error
( |
![[Important]](http://docs.amazonwebservices.com/docs-common/images/important.png) | Important |
|---|---|
After releasing an Elastic IP address, it is released to the IP address pool and might be unavailable to your account. Make sure to update your DNS records and any servers or devices that communicate with the address. |
The short version of this command is ec2reladdr.
Syntax
ec2-release-address [
ip_address | -a
allocation_id}
Options
| Name | Description | Required |
|---|---|---|
|
|
The EC2 Elastic IP address to release. Type: String Default: None Condition: Required for EC2 Elastic IP addresses. Example: 192.0.2.1 |
Conditional |
|
|
The allocation ID that AWS provided when you allocated the address for use with Amazon VPC. Type: String Default: None Condition: Required for VPC Elastic IP addresses. Example: -a eipalloc-5723d13e |
Conditional |
Common Options
| Option | Description |
|---|---|
|
|
Overrides the Region specified in the Default: The Example: |
|
|
Default: The Example: |
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
Specifies a connection timeout (in seconds). Example: --connection-timeout 30 |
|
|
Specifies a request timeout (in seconds). Example: --request-timeout 45 |
|
|
Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API. |
|
|
Displays column headers in the output. |
|
|
Shows empty columns as |
|
|
Do not display tags for tagged resources. |
|
|
Prints internal debugging information. This is useful to assist us when troubleshooting problems. |
|
|
Displays Help. |
|
|
If Example: |
Output
The command returns a table that contains the following information:
Output type identifier ("ADDRESS")
Elastic IP address that you are releasing
Amazon EC2 command line tools display errors on stderr.
Examples
Example Request
This example releases an EC2 Elastic IP address.
PROMPT>ec2-release-address 192.0.2.1ADDRESS 192.0.2.1
Example Request
This example releases a VPC Elastic IP address associated with the account.
PROMPT>ec2-release-address -a eipalloc-5723d13eADDRESS eipalloc-5723d13e
