Package software.amazon.awscdk.services.stepfunctions.tasks

Class EmrContainersStartJobRun

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.services.stepfunctions.State

software.amazon.awscdk.services.stepfunctions.TaskStateBase

software.amazon.awscdk.services.stepfunctions.tasks.EmrContainersStartJobRun

All Implemented Interfaces:

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

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-20T23:37:31.256Z")
@Stability(Stable)
public class EmrContainersStartJobRun
extends TaskStateBase
implements IGrantable

Starts a job run.

A job is a unit of work that you submit to Amazon EMR on EKS for execution. The work performed by the job can be defined by a Spark jar, PySpark script, or SparkSQL query. A job run is an execution of the job on the virtual cluster.

Example:

 EmrContainersStartJobRun.Builder.create(this, "EMR Containers Start Job Run")
         .virtualCluster(VirtualClusterInput.fromVirtualClusterId("de92jdei2910fwedz"))
         .releaseLabel(ReleaseLabel.EMR_6_2_0)
         .jobName("EMR-Containers-Job")
         .jobDriver(JobDriver.builder()
                 .sparkSubmitJobDriver(SparkSubmitJobDriver.builder()
                         .entryPoint(TaskInput.fromText("local:///usr/lib/spark/examples/src/main/python/pi.py"))
                         .build())
                 .build())
         .applicationConfig(List.of(ApplicationConfiguration.builder()
                 .classification(Classification.SPARK_DEFAULTS)
                 .properties(Map.of(
                         "spark.executor.instances", "1",
                         "spark.executor.memory", "512M"))
                 .build()))
         .build();
 

See Also:

• https://docs.aws.amazon.com/step-functions/latest/dg/connect-emr-eks.html

Nested Class Summary

Nested Classes

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

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

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.iam.IGrantable

IGrantable.Jsii$Default, IGrantable.Jsii$Proxy

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

INextable.Jsii$Default

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
IPrincipal	getGrantPrincipal()	The principal to grant permissions to.
protected TaskMetricsConfig	getTaskMetrics()
protected List<PolicyStatement>	getTaskPolicies()
static EmrContainersStartJobRun	jsonata(software.constructs.Construct scope, String id, EmrContainersStartJobRunJsonataProps props)	Starts a job run Task using JSONata.
static EmrContainersStartJobRun	jsonPath(software.constructs.Construct scope, String id, EmrContainersStartJobRunJsonPathProps props)	Starts a job run Task using JSONPath.

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

addCatch, addCatch, addRetry, addRetry, getEndStates, metric, metric, metricFailed, metricFailed, metricHeartbeatTimedOut, metricHeartbeatTimedOut, metricRunTime, metricRunTime, metricScheduled, metricScheduled, metricScheduleTime, metricScheduleTime, metricStarted, metricStarted, metricSucceeded, metricSucceeded, metricTime, metricTime, metricTimedOut, metricTimedOut, next, toStateJson, toStateJson, whenBoundToGraph

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, 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 Details

EmrContainersStartJobRun

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

EmrContainersStartJobRun

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

EmrContainersStartJobRun

@Stability(Stable)
public EmrContainersStartJobRun(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 EmrContainersStartJobRunProps props)

Parameters:

scope - This parameter is required.

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

props - This parameter is required.

Method Details

jsonata

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

Starts a job run Task using JSONata.

A job is a unit of work that you submit to Amazon EMR on EKS for execution. The work performed by the job can be defined by a Spark jar, PySpark script, or SparkSQL query. A job run is an execution of the job on the virtual cluster.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

See Also:

• https://docs.aws.amazon.com/step-functions/latest/dg/connect-emr-eks.html

jsonPath

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

Starts a job run Task using JSONPath.

A job is a unit of work that you submit to Amazon EMR on EKS for execution. The work performed by the job can be defined by a Spark jar, PySpark script, or SparkSQL query. A job run is an execution of the job on the virtual cluster.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

See Also:

• https://docs.aws.amazon.com/step-functions/latest/dg/connect-emr-eks.html

getGrantPrincipal

@Stability(Stable)
@NotNull
public IPrincipal getGrantPrincipal()

The principal to grant permissions to.

Specified by:

getGrantPrincipal in interface IGrantable

getTaskMetrics

@Stability(Stable)
@Nullable
protected TaskMetricsConfig getTaskMetrics()

Specified by:

getTaskMetrics in class TaskStateBase

getTaskPolicies

@Stability(Stable)
@Nullable
protected List<PolicyStatement> getTaskPolicies()

Specified by:

getTaskPolicies in class TaskStateBase