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

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

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