AssociateAddress

Amazon Elastic Compute Cloud: 2009-04-04

previous page next page

AssociateAddress

Description

Associates an elastic IP address with an instance. If the IP address is currently assigned to another instance, the IP address is assigned to the new instance. This is an idempotent operation. If you enter it more than once, Amazon EC2 does not return an error.

Request Parameters

NameDescriptionRequired

AssociateAddress

AssociateAddress element.

Type:

AssociateAddress

Ancestor: None

Children: instanceId, publicIp

instanceId

The instance to associate with the IP address.

Type: xsd:string

Default: None

Ancestor: AssociateAddress

Children: None

Yes

publicIp

IP address that you are assigning to the instance.

Type: xsd:string

Default: None

Ancestor: AssociateAddress

Children: None

Yes

Response Elements

Name Description

AssociateAddressResponse

AssociateAddressResponse element.

Type: AssociateAddressResponse

Ancestor: None

Children: requestId, publicIp, and return

requestId

The ID of the request.

Type: xsd:string

Ancestor: AssociateAddressResponse

Children: None

publicIp

IP address.

Type: xsd:string

Ancestor: AssociateAddressResponse

Children: None

return

Returns

Type: xsd:boolean

Ancestor: AssociateAddressResponse

Children: None

Examples

Example Request

This example associates an IP address with an instance.

<AssociateAddress xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
  <instanceId>i-28a64341</instanceId>
  <publicIp>67.202.55.255</publicIp>
</AssociateAddress>

Example Response

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