Skip to content

Get Durable Execution History

lambda_get_durable_execution_history R Documentation

Retrieves the execution history for a durable execution, showing all the steps, callbacks, and events that occurred during the execution

Description

Retrieves the execution history for a durable execution, showing all the steps, callbacks, and events that occurred during the execution. This provides a detailed audit trail of the execution's progress over time.

The history is available while the execution is running and for a retention period after it completes (1-90 days, default 30 days). You can control whether to include execution data such as step results and callback payloads.

Usage

lambda_get_durable_execution_history(DurableExecutionArn,
  IncludeExecutionData, MaxItems, Marker, ReverseOrder)

Arguments

DurableExecutionArn

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

IncludeExecutionData

Specifies whether to include execution data such as step results and callback payloads in the history events. Set to true to include data, or false to exclude it for a more compact response. The default is true.

MaxItems

The maximum number of history events 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.

Marker

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

ReverseOrder

When set to true, returns the history events in reverse chronological order (newest first). By default, events are returned in chronological order (oldest first).

Value

A list with the following syntax:

list(
  Events = list(
    list(
      EventType = "ExecutionStarted"|"ExecutionSucceeded"|"ExecutionFailed"|"ExecutionTimedOut"|"ExecutionStopped"|"ContextStarted"|"ContextSucceeded"|"ContextFailed"|"WaitStarted"|"WaitSucceeded"|"WaitCancelled"|"StepStarted"|"StepSucceeded"|"StepFailed"|"ChainedInvokeStarted"|"ChainedInvokeSucceeded"|"ChainedInvokeFailed"|"ChainedInvokeTimedOut"|"ChainedInvokeStopped"|"CallbackStarted"|"CallbackSucceeded"|"CallbackFailed"|"CallbackTimedOut"|"InvocationCompleted",
      SubType = "string",
      EventId = 123,
      Id = "string",
      Name = "string",
      EventTimestamp = as.POSIXct(
        "2015-01-01"
      ),
      ParentId = "string",
      ExecutionStartedDetails = list(
        Input = list(
          Payload = "string",
          Truncated = TRUE|FALSE
        ),
        ExecutionTimeout = 123
      ),
      ExecutionSucceededDetails = list(
        Result = list(
          Payload = "string",
          Truncated = TRUE|FALSE
        )
      ),
      ExecutionFailedDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      ExecutionTimedOutDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      ExecutionStoppedDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      ContextStartedDetails = list(),
      ContextSucceededDetails = list(
        Result = list(
          Payload = "string",
          Truncated = TRUE|FALSE
        )
      ),
      ContextFailedDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      WaitStartedDetails = list(
        Duration = 123,
        ScheduledEndTimestamp = as.POSIXct(
          "2015-01-01"
        )
      ),
      WaitSucceededDetails = list(
        Duration = 123
      ),
      WaitCancelledDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      StepStartedDetails = list(),
      StepSucceededDetails = list(
        Result = list(
          Payload = "string",
          Truncated = TRUE|FALSE
        ),
        RetryDetails = list(
          CurrentAttempt = 123,
          NextAttemptDelaySeconds = 123
        )
      ),
      StepFailedDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        ),
        RetryDetails = list(
          CurrentAttempt = 123,
          NextAttemptDelaySeconds = 123
        )
      ),
      ChainedInvokeStartedDetails = list(
        FunctionName = "string",
        TenantId = "string",
        Input = list(
          Payload = "string",
          Truncated = TRUE|FALSE
        ),
        ExecutedVersion = "string",
        DurableExecutionArn = "string"
      ),
      ChainedInvokeSucceededDetails = list(
        Result = list(
          Payload = "string",
          Truncated = TRUE|FALSE
        )
      ),
      ChainedInvokeFailedDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      ChainedInvokeTimedOutDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      ChainedInvokeStoppedDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      CallbackStartedDetails = list(
        CallbackId = "string",
        HeartbeatTimeout = 123,
        Timeout = 123
      ),
      CallbackSucceededDetails = list(
        Result = list(
          Payload = "string",
          Truncated = TRUE|FALSE
        )
      ),
      CallbackFailedDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      CallbackTimedOutDetails = list(
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      ),
      InvocationCompletedDetails = list(
        StartTimestamp = as.POSIXct(
          "2015-01-01"
        ),
        EndTimestamp = as.POSIXct(
          "2015-01-01"
        ),
        RequestId = "string",
        Error = list(
          Payload = list(
            ErrorMessage = "string",
            ErrorType = "string",
            ErrorData = "string",
            StackTrace = list(
              "string"
            )
          ),
          Truncated = TRUE|FALSE
        )
      )
    )
  ),
  NextMarker = "string"
)

Request syntax

svc$get_durable_execution_history(
  DurableExecutionArn = "string",
  IncludeExecutionData = TRUE|FALSE,
  MaxItems = 123,
  Marker = "string",
  ReverseOrder = TRUE|FALSE
)