PurchaseReservedInstancesOffering

Amazon Elastic Compute Cloud: 2009-04-04

previous page next page

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. For more information about Reserved Instances, go to the

Amazon Elastic Compute Cloud Developer Guide.

Request Parameters

Name Description Required

PurchaseReservedInstancesOffering

PurchaseReservedInstancesOffering element.

Type: PurchaseReservedInstancesOffering

Ancestor: None

Children: reservedInstancesOfferingId, instanceCount

reservedInstancesOfferingId

The offering ID of the Reserved Instance to purchase.

Type: xsd:string

Default: None

Ancestor: PurchaseReservedInstancesOffering

Children: None

Yes

instanceCount

The number of Reserved Instances to purchase.

Type: xsd:int

Default: 1

Ancestor: PurchaseReservedInstancesOffering

Children: None

No

Response Elements

Name Description

PurchaseReservedInstancesOfferingResponse

PurchaseReservedInstancesOfferingResponse element.

Type: PurchaseReservedInstancesOfferingResponse

Ancestor: None

Children: requestId, reservedInstancesId

requestId

The ID of the request.

Type: xsd:string

Ancestor: PurchaseReservedInstancesOfferingResponse

Children: None

reservedInstancesId

The IDs of the purchased Reserved Instances.

Type: xsd:string

Ancestor: PurchaseReservedInstancesOfferingResponse

Children: None

Examples

Example Request

This example purchases Reserved Instances.

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

Example Response

<PurchaseReservedInstancesOfferingResponse xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
   <reservedInstancesId>reservation-1001001</reservedInstancesId>
						</PurchaseReservedInstancesOfferingResponse>
previous page start next page