ReleaseAddress

Amazon Elastic Compute Cloud: 2009-07-15

previous page next page

ReleaseAddress

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.

Request Parameters

NameDescriptionRequired

ReleaseAddressType

ReleaseAddressType element.

Type:

ReleaseAddressType

Ancestor: None

Children: publicIp

publicIp

The IP address that you are releasing from your account.

Type: xsd:string

Default: None

Ancestor: ReleaseAddressType

Children: None

Yes

Response Elements

Name Description

ReleaseAddressResponseType

ReleaseAddressResponseType element.

Type: ReleaseAddressResponseType

Ancestor: None

Children: requestId, return

requestId

The ID of the request.

Type: xsd:string

Ancestor: ReleaseAddressResponseType

Children: None

return

Returns "true" if successful; otherwise "false".

Type: xsd:boolean

Ancestor: ReleaseAddressResponseType

Children: None

Examples

Example Request

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

<ReleaseAddress xmlns="http://ec2.amazonaws.com/doc/2009-07-15/">
  <publicIp>67.202.55.255</publicIp>
</ReleaseAddress>

Example Response

<ReleaseAddressResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/">
  <return>true</return>
</ReleaseAddressResponse>
previous page start next page