Package software.amazon.awscdk.services.stepfunctions

Class Fail

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.services.stepfunctions.State

software.amazon.awscdk.services.stepfunctions.Fail

All Implemented Interfaces:

IChainable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)",
           date="2025-10-29T11:15:49.406Z")
@Stability(Stable)
public class Fail
extends State

Define a Fail state in the state machine.

Reaching a Fail state terminates the state execution in failure.

Example:

 Fail fail = Fail.Builder.create(this, "Fail")
         .errorPath(JsonPath.format("error: {}.", JsonPath.stringAt("$.someError")))
         .causePath("States.Format('cause: {}.', $.someCause)")
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Fail.Builder	A fluent builder for Fail.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.stepfunctions.IChainable

IChainable.Jsii$Default

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Fail(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Fail(software.amazon.jsii.JsiiObjectRef objRef)
	Fail(software.constructs.Construct scope, String id)
	Fail(software.constructs.Construct scope, String id, FailProps props)

Method Summary

Modifier and Type	Method	Description
List<INextable>	getEndStates()	Continuable states of this Chainable.
static Fail	jsonata(software.constructs.Construct scope, String id)	Define a Fail state using JSONata in the state machine.
static Fail	jsonata(software.constructs.Construct scope, String id, FailJsonataProps props)	Define a Fail state using JSONata in the state machine.
static Fail	jsonPath(software.constructs.Construct scope, String id)	Define a Fail state using JSONPath in the state machine.
static Fail	jsonPath(software.constructs.Construct scope, String id, FailJsonPathProps props)	Define a Fail state using JSONPath in the state machine.
com.fasterxml.jackson.databind.node.ObjectNode	toStateJson()	Return the Amazon States Language object for this state.
com.fasterxml.jackson.databind.node.ObjectNode	toStateJson(QueryLanguage queryLanguage)	Return the Amazon States Language object for this state.
protected List<String>	validateState()	Validate this state.

Methods inherited from class software.amazon.awscdk.services.stepfunctions.State

addBranch, addChoice, addChoice, addItemProcessor, addItemProcessor, addIterator, addPrefix, bindToGraph, filterNextables, findReachableEndStates, findReachableEndStates, findReachableStates, findReachableStates, getArguments, getAssign, getBranches, getComment, getDefaultChoice, getId, getInputPath, getIteration, getOutputPath, getOutputs, getParameters, getProcessor, getProcessorConfig, getProcessorMode, getQueryLanguage, getResultPath, getResultSelector, getStartState, getStateId, getStateName, makeDefault, makeNext, prefixStates, renderAssign, renderAssign, renderBranches, renderChoices, renderChoices, renderInputOutput, renderItemProcessor, renderIterator, renderNextEnd, renderQueryLanguage, renderQueryLanguage, renderResultSelector, renderRetryCatch, renderRetryCatch, setDefaultChoice, setIteration, setProcessor, setProcessorConfig, setProcessorMode, whenBoundToGraph

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Details

Fail

protected Fail(software.amazon.jsii.JsiiObjectRef objRef)

Fail

protected Fail(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Fail

@Stability(Stable)
public Fail(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @Nullable
 FailProps props)

Parameters:

scope - This parameter is required.

id - Descriptive identifier for this chainable. This parameter is required.

props -

Fail

@Stability(Stable)
public Fail(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id)

Parameters:

scope - This parameter is required.

id - Descriptive identifier for this chainable. This parameter is required.

Method Details

jsonata

@Stability(Stable)
@NotNull
public static Fail jsonata(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @Nullable
 FailJsonataProps props)

Define a Fail state using JSONata in the state machine.

Reaching a Fail state terminates the state execution in failure.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

jsonata

@Stability(Stable)
@NotNull
public static Fail jsonata(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id)

Define a Fail state using JSONata in the state machine.

Reaching a Fail state terminates the state execution in failure.

Parameters:

scope - This parameter is required.

id - This parameter is required.

jsonPath

@Stability(Stable)
@NotNull
public static Fail jsonPath(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @Nullable
 FailJsonPathProps props)

Define a Fail state using JSONPath in the state machine.

Reaching a Fail state terminates the state execution in failure.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

jsonPath

@Stability(Stable)
@NotNull
public static Fail jsonPath(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id)

Define a Fail state using JSONPath in the state machine.

Reaching a Fail state terminates the state execution in failure.

Parameters:

scope - This parameter is required.

id - This parameter is required.

toStateJson

@Stability(Stable)
@NotNull
public com.fasterxml.jackson.databind.node.ObjectNode toStateJson(@Nullable
 QueryLanguage queryLanguage)

Return the Amazon States Language object for this state.

Specified by:

toStateJson in class State

Parameters:

queryLanguage -

toStateJson

@Stability(Stable)
@NotNull
public com.fasterxml.jackson.databind.node.ObjectNode toStateJson()

Return the Amazon States Language object for this state.

Specified by:

toStateJson in class State

validateState

@Stability(Stable)
@NotNull
protected List<String> validateState()

Validate this state.

Overrides:

validateState in class State

getEndStates

@Stability(Stable)
@NotNull
public List<INextable> getEndStates()

Continuable states of this Chainable.

Specified by:

getEndStates in interface IChainable

Specified by:

getEndStates in class State