Prev Documentation Feedback Next
Welcome » API Command Line Tools Reference » ec2-describe-reserved-instances-offerings

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 or Amazon Elastic Compute Cloud User Guide.

Syntax

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

Options

NameDescriptionRequired

--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

Constraints: 255 characters

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
Prev Copyright Information Next
 Home