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¶

METHODS /AWS1/IF_EC2~PURCHASERSVDINSTSOFFERING
  IMPORTING
    !IV_INSTANCECOUNT TYPE /AWS1/EC2INTEGER OPTIONAL
    !IV_RESERVEDINSTSOFFERINGID TYPE /AWS1/EC2RSVDINSTSOFFERINGID OPTIONAL
    !IV_PURCHASETIME TYPE /AWS1/EC2DATETIME OPTIONAL
    !IV_DRYRUN TYPE /AWS1/EC2BOOLEAN OPTIONAL
    !IO_LIMITPRICE TYPE REF TO /AWS1/CL_EC2RSVDINSTLIMITPRICE OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_ec2purchasersvdinst01
  RAISING
    /AWS1/CX_EC2CLIENTEXC
    /AWS1/CX_EC2SERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

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`¶

Domain /AWS1/RT_ACCOUNT_ID

Primitive Type NUMC

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->purchasersvdinstsoffering(
  io_limitprice = new /aws1/cl_ec2rsvdinstlimitprice(
    iv_amount = '0.1'
    iv_currencycode = |string|
  )
  iv_dryrun = ABAP_TRUE
  iv_instancecount = 123
  iv_purchasetime = '20150101000000.0000000'
  iv_reservedinstsofferingid = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  lv_string = lo_result->get_reservedinstancesid( ).
ENDIF.

/AWS1/IF_EC2=>PURCHASERSVDINSTSOFFERING()¶