amazonka-ec2-1.3.0: Amazon Elastic Compute Cloud SDK.

Copyright(c) 2013-2015 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <>
Portabilitynon-portable (GHC extensions)
Safe HaskellNone




Purchases a Reserved Instance for use with your account. With Amazon EC2 Reserved Instances, you obtain a capacity reservation for a certain instance configuration over a specified period of time and pay a lower hourly rate compared to on-Demand Instance pricing.

Use DescribeReservedInstancesOfferings to get a list of Reserved Instance offerings that match your specifications. After you've purchased a Reserved Instance, you can check for your new Reserved Instance with DescribeReservedInstances.

For more information, see Reserved Instances and Reserved Instance Marketplace in the Amazon Elastic Compute Cloud User Guide.

See: AWS API Reference for PurchaseReservedInstancesOffering.


Creating a Request

purchaseReservedInstancesOffering Source

Creates a value of PurchaseReservedInstancesOffering with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Request Lenses

prioLimitPrice :: Lens' PurchaseReservedInstancesOffering (Maybe ReservedInstanceLimitPrice) Source

Specified for Reserved Instance Marketplace offerings to limit the total order and ensure that the Reserved Instances are not purchased at unexpected prices.

prioDryRun :: Lens' PurchaseReservedInstancesOffering (Maybe Bool) Source

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

prioReservedInstancesOfferingId :: Lens' PurchaseReservedInstancesOffering Text Source

The ID of the Reserved Instance offering to purchase.

prioInstanceCount :: Lens' PurchaseReservedInstancesOffering Int Source

The number of Reserved Instances to purchase.

Destructuring the Response

purchaseReservedInstancesOfferingResponse Source

Creates a value of PurchaseReservedInstancesOfferingResponse with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

Response Lenses