documentation.help

ec2-purchase-reserved-instance-offering

From Amazon Elastic Compute Cloud: 2009-08-15

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.

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