/AWS1/CL_EC2=>PURCHASERSVDINSTSOFFERING()

About PurchaseReservedInstancesOffering

Purchases a Reserved Instance for use with your account. With Reserved Instances, you 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.

To queue a purchase for a future date and time, specify a purchase time. If you do not specify a purchase time, the default is the current time.

For more information, see Reserved Instances and Sell in the Reserved Instance Marketplace in the Amazon EC2 User Guide.

Method Signature

IMPORTING

Required arguments:

IV_INSTANCECOUNT TYPE /AWS1/EC2INTEGER /AWS1/EC2INTEGER

The number of Reserved Instances to purchase.

IV_RESERVEDINSTSOFFERINGID TYPE /AWS1/EC2RSVDINSTSOFFERINGID /AWS1/EC2RSVDINSTSOFFERINGID

The ID of the Reserved Instance offering to purchase.

Optional arguments:

IV_PURCHASETIME TYPE /AWS1/EC2DATETIME /AWS1/EC2DATETIME

The time at which to purchase the Reserved Instance, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

IV_DRYRUN TYPE /AWS1/EC2BOOLEAN /AWS1/EC2BOOLEAN

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.

IO_LIMITPRICE TYPE REF TO /AWS1/CL_EC2RSVDINSTLIMITPRICE /AWS1/CL_EC2RSVDINSTLIMITPRICE

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

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_EC2PURCHASERSVDINST01 /AWS1/CL_EC2PURCHASERSVDINST01