software.amazon.awscdk.services.stepfunctions

Class TaskStateBase

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.services.stepfunctions.State

software.amazon.awscdk.services.stepfunctions.TaskStateBase

All Implemented Interfaces:

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

Direct Known Subclasses:

AthenaGetQueryExecution, AthenaGetQueryResults, AthenaStartQueryExecution, AthenaStopQueryExecution, BatchSubmitJob, CallApiGatewayHttpApiEndpoint, CallApiGatewayRestApiEndpoint, CodeBuildStartBuild, DynamoDeleteItem, DynamoGetItem, DynamoPutItem, DynamoUpdateItem, EcsRunTask, EksCall, EmrAddStep, EmrCancelStep, EmrCreateCluster, EmrModifyInstanceFleetByName, EmrModifyInstanceGroupByName, EmrSetClusterTerminationProtection, EmrTerminateCluster, EvaluateExpression, GlueDataBrewStartJobRun, GlueStartJobRun, LambdaInvoke, SageMakerCreateEndpoint, SageMakerCreateEndpointConfig, SageMakerCreateModel, SageMakerCreateTrainingJob, SageMakerCreateTransformJob, SageMakerUpdateEndpoint, SnsPublish, SqsSendMessage, StepFunctionsInvokeActivity, StepFunctionsStartExecution

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:38.432Z")
 @Stability(value=Experimental)
public abstract class TaskStateBase
extends State
implements INextable

(experimental) Define a Task state in the state machine.

Reaching a Task state causes some work to be executed, represented by the Task's resource property. Task constructs represent a generic Amazon States Language Task.

For some resource types, more specific subclasses of Task may be available which are more convenient to use.

Nested Class Summary

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.INextable

INextable.Jsii$Default

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 and Description
protected	TaskStateBase(software.constructs.Construct scope, String id, TaskStateBaseProps props)
protected	TaskStateBase(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	TaskStateBase(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
TaskStateBase	addCatch(IChainable handler) (experimental) Add a recovery handler for this state.
TaskStateBase	addCatch(IChainable handler, CatchProps props) (experimental) Add a recovery handler for this state.
TaskStateBase	addRetry() (experimental) Add retry configuration for this state.
TaskStateBase	addRetry(RetryProps props) (experimental) Add retry configuration for this state.
List<INextable>	getEndStates() (experimental) Continuable states of this Chainable.
protected abstract TaskMetricsConfig	getTaskMetrics()
protected abstract List<PolicyStatement>	getTaskPolicies()
Metric	metric(String metricName) (experimental) Return the given named metric for this Task.
Metric	metric(String metricName, MetricOptions props) (experimental) Return the given named metric for this Task.
Metric	metricFailed() (experimental) Metric for the number of times this activity fails.
Metric	metricFailed(MetricOptions props) (experimental) Metric for the number of times this activity fails.
Metric	metricHeartbeatTimedOut() (experimental) Metric for the number of times the heartbeat times out for this activity.
Metric	metricHeartbeatTimedOut(MetricOptions props) (experimental) Metric for the number of times the heartbeat times out for this activity.
Metric	metricRunTime() (experimental) The interval, in milliseconds, between the time the Task starts and the time it closes.
Metric	metricRunTime(MetricOptions props) (experimental) The interval, in milliseconds, between the time the Task starts and the time it closes.
Metric	metricScheduled() (experimental) Metric for the number of times this activity is scheduled.
Metric	metricScheduled(MetricOptions props) (experimental) Metric for the number of times this activity is scheduled.
Metric	metricScheduleTime() (experimental) The interval, in milliseconds, for which the activity stays in the schedule state.
Metric	metricScheduleTime(MetricOptions props) (experimental) The interval, in milliseconds, for which the activity stays in the schedule state.
Metric	metricStarted() (experimental) Metric for the number of times this activity is started.
Metric	metricStarted(MetricOptions props) (experimental) Metric for the number of times this activity is started.
Metric	metricSucceeded() (experimental) Metric for the number of times this activity succeeds.
Metric	metricSucceeded(MetricOptions props) (experimental) Metric for the number of times this activity succeeds.
Metric	metricTime() (experimental) The interval, in milliseconds, between the time the activity is scheduled and the time it closes.
Metric	metricTime(MetricOptions props) (experimental) The interval, in milliseconds, between the time the activity is scheduled and the time it closes.
Metric	metricTimedOut() (experimental) Metric for the number of times this activity times out.
Metric	metricTimedOut(MetricOptions props) (experimental) Metric for the number of times this activity times out.
Chain	next(IChainable next) (experimental) Continue normal execution with the given state.
com.fasterxml.jackson.databind.node.ObjectNode	toStateJson() (experimental) Return the Amazon States Language object for this state.
protected void	whenBoundToGraph(StateGraph graph) (experimental) Called whenever this state is bound to a graph.

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

addBranch, addChoice, addIterator, addPrefix, bindToGraph, filterNextables, findReachableEndStates, findReachableEndStates, findReachableStates, findReachableStates, getBranches, getComment, getDefaultChoice, getId, getInputPath, getIteration, getOutputPath, getParameters, getResultPath, getResultSelector, getStartState, getStateId, makeDefault, makeNext, prefixStates, renderBranches, renderChoices, renderInputOutput, renderIterator, renderNextEnd, renderResultSelector, renderRetryCatch, setDefaultChoice, setIteration, validateState

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 Detail

TaskStateBase

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

TaskStateBase

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

TaskStateBase

@Stability(value=Experimental)
protected TaskStateBase(@NotNull
                                                       software.constructs.Construct scope,
                                                       @NotNull
                                                       String id,
                                                       @NotNull
                                                       TaskStateBaseProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Detail

addCatch

@Stability(value=Experimental)
 @NotNull
public TaskStateBase addCatch(@NotNull
                                                                       IChainable handler,
                                                                       @Nullable
                                                                       CatchProps props)

(experimental) Add a recovery handler for this state.

When a particular error occurs, execution will continue at the error handler instead of failing the state machine execution.

Parameters:

handler - This parameter is required.

props -

addCatch

@Stability(value=Experimental)
 @NotNull
public TaskStateBase addCatch(@NotNull
                                                                       IChainable handler)

(experimental) Add a recovery handler for this state.

When a particular error occurs, execution will continue at the error handler instead of failing the state machine execution.

Parameters:

handler - This parameter is required.

addRetry

@Stability(value=Experimental)
 @NotNull
public TaskStateBase addRetry(@Nullable
                                                                       RetryProps props)

(experimental) Add retry configuration for this state.

This controls if and how the execution will be retried if a particular error occurs.

Parameters:

props -

addRetry

@Stability(value=Experimental)
 @NotNull
public TaskStateBase addRetry()

(experimental) Add retry configuration for this state.

This controls if and how the execution will be retried if a particular error occurs.

metric

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              String metricName,
                                                              @Nullable
                                                              MetricOptions props)

(experimental) Return the given named metric for this Task.

Default: - sum over 5 minutes

Parameters:

metricName - This parameter is required.

props -

metric

@Stability(value=Experimental)
 @NotNull
public Metric metric(@NotNull
                                                              String metricName)

(experimental) Return the given named metric for this Task.

Default: - sum over 5 minutes

Parameters:

metricName - This parameter is required.

metricFailed

@Stability(value=Experimental)
 @NotNull
public Metric metricFailed(@Nullable
                                                                    MetricOptions props)

(experimental) Metric for the number of times this activity fails.

Default: - sum over 5 minutes

Parameters:

props -

metricFailed

@Stability(value=Experimental)
 @NotNull
public Metric metricFailed()

(experimental) Metric for the number of times this activity fails.

Default: - sum over 5 minutes

metricHeartbeatTimedOut

@Stability(value=Experimental)
 @NotNull
public Metric metricHeartbeatTimedOut(@Nullable
                                                                               MetricOptions props)

(experimental) Metric for the number of times the heartbeat times out for this activity.

Default: - sum over 5 minutes

Parameters:

props -

metricHeartbeatTimedOut

@Stability(value=Experimental)
 @NotNull
public Metric metricHeartbeatTimedOut()

(experimental) Metric for the number of times the heartbeat times out for this activity.

Default: - sum over 5 minutes

metricRunTime

@Stability(value=Experimental)
 @NotNull
public Metric metricRunTime(@Nullable
                                                                     MetricOptions props)

(experimental) The interval, in milliseconds, between the time the Task starts and the time it closes.

Default: - average over 5 minutes

Parameters:

props -

metricRunTime

@Stability(value=Experimental)
 @NotNull
public Metric metricRunTime()

(experimental) The interval, in milliseconds, between the time the Task starts and the time it closes.

Default: - average over 5 minutes

metricScheduled

@Stability(value=Experimental)
 @NotNull
public Metric metricScheduled(@Nullable
                                                                       MetricOptions props)

(experimental) Metric for the number of times this activity is scheduled.

Default: - sum over 5 minutes

Parameters:

props -

metricScheduled

@Stability(value=Experimental)
 @NotNull
public Metric metricScheduled()

(experimental) Metric for the number of times this activity is scheduled.

Default: - sum over 5 minutes

metricScheduleTime

@Stability(value=Experimental)
 @NotNull
public Metric metricScheduleTime(@Nullable
                                                                          MetricOptions props)

(experimental) The interval, in milliseconds, for which the activity stays in the schedule state.

Default: - average over 5 minutes

Parameters:

props -

metricScheduleTime

@Stability(value=Experimental)
 @NotNull
public Metric metricScheduleTime()

(experimental) The interval, in milliseconds, for which the activity stays in the schedule state.

Default: - average over 5 minutes

metricStarted

@Stability(value=Experimental)
 @NotNull
public Metric metricStarted(@Nullable
                                                                     MetricOptions props)

(experimental) Metric for the number of times this activity is started.

Default: - sum over 5 minutes

Parameters:

props -

metricStarted

@Stability(value=Experimental)
 @NotNull
public Metric metricStarted()

(experimental) Metric for the number of times this activity is started.

Default: - sum over 5 minutes

metricSucceeded

@Stability(value=Experimental)
 @NotNull
public Metric metricSucceeded(@Nullable
                                                                       MetricOptions props)

(experimental) Metric for the number of times this activity succeeds.

Default: - sum over 5 minutes

Parameters:

props -

metricSucceeded

@Stability(value=Experimental)
 @NotNull
public Metric metricSucceeded()

(experimental) Metric for the number of times this activity succeeds.

Default: - sum over 5 minutes

metricTime

@Stability(value=Experimental)
 @NotNull
public Metric metricTime(@Nullable
                                                                  MetricOptions props)

(experimental) The interval, in milliseconds, between the time the activity is scheduled and the time it closes.

Default: - average over 5 minutes

Parameters:

props -

metricTime

@Stability(value=Experimental)
 @NotNull
public Metric metricTime()

(experimental) The interval, in milliseconds, between the time the activity is scheduled and the time it closes.

Default: - average over 5 minutes

metricTimedOut

@Stability(value=Experimental)
 @NotNull
public Metric metricTimedOut(@Nullable
                                                                      MetricOptions props)

(experimental) Metric for the number of times this activity times out.

Default: - sum over 5 minutes

Parameters:

props -

metricTimedOut

@Stability(value=Experimental)
 @NotNull
public Metric metricTimedOut()

(experimental) Metric for the number of times this activity times out.

Default: - sum over 5 minutes

next

@Stability(value=Experimental)
 @NotNull
public Chain next(@NotNull
                                                           IChainable next)

(experimental) Continue normal execution with the given state.

Specified by:

next in interface INextable

Parameters:

next - This parameter is required.

Returns:

The chain of states built up

toStateJson

@Stability(value=Experimental)
 @NotNull
public com.fasterxml.jackson.databind.node.ObjectNode toStateJson()

(experimental) Return the Amazon States Language object for this state.

Specified by:

toStateJson in class State

whenBoundToGraph

@Stability(value=Experimental)
protected void whenBoundToGraph(@NotNull
                                                               StateGraph graph)

(experimental) Called whenever this state is bound to a graph.

Can be overridden by subclasses.

Overrides:

whenBoundToGraph in class State

Parameters:

graph - This parameter is required.

getEndStates

@Stability(value=Experimental)
 @NotNull
public List<INextable> getEndStates()

(experimental) Continuable states of this Chainable.

Specified by:

getEndStates in interface IChainable

Specified by:

getEndStates in class State

getTaskMetrics

@Stability(value=Experimental)
 @Nullable
protected abstract TaskMetricsConfig getTaskMetrics()

getTaskPolicies

@Stability(value=Experimental)
 @Nullable
protected abstract List<PolicyStatement> getTaskPolicies()