AWS::EMR::Step - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Use Step to specify a cluster (job flow) step, which runs only on the master node. Steps are used to submit data processing jobs to a cluster.


To declare this entity in your Amazon CloudFormation template, use the following syntax:


{ "Type" : "AWS::EMR::Step", "Properties" : { "ActionOnFailure" : String, "HadoopJarStep" : HadoopJarStepConfig, "JobFlowId" : String, "Name" : String } }


Type: AWS::EMR::Step Properties: ActionOnFailure: String HadoopJarStep: HadoopJarStepConfig JobFlowId: String Name: String



This specifies what action to take when the cluster step fails. Possible values are CANCEL_AND_WAIT and CONTINUE.

Required: Yes

Type: String

Update requires: Replacement


The HadoopJarStepConfig property type specifies a job flow step consisting of a JAR file whose main function will be executed. The main function submits a job for the cluster to execute as a step on the master node, and then waits for the job to finish or fail before executing subsequent steps.

Required: Yes

Type: HadoopJarStepConfig

Update requires: Replacement


A string that uniquely identifies the cluster (job flow).

Required: Yes

Type: String

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Minimum: 0

Maximum: 256

Update requires: Replacement


The name of the cluster step.

Required: Yes

Type: String

Update requires: Replacement

Return values


When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns returns the ID of the step.

For more information about using the Ref function, see Ref.



The identifier of the cluster step.