AWS SDK Version 3 for .NET
API Reference

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.

You can retry a stage that has failed without having to run a pipeline again from the beginning. You do this by either retrying the failed actions in a stage or by retrying all actions in the stage starting from the first action in the stage. When you retry the failed actions in a stage, all actions that are still in progress continue working, and failed actions are triggered again. When you retry a failed stage from the first action in the stage, the stage cannot have any actions in progress. Before a stage can be retried, it must either have all actions failed or some actions failed and some succeeded.

Note:

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 BeginRetryStageExecution and EndRetryStageExecution.

Namespace: Amazon.CodePipeline
Assembly: AWSSDK.CodePipeline.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<RetryStageExecutionResponse> RetryStageExecutionAsync(
         RetryStageExecutionRequest request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.CodePipeline.Model.RetryStageExecutionRequest

Container for the necessary parameters to execute the RetryStageExecution service method.

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the RetryStageExecution service method, as returned by CodePipeline.

Exceptions

ExceptionCondition
ConflictException Your request cannot be handled because the pipeline is busy handling ongoing activities. Try again later.
NotLatestPipelineExecutionException The stage has failed in a later run of the pipeline and the pipelineExecutionId associated with the request is out of date.
PipelineNotFoundException The pipeline was specified in an invalid format or cannot be found.
StageNotFoundException The stage was specified in an invalid format or cannot be found.
StageNotRetryableException Unable to retry. The pipeline structure or stage state might have changed while actions awaited retry, or the stage contains no failed actions.
ValidationException The validation was specified in an invalid format.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also