ec2-describe-instances

From Amazon Elastic Compute Cloud: 2008-05-05

previous page next page

ec2-describe-instances

Syntax

ec2-describe-instances [instance_id|availability-zone ...]

Description

Describes the current state of the specified 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
`availability-zone`	Returns instances within the specified availability zone. Example: `us-east-1a`	No

instance_id

Instance identifier that was generated when the instance launched.

Example: r-15a4417c

availability-zone

Returns instances within the specified availability zone.

Example: us-east-1a

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 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
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. For more information, see Instance Types

Instance launch time. The time the instance launched

Availability zone. The availability zone in which the instance is located

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 10-251-50-154.ec2.internal running 0 774F4FF8 m1.small 2007-07-11T16:40:44+0000   aki-ba3adfd3   ari-badbad00   us-east-1a
INSTANCE i-31a74258 ami-6ba54002 ec2-72-44-34-23.compute-1.amazonaws.com 10-251-50-156.ec2.internal running 1 m1.small 2007-07-11T16:40:44+0000   aki-ba3adfd3   ari-badbad00   us-east-1a

ec2-describe-instances