ec2-associate-address

Amazon Elastic Compute Cloud: 2009-04-04

previous page next page

ec2-associate-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.

Syntax

ec2-associate-address -i instance_id ip_address

Options

Name Description Required

instance_id

The instance to associate with the IP address.

Type: String

Default: None

Example: i-43a4412a

Yes

ip_address

IP address that you are assigning to the instance.

Type: String

Default: None

Example: 67.202.55.255

Yes

Output

The command 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.

Examples

Example Request

This example associates an IP address with an instance.

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

ec2-allocate-address

  • ec2-describe-addresses

  • ec2-release-address

  • ec2-disassociate-address

    • previous page start next page