DESCRSPOTFLEETREQUESTHISTORY()`¶

About DescribeSpotFleetRequestHistory¶

Describes the events for the specified Spot Fleet request during the specified time.

Spot Fleet events are delayed by up to 30 seconds before they can be described. This ensures that you can query by the last evaluated time and not miss a recorded event. Spot Fleet events are available for 48 hours.

For more information, see Monitor fleet events using Amazon EventBridge in the Amazon EC2 User Guide.

Method Signature¶

IMPORTING¶

Required arguments:¶

`iv_spotfleetrequestid` `TYPE /AWS1/EC2SPOTFLEETREQUESTID` `/AWS1/EC2SPOTFLEETREQUESTID`¶

The ID of the Spot Fleet request.

`iv_starttime` `TYPE /AWS1/EC2DATETIME` `/AWS1/EC2DATETIME`¶

The starting date and time for the events, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

Optional arguments:¶

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

`iv_eventtype` `TYPE /AWS1/EC2EVENTTYPE` `/AWS1/EC2EVENTTYPE`¶

The type of events to describe. By default, all events are described.

`iv_nexttoken` `TYPE /AWS1/EC2STRING` `/AWS1/EC2STRING`¶

The token to include in another request to get the next page of items. This value is null when there are no more items to return.

`iv_maxresults` `TYPE /AWS1/EC2DSCSPOTFLEETREQHIST00` `/AWS1/EC2DSCSPOTFLEETREQHIST00`¶

The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_ec2dscspotfleetreqh01` `/AWS1/CL_EC2DSCSPOTFLEETREQH01`¶

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->/aws1/if_ec2~descrspotfleetrequesthistory(
  iv_dryrun = ABAP_TRUE
  iv_eventtype = |string|
  iv_maxresults = 123
  iv_nexttoken = |string|
  iv_spotfleetrequestid = |string|
  iv_starttime = '20150101000000.0000000'
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
  LOOP AT lo_result->get_historyrecords( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lo_eventinformation = lo_row_1->get_eventinformation( ).
      IF lo_eventinformation IS NOT INITIAL.
        lv_string = lo_eventinformation->get_eventdescription( ).
        lv_string = lo_eventinformation->get_eventsubtype( ).
        lv_string = lo_eventinformation->get_instanceid( ).
      ENDIF.
      lv_eventtype = lo_row_1->get_eventtype( ).
      lv_datetime = lo_row_1->get_timestamp( ).
    ENDIF.
  ENDLOOP.
  lv_datetime = lo_result->get_lastevaluatedtime( ).
  lv_string = lo_result->get_nexttoken( ).
  lv_string = lo_result->get_spotfleetrequestid( ).
  lv_datetime = lo_result->get_starttime( ).
ENDIF.

To describe Spot fleet history¶

This example returns the history for the specified Spot fleet starting at the specified time.

DATA(lo_result) = lo_client->/aws1/if_ec2~descrspotfleetrequesthistory(
  iv_spotfleetrequestid = |sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE|
  iv_starttime = '20150526000000.0000000'
).

/AWS1/CL_EC2=>DESCRSPOTFLEETREQUESTHISTORY()¶