Step - Amazon EMR

Step

This represents a step in a cluster.

Contents

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.

If a cluster's StepConcurrencyLevel is greater than 1, do not use AddJobFlowSteps to submit a step with this parameter set to CANCEL_AND_WAIT or TERMINATE_CLUSTER. The step is not submitted and the action fails with a message that the ActionOnFailure setting is not valid.

If you change a cluster's StepConcurrencyLevel to be greater than 1 while a step is running, the ActionOnFailure parameter may not behave as you expect. In this case, for a step that fails with this parameter set to CANCEL_AND_WAIT, pending steps and the running step are not canceled; for a step that fails with this parameter set to TERMINATE_CLUSTER, the cluster does not terminate.

Type: String

Valid Values: TERMINATE_JOB_FLOW | TERMINATE_CLUSTER | CANCEL_AND_WAIT | CONTINUE

Required: No

Config

The Hadoop job configuration of the cluster step.

Type: HadoopStepConfig object

Required: No

ExecutionRoleArn

The Amazon Resource Name (ARN) of the runtime role for a step on the cluster. The runtime role can be a cross-account IAM role. The runtime role ARN is a combination of account ID, role name, and role type using the following format: arn:partition:service:region:account:resource.

For example, arn:aws:IAM::1234567890:role/ReadOnly is a correctly formatted runtime role ARN.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 2048.

Required: No

Id

The identifier of the cluster step.

Type: String

Required: No

Name

The name of the cluster step.

Type: String

Required: No

Status

The current execution status details of the cluster step.

Type: StepStatus object

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: