Package software.amazon.awscdk.services.codepipeline

Interface FailureConditions

All Superinterfaces:

Conditions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

FailureConditions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.118.0 (build 02eec31)",
           date="2025-11-04T09:27:36.922Z")
@Stability(Stable)
public interface FailureConditions
extends software.amazon.jsii.JsiiSerializable, Conditions

The configuration that specifies the result, such as rollback, to occur upon stage failure.

Example:

 CodeStarConnectionsSourceAction sourceAction;
 CodeBuildAction buildAction;
 Pipeline.Builder.create(this, "Pipeline")
         .pipelineType(PipelineType.V2)
         .stages(List.of(StageProps.builder()
                 .stageName("Source")
                 .actions(List.of(sourceAction))
                 .build(), StageProps.builder()
                 .stageName("Build")
                 .actions(List.of(buildAction))
                 // BeforeEntry condition - checks before entering the stage
                 .beforeEntry(Conditions.builder()
                         .conditions(List.of(Condition.builder()
                                 .rules(List.of(Rule.Builder.create()
                                         .name("LambdaCheck")
                                         .provider("LambdaInvoke")
                                         .version("1")
                                         .configuration(Map.of(
                                                 "FunctionName", "LambdaFunctionName"))
                                         .build()))
                                 .result(Result.FAIL)
                                 .build()))
                         .build())
                 // OnSuccess condition - checks after successful stage completion
                 .onSuccess(Conditions.builder()
                         .conditions(List.of(Condition.builder()
                                 .result(Result.FAIL)
                                 .rules(List.of(Rule.Builder.create()
                                         .name("CloudWatchCheck")
                                         .provider("LambdaInvoke")
                                         .version("1")
                                         .configuration(Map.of(
                                                 "AlarmName", "AlarmName1",
                                                 "WaitTime", "300",  // 5 minutes
                                                 "FunctionName", "funcName2"))
                                         .build()))
                                 .build()))
                         .build())
                 // OnFailure condition - handles stage failure
                 .onFailure(FailureConditions.builder()
                         .conditions(List.of(Condition.builder()
                                 .result(Result.ROLLBACK)
                                 .rules(List.of(Rule.Builder.create()
                                         .name("RollBackOnFailure")
                                         .provider("LambdaInvoke")
                                         .version("1")
                                         .configuration(Map.of(
                                                 "AlarmName", "Alarm",
                                                 "WaitTime", "300",  // 5 minutes
                                                 "FunctionName", "funcName1"))
                                         .build()))
                                 .build()))
                         .build())
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	FailureConditions.Builder	A builder for FailureConditions
static final class	FailureConditions.Jsii$Proxy	An implementation for FailureConditions

Method Summary

Modifier and Type	Method	Description
static FailureConditions.Builder	builder()
default Result	getResult()	The specified result for when the failure conditions are met, such as rolling back the stage.
default RetryMode	getRetryMode()	The method that you want to configure for automatic stage retry on stage failure.

Methods inherited from interface software.amazon.awscdk.services.codepipeline.Conditions

getConditions

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getResult

@Stability(Stable)
@Nullable
default Result getResult()

The specified result for when the failure conditions are met, such as rolling back the stage.

Default: FAIL

getRetryMode

@Stability(Stable)
@Nullable
default RetryMode getRetryMode()

The method that you want to configure for automatic stage retry on stage failure.

Default: ALL_ACTIONS

builder

@Stability(Stable)
static FailureConditions.Builder builder()

Returns:

a FailureConditions.Builder of FailureConditions