Get Durable Execution State

lambda_get_durable_execution_state

R Documentation

Retrieves the current execution state required for the replay process during durable function execution¶

Description¶

Retrieves the current execution state required for the replay process during durable function execution. This API is used by the Lambda durable functions SDK to get state information needed for replay. You typically don't need to call this API directly as the SDK handles state management automatically.

The response contains operations ordered by start sequence number in ascending order. Completed operations with children don't include child operation details since they don't need to be replayed.

Usage¶

lambda_get_durable_execution_state(DurableExecutionArn, CheckpointToken,
  Marker, MaxItems)

Arguments¶

DurableExecutionArn

[required] The Amazon Resource Name (ARN) of the durable execution.

CheckpointToken

[required] A checkpoint token that identifies the current state of the execution. This token is provided by the Lambda runtime and ensures that state retrieval is consistent with the current execution context.

Marker

If NextMarker was returned from a previous request, use this value to retrieve the next page of operations. Each pagination token expires after 24 hours.

MaxItems

The maximum number of operations to return per call. You can use Marker to retrieve additional pages of results. The default is 100 and the maximum allowed is 1000. A value of 0 uses the default.

Value¶

A list with the following syntax:

list(
  Operations = list(
    list(
      Id = "string",
      ParentId = "string",
      Name = "string",
      Type = "EXECUTION"|"CONTEXT"|"STEP"|"WAIT"|"CALLBACK"|"CHAINED_INVOKE",
      SubType = "string",
      StartTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      EndTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      Status = "STARTED"|"PENDING"|"READY"|"SUCCEEDED"|"FAILED"|"CANCELLED"|"TIMED_OUT"|"STOPPED",
      ExecutionDetails = list(
        InputPayload = "string"
      ),
      ContextDetails = list(
        ReplayChildren = TRUE|FALSE,
        Result = "string",
        Error = list(
          ErrorMessage = "string",
          ErrorType = "string",
          ErrorData = "string",
          StackTrace = list(
            "string"
          )
        )
      ),
      StepDetails = list(
        Attempt = 123,
        NextAttemptTimestamp = as.POSIXct(
          "2015-01-01"
        ),
        Result = "string",
        Error = list(
          ErrorMessage = "string",
          ErrorType = "string",
          ErrorData = "string",
          StackTrace = list(
            "string"
          )
        )
      ),
      WaitDetails = list(
        ScheduledEndTimestamp = as.POSIXct(
          "2015-01-01"
        )
      ),
      CallbackDetails = list(
        CallbackId = "string",
        Result = "string",
        Error = list(
          ErrorMessage = "string",
          ErrorType = "string",
          ErrorData = "string",
          StackTrace = list(
            "string"
          )
        )
      ),
      ChainedInvokeDetails = list(
        Result = "string",
        Error = list(
          ErrorMessage = "string",
          ErrorType = "string",
          ErrorData = "string",
          StackTrace = list(
            "string"
          )
        )
      )
    )
  ),
  NextMarker = "string"
)

Request syntax¶

svc$get_durable_execution_state(
  DurableExecutionArn = "string",
  CheckpointToken = "string",
  Marker = "string",
  MaxItems = 123
)