AWS CloudFormation
User Guide (Version )

AWS::EMR::Step

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.

Syntax

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

JSON

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

YAML

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

Properties

ActionOnFailure

The action to take when the cluster step fails. Possible values are TERMINATE_CLUSTER, CANCEL_AND_WAIT, and CONTINUE. TERMINATE_JOB_FLOW is provided for backward compatibility. We recommend using TERMINATE_CLUSTER instead.

Required: Yes

Type: String

Allowed Values: CANCEL_AND_WAIT | CONTINUE | TERMINATE_CLUSTER | TERMINATE_JOB_FLOW

Update requires: Replacement

HadoopJarStep

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

JobFlowId

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

Name

The name of the cluster step.

Required: Yes

Type: String

Update requires: Replacement

Return Values

Ref

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.