AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Restarts unsuccessful executions of Standard workflows that didn't complete successfully in the last 14 days. These include failed, aborted, or timed out executions. When you redrive an execution, it continues the failed execution from the unsuccessful step and uses the same input. Step Functions preserves the results and execution history of the successful steps, and doesn't rerun these steps when you redrive an execution. Redriven executions use the same state machine definition and execution ARN as the original execution attempt.
For workflows that include an Inline
Map or Parallel
state, RedriveExecution API action reschedules and redrives only the iterations
and branches that failed or aborted.
To redrive a workflow that includes a Distributed Map state whose Map Run failed, you must redrive the parent workflow. The parent workflow redrives all the unsuccessful states, including a failed Map Run. If a Map Run was not started in the original execution attempt, the redriven parent workflow starts the Map Run.
This API action is not supported by EXPRESS state machines.
However, you can restart the unsuccessful executions of Express child workflows in a Distributed Map by redriving its Map Run. When you redrive a Map Run, the Express child workflows are rerun using the StartExecution API action. For more information, see Redriving Map Runs.
You can redrive executions if your original execution meets the following conditions:
The execution status isn't SUCCEEDED.
Your workflow execution has not exceeded the redrivable period of 14 days. Redrivable period refers to the time during which you can redrive a given execution. This period starts from the day a state machine completes its execution.
The workflow execution has not exceeded the maximum open time of one year. For more information about state machine quotas, see Quotas related to state machine executions.
The execution event history count is less than 24,999. Redriven executions append
their event history to the existing event history. Make sure your workflow execution
contains less than 24,999 events to accommodate the ExecutionRedriven history
event and at least one other history event.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginRedriveExecution and EndRedriveExecution.
Namespace: Amazon.StepFunctions
Assembly: AWSSDK.StepFunctions.dll
Version: 3.x.y.z
public virtual Task<RedriveExecutionResponse> RedriveExecutionAsync( RedriveExecutionRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the RedriveExecution service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| ExecutionDoesNotExistException | The specified execution does not exist. |
| ExecutionLimitExceededException | The maximum number of running executions has been reached. Running executions must end or be stopped before a new execution can be started. |
| ExecutionNotRedrivableException | The execution Amazon Resource Name (ARN) that you specified for executionArn cannot be redriven. |
| InvalidArnException | The provided Amazon Resource Name (ARN) is not valid. |
| ValidationException | The input does not satisfy the constraints specified by an Amazon Web Services service. |
.NET Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5