Skip to content

/AWS1/IF_LMD=>LISTDURABLEEXECSBYFUNCTION()

About ListDurableExecutionsByFunction

Returns a list of durable executions for a specified Lambda function. You can filter the results by execution name, status, and start time range. This API supports pagination for large result sets.

Method Signature

METHODS /AWS1/IF_LMD~LISTDURABLEEXECSBYFUNCTION
  IMPORTING
    !IV_FUNCTIONNAME TYPE /AWS1/LMDNAMESPACEDFUNCNAME OPTIONAL
    !IV_QUALIFIER TYPE /AWS1/LMDNUMERICLATPUBEDORAL00 OPTIONAL
    !IV_DURABLEEXECUTIONNAME TYPE /AWS1/LMDDURABLEEXECUTIONNAME OPTIONAL
    !IT_STATUSES TYPE /AWS1/CL_LMDEXECSTATUSLIST_W=>TT_EXECUTIONSTATUSLIST OPTIONAL
    !IV_STARTEDAFTER TYPE /AWS1/LMDEXECUTIONTIMESTAMP OPTIONAL
    !IV_STARTEDBEFORE TYPE /AWS1/LMDEXECUTIONTIMESTAMP OPTIONAL
    !IV_REVERSEORDER TYPE /AWS1/LMDREVERSEORDER OPTIONAL
    !IV_MARKER TYPE /AWS1/LMDSTRING OPTIONAL
    !IV_MAXITEMS TYPE /AWS1/LMDITEMCOUNT OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_lmdlstdurableexsbyf01
  RAISING
    /AWS1/CX_LMDINVPARAMVALUEEX
    /AWS1/CX_LMDRESOURCENOTFOUNDEX
    /AWS1/CX_LMDSERVICEEXCEPTION
    /AWS1/CX_LMDTOOMANYREQUESTSEX
    /AWS1/CX_LMDCLIENTEXC
    /AWS1/CX_LMDSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING

Required arguments:

iv_functionname TYPE /AWS1/LMDNAMESPACEDFUNCNAME /AWS1/LMDNAMESPACEDFUNCNAME

The name or ARN of the Lambda function. You can specify a function name, a partial ARN, or a full ARN.

Optional arguments:

iv_qualifier TYPE /AWS1/LMDNUMERICLATPUBEDORAL00 /AWS1/LMDNUMERICLATPUBEDORAL00

The function version or alias. If not specified, lists executions for the $LATEST version.

iv_durableexecutionname TYPE /AWS1/LMDDURABLEEXECUTIONNAME /AWS1/LMDDURABLEEXECUTIONNAME

Filter executions by name. Only executions with names that contain this string are returned.

it_statuses TYPE /AWS1/CL_LMDEXECSTATUSLIST_W=>TT_EXECUTIONSTATUSLIST TT_EXECUTIONSTATUSLIST

Filter executions by status. Valid values: RUNNING, SUCCEEDED, FAILED, TIMED_OUT, STOPPED.

iv_startedafter TYPE /AWS1/LMDEXECUTIONTIMESTAMP /AWS1/LMDEXECUTIONTIMESTAMP

Filter executions that started after this timestamp (ISO 8601 format).

iv_startedbefore TYPE /AWS1/LMDEXECUTIONTIMESTAMP /AWS1/LMDEXECUTIONTIMESTAMP

Filter executions that started before this timestamp (ISO 8601 format).

iv_reverseorder TYPE /AWS1/LMDREVERSEORDER /AWS1/LMDREVERSEORDER

Set to true to return results in reverse chronological order (newest first). Default is false.

iv_marker TYPE /AWS1/LMDSTRING /AWS1/LMDSTRING

Pagination token from a previous request to continue retrieving results.

iv_maxitems TYPE /AWS1/LMDITEMCOUNT /AWS1/LMDITEMCOUNT

Maximum number of executions to return (1-1000). Default is 100.

RETURNING

oo_output TYPE REF TO /aws1/cl_lmdlstdurableexsbyf01 /AWS1/CL_LMDLSTDURABLEEXSBYF01

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->listdurableexecsbyfunction(
  it_statuses = VALUE /aws1/cl_lmdexecstatuslist_w=>tt_executionstatuslist(
    ( new /aws1/cl_lmdexecstatuslist_w( |string| ) )
  )
  iv_durableexecutionname = |string|
  iv_functionname = |string|
  iv_marker = |string|
  iv_maxitems = 123
  iv_qualifier = |string|
  iv_reverseorder = ABAP_TRUE
  iv_startedafter = '20150101000000.0000000'
  iv_startedbefore = '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_durableexecutions( ) into lo_row.
    lo_row_1 = lo_row.
    IF lo_row_1 IS NOT INITIAL.
      lv_durableexecutionarn = lo_row_1->get_durableexecutionarn( ).
      lv_durableexecutionname = lo_row_1->get_durableexecutionname( ).
      lv_namespacedfunctionarn = lo_row_1->get_functionarn( ).
      lv_executionstatus = lo_row_1->get_status( ).
      lv_executiontimestamp = lo_row_1->get_starttimestamp( ).
      lv_executiontimestamp = lo_row_1->get_endtimestamp( ).
    ENDIF.
  ENDLOOP.
  lv_string = lo_result->get_nextmarker( ).
ENDIF.