This section describes how to find and purchase available Amazon EC2 Reserved Instances.
How to Find and Purchase Reserved Instances
This section describes how to find and purchase Reserved Instances.
Procedure
To find and purchase a Reserved Instance
-
If you are using SOAP, construct the following request:
<DescribeReservedInstancesOfferings xmlns="http://ec2.amazonaws.com/doc/2009-08-15/"/>
-
If you are using Query, construct the following request:
https://ec2.amazonaws.com/ ?Action=DescribeReservedInstancesOfferings &...auth parameters...
-
View output similar to the following:
<DescribeReservedInstancesOfferings xmlns="http://ec2.amazonaws.com/doc/2009-08-15//"> <reservedInstancesOfferingsSet> <item> <reservedInstancesOfferingId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesOfferingId> <instanceType>m1.small</instanceType> <availabilityZone>us-east-1a</availabilityZone> <duration>12</duration> <fixedPrice>0.00</fixedPrice> <usagePrice>0.00</usagePrice> <productDescription>m1.small offering in us-east-1a</productDescription> </item> </reservedInstancesOfferingsSet> </DescribeReservedInstancesOfferings>
-
To purchase a Reserved Instance using SOAP, construct a request similar to the following:
<PurchaseReservedInstancesOffering xmlns="http://ec2.amazonaws.com/doc/2009-08-15/"> <reservedInstancesOfferingId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesOfferingId> <instanceCount>19</instanceCount> </PurchaseReservedInstancesOffering>
-
To purchase a Reserved Instance using Query, construct a request similar to the following:
https://ec2.amazonaws.com/ ?Action=PurchaseReservedInstancesOffering &OfferingId.1=offering-12345678&instanceCount.1=2 &...auth parameters...
-
View output similar to the following:
<PurchaseReservedInstancesOffering xmlns="http://ec2.amazonaws.com/doc/2009-08-15/"> <reservedInstancesId>reservation-1001001</reservedInstancesId> </PurchaseReservedInstancesOffering>
-
To verify the purchase using SOAP, construct the following request:
<DescribeReservedInstances xmlns="http://ec2.amazonaws.com/doc/2009-08-15/"/>
-
To verify the purchase using Query, construct the following request:
https://ec2.amazonaws.com/ ?Action=DescribeReservedInstances &...auth parameters...
-
View output similar to the following:
<DescribeReservedInstances xmlns="http://ec2.amazonaws.com/doc/2009-08-15//"> <reservedInstancesSet> <item> <reservedInstancesId>4b2293b4-5813-4cc8-9ce3-1957fc1dcfc8</reservedInstancesId> <instanceType>m1.small</instanceType> <availabilityZone>us-east-1a</availabilityZone> <duration>12</duration> <usagePrice>0.00</usagePrice> <fixedPrice>0.00</fixedPrice> <instanceCount>19</instanceCount> <productDescription>m1.small offering in us-east-1a</productDescription> <state>Active</state> </item> </reservedInstancesSet> </DescribeReservedInstances>