Did this page help you? Yes No Tell us about it...

PurchaseReservedInstancesOffering

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.

Starting with the 2011-11-01 API version, AWS expanded its offering of Amazon EC2 Reserved Instances to address a range of projected instance use. There are three types of Reserved Instances based on customer utilization levels: Heavy Utilization, Medium Utilization, and Light Utilization. You determine the type of the Reserved Instances offerings by including the optional offeringType parameter when calling DescribeReservedInstancesOfferings. After you've identified the Reserved Instance with the offering type you want, specify its ReservedInstancesOfferingId when you call PurchaseReservedInstancesOffering.

The Medium Utilization offering type is equivalent to the Reserved Instance offering available before API version 2011-11-01. If you are using tools that predate the 2011-11-01 API version, DescribeReservedInstancesOfferings will only list information about the Medium Utilization Reserved Instance offering type.

For more information about Reserved Instances, go to Reserved Instances in the Amazon Elastic Compute Cloud User Guide.

Request Parameters

Name Description Required

Name	Description	Required
`ReservedInstancesOfferingId`	ID of the Reserved Instance offering you want to purchase. Type: String Default: None	Yes
`InstanceCount`	The number of Reserved Instances to purchase. Type: Integer Default: 1	No

ReservedInstancesOfferingId

ID of the Reserved Instance offering you want to purchase.

Type: String

Default: None

Yes

InstanceCount

The number of Reserved Instances to purchase.

Type: Integer

Default: 1

Response Elements

The elements in the following table are wrapped in a PurchaseReservedInstancesOfferingResponse structure.

Name Description

Name	Description
`requestId`	The ID of the request. Type: xsd:string
`reservedInstancesId`	The IDs of the purchased Reserved Instances. Type: xsd:string

requestId

The ID of the request.

Type: xsd:string

reservedInstancesId

The IDs of the purchased Reserved Instances.

Type: xsd:string

Examples

Example Request

This example illustrates a purchase of a Reserved Instances offering.

https://ec2.amazonaws.com/?Action=PurchaseReservedInstancesOffering
&ReservedInstancesOfferingId=4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8
&InstanceCount=2
&AUTHPARAMS

Example Response

<PurchaseReservedInstancesOfferingResponse xmlns="http://ec2.amazonaws.com/doc/2011-12-15/">
   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
   <reservedInstancesId>af9f760e-c1c1-449b-8128-1342d3a6927a</reservedInstancesId> 
</PurchaseReservedInstancesOfferingResponse>

Document Conventions
Terms of Use