ec2-associate-address

From Amazon Elastic Compute Cloud: 2008-12-01

previous page next page

ec2-associate-address

Syntax

ec2-associate-address -i instance_id ip_address

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.

Options

Option Description Required

Option	Description	Required
`instance_id`	The instance to which the IP address is assigned. Example: `i-43a4412a`	Yes
`ip_address`	The IP address that you are assigning to the instance. Example: `67.202.55.255`	Yes

instance_id

The instance to which the IP address is assigned.

Example: i-43a4412a

Yes

ip_address

The IP address that you are assigning to the instance.

Example: 67.202.55.255

Yes

Output

Amazon EC2 returns a table that contains the following information:

Output type identifier ("ADDRESS")
Elastic IP address that you are assigning to the instance
Instance to which the IP address is assigned

Amazon EC2 displays errors on stderr.

Example

This example assigns the 67.202.55.255 IP address to the i-43a4412a instance.

PROMPT> ec2-associate-address -i i-43a4412a 67.202.55.255 
ADDRESS 67.202.55.255   i-43a4412a

ec2-associate-address