AssociateAddress

Amazon Elastic Compute Cloud: 2008-02-01

previous page next page

AssociateAddress

The AssociateAddress operation 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

The following table describes the request parameters for AssociateAddress. Parameter names are case sensitive.

Name Description Required

Name	Description	Required
`instanceId`	The instance to which the IP address is assigned. Type: xsd:string	Yes
`publicIp`	IP address that you are assigning to the instance. Type: xsd:string	Yes

instanceId

The instance to which the IP address is assigned.

Type: xsd:string

Yes

publicIp

IP address that you are assigning to the instance.

Type: xsd:string

Yes

Response Elements

The following table describes the default response tags included in AssociateAddress responses.

Name Description

Name	Description
`return`	`true` if the IP address is associated with the instance. Otherwise, `false`. Type: xsd:boolean

return

true if the IP address is associated with the instance. Otherwise, false.

Type: xsd:boolean

Sample Request

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

Sample Response

<AssociateAddressResponse xmlns="http://ec2.amazonaws.com/doc/2008-02-01">
  <return>true</return>
</AssociateAddressResponse>

Related Operations

previous page start next page