AWS CloudFormation
User Guide (Version )

AWS::EMR::Cluster JobFlowInstancesConfig

JobFlowInstancesConfig is a property of the AWS::EMR::Cluster resource. JobFlowInstancesConfig defines the instance groups or instance fleets that comprise the cluster. JobFlowInstancesConfig must contain either InstanceFleetConfig or InstanceGroupConfig. They cannot be used together.

Syntax

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

Properties

AdditionalMasterSecurityGroups

A list of additional Amazon EC2 security group IDs for the master node.

Required: No

Type: List of String

Update requires: Replacement

AdditionalSlaveSecurityGroups

A list of additional Amazon EC2 security group IDs for the core and task nodes.

Required: No

Type: List of String

Update requires: Replacement

CoreInstanceFleet

Describes the EC2 instances and instance configurations for the core instance fleet when using clusters with the instance fleet configuration.

Required: No

Type: InstanceFleetConfig

Update requires: Replacement

CoreInstanceGroup

Describes the EC2 instances and instance configurations for core instance groups when using clusters with the uniform instance group configuration.

Required: No

Type: InstanceGroupConfig

Update requires: Replacement

Ec2KeyName

The name of the EC2 key pair that can be used to ssh to the master node as the user called "hadoop."

Required: No

Type: String

Minimum: 0

Maximum: 256

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

Update requires: Replacement

Ec2SubnetId

Applies to clusters that use the uniform instance group configuration. To launch the cluster in Amazon Virtual Private Cloud (Amazon VPC), set this parameter to the identifier of the Amazon VPC subnet where you want the cluster to launch. If you do not specify this value and your account supports EC2-Classic, the cluster launches in EC2-Classic.

Required: No

Type: String

Minimum: 0

Maximum: 256

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

Update requires: Replacement

Ec2SubnetIds

Applies to clusters that use the instance fleet configuration. When multiple EC2 subnet IDs are specified, Amazon EMR evaluates them and launches instances in the optimal subnet.

Note

The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.

Required: No

Type: List of String

Update requires: Replacement

EmrManagedMasterSecurityGroup

The identifier of the Amazon EC2 security group for the master node.

Required: No

Type: String

Minimum: 0

Maximum: 256

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

Update requires: Replacement

EmrManagedSlaveSecurityGroup

The identifier of the Amazon EC2 security group for the core and task nodes.

Required: No

Type: String

Minimum: 0

Maximum: 256

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

Update requires: Replacement

HadoopVersion

Applies only to Amazon EMR release versions earlier than 4.0. The Hadoop version for the cluster. Valid inputs are "0.18" (deprecated), "0.20" (deprecated), "0.20.205" (deprecated), "1.0.3", "2.2.0", or "2.4.0". If you do not set this value, the default of 0.18 is used, unless the AmiVersion parameter is set in the RunJobFlow call, in which case the default version of Hadoop for that AMI version is used.

Required: No

Type: String

Minimum: 0

Maximum: 256

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

Update requires: Replacement

KeepJobFlowAliveWhenNoSteps

Specifies whether the cluster should remain available after completing all steps.

Required: No

Type: Boolean

Update requires: Replacement

MasterInstanceFleet

Describes the EC2 instances and instance configurations for the master instance fleet when using clusters with the instance fleet configuration.

Required: No

Type: InstanceFleetConfig

Update requires: Replacement

MasterInstanceGroup

Describes the EC2 instances and instance configurations for the master instance group when using clusters with the uniform instance group configuration.

Required: No

Type: InstanceGroupConfig

Update requires: Replacement

Placement

The Availability Zone in which the cluster runs.

Required: No

Type: PlacementType

Update requires: Replacement

ServiceAccessSecurityGroup

The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private subnets.

Required: No

Type: String

Minimum: 0

Maximum: 256

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

Update requires: Replacement

TerminationProtected

Specifies whether to lock the cluster to prevent the Amazon EC2 instances from being terminated by API call, user intervention, or in the event of a job-flow error.

Required: No

Type: Boolean

Update requires: No interruption

On this page: