documentation.help

ec2-describe-reserved-instances-offerings

From Amazon Elastic Compute Cloud: 2009-08-15

previous page next page

ec2-describe-reserved-instances-offerings

Description

Describes Reserved Instance offerings that are available for purchase. With Amazon EC2 Reserved Instances, you purchase the right to launch Amazon EC2 instances for a period of time (without getting insufficient capacity errors) and pay a lower usage rate for the actual time used. For more information about Reserved Instances, go to the

Amazon Elastic Compute Cloud Developer Guide.

Syntax

ec2-describe-reserved-instances-offerings [offering_id ...] [--typeinstance_type ...] [--availability-zonezone ...] [--descriptiondescription ...]

Options

Name Description Required

--type instance_type

The instance type on which the Reserved Instance can be used.

Type: String

Default: None

Example: m1.small

No

--availability-zone zone

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

Type: String

Default: None

Example: us-east-1a

No

--description description

The Reserved Instance description.

Type: String

Default: None

Example: m1.small offering in us-east-1a

No

Output

The command returns a table that contains the following information:

  • OFFERING identifier

  • ID of the offer

  • The instance type

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

  • The duration of the Reserved Instance

  • The purchase price of the Reserved Instance

  • The usage price of the Reserved Instance, per hour

  • The Reserved Instance description

Amazon EC2 displays errors on stderr.

Examples

Example Request

This example describes available Reserved Instance offerings.

PROMPT> ec2-describe-reserved-instances-offerings
OFFERING 4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8 m1.small us-east-1a 1y 0.00 0.00 Linux/UNIX
previous page start next page