ec2-purchase-reserved-instance-offering

Amazon Elastic Compute Cloud: 2009-10-31

previous page next page

ec2-purchase-reserved-instance-offering

Description

Purchases a Reserved Instance for use with your account. 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-purchase-reserved-instance-offering --offering offering--instance-count count

Options

Name Description Required

offering

The offering ID of the Reserved Instance to purchase.

Type: String

Default: None

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

Yes

count

The number of Reserved Instances to purchase.

Type: Integer

Default: 1

Example: 5

No

Output

The command returns a table that contains the following information:

  • RESERVEDINSTANCES identifier

  • The ID(s) of the purchased Reserved Instances

Amazon EC2 displays errors on stderr.

Examples

Example Request

This example purchases Reserved Instances.

PROMPT> ec2-purchase-reserved-instance-offering --offering offering-12345678 --instance-count 3
RESERVEDINSTANCES b847fa93-0c31-405b-b745-b6bf00032333 b847fa93-0c31-405b-b745-b6bf00032334 b847fa93-0c31-405b-b745-b6bf00032335
previous page start next page