ec2-describe-instances

From Amazon Elastic Compute Cloud: 2007-08-29

previous page next page

ec2-describe-instances

Syntax

ec2-describe-instances [instance_id ...]

Description

Describes the current state of the specifeid instance(s). If you do not specify instances, all your instances are included in the output.

Options

Option Description Required

Option	Description	Required
`instance_id`	Instance identifier that was generated when the instance launched. Example: `r-15a4417c`	No

instance_id

Instance identifier that was generated when the instance launched.

Example: r-15a4417c

Output

Amazon EC2 returns a table that contains the following information:

Output type identifier ("RESERVATION", "INSTANCE")
Instance ID for each running instance.
AMI ID of the image on which the the instance is based.
Public DNS name associated with the instance. This is only present for instances in the running state.
Private DNS name associated with the instance. This is only present for instances in the running state, but is not valid for instances using legacy direct addressing.
Instance state.
Key name. If a key was associated with the instance at launch, its name will appear.
AMI launch index. For more information, see Instance Metadata.
Product codes attached to the instance.
Instance type. The type of the instance (e.g., m1.small, m1.large, m1.xlarge).
Instance launch time. The time the instance launched.

Amazon EC2 displays errors on stderr.

Example

This example describes the current state of the instances (currently one) owned by this user:

$ ec2-describe-instances
RESERVATION r-15a4417c 495219933132 
INSTANCE i-3ea74257 ami-6ba54002 ec2-72-44-33-4.compute-1.amazonaws.com domU-12-31-33-00-00-01.compute-1.internal running 0 774F4FF8 m1.small 2007-07-11T16:40:44+0000
INSTANCE i-31a74258 ami-6ba54002 ec2-72-44-34-23.compute-1.amazonaws.com domU-12-31-33-00-00-02.compute-1.internal running 1 m1.small 2007-07-11T16:40:44+0000

ec2-describe-instances