ec2-purchase-reserved-instances-offering

From Amazon Elastic Compute Cloud: 2009-03-01

previous page next page

ec2-purchase-reserved-instances-offering

Syntax

ec2-purchase-reserved-instances-offering --offering offering --instance-count count

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

Reserving Amazon EC2 Instances for Long-Term Use.

Options

Option Description Required

Option	Description	Required
`--offering` `offering`	The ID of the offering. Example: `4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8`	Yes
`--instance-count` `count`	The number of Reserved Instances to purchase. Example: `19`	Yes

--offering offering

The ID of the offering.

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

Yes

--instance-count count

The number of Reserved Instances to purchase.

Example: 19

Yes

Output

Amazon EC2 returns a table that contains the following information:

RESERVEDINSTANCES identifier
The ID(s) of the purchased Reserved Instances

Amazon EC2 displays errors on stderr.

Example

This example purchases Reserved Instances.

PROMPT> ec2-purchase-reserved-instances-offering --offering 4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8 --instance-count 3
RESERVEDINSTANCES b847fa93-0c31-405b-b745-b6bf00032333 b847fa93-0c31-405b-b745-b6bf00032334 b847fa93-0c31-405b-b745-b6bf00032335

ec2-purchase-reserved-instances-offering