Amazon Elastic Compute Cloud
API Reference (API Version 2011-12-15)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

DisassociateAddress

Description

Disassociates an Elastic IP address from the instance it's assigned to.

This action 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 Elastic IP Addresses in the Amazon Virtual Private Cloud User Guide.

This is an idempotent action. If you enter it more than once, Amazon EC2 does not return an error.

Request Parameters

NameDescriptionRequired

PublicIp

EC2 Elastic IP address you want to disassociate.

Type: String

Default: None

Condition: Required for EC2 Elastic IP addresses

Conditional

AssociationId

Association ID corresponding to the VPC Elastic IP address you want to disassociate.

Type: String

Default: None

Condition: Required for VPC Elastic IP addresses

Conditional

Response Elements

The elements in the following table are wrapped in a DisassociateAddressResponse structure.

NameDescription

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example disassociates the EC2 Elastic IP address 67.202.55.255 from the instance to which it is assigned.

https://ec2.amazonaws.com/?Action=DisassociateAddress
&PublicIp=192.0.2.1
&AUTHPARAMS

Example Request

This example disassociates the VPC Elastic IP address with association ID eipassoc-aa7486c3 from the VPC instance to which it is assigned.

https://ec2.amazonaws.com/?Action=DisassociateAddress
&AssociationID=eipassoc-aa7486c3
&AUTHPARAMS

Example Response

<DisassociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2011-12-15/">
  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
  <return>true</return>
</DisassociateAddressResponse>