documentation.help

ec2-describe-reserved-instances

From Amazon Elastic Compute Cloud: 2009-08-15

previous page next page

ec2-describe-reserved-instances

Description

Describes Reserved Instances that you purchased. For more information about Reserved Instances, go to the

Amazon Elastic Compute Cloud Developer Guide.

Syntax

ec2-describe-reserved-instances [reservation_id ...]

Options

Name Description Required

reservation_id

IDs of the Reserved Instance to describe.

Type: String

Default: None

Example: 4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8

No

Output

The command returns a table that contains the following information:

  • RESERVEDINSTANCES identifier

  • ID of the Reserved Instance

  • The instance type

  • The Availability Zone in which the Reserved Instance can be used

  • The duration of the Reserved Instance

  • The usage price of the Reserved Instance, per hour

  • The purchase price of the Reserved Instance

  • The number of Reserved Instance purchased

  • The Reserved Instance description

  • The state of the Reserved Instance purchase (pending-payment, active, payment-failed)

Amazon EC2 displays errors on stderr.

Examples

Example Request

This example describes Reserved Instances owned by the account.

PROMPT> ec2-describe-reserved-instances
RESERVEDINSTANCE 1ba8e2e3-2538-4a35-b749-1f4442d50744 us-east-1a m1.small  1y 0.00 0.00 19 2009-01-19T00:00:00+0000 active
af9f760e-c1c1-449b-8128-1342d3a6927d us-east-1a m1.xlarge 1y 0.00 0.00 3 2009-01-20T00:00:00+0000 active
previous page start next page