AWS CloudFormation
User Guide (Version )

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


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 AWS 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

Minimum: 0

Maximum: 256

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

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.