/AWS1/CL_EC2=>PURCHASEHOSTRESERVATION()¶
About PurchaseHostReservation¶
Purchase a reservation with configurations that match those of your Dedicated Host. You must have active Dedicated Hosts in your account before you purchase a reservation. This action results in the specified reservation being purchased and charged to your account.
Method Signature¶
IMPORTING¶
Required arguments:¶
IT_HOSTIDSET TYPE /AWS1/CL_EC2REQUESTHOSTIDSET_W=>TT_REQUESTHOSTIDSET TT_REQUESTHOSTIDSET¶
The IDs of the Dedicated Hosts with which the reservation will be associated.
IV_OFFERINGID TYPE /AWS1/EC2OFFERINGID /AWS1/EC2OFFERINGID¶
The ID of the offering.
Optional arguments:¶
IV_CLIENTTOKEN TYPE /AWS1/EC2STRING /AWS1/EC2STRING¶
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensuring Idempotency.
IV_CURRENCYCODE TYPE /AWS1/EC2CURRENCYCODEVALUES /AWS1/EC2CURRENCYCODEVALUES¶
The currency in which the
totalUpfrontPrice,LimitPrice, andtotalHourlyPriceamounts are specified. At this time, the only supported currency isUSD.
IV_LIMITPRICE TYPE /AWS1/EC2STRING /AWS1/EC2STRING¶
The specified limit is checked against the total upfront cost of the reservation (calculated as the offering's upfront cost multiplied by the host count). If the total upfront cost is greater than the specified price limit, the request fails. This is used to ensure that the purchase does not exceed the expected upfront cost of the purchase. At this time, the only supported currency is
USD. For example, to indicate a limit price of USD 100, specify 100.00.
IT_TAGSPECIFICATIONS TYPE /AWS1/CL_EC2TAGSPECIFICATION=>TT_TAGSPECIFICATIONLIST TT_TAGSPECIFICATIONLIST¶
The tags to apply to the Dedicated Host Reservation during purchase.