PurchaseReservedInstancesOffering

Amazon Elastic Compute Cloud: 2009-03-01

previous page next page

PurchaseReservedInstancesOffering

The PurchaseReservedInstancesOffering operation 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.

[Note] Note

Amazon EC2 Reserved Instances are based on instance type and location (region and Availability Zone) for a specified period of time. Before purchasing a Reserved Instance, make sure it meets your requirements.

For more information about Reserved Instances, see Reserving Amazon EC2 Instances for Long-Term Use.

Request Parameters

The following table describes the request parameters for PurchaseReservedInstancesOffering. Parameter names are case sensitive.

Name Description Required

reservedInstancesOfferingId

The offering ID of the Reserved Instance to purchase.

Type: xsd:string[]

Default: none

Valid Values: Valid offering IDs.

Constraints: none

Yes

instanceCount

The number of Reserved Instances to purchase.

Type: xsd:int

Default: 1

Constraints: Any valid positive integer

No

Response Elements

The following table describes the default response tags included in PurchaseReservedInstancesOffering responses.

Name Description

reservedInstancesId

The IDs of the purchased Reserved Instances.

Type: xsd:string

Sample Request

<PurchaseReservedInstancesOffering xmlns="http://ec2.amazonaws.com/doc/2009-03-01/">
   <reservedInstancesOfferingId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesOfferingId>
   <instanceCount>19</instanceCount>
<PurchaseReservedInstancesOffering/>

Sample Response

<PurchaseReservedInstancesOfferingResponse xmlns="http://ec2.amazonaws.com/doc/2009-03-01/">
   <reservedInstancesId>reservation-1001001</reservedInstancesId>
</PurchaseReservedInstancesOfferingResponse>

Related Operations

previous page start next page