This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
# AWS::EMR::Cluster
The `AWS::EMR::Cluster` resource specifies an Amazon EMR cluster. This cluster is a collection of Amazon EC2 instances that run open source big data frameworks and applications to process and analyze vast amounts of data. For more information, see the [Amazon EMR Management Guide](https://docs.aws.amazon.com//emr/latest/ManagementGuide/).
Amazon EMR now supports launching task instance groups and task instance fleets as part of the `AWS::EMR::Cluster` resource. This can be done by using the `JobFlowInstancesConfig` property type's `TaskInstanceGroups` and `TaskInstanceFleets` subproperties. Using these subproperties reduces delays in provisioning task nodes compared to specifying task nodes with the `AWS::EMR::InstanceGroupConfig` and `AWS::EMR::InstanceFleetConfig` resources. Please refer to the examples at the bottom of this page to learn how to use these subproperties.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"Type" : "AWS::EMR::Cluster",
"Properties" : {
"[AdditionalInfo](#cfn-emr-cluster-additionalinfo)" : Json,
"[Applications](#cfn-emr-cluster-applications)" : [ Application, ... ],
"[AutoScalingRole](#cfn-emr-cluster-autoscalingrole)" : String,
"[AutoTerminationPolicy](#cfn-emr-cluster-autoterminationpolicy)" : AutoTerminationPolicy,
"[BootstrapActions](#cfn-emr-cluster-bootstrapactions)" : [ BootstrapActionConfig, ... ],
"[Configurations](#cfn-emr-cluster-configurations)" : [ Configuration, ... ],
"[CustomAmiId](#cfn-emr-cluster-customamiid)" : String,
"[EbsRootVolumeIops](#cfn-emr-cluster-ebsrootvolumeiops)" : Integer,
"[EbsRootVolumeSize](#cfn-emr-cluster-ebsrootvolumesize)" : Integer,
"[EbsRootVolumeThroughput](#cfn-emr-cluster-ebsrootvolumethroughput)" : Integer,
"[Instances](#cfn-emr-cluster-instances)" : JobFlowInstancesConfig,
"[JobFlowRole](#cfn-emr-cluster-jobflowrole)" : String,
"[KerberosAttributes](#cfn-emr-cluster-kerberosattributes)" : KerberosAttributes,
"[LogEncryptionKmsKeyId](#cfn-emr-cluster-logencryptionkmskeyid)" : String,
"[LogUri](#cfn-emr-cluster-loguri)" : String,
"[ManagedScalingPolicy](#cfn-emr-cluster-managedscalingpolicy)" : ManagedScalingPolicy,
"[Name](#cfn-emr-cluster-name)" : String,
"[OSReleaseLabel](#cfn-emr-cluster-osreleaselabel)" : String,
"[PlacementGroupConfigs](#cfn-emr-cluster-placementgroupconfigs)" : [ PlacementGroupConfig, ... ],
"[ReleaseLabel](#cfn-emr-cluster-releaselabel)" : String,
"[ScaleDownBehavior](#cfn-emr-cluster-scaledownbehavior)" : String,
"[SecurityConfiguration](#cfn-emr-cluster-securityconfiguration)" : String,
"[ServiceRole](#cfn-emr-cluster-servicerole)" : String,
"[StepConcurrencyLevel](#cfn-emr-cluster-stepconcurrencylevel)" : Integer,
"[Steps](#cfn-emr-cluster-steps)" : [ StepConfig, ... ],
"[Tags](#cfn-emr-cluster-tags)" : [ Tag, ... ],
"[VisibleToAllUsers](#cfn-emr-cluster-visibletoallusers)" : Boolean
}
}
```
### YAML
```
Type: AWS::EMR::Cluster
Properties:
[AdditionalInfo](#cfn-emr-cluster-additionalinfo): Json
[Applications](#cfn-emr-cluster-applications):
- Application
[AutoScalingRole](#cfn-emr-cluster-autoscalingrole): String
[AutoTerminationPolicy](#cfn-emr-cluster-autoterminationpolicy):
AutoTerminationPolicy
[BootstrapActions](#cfn-emr-cluster-bootstrapactions):
- BootstrapActionConfig
[Configurations](#cfn-emr-cluster-configurations):
- Configuration
[CustomAmiId](#cfn-emr-cluster-customamiid): String
[EbsRootVolumeIops](#cfn-emr-cluster-ebsrootvolumeiops): Integer
[EbsRootVolumeSize](#cfn-emr-cluster-ebsrootvolumesize): Integer
[EbsRootVolumeThroughput](#cfn-emr-cluster-ebsrootvolumethroughput): Integer
[Instances](#cfn-emr-cluster-instances):
JobFlowInstancesConfig
[JobFlowRole](#cfn-emr-cluster-jobflowrole): String
[KerberosAttributes](#cfn-emr-cluster-kerberosattributes):
KerberosAttributes
[LogEncryptionKmsKeyId](#cfn-emr-cluster-logencryptionkmskeyid): String
[LogUri](#cfn-emr-cluster-loguri): String
[ManagedScalingPolicy](#cfn-emr-cluster-managedscalingpolicy):
ManagedScalingPolicy
[Name](#cfn-emr-cluster-name): String
[OSReleaseLabel](#cfn-emr-cluster-osreleaselabel): String
[PlacementGroupConfigs](#cfn-emr-cluster-placementgroupconfigs):
- PlacementGroupConfig
[ReleaseLabel](#cfn-emr-cluster-releaselabel): String
[ScaleDownBehavior](#cfn-emr-cluster-scaledownbehavior): String
[SecurityConfiguration](#cfn-emr-cluster-securityconfiguration): String
[ServiceRole](#cfn-emr-cluster-servicerole): String
[StepConcurrencyLevel](#cfn-emr-cluster-stepconcurrencylevel): Integer
[Steps](#cfn-emr-cluster-steps):
- StepConfig
[Tags](#cfn-emr-cluster-tags):
- Tag
[VisibleToAllUsers](#cfn-emr-cluster-visibletoallusers): Boolean
```
## Properties
`AdditionalInfo`
A JSON string for selecting additional features.
*Required*: No
*Type*: Json
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Applications`
The applications to install on this cluster, for example, Spark, Flink, Oozie, Zeppelin, and so on.
*Required*: No
*Type*: Array of [Application](aws-properties-emr-cluster-application.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`AutoScalingRole`
An IAM role for automatic scaling policies. The default role is `EMR_AutoScaling_DefaultRole`. The IAM role provides permissions that the automatic scaling feature requires to launch and terminate Amazon EC2 instances in an instance group.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`AutoTerminationPolicy`
An auto-termination policy for an Amazon EMR cluster. An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see [Control cluster termination](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html).
*Required*: No
*Type*: [AutoTerminationPolicy](aws-properties-emr-cluster-autoterminationpolicy.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`BootstrapActions`
A list of bootstrap actions to run before Hadoop starts on the cluster nodes.
*Required*: No
*Type*: Array of [BootstrapActionConfig](aws-properties-emr-cluster-bootstrapactionconfig.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Configurations`
Applies only to Amazon EMR releases 4.x and later. The list of configurations that are supplied to the Amazon EMR cluster.
*Required*: No
*Type*: Array of [Configuration](aws-properties-emr-cluster-configuration.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`CustomAmiId`
Available only in Amazon EMR releases 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI if the cluster uses a custom AMI.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`EbsRootVolumeIops`
The IOPS, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance. Available in Amazon EMR releases 6.15.0 and later.
*Required*: No
*Type*: Integer
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`EbsRootVolumeSize`
The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance. Available in Amazon EMR releases 4.x and later.
*Required*: No
*Type*: Integer
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`EbsRootVolumeThroughput`
The throughput, in MiB/s, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance. Available in Amazon EMR releases 6.15.0 and later.
*Required*: No
*Type*: Integer
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Instances`
A specification of the number and type of Amazon EC2 instances.
*Required*: Yes
*Type*: [JobFlowInstancesConfig](aws-properties-emr-cluster-jobflowinstancesconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`JobFlowRole`
Also called instance profile and Amazon EC2 role. An IAM role for an Amazon EMR cluster. The Amazon EC2 instances of the cluster assume this role. The default role is `EMR_EC2_DefaultRole`. In order to use the default role, you must have already created it using the AWS CLI or console.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`KerberosAttributes`
Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration. For more information see [Use Kerberos Authentication](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-kerberos.html) in the *Amazon EMR Management Guide*.
*Required*: No
*Type*: [KerberosAttributes](aws-properties-emr-cluster-kerberosattributes.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`LogEncryptionKmsKeyId`
The AWS KMS key used for encrypting log files. This attribute is only available with Amazon EMR 5.30.0 and later, excluding Amazon EMR 6.0.0.
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`LogUri`
The path to the Amazon S3 location where logs for this cluster are stored.
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`ManagedScalingPolicy`
Creates or updates a managed scaling policy for an Amazon EMR cluster. The managed scaling policy defines the limits for resources, such as Amazon EC2 instances that can be added or terminated from a cluster. The policy only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
*Required*: No
*Type*: [ManagedScalingPolicy](aws-properties-emr-cluster-managedscalingpolicy.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Name`
The name of the cluster. This parameter can't contain the characters <, >, \$1, \$1, or ` (backtick).
*Required*: Yes
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`OSReleaseLabel`
The Amazon Linux release specified in a cluster launch RunJobFlow request. If no Amazon Linux release was specified, the default Amazon Linux release is shown in the response.
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`PlacementGroupConfigs`
Property description not available.
*Required*: No
*Type*: Array of [PlacementGroupConfig](aws-properties-emr-cluster-placementgroupconfig.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`ReleaseLabel`
The Amazon EMR release label, which determines the version of open-source application packages installed on the cluster. Release labels are in the form `emr-x.x.x`, where x.x.x is an Amazon EMR release version such as `emr-5.14.0`. For more information about Amazon EMR release versions and included application versions and features, see [https://docs.aws.amazon.com/emr/latest/ReleaseGuide/](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/). The release label applies only to Amazon EMR releases version 4.0 and later. Earlier versions use `AmiVersion`.
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`ScaleDownBehavior`
The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized. `TERMINATE_AT_INSTANCE_HOUR` indicates that Amazon EMR terminates nodes at the instance-hour boundary, regardless of when the request to terminate the instance was submitted. This option is only available with Amazon EMR 5.1.0 and later and is the default for clusters created using that version. `TERMINATE_AT_TASK_COMPLETION` indicates that Amazon EMR adds nodes to a deny list and drains tasks from nodes before terminating the Amazon EC2 instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to HDFS corruption. `TERMINATE_AT_TASK_COMPLETION` is available only in Amazon EMR releases 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.
*Required*: No
*Type*: String
*Allowed values*: `TERMINATE_AT_INSTANCE_HOUR | TERMINATE_AT_TASK_COMPLETION`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`SecurityConfiguration`
The name of the security configuration applied to the cluster.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`ServiceRole`
The IAM role that Amazon EMR assumes in order to access AWS resources on your behalf.
*Required*: Yes
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`StepConcurrencyLevel`
Specifies the number of steps that can be executed concurrently. The default value is `1`. The maximum value is `256`.
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Steps`
A list of steps to run.
*Required*: No
*Type*: Array of [StepConfig](aws-properties-emr-cluster-stepconfig.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Tags`
A list of tags associated with a cluster.
*Required*: No
*Type*: Array of [Tag](aws-properties-emr-cluster-tag.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`VisibleToAllUsers`
Indicates whether the cluster is visible to all IAM users of the AWS account associated with the cluster. If this value is set to `true`, all IAM users of that AWS account can view and manage the cluster if they have the proper policy permissions set. If this value is `false`, only the IAM user that created the cluster can view and manage it. This value can be changed using the SetVisibleToAllUsers action.
When you create clusters directly through the EMR console or API, this value is set to `true` by default. However, for `AWS::EMR::Cluster` resources in CloudFormation, the default is `false`.
*Required*: No
*Type*: Boolean
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
## Return values
### Ref
When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns returns the cluster ID, such as j-1ABCD123AB1A.
For more information about using the `Ref` function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).
### Fn::GetAtt
The `Fn::GetAtt` intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.
For more information about using the `Fn::GetAtt` intrinsic function, see [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).
####
`Id`
The unique identifier for the cluster.
`MasterPublicDNS`
The public DNS name of the master node (instance), such as `ec2-12-123-123-123.us-west-2.compute.amazonaws.com`.
## Examples
Create cluster examples.
**Topics**
+ [Create a cluster using a custom AMI for EC2 instances](#aws-resource-emr-cluster--examples--Create_a_cluster_using_a_custom_AMI_for_EC2_instances)
+ [Create a cluster and specify the root volume size of EC2 instances](#aws-resource-emr-cluster--examples--Create_a_cluster_and_specify_the_root_volume_size_of_EC2_instances)
+ [Create a cluster with Kerberos authentication](#aws-resource-emr-cluster--examples--Create_a_cluster_with_Kerberos_authentication)
+ [Create a cluster with a managed scaling policy](#aws-resource-emr-cluster--examples--Create_a_cluster_with_a_managed_scaling_policy)
+ [Create a cluster with task instance groups](#aws-resource-emr-cluster--examples--Create_a_cluster_with_task_instance_groups)
+ [Create a cluster with a task instance fleet](#aws-resource-emr-cluster--examples--Create_a_cluster_with_a_task_instance_fleet)
### Create a cluster using a custom AMI for EC2 instances
The following example template specifies a cluster using a custom Amazon Linux AMI for the EC2 instances in the cluster.
#### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"CustomAmiId" : {
"Type" : "String"
},
"InstanceType" : {
"Type" : "String"
},
"ReleaseLabel" : {
"Type" : "String"
},
"SubnetId" : {
"Type" : "String"
},
"TerminationProtected" : {
"Type" : "String",
"Default" : "false"
},
"ElasticMapReducePrincipal" : {
"Type" : "String"
},
"Ec2Principal" : {
"Type" : "String"
}
},
"Resources": {
"cluster": {
"Type": "AWS::EMR::Cluster",
"Properties": {
"CustomAmiId" : {"Ref" : "CustomAmiId"},
"Instances": {
"MasterInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnMaster"
},
"CoreInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnCore"
},
"TaskInstanceGroups": [
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-1"
},
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-2"
}
],
"TerminationProtected" : {"Ref" : "TerminationProtected"},
"Ec2SubnetId" : {"Ref" : "SubnetId"}
},
"Name": "CFNtest",
"JobFlowRole" : {"Ref": "emrEc2InstanceProfile"},
"ServiceRole" : {"Ref": "emrRole"},
"ReleaseLabel" : {"Ref" : "ReleaseLabel"},
"VisibleToAllUsers" : true,
"Tags": [
{
"Key": "key1",
"Value": "value1"
}
]
}
},
"emrRole": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": {"Ref" : "ElasticMapReducePrincipal"}
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole"]
}
},
"emrEc2Role": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": {"Ref" : "Ec2Principal"}
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role"]
}
},
"emrEc2InstanceProfile": {
"Type": "AWS::IAM::InstanceProfile",
"Properties": {
"Path": "/",
"Roles": [ {
"Ref": "emrEc2Role"
} ]
}
}
}
}
```
#### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Parameters:
CustomAmiId:
Type: String
InstanceType:
Type: String
ReleaseLabel:
Type: String
SubnetId:
Type: String
TerminationProtected:
Type: String
Default: 'false'
ElasticMapReducePrincipal:
Type: String
Ec2Principal:
Type: String
Resources:
cluster:
Type: AWS::EMR::Cluster
Properties:
CustomAmiId: !Ref CustomAmiId
Instances:
MasterInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnMaster
CoreInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnCore
TaskInstanceGroups:
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-1
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-2
TerminationProtected: !Ref TerminationProtected
Ec2SubnetId: !Ref SubnetId
Name: CFNtest
JobFlowRole: !Ref emrEc2InstanceProfile
ServiceRole: !Ref emrRole
ReleaseLabel: !Ref ReleaseLabel
VisibleToAllUsers: true
Tags:
- Key: key1
Value: value1
emrRole:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: !Ref ElasticMapReducePrincipal
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole'
emrEc2Role:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: !Ref Ec2Principal
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role'
emrEc2InstanceProfile:
Type: AWS::IAM::InstanceProfile
Properties:
Path: /
Roles:
- !Ref emrEc2Role
```
### Create a cluster and specify the root volume size of EC2 instances
The following example template enables you to specify the size of the EBS root volume for cluster instances.
#### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"InstanceType" : {
"Type" : "String"
},
"ReleaseLabel" : {
"Type" : "String"
},
"SubnetId" : {
"Type" : "String"
},
"TerminationProtected" : {
"Type" : "String",
"Default" : "false"
},
"EbsRootVolumeSize" : {
"Type" : "String"
}
},
"Resources": {
"cluster": {
"Type": "AWS::EMR::Cluster",
"Properties": {
"EbsRootVolumeSize" : {"Ref" : "EbsRootVolumeSize"},
"Instances": {
"MasterInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnMaster"
},
"CoreInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnCore"
},
"TaskInstanceGroups": [
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-1"
},
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-2"
}
],
"TerminationProtected" : {"Ref" : "TerminationProtected"},
"Ec2SubnetId" : {"Ref" : "SubnetId"}
},
"Name": "CFNtest",
"JobFlowRole" : {"Ref": "emrEc2InstanceProfile"},
"ServiceRole" : {"Ref": "emrRole"},
"ReleaseLabel" : {"Ref" : "ReleaseLabel"},
"VisibleToAllUsers" : true,
"Tags": [
{
"Key": "key1",
"Value": "value1"
}
]
}
},
"emrRole": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "elasticmapreduce.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole"]
}
},
"emrEc2Role": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "ec2.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role"]
}
},
"emrEc2InstanceProfile": {
"Type": "AWS::IAM::InstanceProfile",
"Properties": {
"Path": "/",
"Roles": [ {
"Ref": "emrEc2Role"
} ]
}
}
}
}
```
#### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Parameters:
InstanceType:
Type: String
ReleaseLabel:
Type: String
SubnetId:
Type: String
TerminationProtected:
Type: String
Default: 'false'
EbsRootVolumeSize:
Type: String
Resources:
cluster:
Type: AWS::EMR::Cluster
Properties:
EbsRootVolumeSize: !Ref EbsRootVolumeSize
Instances:
MasterInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnMaster
CoreInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnCore
TaskInstanceGroups:
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-1
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-2
TerminationProtected: !Ref TerminationProtected
Ec2SubnetId: !Ref SubnetId
Name: CFNtest
JobFlowRole: !Ref emrEc2InstanceProfile
ServiceRole: !Ref emrRole
ReleaseLabel: !Ref ReleaseLabel
VisibleToAllUsers: true
Tags:
- Key: key1
Value: value1
emrRole:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: elasticmapreduce.amazonaws.com
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole'
emrEc2Role:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: ec2.amazonaws.com
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role'
emrEc2InstanceProfile:
Type: AWS::IAM::InstanceProfile
Properties:
Path: /
Roles:
- !Ref emrEc2Role
```
### Create a cluster with Kerberos authentication
The following example template enables you to specify the Kerberos authentication configuration for an EMR cluster.
#### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"CrossRealmTrustPrincipalPassword" : {
"Type" : "String"
},
"KdcAdminPassword" : {
"Type" : "String"
},
"Realm" : {
"Type" : "String"
},
"InstanceType" : {
"Type" : "String"
},
"ReleaseLabel" : {
"Type" : "String"
},
"SubnetId" : {
"Type" : "String"
}
},
"Resources": {
"cluster": {
"Type": "AWS::EMR::Cluster",
"Properties": {
"Instances": {
"MasterInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnMaster"
},
"CoreInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnCore"
},
"TaskInstanceGroups": [
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-1"
},
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-2"
}
],
"Ec2SubnetId" : {"Ref" : "SubnetId"}
},
"Name": "CFNtest2",
"JobFlowRole" : {"Ref": "emrEc2InstanceProfile"},
"KerberosAttributes" : {
"CrossRealmTrustPrincipalPassword" : "CfnIntegrationTest-1",
"KdcAdminPassword" : "CfnIntegrationTest-1",
"Realm": "EC2.INTERNAL"
},
"ServiceRole" : {"Ref": "emrRole"},
"ReleaseLabel" : {"Ref" : "ReleaseLabel"},
"SecurityConfiguration" : {"Ref" : "securityConfiguration"},
"VisibleToAllUsers" : true,
"Tags": [
{
"Key": "key1",
"Value": "value1"
}
]
}
},
"key" : {
"Type" : "AWS::KMS::Key",
"Properties" : {
"KeyPolicy" : {
"Version": "2012-10-17" ,
"Id": "key-default-1",
"Statement": [
{
"Sid": "Enable IAM User Permissions",
"Effect": "Allow",
"Principal": {
"AWS": { "Fn::GetAtt" : ["emrEc2Role", "Arn"]}
},
"Action": "kms:*",
"Resource": "*"
},
{
"Sid": "Enable IAM User Permissions",
"Effect": "Allow",
"Principal": {
"AWS": { "Fn::Join" : ["" , ["arn:aws:iam::", {"Ref" : "AWS::AccountId"} ,":root" ]] }
},
"Action": "kms:*",
"Resource": "*"
}
]
}
}
},
"securityConfiguration": {
"Type" : "AWS::EMR::SecurityConfiguration",
"Properties" : {
"SecurityConfiguration" : {
"AuthenticationConfiguration": {
"KerberosConfiguration": {
"Provider": "ClusterDedicatedKdc",
"ClusterDedicatedKdcConfiguration": {
"TicketLifetimeInHours": 24,
"CrossRealmTrustConfiguration": {
"Realm": "AD.DOMAIN.COM",
"Domain": "ad.domain.com",
"AdminServer": "ad.domain.com",
"KdcServer": "ad.domain.com"
}
}
}
}
}
}
},
"emrRole": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "elasticmapreduce.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole"]
}
},
"emrEc2Role": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": "ec2.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role"]
}
},
"emrEc2InstanceProfile": {
"Type": "AWS::IAM::InstanceProfile",
"Properties": {
"Path": "/",
"Roles": [ {
"Ref": "emrEc2Role"
} ]
}
}
},
"Outputs" : {
"keyArn" : {
"Value" : {"Fn::GetAtt" : ["key", "Arn"]}
}
}
}
```
#### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Parameters:
CrossRealmTrustPrincipalPassword:
Type: String
KdcAdminPassword:
Type: String
Realm:
Type: String
InstanceType:
Type: String
ReleaseLabel:
Type: String
SubnetId:
Type: String
Resources:
cluster:
Type: 'AWS::EMR::Cluster'
Properties:
Instances:
MasterInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnMaster
CoreInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnCore
TaskInstanceGroups:
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-1
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-2
Ec2SubnetId: !Ref SubnetId
Name: CFNtest2
JobFlowRole: !Ref emrEc2InstanceProfile
KerberosAttributes:
CrossRealmTrustPrincipalPassword: CfnIntegrationTest-1
KdcAdminPassword: CfnIntegrationTest-1
Realm: EC2.INTERNAL
ServiceRole: !Ref emrRole
ReleaseLabel: !Ref ReleaseLabel
SecurityConfiguration: !Ref securityConfiguration
VisibleToAllUsers: true
Tags:
- Key: key1
Value: value1
key:
Type: 'AWS::KMS::Key'
Properties:
KeyPolicy:
Version: 2012-10-17
Id: key-default-1
Statement:
- Sid: Enable IAM User Permissions
Effect: Allow
Principal:
AWS: !GetAtt
- emrEc2Role
- Arn
Action: 'kms:*'
Resource: '*'
- Sid: Enable IAM User Permissions
Effect: Allow
Principal:
AWS: !Join
- ''
- - 'arn:aws:iam::'
- !Ref 'AWS::AccountId'
- ':root'
Action: 'kms:*'
Resource: '*'
securityConfiguration:
Type: 'AWS::EMR::SecurityConfiguration'
Properties:
SecurityConfiguration:
AuthenticationConfiguration:
KerberosConfiguration:
Provider: ClusterDedicatedKdc
ClusterDedicatedKdcConfiguration:
TicketLifetimeInHours: 24
CrossRealmTrustConfiguration:
Realm: AD.DOMAIN.COM
Domain: ad.domain.com
AdminServer: ad.domain.com
KdcServer: ad.domain.com
emrRole:
Type: 'AWS::IAM::Role'
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: elasticmapreduce.amazonaws.com
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole'
emrEc2Role:
Type: 'AWS::IAM::Role'
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: ec2.amazonaws.com
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role'
emrEc2InstanceProfile:
Type: 'AWS::IAM::InstanceProfile'
Properties:
Path: /
Roles:
- !Ref emrEc2Role
Outputs:
keyArn:
Value: !GetAtt
- key
- Arn
```
### Create a cluster with a managed scaling policy
The following example template enables you to specify the managed scaling policy for an EMR cluster.
#### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"InstanceType" : {
"Type" : "String"
},
"ReleaseLabel" : {
"Type" : "String"
},
"SubnetId" : {
"Type" : "String"
},
"MinimumCapacityUnits" : {
"Type" : "String"
},
"MaximumCapacityUnits" : {
"Type" : "String"
},
"MaximumCoreCapacityUnits" : {
"Type" : "String"
},
"MaximumOnDemandCapacityUnits" : {
"Type" : "String"
},
"UnitType" : {
"Type" : "String"
}
},
"Resources": {
"cluster": {
"Type": "AWS::EMR::Cluster",
"Properties": {
"Instances": {
"MasterInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "primary"
},
"CoreInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "core"
},
"TaskInstanceGroups": [
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-1"
},
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-2"
}
],
"Ec2SubnetId" : {"Ref" : "SubnetId"}
},
"Name": "ManagedScalingExample",
"JobFlowRole" : "EMR_EC2_DefaultRole",
"ServiceRole" : "EMR_DefaultRole",
"ReleaseLabel" : {"Ref" : "ReleaseLabel"},
"ManagedScalingPolicy" : {
"ComputeLimits" : {
"MinimumCapacityUnits" : {"Ref": "MinimumCapacityUnits"},
"MaximumCapacityUnits" : {"Ref": "MaximumCapacityUnits"},
"MaximumCoreCapacityUnits" : {"Ref": "MaximumCoreCapacityUnits"},
"MaximumOnDemandCapacityUnits" : {"Ref": "MaximumOnDemandCapacityUnits"},
"UnitType" : {"Ref": "UnitType"}
}
}
}
}
}
}
```
#### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Parameters:
InstanceType:
Type: String
ReleaseLabel:
Type: String
SubnetId:
Type: String
MinimumCapacityUnits:
Type: String
MaximumCapacityUnits:
Type: String
MaximumCoreCapacityUnits:
Type: String
MaximumOnDemandCapacityUnits:
Type: String
UnitType:
Type: String
Resources:
cluster:
Type: 'AWS::EMR::Cluster'
Properties:
Instances:
MasterInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: primary
CoreInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: core
TaskInstanceGroups:
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-1
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-2
Ec2SubnetId: !Ref SubnetId
Name: ManagedScalingExample
JobFlowRole: EMR_EC2_DefaultRole
ServiceRole: EMR_DefaultRole
ReleaseLabel: !Ref ReleaseLabel
ManagedScalingPolicy:
ComputeLimits:
MinimumCapacityUnits: !Ref MinimumCapacityUnits
MaximumCapacityUnits: !Ref MaximumCapacityUnits
MaximumCoreCapacityUnits: !Ref MaximumCoreCapacityUnits
MaximumOnDemandCapacityUnits: !Ref MaximumOnDemandCapacityUnits
UnitType: !Ref UnitType
```
### Create a cluster with task instance groups
The following example template enables you to create task instance groups for an EMR cluster.
#### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"InstanceType" : {
"Type" : "String"
},
"ReleaseLabel" : {
"Type" : "String"
},
"SubnetId" : {
"Type" : "String"
},
"TerminationProtected" : {
"Type" : "String",
"Default" : "false"
},
"ElasticMapReducePrincipal" : {
"Type" : "String"
},
"Ec2Principal" : {
"Type" : "String"
}
},
"Resources": {
"cluster": {
"Type": "AWS::EMR::Cluster",
"Properties": {
"Instances": {
"MasterInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnMaster"
},
"CoreInstanceGroup": {
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnCore"
},
"TaskInstanceGroups": [
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-1"
},
{
"InstanceCount": 1,
"InstanceType": {"Ref" : "InstanceType"},
"Market": "ON_DEMAND",
"Name": "cfnTask-2"
}
],
"TerminationProtected" : {"Ref" : "TerminationProtected"},
"Ec2SubnetId" : {"Ref" : "SubnetId"}
},
"Name": "CFNtest",
"JobFlowRole" : {"Ref": "emrEc2InstanceProfile"},
"ServiceRole" : {"Ref": "emrRole"},
"ReleaseLabel" : {"Ref" : "ReleaseLabel"},
"VisibleToAllUsers" : true,
"Tags": [
{
"Key": "key1",
"Value": "value1"
}
]
}
},
"emrRole": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": {"Ref" : "ElasticMapReducePrincipal"}
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole"]
}
},
"emrEc2Role": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": {"Ref" : "Ec2Principal"}
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role"]
}
},
"emrEc2InstanceProfile": {
"Type": "AWS::IAM::InstanceProfile",
"Properties": {
"Path": "/",
"Roles": [ {
"Ref": "emrEc2Role"
} ]
}
}
}
}
```
#### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Parameters:
InstanceType:
Type: String
ReleaseLabel:
Type: String
SubnetId:
Type: String
TerminationProtected:
Type: String
Default: 'false'
ElasticMapReducePrincipal:
Type: String
Ec2Principal:
Type: String
Resources:
cluster:
Type: AWS::EMR::Cluster
Properties:
Instances:
MasterInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnMaster
CoreInstanceGroup:
InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnCore
TaskInstanceGroups:
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-1
- InstanceCount: 1
InstanceType: !Ref InstanceType
Market: ON_DEMAND
Name: cfnTask-2
TerminationProtected: !Ref TerminationProtected
Ec2SubnetId: !Ref SubnetId
Name: CFNtest
JobFlowRole: !Ref emrEc2InstanceProfile
ServiceRole: !Ref emrRole
ReleaseLabel: !Ref ReleaseLabel
VisibleToAllUsers: true
Tags:
- Key: key1
Value: value1
emrRole:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: !Ref ElasticMapReducePrincipal
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole'
emrEc2Role:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: !Ref Ec2Principal
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role'
emrEc2InstanceProfile:
Type: AWS::IAM::InstanceProfile
Properties:
Path: /
Roles:
- !Ref emrEc2Role
```
### Create a cluster with a task instance fleet
The following example template enables you to create a task instance fleet for an EMR cluster.
#### JSON
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"InstanceType" : {
"Type" : "String"
},
"ReleaseLabel" : {
"Type" : "String"
},
"SubnetId" : {
"Type" : "String"
},
"TerminationProtected" : {
"Type" : "String",
"Default" : "false"
},
"ElasticMapReducePrincipal" : {
"Type" : "String"
},
"Ec2Principal" : {
"Type" : "String"
}
},
"Resources": {
"cluster": {
"Type": "AWS::EMR::Cluster",
"Properties": {
"Instances": {
"MasterInstanceFleet": {
"Name": "cfnMaster",
"TargetOnDemandCapacity": 1,
"TargetSpotCapacity": 0,
"InstanceTypeConfigs": [
{
"InstanceType": {"Ref" : "InstanceType"},
"WeightedCapacity": 1
}
]
},
"CoreInstanceFleet": {
"Name": "cfnCore",
"TargetOnDemandCapacity": 1,
"TargetSpotCapacity": 0,
"InstanceTypeConfigs": [
{
"InstanceType": {"Ref" : "InstanceType"},
"WeightedCapacity": 1
}
]
},
"TaskInstanceFleets": [
{
"Name": "cfnTask",
"TargetOnDemandCapacity": 1,
"TargetSpotCapacity": 0,
"InstanceTypeConfigs": [
{
"InstanceType": {"Ref" : "InstanceType"},
"WeightedCapacity": 1
}
]
}
],
"TerminationProtected" : {"Ref" : "TerminationProtected"},
"Ec2SubnetIds" : [
{"Ref" : "SubnetId"}
]
},
"Name": "CFNtest",
"JobFlowRole" : {"Ref": "emrEc2InstanceProfile"},
"ServiceRole" : {"Ref": "emrRole"},
"ReleaseLabel" : {"Ref" : "ReleaseLabel"},
"VisibleToAllUsers" : true,
"Tags": [
{
"Key": "key1",
"Value": "value1"
}
]
}
},
"emrRole": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": {"Ref" : "ElasticMapReducePrincipal"}
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole"]
}
},
"emrEc2Role": {
"Type": "AWS::IAM::Role",
"Properties": {
"AssumeRolePolicyDocument": {
"Version": "2012-10-17" ,
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": {"Ref" : "Ec2Principal"}
},
"Action": "sts:AssumeRole"
}
]
},
"Path": "/",
"ManagedPolicyArns": ["arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role"]
}
},
"emrEc2InstanceProfile": {
"Type": "AWS::IAM::InstanceProfile",
"Properties": {
"Path": "/",
"Roles": [ {
"Ref": "emrEc2Role"
} ]
}
}
}
}
```
#### YAML
```
AWSTemplateFormatVersion: 2010-09-09
Parameters:
InstanceType:
Type: String
ReleaseLabel:
Type: String
SubnetId:
Type: String
TerminationProtected:
Type: String
Default: 'false'
ElasticMapReducePrincipal:
Type: String
Ec2Principal:
Type: String
Resources:
cluster:
Type: AWS::EMR::Cluster
Properties:
Instances:
MasterInstanceFleet:
Name: cfnMaster
TargetOnDemandCapacity: 1
TargetSpotCapacity: 0
InstanceTypeConfigs:
- InstanceType: !Ref InstanceType
WeightedCapacity: 1
CoreInstanceFleet:
Name: cfnCore
TargetOnDemandCapacity: 1
TargetSpotCapacity: 0
InstanceTypeConfigs:
- InstanceType: !Ref InstanceType
WeightedCapacity: 1
TaskInstanceFleets:
- Name: cfnTask
TargetOnDemandCapacity: 1
TargetSpotCapacity: 0
InstanceTypeConfigs:
- InstanceType: !Ref InstanceType
WeightedCapacity: 1
TerminationProtected: !Ref TerminationProtected
Ec2SubnetIds:
- !Ref SubnetId
Name: CFNtest
JobFlowRole: !Ref emrEc2InstanceProfile
ServiceRole: !Ref emrRole
ReleaseLabel: !Ref ReleaseLabel
VisibleToAllUsers: true
Tags:
- Key: key1
Value: value1
emrRole:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: !Ref ElasticMapReducePrincipal
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceRole'
emrEc2Role:
Type: AWS::IAM::Role
Properties:
AssumeRolePolicyDocument:
Version: 2008-10-17
Statement:
- Sid: ''
Effect: Allow
Principal:
Service: !Ref Ec2Principal
Action: 'sts:AssumeRole'
Path: /
ManagedPolicyArns:
- 'arn:aws:iam::aws:policy/service-role/AmazonElasticMapReduceforEC2Role'
emrEc2InstanceProfile:
Type: AWS::IAM::InstanceProfile
Properties:
Path: /
Roles:
- !Ref emrEc2Role
```
# AWS::EMR::Cluster Application
`Application` is a property of `AWS::EMR::Cluster`. The `Application` property type defines the open-source big data applications for EMR to install and configure when a cluster is created.
With Amazon EMR release version 4.0 and later, the only accepted parameter is the application `Name`. To pass arguments to these applications, you use configuration classifications specified using JSON objects in a `Configuration` property. For more information, see [Configuring Applications](https://docs.aws.amazon.com//emr/latest/ReleaseGuide/emr-configure-apps.html).
With earlier Amazon EMR releases, the application is any AWS or third-party software that you can add to the cluster. You can specify the version of the application and arguments to pass to it. Amazon EMR accepts and forwards the argument list to the corresponding installation script as a bootstrap action argument.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AdditionalInfo](#cfn-emr-cluster-application-additionalinfo)" : {Key: Value, ...},
"[Args](#cfn-emr-cluster-application-args)" : [ String, ... ],
"[Name](#cfn-emr-cluster-application-name)" : String,
"[Version](#cfn-emr-cluster-application-version)" : String
}
```
### YAML
```
[AdditionalInfo](#cfn-emr-cluster-application-additionalinfo):
Key: Value
[Args](#cfn-emr-cluster-application-args):
- String
[Name](#cfn-emr-cluster-application-name): String
[Version](#cfn-emr-cluster-application-version): String
```
## Properties
`AdditionalInfo`
This option is for advanced users only. This is meta information about clusters and applications that are used for testing and troubleshooting.
*Required*: No
*Type*: Object of String
*Pattern*: `[a-zA-Z0-9]+`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Args`
Arguments for Amazon EMR to pass to the application.
*Required*: No
*Type*: Array of String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Name`
The name of the application.
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Version`
The version of the application.
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster AutoScalingPolicy
`AutoScalingPolicy` is a subproperty of `InstanceGroupConfig`. `AutoScalingPolicy` defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric. For more information, see [Using Automatic Scaling in Amazon EMR](https://docs.aws.amazon.com//emr/latest/ManagementGuide/emr-automatic-scaling.html) in the *Amazon EMR Management Guide*.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Constraints](#cfn-emr-cluster-autoscalingpolicy-constraints)" : ScalingConstraints,
"[Rules](#cfn-emr-cluster-autoscalingpolicy-rules)" : [ ScalingRule, ... ]
}
```
### YAML
```
[Constraints](#cfn-emr-cluster-autoscalingpolicy-constraints):
ScalingConstraints
[Rules](#cfn-emr-cluster-autoscalingpolicy-rules):
- ScalingRule
```
## Properties
`Constraints`
The upper and lower Amazon EC2 instance limits for an automatic scaling policy. Automatic scaling activity will not cause an instance group to grow above or below these limits.
*Required*: Yes
*Type*: [ScalingConstraints](aws-properties-emr-cluster-scalingconstraints.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Rules`
The scale-in and scale-out rules that comprise the automatic scaling policy.
*Required*: Yes
*Type*: Array of [ScalingRule](aws-properties-emr-cluster-scalingrule.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster AutoTerminationPolicy
An auto-termination policy for an Amazon EMR cluster. An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see [Control cluster termination](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html).
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[IdleTimeout](#cfn-emr-cluster-autoterminationpolicy-idletimeout)" : Integer
}
```
### YAML
```
[IdleTimeout](#cfn-emr-cluster-autoterminationpolicy-idletimeout): Integer
```
## Properties
`IdleTimeout`
Specifies the amount of idle time in seconds after which the cluster automatically terminates. You can specify a minimum of 60 seconds and a maximum of 604800 seconds (seven days).
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster BootstrapActionConfig
`BootstrapActionConfig` is a property of `AWS::EMR::Cluster` that can be used to run bootstrap actions on EMR clusters. You can use a bootstrap action to install software and configure EC2 instances for all cluster nodes before EMR installs and configures open-source big data applications on cluster instances. For more information, see [Create Bootstrap Actions to Install Additional Software](https://docs.aws.amazon.com//emr/latest/ManagementGuide/emr-plan-bootstrap.html) in the *Amazon EMR Management Guide*.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Name](#cfn-emr-cluster-bootstrapactionconfig-name)" : String,
"[ScriptBootstrapAction](#cfn-emr-cluster-bootstrapactionconfig-scriptbootstrapaction)" : ScriptBootstrapActionConfig
}
```
### YAML
```
[Name](#cfn-emr-cluster-bootstrapactionconfig-name): String
[ScriptBootstrapAction](#cfn-emr-cluster-bootstrapactionconfig-scriptbootstrapaction):
ScriptBootstrapActionConfig
```
## Properties
`Name`
The name of the bootstrap action.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`ScriptBootstrapAction`
The script run by the bootstrap action.
*Required*: Yes
*Type*: [ScriptBootstrapActionConfig](aws-properties-emr-cluster-scriptbootstrapactionconfig.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster CloudWatchAlarmDefinition
`CloudWatchAlarmDefinition` is a subproperty of the `ScalingTrigger `property, which determines when to trigger an automatic scaling activity. Scaling activity begins when you satisfy the defined alarm conditions.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[ComparisonOperator](#cfn-emr-cluster-cloudwatchalarmdefinition-comparisonoperator)" : String,
"[Dimensions](#cfn-emr-cluster-cloudwatchalarmdefinition-dimensions)" : [ MetricDimension, ... ],
"[EvaluationPeriods](#cfn-emr-cluster-cloudwatchalarmdefinition-evaluationperiods)" : Integer,
"[MetricName](#cfn-emr-cluster-cloudwatchalarmdefinition-metricname)" : String,
"[Namespace](#cfn-emr-cluster-cloudwatchalarmdefinition-namespace)" : String,
"[Period](#cfn-emr-cluster-cloudwatchalarmdefinition-period)" : Integer,
"[Statistic](#cfn-emr-cluster-cloudwatchalarmdefinition-statistic)" : String,
"[Threshold](#cfn-emr-cluster-cloudwatchalarmdefinition-threshold)" : Number,
"[Unit](#cfn-emr-cluster-cloudwatchalarmdefinition-unit)" : String
}
```
### YAML
```
[ComparisonOperator](#cfn-emr-cluster-cloudwatchalarmdefinition-comparisonoperator): String
[Dimensions](#cfn-emr-cluster-cloudwatchalarmdefinition-dimensions):
- MetricDimension
[EvaluationPeriods](#cfn-emr-cluster-cloudwatchalarmdefinition-evaluationperiods): Integer
[MetricName](#cfn-emr-cluster-cloudwatchalarmdefinition-metricname): String
[Namespace](#cfn-emr-cluster-cloudwatchalarmdefinition-namespace): String
[Period](#cfn-emr-cluster-cloudwatchalarmdefinition-period): Integer
[Statistic](#cfn-emr-cluster-cloudwatchalarmdefinition-statistic): String
[Threshold](#cfn-emr-cluster-cloudwatchalarmdefinition-threshold): Number
[Unit](#cfn-emr-cluster-cloudwatchalarmdefinition-unit): String
```
## Properties
`ComparisonOperator`
Determines how the metric specified by `MetricName` is compared to the value specified by `Threshold`.
*Required*: Yes
*Type*: String
*Allowed values*: `GREATER_THAN_OR_EQUAL | GREATER_THAN | LESS_THAN | LESS_THAN_OR_EQUAL`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Dimensions`
A CloudWatch metric dimension.
*Required*: No
*Type*: Array of [MetricDimension](aws-properties-emr-cluster-metricdimension.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`EvaluationPeriods`
The number of periods, in five-minute increments, during which the alarm condition must exist before the alarm triggers automatic scaling activity. The default value is `1`.
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`MetricName`
The name of the CloudWatch metric that is watched to determine an alarm condition.
*Required*: Yes
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Namespace`
The namespace for the CloudWatch metric. The default is `AWS/ElasticMapReduce`.
*Required*: No
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Period`
The period, in seconds, over which the statistic is applied. CloudWatch metrics for Amazon EMR are emitted every five minutes (300 seconds), so if you specify a CloudWatch metric, specify `300`.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Statistic`
The statistic to apply to the metric associated with the alarm. The default is `AVERAGE`.
*Required*: No
*Type*: String
*Allowed values*: `SAMPLE_COUNT | AVERAGE | SUM | MINIMUM | MAXIMUM`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Threshold`
The value against which the specified statistic is compared.
*Required*: Yes
*Type*: Number
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Unit`
The unit of measure associated with the CloudWatch metric being watched. The value specified for `Unit` must correspond to the units specified in the CloudWatch metric.
*Required*: No
*Type*: String
*Allowed values*: `NONE | SECONDS | MICRO_SECONDS | MILLI_SECONDS | BYTES | KILO_BYTES | MEGA_BYTES | GIGA_BYTES | TERA_BYTES | BITS | KILO_BITS | MEGA_BITS | GIGA_BITS | TERA_BITS | PERCENT | COUNT | BYTES_PER_SECOND | KILO_BYTES_PER_SECOND | MEGA_BYTES_PER_SECOND | GIGA_BYTES_PER_SECOND | TERA_BYTES_PER_SECOND | BITS_PER_SECOND | KILO_BITS_PER_SECOND | MEGA_BITS_PER_SECOND | GIGA_BITS_PER_SECOND | TERA_BITS_PER_SECOND | COUNT_PER_SECOND`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster ComputeLimits
The Amazon EC2 unit limits for a managed scaling policy. The managed scaling activity of a cluster can not be above or below these limits. The limit only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[MaximumCapacityUnits](#cfn-emr-cluster-computelimits-maximumcapacityunits)" : Integer,
"[MaximumCoreCapacityUnits](#cfn-emr-cluster-computelimits-maximumcorecapacityunits)" : Integer,
"[MaximumOnDemandCapacityUnits](#cfn-emr-cluster-computelimits-maximumondemandcapacityunits)" : Integer,
"[MinimumCapacityUnits](#cfn-emr-cluster-computelimits-minimumcapacityunits)" : Integer,
"[UnitType](#cfn-emr-cluster-computelimits-unittype)" : String
}
```
### YAML
```
[MaximumCapacityUnits](#cfn-emr-cluster-computelimits-maximumcapacityunits): Integer
[MaximumCoreCapacityUnits](#cfn-emr-cluster-computelimits-maximumcorecapacityunits): Integer
[MaximumOnDemandCapacityUnits](#cfn-emr-cluster-computelimits-maximumondemandcapacityunits): Integer
[MinimumCapacityUnits](#cfn-emr-cluster-computelimits-minimumcapacityunits): Integer
[UnitType](#cfn-emr-cluster-computelimits-unittype): String
```
## Properties
`MaximumCapacityUnits`
The upper boundary of Amazon EC2 units. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. Managed scaling activities are not allowed beyond this boundary. The limit only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`MaximumCoreCapacityUnits`
The upper boundary of Amazon EC2 units for core node type in a cluster. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. The core units are not allowed to scale beyond this boundary. The parameter is used to split capacity allocation between core and task nodes.
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`MaximumOnDemandCapacityUnits`
The upper boundary of On-Demand Amazon EC2 units. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. The On-Demand units are not allowed to scale beyond this boundary. The parameter is used to split capacity allocation between On-Demand and Spot Instances.
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`MinimumCapacityUnits`
The lower boundary of Amazon EC2 units. It is measured through vCPU cores or instances for instance groups and measured through units for instance fleets. Managed scaling activities are not allowed beyond this boundary. The limit only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`UnitType`
The unit type used for specifying a managed scaling policy.
*Required*: Yes
*Type*: String
*Allowed values*: `InstanceFleetUnits | Instances | VCPU`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster Configuration
**Note**
Used only with Amazon EMR release 4.0 and later.
`Configuration` is a subproperty of `InstanceFleetConfig` or `InstanceGroupConfig`. `Configuration` specifies optional configurations for customizing open-source big data applications and environment parameters. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file. For more information, see [Configuring Applications](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-configure-apps.html) in the *Amazon EMR Release Guide*.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Classification](#cfn-emr-cluster-configuration-classification)" : String,
"[ConfigurationProperties](#cfn-emr-cluster-configuration-configurationproperties)" : {Key: Value, ...},
"[Configurations](#cfn-emr-cluster-configuration-configurations)" : [ Configuration, ... ]
}
```
### YAML
```
[Classification](#cfn-emr-cluster-configuration-classification): String
[ConfigurationProperties](#cfn-emr-cluster-configuration-configurationproperties):
Key: Value
[Configurations](#cfn-emr-cluster-configuration-configurations):
- Configuration
```
## Properties
`Classification`
The classification within a configuration.
*Required*: No
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`ConfigurationProperties`
A list of additional configurations to apply within a configuration object.
*Required*: No
*Type*: Object of String
*Pattern*: `[a-zA-Z0-9]+`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Configurations`
A list of additional configurations to apply within a configuration object.
*Required*: No
*Type*: Array of [Configuration](#aws-properties-emr-cluster-configuration)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster EbsBlockDeviceConfig
`EbsBlockDeviceConfig` is a subproperty of the `EbsConfiguration` property type. `EbsBlockDeviceConfig` defines the number and type of EBS volumes to associate with all EC2 instances in an EMR cluster.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[VolumeSpecification](#cfn-emr-cluster-ebsblockdeviceconfig-volumespecification)" : VolumeSpecification,
"[VolumesPerInstance](#cfn-emr-cluster-ebsblockdeviceconfig-volumesperinstance)" : Integer
}
```
### YAML
```
[VolumeSpecification](#cfn-emr-cluster-ebsblockdeviceconfig-volumespecification):
VolumeSpecification
[VolumesPerInstance](#cfn-emr-cluster-ebsblockdeviceconfig-volumesperinstance): Integer
```
## Properties
`VolumeSpecification`
EBS volume specifications such as volume type, IOPS, size (GiB) and throughput (MiB/s) that are requested for the EBS volume attached to an Amazon EC2 instance in the cluster.
*Required*: Yes
*Type*: [VolumeSpecification](aws-properties-emr-cluster-volumespecification.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`VolumesPerInstance`
Number of EBS volumes with a specific volume configuration that are associated with every instance in the instance group
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster EbsConfiguration
`EbsConfiguration` is a subproperty of `InstanceFleetConfig` or `InstanceGroupConfig`. `EbsConfiguration` determines the EBS volumes to attach to EMR cluster instances.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[EbsBlockDeviceConfigs](#cfn-emr-cluster-ebsconfiguration-ebsblockdeviceconfigs)" : [ EbsBlockDeviceConfig, ... ],
"[EbsOptimized](#cfn-emr-cluster-ebsconfiguration-ebsoptimized)" : Boolean
}
```
### YAML
```
[EbsBlockDeviceConfigs](#cfn-emr-cluster-ebsconfiguration-ebsblockdeviceconfigs):
- EbsBlockDeviceConfig
[EbsOptimized](#cfn-emr-cluster-ebsconfiguration-ebsoptimized): Boolean
```
## Properties
`EbsBlockDeviceConfigs`
An array of Amazon EBS volume specifications attached to a cluster instance.
*Required*: No
*Type*: Array of [EbsBlockDeviceConfig](aws-properties-emr-cluster-ebsblockdeviceconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`EbsOptimized`
Indicates whether an Amazon EBS volume is EBS-optimized. The default is false. You should explicitly set this value to true to enable the Amazon EBS-optimized setting for an EC2 instance.
*Required*: No
*Type*: Boolean
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster HadoopJarStepConfig
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.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Args](#cfn-emr-cluster-hadoopjarstepconfig-args)" : [ String, ... ],
"[Jar](#cfn-emr-cluster-hadoopjarstepconfig-jar)" : String,
"[MainClass](#cfn-emr-cluster-hadoopjarstepconfig-mainclass)" : String,
"[StepProperties](#cfn-emr-cluster-hadoopjarstepconfig-stepproperties)" : [ KeyValue, ... ]
}
```
### YAML
```
[Args](#cfn-emr-cluster-hadoopjarstepconfig-args):
- String
[Jar](#cfn-emr-cluster-hadoopjarstepconfig-jar): String
[MainClass](#cfn-emr-cluster-hadoopjarstepconfig-mainclass): String
[StepProperties](#cfn-emr-cluster-hadoopjarstepconfig-stepproperties):
- KeyValue
```
## Properties
`Args`
A list of command line arguments passed to the JAR file's main function when executed.
*Required*: No
*Type*: Array of String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Jar`
A path to a JAR file run during the step.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`MainClass`
The name of the main class in the specified Java file. If not specified, the JAR file should specify a Main-Class in its manifest file.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`StepProperties`
A list of Java properties that are set when the step runs. You can use these properties to pass key-value pairs to your main function.
*Required*: No
*Type*: Array of [KeyValue](aws-properties-emr-cluster-keyvalue.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster InstanceFleetConfig
Use `InstanceFleetConfig` to define instance fleets for an EMR cluster. A cluster can not use both instance fleets and instance groups. For more information, see [Configure Instance Fleets](https://docs.aws.amazon.com//emr/latest/ManagementGuide/emr-instance-group-configuration.html) in the *Amazon EMR Management Guide*.
**Note**
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[InstanceTypeConfigs](#cfn-emr-cluster-instancefleetconfig-instancetypeconfigs)" : [ InstanceTypeConfig, ... ],
"[LaunchSpecifications](#cfn-emr-cluster-instancefleetconfig-launchspecifications)" : InstanceFleetProvisioningSpecifications,
"[Name](#cfn-emr-cluster-instancefleetconfig-name)" : String,
"[ResizeSpecifications](#cfn-emr-cluster-instancefleetconfig-resizespecifications)" : InstanceFleetResizingSpecifications,
"[TargetOnDemandCapacity](#cfn-emr-cluster-instancefleetconfig-targetondemandcapacity)" : Integer,
"[TargetSpotCapacity](#cfn-emr-cluster-instancefleetconfig-targetspotcapacity)" : Integer
}
```
### YAML
```
[InstanceTypeConfigs](#cfn-emr-cluster-instancefleetconfig-instancetypeconfigs):
- InstanceTypeConfig
[LaunchSpecifications](#cfn-emr-cluster-instancefleetconfig-launchspecifications):
InstanceFleetProvisioningSpecifications
[Name](#cfn-emr-cluster-instancefleetconfig-name): String
[ResizeSpecifications](#cfn-emr-cluster-instancefleetconfig-resizespecifications):
InstanceFleetResizingSpecifications
[TargetOnDemandCapacity](#cfn-emr-cluster-instancefleetconfig-targetondemandcapacity): Integer
[TargetSpotCapacity](#cfn-emr-cluster-instancefleetconfig-targetspotcapacity): Integer
```
## Properties
`InstanceTypeConfigs`
The instance type configurations that define the Amazon EC2 instances in the instance fleet.
*Required*: No
*Type*: Array of [InstanceTypeConfig](aws-properties-emr-cluster-instancetypeconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`LaunchSpecifications`
The launch specification for the instance fleet.
*Required*: No
*Type*: [InstanceFleetProvisioningSpecifications](aws-properties-emr-cluster-instancefleetprovisioningspecifications.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Name`
The friendly name of the instance fleet.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`ResizeSpecifications`
The resize specification for the instance fleet.
*Required*: No
*Type*: [InstanceFleetResizingSpecifications](aws-properties-emr-cluster-instancefleetresizingspecifications.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TargetOnDemandCapacity`
The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand instances as specified by `InstanceTypeConfig`. Each instance configuration has a specified `WeightedCapacity`. When an On-Demand instance is provisioned, the `WeightedCapacity` units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a `WeightedCapacity` of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.
If not specified or set to 0, only Spot instances are provisioned for the instance fleet using `TargetSpotCapacity`. At least one of `TargetSpotCapacity` and `TargetOnDemandCapacity` should be greater than 0. For a master instance fleet, only one of `TargetSpotCapacity` and `TargetOnDemandCapacity` can be specified, and its value must be 1.
*Required*: No
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TargetSpotCapacity`
The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision. When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified by `InstanceTypeConfig`. Each instance configuration has a specified `WeightedCapacity`. When a Spot instance is provisioned, the `WeightedCapacity` units count toward the target capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a `WeightedCapacity` of 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.
If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least one of `TargetSpotCapacity` and `TargetOnDemandCapacity` should be greater than 0. For a master instance fleet, only one of `TargetSpotCapacity` and `TargetOnDemandCapacity` can be specified, and its value must be 1.
*Required*: No
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster InstanceFleetProvisioningSpecifications
`InstanceFleetProvisioningSpecification` is a subproperty of `InstanceFleetConfig`. `InstanceFleetProvisioningSpecification` defines the launch specification for Spot instances in an instance fleet, which determines the defined duration and provisioning timeout behavior for Spot instances.
**Note**
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[OnDemandSpecification](#cfn-emr-cluster-instancefleetprovisioningspecifications-ondemandspecification)" : OnDemandProvisioningSpecification,
"[SpotSpecification](#cfn-emr-cluster-instancefleetprovisioningspecifications-spotspecification)" : SpotProvisioningSpecification
}
```
### YAML
```
[OnDemandSpecification](#cfn-emr-cluster-instancefleetprovisioningspecifications-ondemandspecification):
OnDemandProvisioningSpecification
[SpotSpecification](#cfn-emr-cluster-instancefleetprovisioningspecifications-spotspecification):
SpotProvisioningSpecification
```
## Properties
`OnDemandSpecification`
The launch specification for On-Demand Instances in the instance fleet, which determines the allocation strategy and capacity reservation options.
The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions. On-Demand Instances allocation strategy is available in Amazon EMR releases 5.12.1 and later.
*Required*: No
*Type*: [OnDemandProvisioningSpecification](aws-properties-emr-cluster-ondemandprovisioningspecification.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`SpotSpecification`
The launch specification for Spot instances in the fleet, which determines the allocation strategy, defined duration, and provisioning timeout behavior.
*Required*: No
*Type*: [SpotProvisioningSpecification](aws-properties-emr-cluster-spotprovisioningspecification.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster InstanceFleetResizingSpecifications
The resize specification for On-Demand and Spot Instances in the fleet.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[OnDemandResizeSpecification](#cfn-emr-cluster-instancefleetresizingspecifications-ondemandresizespecification)" : OnDemandResizingSpecification,
"[SpotResizeSpecification](#cfn-emr-cluster-instancefleetresizingspecifications-spotresizespecification)" : SpotResizingSpecification
}
```
### YAML
```
[OnDemandResizeSpecification](#cfn-emr-cluster-instancefleetresizingspecifications-ondemandresizespecification):
OnDemandResizingSpecification
[SpotResizeSpecification](#cfn-emr-cluster-instancefleetresizingspecifications-spotresizespecification):
SpotResizingSpecification
```
## Properties
`OnDemandResizeSpecification`
The resize specification for On-Demand Instances in the instance fleet, which contains the allocation strategy, capacity reservation options, and the resize timeout period.
*Required*: No
*Type*: [OnDemandResizingSpecification](aws-properties-emr-cluster-ondemandresizingspecification.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`SpotResizeSpecification`
The resize specification for Spot Instances in the instance fleet, which contains the allocation strategy and the resize timeout period.
*Required*: No
*Type*: [SpotResizingSpecification](aws-properties-emr-cluster-spotresizingspecification.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster InstanceGroupConfig
Use `InstanceGroupConfig` to define instance groups for an EMR cluster. A cluster can not use both instance groups and instance fleets. For more information, see [Create a Cluster with Instance Fleets or Uniform Instance Groups](https://docs.aws.amazon.com//emr/latest/ManagementGuide/emr-instance-group-configuration.html) in the *Amazon EMR Management Guide*.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AutoScalingPolicy](#cfn-emr-cluster-instancegroupconfig-autoscalingpolicy)" : AutoScalingPolicy,
"[BidPrice](#cfn-emr-cluster-instancegroupconfig-bidprice)" : String,
"[Configurations](#cfn-emr-cluster-instancegroupconfig-configurations)" : [ Configuration, ... ],
"[CustomAmiId](#cfn-emr-cluster-instancegroupconfig-customamiid)" : String,
"[EbsConfiguration](#cfn-emr-cluster-instancegroupconfig-ebsconfiguration)" : EbsConfiguration,
"[InstanceCount](#cfn-emr-cluster-instancegroupconfig-instancecount)" : Integer,
"[InstanceType](#cfn-emr-cluster-instancegroupconfig-instancetype)" : String,
"[Market](#cfn-emr-cluster-instancegroupconfig-market)" : String,
"[Name](#cfn-emr-cluster-instancegroupconfig-name)" : String
}
```
### YAML
```
[AutoScalingPolicy](#cfn-emr-cluster-instancegroupconfig-autoscalingpolicy):
AutoScalingPolicy
[BidPrice](#cfn-emr-cluster-instancegroupconfig-bidprice): String
[Configurations](#cfn-emr-cluster-instancegroupconfig-configurations):
- Configuration
[CustomAmiId](#cfn-emr-cluster-instancegroupconfig-customamiid): String
[EbsConfiguration](#cfn-emr-cluster-instancegroupconfig-ebsconfiguration):
EbsConfiguration
[InstanceCount](#cfn-emr-cluster-instancegroupconfig-instancecount): Integer
[InstanceType](#cfn-emr-cluster-instancegroupconfig-instancetype): String
[Market](#cfn-emr-cluster-instancegroupconfig-market): String
[Name](#cfn-emr-cluster-instancegroupconfig-name): String
```
## Properties
`AutoScalingPolicy`
`AutoScalingPolicy` is a subproperty of the [InstanceGroupConfig](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-properties-emr-cluster-jobflowinstancesconfig-instancegroupconfig.html) property type that specifies the constraints and rules of an automatic scaling policy in Amazon EMR. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric. Only core and task instance groups can use automatic scaling policies. For more information, see [Using Automatic Scaling in Amazon EMR](https://docs.aws.amazon.com//emr/latest/ManagementGuide/emr-automatic-scaling.html).
*Required*: No
*Type*: [AutoScalingPolicy](aws-properties-emr-cluster-autoscalingpolicy.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`BidPrice`
If specified, indicates that the instance group uses Spot Instances. This is the maximum price you are willing to pay for Spot Instances. Specify `OnDemandPrice` to set the amount equal to the On-Demand price, or specify an amount in USD.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Configurations`
Amazon EMR releases 4.x or later.
The list of configurations supplied for an Amazon EMR cluster instance group. You can specify a separate configuration for each instance group (master, core, and task).
*Required*: No
*Type*: Array of [Configuration](aws-properties-emr-cluster-configuration.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`CustomAmiId`
The custom AMI ID to use for the provisioned instance group.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`EbsConfiguration`
EBS configurations that will be attached to each Amazon EC2 instance in the instance group.
*Required*: No
*Type*: [EbsConfiguration](aws-properties-emr-cluster-ebsconfiguration.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`InstanceCount`
Target number of instances for the instance group.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`InstanceType`
The Amazon EC2 instance type for all instances in the instance group.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `1`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Market`
Market type of the Amazon EC2 instances used to create a cluster node.
*Required*: No
*Type*: String
*Allowed values*: `ON_DEMAND | SPOT`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Name`
Friendly name given to the instance group.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster InstanceTypeConfig
**Note**
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
`InstanceTypeConfig` is a sub-property of `InstanceFleetConfig`. `InstanceTypeConfig` determines the EC2 instances that Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[BidPrice](#cfn-emr-cluster-instancetypeconfig-bidprice)" : String,
"[BidPriceAsPercentageOfOnDemandPrice](#cfn-emr-cluster-instancetypeconfig-bidpriceaspercentageofondemandprice)" : Number,
"[Configurations](#cfn-emr-cluster-instancetypeconfig-configurations)" : [ Configuration, ... ],
"[CustomAmiId](#cfn-emr-cluster-instancetypeconfig-customamiid)" : String,
"[EbsConfiguration](#cfn-emr-cluster-instancetypeconfig-ebsconfiguration)" : EbsConfiguration,
"[InstanceType](#cfn-emr-cluster-instancetypeconfig-instancetype)" : String,
"[Priority](#cfn-emr-cluster-instancetypeconfig-priority)" : Number,
"[WeightedCapacity](#cfn-emr-cluster-instancetypeconfig-weightedcapacity)" : Integer
}
```
### YAML
```
[BidPrice](#cfn-emr-cluster-instancetypeconfig-bidprice): String
[BidPriceAsPercentageOfOnDemandPrice](#cfn-emr-cluster-instancetypeconfig-bidpriceaspercentageofondemandprice): Number
[Configurations](#cfn-emr-cluster-instancetypeconfig-configurations):
- Configuration
[CustomAmiId](#cfn-emr-cluster-instancetypeconfig-customamiid): String
[EbsConfiguration](#cfn-emr-cluster-instancetypeconfig-ebsconfiguration):
EbsConfiguration
[InstanceType](#cfn-emr-cluster-instancetypeconfig-instancetype): String
[Priority](#cfn-emr-cluster-instancetypeconfig-priority): Number
[WeightedCapacity](#cfn-emr-cluster-instancetypeconfig-weightedcapacity): Integer
```
## Properties
`BidPrice`
The bid price for each Amazon EC2 Spot Instance type as defined by `InstanceType`. Expressed in USD. If neither `BidPrice` nor `BidPriceAsPercentageOfOnDemandPrice` is provided, `BidPriceAsPercentageOfOnDemandPrice` defaults to 100%.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`BidPriceAsPercentageOfOnDemandPrice`
The bid price, as a percentage of On-Demand price, for each Amazon EC2 Spot Instance as defined by `InstanceType`. Expressed as a number (for example, 20 specifies 20%). If neither `BidPrice` nor `BidPriceAsPercentageOfOnDemandPrice` is provided, `BidPriceAsPercentageOfOnDemandPrice` defaults to 100%.
*Required*: No
*Type*: Number
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Configurations`
A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster.
*Required*: No
*Type*: Array of [Configuration](aws-properties-emr-cluster-configuration.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`CustomAmiId`
The custom AMI ID to use for the instance type.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`EbsConfiguration`
The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each instance as defined by `InstanceType`.
*Required*: No
*Type*: [EbsConfiguration](aws-properties-emr-cluster-ebsconfiguration.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`InstanceType`
An Amazon EC2 instance type, such as `m3.xlarge`.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `1`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Priority`
The priority at which Amazon EMR launches the Amazon EC2 instances with this instance type. Priority starts at 0, which is the highest priority. Amazon EMR considers the highest priority first.
*Required*: No
*Type*: Number
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`WeightedCapacity`
The number of units that a provisioned instance of this type provides toward fulfilling the target capacities defined in `InstanceFleetConfig`. This value is 1 for a master instance fleet, and must be 1 or greater for core and task instance fleets. Defaults to 1 if not specified.
*Required*: No
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# 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.
You can now define task instance groups or task instance fleets using the `TaskInstanceGroups` and `TaskInstanceFleets` subproperties. Using these subproperties reduces delays in provisioning task nodes compared to specifying task nodes with the `InstanceFleetConfig` and `InstanceGroupConfig` resources.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AdditionalMasterSecurityGroups](#cfn-emr-cluster-jobflowinstancesconfig-additionalmastersecuritygroups)" : [ String, ... ],
"[AdditionalSlaveSecurityGroups](#cfn-emr-cluster-jobflowinstancesconfig-additionalslavesecuritygroups)" : [ String, ... ],
"[CoreInstanceFleet](#cfn-emr-cluster-jobflowinstancesconfig-coreinstancefleet)" : InstanceFleetConfig,
"[CoreInstanceGroup](#cfn-emr-cluster-jobflowinstancesconfig-coreinstancegroup)" : InstanceGroupConfig,
"[Ec2KeyName](#cfn-emr-cluster-jobflowinstancesconfig-ec2keyname)" : String,
"[Ec2SubnetId](#cfn-emr-cluster-jobflowinstancesconfig-ec2subnetid)" : String,
"[Ec2SubnetIds](#cfn-emr-cluster-jobflowinstancesconfig-ec2subnetids)" : [ String, ... ],
"[EmrManagedMasterSecurityGroup](#cfn-emr-cluster-jobflowinstancesconfig-emrmanagedmastersecuritygroup)" : String,
"[EmrManagedSlaveSecurityGroup](#cfn-emr-cluster-jobflowinstancesconfig-emrmanagedslavesecuritygroup)" : String,
"[HadoopVersion](#cfn-emr-cluster-jobflowinstancesconfig-hadoopversion)" : String,
"[KeepJobFlowAliveWhenNoSteps](#cfn-emr-cluster-jobflowinstancesconfig-keepjobflowalivewhennosteps)" : Boolean,
"[MasterInstanceFleet](#cfn-emr-cluster-jobflowinstancesconfig-masterinstancefleet)" : InstanceFleetConfig,
"[MasterInstanceGroup](#cfn-emr-cluster-jobflowinstancesconfig-masterinstancegroup)" : InstanceGroupConfig,
"[Placement](#cfn-emr-cluster-jobflowinstancesconfig-placement)" : PlacementType,
"[ServiceAccessSecurityGroup](#cfn-emr-cluster-jobflowinstancesconfig-serviceaccesssecuritygroup)" : String,
"[TaskInstanceFleets](#cfn-emr-cluster-jobflowinstancesconfig-taskinstancefleets)" : [ InstanceFleetConfig, ... ],
"[TaskInstanceGroups](#cfn-emr-cluster-jobflowinstancesconfig-taskinstancegroups)" : [ InstanceGroupConfig, ... ],
"[TerminationProtected](#cfn-emr-cluster-jobflowinstancesconfig-terminationprotected)" : Boolean,
"[UnhealthyNodeReplacement](#cfn-emr-cluster-jobflowinstancesconfig-unhealthynodereplacement)" : Boolean
}
```
### YAML
```
[AdditionalMasterSecurityGroups](#cfn-emr-cluster-jobflowinstancesconfig-additionalmastersecuritygroups):
- String
[AdditionalSlaveSecurityGroups](#cfn-emr-cluster-jobflowinstancesconfig-additionalslavesecuritygroups):
- String
[CoreInstanceFleet](#cfn-emr-cluster-jobflowinstancesconfig-coreinstancefleet):
InstanceFleetConfig
[CoreInstanceGroup](#cfn-emr-cluster-jobflowinstancesconfig-coreinstancegroup):
InstanceGroupConfig
[Ec2KeyName](#cfn-emr-cluster-jobflowinstancesconfig-ec2keyname): String
[Ec2SubnetId](#cfn-emr-cluster-jobflowinstancesconfig-ec2subnetid): String
[Ec2SubnetIds](#cfn-emr-cluster-jobflowinstancesconfig-ec2subnetids):
- String
[EmrManagedMasterSecurityGroup](#cfn-emr-cluster-jobflowinstancesconfig-emrmanagedmastersecuritygroup): String
[EmrManagedSlaveSecurityGroup](#cfn-emr-cluster-jobflowinstancesconfig-emrmanagedslavesecuritygroup): String
[HadoopVersion](#cfn-emr-cluster-jobflowinstancesconfig-hadoopversion): String
[KeepJobFlowAliveWhenNoSteps](#cfn-emr-cluster-jobflowinstancesconfig-keepjobflowalivewhennosteps): Boolean
[MasterInstanceFleet](#cfn-emr-cluster-jobflowinstancesconfig-masterinstancefleet):
InstanceFleetConfig
[MasterInstanceGroup](#cfn-emr-cluster-jobflowinstancesconfig-masterinstancegroup):
InstanceGroupConfig
[Placement](#cfn-emr-cluster-jobflowinstancesconfig-placement):
PlacementType
[ServiceAccessSecurityGroup](#cfn-emr-cluster-jobflowinstancesconfig-serviceaccesssecuritygroup): String
[TaskInstanceFleets](#cfn-emr-cluster-jobflowinstancesconfig-taskinstancefleets):
- InstanceFleetConfig
[TaskInstanceGroups](#cfn-emr-cluster-jobflowinstancesconfig-taskinstancegroups):
- InstanceGroupConfig
[TerminationProtected](#cfn-emr-cluster-jobflowinstancesconfig-terminationprotected): Boolean
[UnhealthyNodeReplacement](#cfn-emr-cluster-jobflowinstancesconfig-unhealthynodereplacement): Boolean
```
## Properties
`AdditionalMasterSecurityGroups`
A list of additional Amazon EC2 security group IDs for the master node.
*Required*: No
*Type*: Array of String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`AdditionalSlaveSecurityGroups`
A list of additional Amazon EC2 security group IDs for the core and task nodes.
*Required*: No
*Type*: Array of String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`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](aws-properties-emr-cluster-instancefleetconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`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](aws-properties-emr-cluster-instancegroupconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Ec2KeyName`
The name of the Amazon EC2 key pair that can be used to connect to the master node using SSH as the user called "hadoop."
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`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
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Ec2SubnetIds`
Applies to clusters that use the instance fleet configuration. When multiple Amazon EC2 subnet IDs are specified, Amazon EMR evaluates them and launches instances in the optimal subnet.
The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions.
*Required*: No
*Type*: Array of String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`EmrManagedMasterSecurityGroup`
The identifier of the Amazon EC2 security group for the master node. If you specify `EmrManagedMasterSecurityGroup`, you must also specify `EmrManagedSlaveSecurityGroup`.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`EmrManagedSlaveSecurityGroup`
The identifier of the Amazon EC2 security group for the core and task nodes. If you specify `EmrManagedSlaveSecurityGroup`, you must also specify `EmrManagedMasterSecurityGroup`.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`HadoopVersion`
Applies only to Amazon EMR release versions earlier than 4.0. The Hadoop version for the cluster. Valid inputs are "0.18" (no longer maintained), "0.20" (no longer maintained), "0.20.205" (no longer maintained), "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
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`KeepJobFlowAliveWhenNoSteps`
Specifies whether the cluster should remain available after completing all steps. Defaults to `false`. For more information about configuring cluster termination, see [Control Cluster Termination](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-termination.html) in the *EMR Management Guide*.
*Required*: No
*Type*: Boolean
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`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](aws-properties-emr-cluster-instancefleetconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`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](aws-properties-emr-cluster-instancegroupconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Placement`
The Availability Zone in which the cluster runs.
*Required*: No
*Type*: [PlacementType](aws-properties-emr-cluster-placementtype.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`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
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TaskInstanceFleets`
Describes the EC2 instances and instance configurations for the task instance fleets when using clusters with the instance fleet configuration. These task instance fleets are added to the cluster as part of the cluster launch. Each task instance fleet must have a unique name specified so that CloudFormation can differentiate between the task instance fleets.
You can currently specify only one task instance fleet for a cluster. After creating the cluster, you can only modify the mutable properties of `InstanceFleetConfig`, which are `TargetOnDemandCapacity` and `TargetSpotCapacity`. Modifying any other property results in cluster replacement.
To allow a maximum of 30 Amazon EC2 instance types per fleet, include `TaskInstanceFleets` when you create your cluster. If you create your cluster without `TaskInstanceFleets`, Amazon EMR uses its default allocation strategy, which allows for a maximum of five Amazon EC2 instance types.
*Required*: No
*Type*: Array of [InstanceFleetConfig](aws-properties-emr-cluster-instancefleetconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TaskInstanceGroups`
Describes the EC2 instances and instance configurations for task instance groups when using clusters with the uniform instance group configuration. These task instance groups are added to the cluster as part of the cluster launch. Each task instance group must have a unique name specified so that CloudFormation can differentiate between the task instance groups.
After creating the cluster, you can only modify the mutable properties of `InstanceGroupConfig`, which are `AutoScalingPolicy` and `InstanceCount`. Modifying any other property results in cluster replacement.
*Required*: No
*Type*: Array of [InstanceGroupConfig](aws-properties-emr-cluster-instancegroupconfig.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`UnhealthyNodeReplacement`
Indicates whether Amazon EMR should gracefully replace core nodes that have degraded within the cluster.
*Required*: No
*Type*: Boolean
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster KerberosAttributes
`KerberosAttributes` is a property of the `AWS::EMR::Cluster` resource. `KerberosAttributes` define the cluster-specific Kerberos configuration when Kerberos authentication is enabled using a security configuration. The cluster-specific configuration must be compatible with the security configuration. For more information see [Use Kerberos Authentication](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-kerberos.html) in the *EMR Management Guide*.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[ADDomainJoinPassword](#cfn-emr-cluster-kerberosattributes-addomainjoinpassword)" : String,
"[ADDomainJoinUser](#cfn-emr-cluster-kerberosattributes-addomainjoinuser)" : String,
"[CrossRealmTrustPrincipalPassword](#cfn-emr-cluster-kerberosattributes-crossrealmtrustprincipalpassword)" : String,
"[KdcAdminPassword](#cfn-emr-cluster-kerberosattributes-kdcadminpassword)" : String,
"[Realm](#cfn-emr-cluster-kerberosattributes-realm)" : String
}
```
### YAML
```
[ADDomainJoinPassword](#cfn-emr-cluster-kerberosattributes-addomainjoinpassword): String
[ADDomainJoinUser](#cfn-emr-cluster-kerberosattributes-addomainjoinuser): String
[CrossRealmTrustPrincipalPassword](#cfn-emr-cluster-kerberosattributes-crossrealmtrustprincipalpassword): String
[KdcAdminPassword](#cfn-emr-cluster-kerberosattributes-kdcadminpassword): String
[Realm](#cfn-emr-cluster-kerberosattributes-realm): String
```
## Properties
`ADDomainJoinPassword`
The Active Directory password for `ADDomainJoinUser`.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`ADDomainJoinUser`
Required only when establishing a cross-realm trust with an Active Directory domain. A user with sufficient privileges to join resources to the domain.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`CrossRealmTrustPrincipalPassword`
Required only when establishing a cross-realm trust with a KDC in a different realm. The cross-realm principal password, which must be identical across realms.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`KdcAdminPassword`
The password used within the cluster for the kadmin service on the cluster-dedicated KDC, which maintains Kerberos principals, password policies, and keytabs for the cluster.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Realm`
The name of the Kerberos realm to which all nodes in a cluster belong. For example, `EC2.INTERNAL`.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster KeyValue
`KeyValue` is a subproperty of the `HadoopJarStepConfig` property type. `KeyValue` is used to pass parameters to a step.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Key](#cfn-emr-cluster-keyvalue-key)" : String,
"[Value](#cfn-emr-cluster-keyvalue-value)" : String
}
```
### YAML
```
[Key](#cfn-emr-cluster-keyvalue-key): String
[Value](#cfn-emr-cluster-keyvalue-value): String
```
## Properties
`Key`
The unique identifier of a key-value pair.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Value`
The value part of the identified key.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster ManagedScalingPolicy
Managed scaling policy for an Amazon EMR cluster. The policy specifies the limits for resources that can be added or terminated from a cluster. The policy only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[ComputeLimits](#cfn-emr-cluster-managedscalingpolicy-computelimits)" : ComputeLimits,
"[ScalingStrategy](#cfn-emr-cluster-managedscalingpolicy-scalingstrategy)" : String,
"[UtilizationPerformanceIndex](#cfn-emr-cluster-managedscalingpolicy-utilizationperformanceindex)" : Integer
}
```
### YAML
```
[ComputeLimits](#cfn-emr-cluster-managedscalingpolicy-computelimits):
ComputeLimits
[ScalingStrategy](#cfn-emr-cluster-managedscalingpolicy-scalingstrategy): String
[UtilizationPerformanceIndex](#cfn-emr-cluster-managedscalingpolicy-utilizationperformanceindex): Integer
```
## Properties
`ComputeLimits`
The Amazon EC2 unit limits for a managed scaling policy. The managed scaling activity of a cluster is not allowed to go above or below these limits. The limit only applies to the core and task nodes. The master node cannot be scaled after initial configuration.
*Required*: No
*Type*: [ComputeLimits](aws-properties-emr-cluster-computelimits.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`ScalingStrategy`
Determines whether a custom scaling utilization performance index can be set. Possible values include *ADVANCED* or *DEFAULT*.
*Required*: No
*Type*: String
*Allowed values*: `DEFAULT | ADVANCED`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`UtilizationPerformanceIndex`
An integer value that represents an advanced scaling strategy. Setting a higher value optimizes for performance. Setting a lower value optimizes for resource conservation. Setting the value to 50 balances performance and resource conservation. Possible values are 1, 25, 50, 75, and 100.
*Required*: No
*Type*: Integer
*Minimum*: `1`
*Maximum*: `100`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster MetricDimension
`MetricDimension` is a subproperty of the `CloudWatchAlarmDefinition` property type. `MetricDimension` specifies a CloudWatch dimension, which is specified with a `Key``Value` pair. The key is known as a `Name` in CloudWatch. By default, Amazon EMR uses one dimension whose `Key` is `JobFlowID` and `Value` is a variable representing the cluster ID, which is `${emr.clusterId}`. This enables the automatic scaling rule for EMR to bootstrap when the cluster ID becomes available during cluster creation.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Key](#cfn-emr-cluster-metricdimension-key)" : String,
"[Value](#cfn-emr-cluster-metricdimension-value)" : String
}
```
### YAML
```
[Key](#cfn-emr-cluster-metricdimension-key): String
[Value](#cfn-emr-cluster-metricdimension-value): String
```
## Properties
`Key`
The dimension name.
*Required*: Yes
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Value`
The dimension value.
*Required*: Yes
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster OnDemandCapacityReservationOptions
Describes the strategy for using unused Capacity Reservations for fulfilling On-Demand capacity.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[CapacityReservationPreference](#cfn-emr-cluster-ondemandcapacityreservationoptions-capacityreservationpreference)" : String,
"[CapacityReservationResourceGroupArn](#cfn-emr-cluster-ondemandcapacityreservationoptions-capacityreservationresourcegrouparn)" : String,
"[UsageStrategy](#cfn-emr-cluster-ondemandcapacityreservationoptions-usagestrategy)" : String
}
```
### YAML
```
[CapacityReservationPreference](#cfn-emr-cluster-ondemandcapacityreservationoptions-capacityreservationpreference): String
[CapacityReservationResourceGroupArn](#cfn-emr-cluster-ondemandcapacityreservationoptions-capacityreservationresourcegrouparn): String
[UsageStrategy](#cfn-emr-cluster-ondemandcapacityreservationoptions-usagestrategy): String
```
## Properties
`CapacityReservationPreference`
Indicates the instance's Capacity Reservation preferences. Possible preferences include:
+ `open` - The instance can run in any open Capacity Reservation that has matching attributes (instance type, platform, Availability Zone).
+ `none` - The instance avoids running in a Capacity Reservation even if one is available. The instance runs as an On-Demand Instance.
*Required*: No
*Type*: String
*Allowed values*: `open | none`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`CapacityReservationResourceGroupArn`
The ARN of the Capacity Reservation resource group in which to run the instance.
*Required*: No
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`UsageStrategy`
Indicates whether to use unused Capacity Reservations for fulfilling On-Demand capacity.
If you specify `use-capacity-reservations-first`, the fleet uses unused Capacity Reservations to fulfill On-Demand capacity up to the target On-Demand capacity. If multiple instance pools have unused Capacity Reservations, the On-Demand allocation strategy (`lowest-price`) is applied. If the number of unused Capacity Reservations is less than the On-Demand target capacity, the remaining On-Demand target capacity is launched according to the On-Demand allocation strategy (`lowest-price`).
If you do not specify a value, the fleet fulfills the On-Demand capacity according to the chosen On-Demand allocation strategy.
*Required*: No
*Type*: String
*Allowed values*: `use-capacity-reservations-first`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster OnDemandProvisioningSpecification
The launch specification for On-Demand Instances in the instance fleet, which determines the allocation strategy.
**Note**
The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions. On-Demand Instances allocation strategy is available in Amazon EMR releases 5.12.1 and later.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AllocationStrategy](#cfn-emr-cluster-ondemandprovisioningspecification-allocationstrategy)" : String,
"[CapacityReservationOptions](#cfn-emr-cluster-ondemandprovisioningspecification-capacityreservationoptions)" : OnDemandCapacityReservationOptions
}
```
### YAML
```
[AllocationStrategy](#cfn-emr-cluster-ondemandprovisioningspecification-allocationstrategy): String
[CapacityReservationOptions](#cfn-emr-cluster-ondemandprovisioningspecification-capacityreservationoptions):
OnDemandCapacityReservationOptions
```
## Properties
`AllocationStrategy`
Specifies the strategy to use in launching On-Demand instance fleets. Available options are `lowest-price` and `prioritized`. `lowest-price` specifies to launch the instances with the lowest price first, and `prioritized` specifies that Amazon EMR should launch the instances with the highest priority first. The default is `lowest-price`.
*Required*: Yes
*Type*: String
*Allowed values*: `lowest-price | prioritized`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`CapacityReservationOptions`
The launch specification for On-Demand instances in the instance fleet, which determines the allocation strategy.
*Required*: No
*Type*: [OnDemandCapacityReservationOptions](aws-properties-emr-cluster-ondemandcapacityreservationoptions.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster OnDemandResizingSpecification
The resize specification for On-Demand Instances in the instance fleet, which contains the resize timeout period.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AllocationStrategy](#cfn-emr-cluster-ondemandresizingspecification-allocationstrategy)" : String,
"[CapacityReservationOptions](#cfn-emr-cluster-ondemandresizingspecification-capacityreservationoptions)" : OnDemandCapacityReservationOptions,
"[TimeoutDurationMinutes](#cfn-emr-cluster-ondemandresizingspecification-timeoutdurationminutes)" : Integer
}
```
### YAML
```
[AllocationStrategy](#cfn-emr-cluster-ondemandresizingspecification-allocationstrategy): String
[CapacityReservationOptions](#cfn-emr-cluster-ondemandresizingspecification-capacityreservationoptions):
OnDemandCapacityReservationOptions
[TimeoutDurationMinutes](#cfn-emr-cluster-ondemandresizingspecification-timeoutdurationminutes): Integer
```
## Properties
`AllocationStrategy`
Specifies the allocation strategy to use to launch On-Demand instances during a resize. The default is `lowest-price`.
*Required*: No
*Type*: String
*Allowed values*: `lowest-price | prioritized`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`CapacityReservationOptions`
Property description not available.
*Required*: No
*Type*: [OnDemandCapacityReservationOptions](aws-properties-emr-cluster-ondemandcapacityreservationoptions.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TimeoutDurationMinutes`
On-Demand resize timeout in minutes. If On-Demand Instances are not provisioned within this time, the resize workflow stops. The minimum value is 5 minutes, and the maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.
*Required*: No
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster PlacementGroupConfig
Placement group configuration for an Amazon EMR cluster. The configuration specifies the placement strategy that can be applied to instance roles during cluster creation.
To use this configuration, consider attaching managed policy AmazonElasticMapReducePlacementGroupPolicy to the Amazon EMR role.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[InstanceRole](#cfn-emr-cluster-placementgroupconfig-instancerole)" : String,
"[PlacementStrategy](#cfn-emr-cluster-placementgroupconfig-placementstrategy)" : String
}
```
### YAML
```
[InstanceRole](#cfn-emr-cluster-placementgroupconfig-instancerole): String
[PlacementStrategy](#cfn-emr-cluster-placementgroupconfig-placementstrategy): String
```
## Properties
`InstanceRole`
Role of the instance in the cluster.
Starting with Amazon EMR release 5.23.0, the only supported instance role is `MASTER`.
*Required*: Yes
*Type*: String
*Allowed values*: `MASTER | CORE | TASK`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`PlacementStrategy`
Amazon EC2 Placement Group strategy associated with instance role.
Starting with Amazon EMR release 5.23.0, the only supported placement strategy is `SPREAD` for the `MASTER` instance role.
*Required*: No
*Type*: String
*Allowed values*: `SPREAD | PARTITION | CLUSTER | NONE`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster PlacementType
`PlacementType` is a property of the `AWS::EMR::Cluster` resource. `PlacementType` determines the Amazon EC2 Availability Zone configuration of the cluster (job flow).
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AvailabilityZone](#cfn-emr-cluster-placementtype-availabilityzone)" : String
}
```
### YAML
```
[AvailabilityZone](#cfn-emr-cluster-placementtype-availabilityzone): String
```
## Properties
`AvailabilityZone`
The Amazon EC2 Availability Zone for the cluster. `AvailabilityZone` is used for uniform instance groups, while `AvailabilityZones` (plural) is used for instance fleets.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster ScalingAction
`ScalingAction` is a subproperty of the `ScalingRule` property type. `ScalingAction` determines the type of adjustment the automatic scaling activity makes when triggered, and the periodicity of the adjustment.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Market](#cfn-emr-cluster-scalingaction-market)" : String,
"[SimpleScalingPolicyConfiguration](#cfn-emr-cluster-scalingaction-simplescalingpolicyconfiguration)" : SimpleScalingPolicyConfiguration
}
```
### YAML
```
[Market](#cfn-emr-cluster-scalingaction-market): String
[SimpleScalingPolicyConfiguration](#cfn-emr-cluster-scalingaction-simplescalingpolicyconfiguration):
SimpleScalingPolicyConfiguration
```
## Properties
`Market`
Not available for instance groups. Instance groups use the market type specified for the group.
*Required*: No
*Type*: String
*Allowed values*: `ON_DEMAND | SPOT`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`SimpleScalingPolicyConfiguration`
The type of adjustment the automatic scaling activity makes when triggered, and the periodicity of the adjustment.
*Required*: Yes
*Type*: [SimpleScalingPolicyConfiguration](aws-properties-emr-cluster-simplescalingpolicyconfiguration.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster ScalingConstraints
`ScalingConstraints` is a subproperty of the `AutoScalingPolicy` property type. `ScalingConstraints` defines the upper and lower EC2 instance limits for an automatic scaling policy. Automatic scaling activities triggered by automatic scaling rules will not cause an instance group to grow above or shrink below these limits.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[MaxCapacity](#cfn-emr-cluster-scalingconstraints-maxcapacity)" : Integer,
"[MinCapacity](#cfn-emr-cluster-scalingconstraints-mincapacity)" : Integer
}
```
### YAML
```
[MaxCapacity](#cfn-emr-cluster-scalingconstraints-maxcapacity): Integer
[MinCapacity](#cfn-emr-cluster-scalingconstraints-mincapacity): Integer
```
## Properties
`MaxCapacity`
The upper boundary of Amazon EC2 instances in an instance group beyond which scaling activities are not allowed to grow. Scale-out activities will not add instances beyond this boundary.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`MinCapacity`
The lower boundary of Amazon EC2 instances in an instance group below which scaling activities are not allowed to shrink. Scale-in activities will not terminate instances below this boundary.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster ScalingRule
`ScalingRule` is a subproperty of the `AutoScalingPolicy` property type. `ScalingRule` defines the scale-in or scale-out rules for scaling activity, including the CloudWatch metric alarm that triggers activity, how EC2 instances are added or removed, and the periodicity of adjustments. The automatic scaling policy for an instance group can comprise one or more automatic scaling rules.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Action](#cfn-emr-cluster-scalingrule-action)" : ScalingAction,
"[Description](#cfn-emr-cluster-scalingrule-description)" : String,
"[Name](#cfn-emr-cluster-scalingrule-name)" : String,
"[Trigger](#cfn-emr-cluster-scalingrule-trigger)" : ScalingTrigger
}
```
### YAML
```
[Action](#cfn-emr-cluster-scalingrule-action):
ScalingAction
[Description](#cfn-emr-cluster-scalingrule-description): String
[Name](#cfn-emr-cluster-scalingrule-name): String
[Trigger](#cfn-emr-cluster-scalingrule-trigger):
ScalingTrigger
```
## Properties
`Action`
The conditions that trigger an automatic scaling activity.
*Required*: Yes
*Type*: [ScalingAction](aws-properties-emr-cluster-scalingaction.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Description`
A friendly, more verbose description of the automatic scaling rule.
*Required*: No
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Name`
The name used to identify an automatic scaling rule. Rule names must be unique within a scaling policy.
*Required*: Yes
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Trigger`
The CloudWatch alarm definition that determines when automatic scaling activity is triggered.
*Required*: Yes
*Type*: [ScalingTrigger](aws-properties-emr-cluster-scalingtrigger.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster ScalingTrigger
`ScalingTrigger` is a subproperty of the `ScalingRule` property type. `ScalingTrigger` determines the conditions that trigger an automatic scaling activity.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[CloudWatchAlarmDefinition](#cfn-emr-cluster-scalingtrigger-cloudwatchalarmdefinition)" : CloudWatchAlarmDefinition
}
```
### YAML
```
[CloudWatchAlarmDefinition](#cfn-emr-cluster-scalingtrigger-cloudwatchalarmdefinition):
CloudWatchAlarmDefinition
```
## Properties
`CloudWatchAlarmDefinition`
The definition of a CloudWatch metric alarm. When the defined alarm conditions are met along with other trigger parameters, scaling activity begins.
*Required*: Yes
*Type*: [CloudWatchAlarmDefinition](aws-properties-emr-cluster-cloudwatchalarmdefinition.md)
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster ScriptBootstrapActionConfig
`ScriptBootstrapActionConfig` is a subproperty of the `BootstrapActionConfig` property type. `ScriptBootstrapActionConfig` specifies the arguments and location of the bootstrap script for EMR to run on all cluster nodes before it installs open-source big data applications on them.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Args](#cfn-emr-cluster-scriptbootstrapactionconfig-args)" : [ String, ... ],
"[Path](#cfn-emr-cluster-scriptbootstrapactionconfig-path)" : String
}
```
### YAML
```
[Args](#cfn-emr-cluster-scriptbootstrapactionconfig-args):
- String
[Path](#cfn-emr-cluster-scriptbootstrapactionconfig-path): String
```
## Properties
`Args`
A list of command line arguments to pass to the bootstrap action script.
*Required*: No
*Type*: Array of String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Path`
Location in Amazon S3 of the script to run during a bootstrap action.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `10280`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster SimpleScalingPolicyConfiguration
`SimpleScalingPolicyConfiguration` is a subproperty of the `ScalingAction` property type. `SimpleScalingPolicyConfiguration` determines how an automatic scaling action adds or removes instances, the cooldown period, and the number of EC2 instances that are added each time the CloudWatch metric alarm condition is satisfied.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AdjustmentType](#cfn-emr-cluster-simplescalingpolicyconfiguration-adjustmenttype)" : String,
"[CoolDown](#cfn-emr-cluster-simplescalingpolicyconfiguration-cooldown)" : Integer,
"[ScalingAdjustment](#cfn-emr-cluster-simplescalingpolicyconfiguration-scalingadjustment)" : Integer
}
```
### YAML
```
[AdjustmentType](#cfn-emr-cluster-simplescalingpolicyconfiguration-adjustmenttype): String
[CoolDown](#cfn-emr-cluster-simplescalingpolicyconfiguration-cooldown): Integer
[ScalingAdjustment](#cfn-emr-cluster-simplescalingpolicyconfiguration-scalingadjustment): Integer
```
## Properties
`AdjustmentType`
The way in which Amazon EC2 instances are added (if `ScalingAdjustment` is a positive number) or terminated (if `ScalingAdjustment` is a negative number) each time the scaling activity is triggered. `CHANGE_IN_CAPACITY` is the default. `CHANGE_IN_CAPACITY` indicates that the Amazon EC2 instance count increments or decrements by `ScalingAdjustment`, which should be expressed as an integer. `PERCENT_CHANGE_IN_CAPACITY` indicates the instance count increments or decrements by the percentage specified by `ScalingAdjustment`, which should be expressed as an integer. For example, 20 indicates an increase in 20% increments of cluster capacity. `EXACT_CAPACITY` indicates the scaling activity results in an instance group with the number of Amazon EC2 instances specified by `ScalingAdjustment`, which should be expressed as a positive integer.
*Required*: No
*Type*: String
*Allowed values*: `CHANGE_IN_CAPACITY | PERCENT_CHANGE_IN_CAPACITY | EXACT_CAPACITY`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`CoolDown`
The amount of time, in seconds, after a scaling activity completes before any further trigger-related scaling activities can start. The default value is 0.
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`ScalingAdjustment`
The amount by which to scale in or scale out, based on the specified `AdjustmentType`. A positive value adds to the instance group's Amazon EC2 instance count while a negative number removes instances. If `AdjustmentType` is set to `EXACT_CAPACITY`, the number should only be a positive integer. If `AdjustmentType` is set to `PERCENT_CHANGE_IN_CAPACITY`, the value should express the percentage as an integer. For example, -20 indicates a decrease in 20% increments of cluster capacity.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster SpotProvisioningSpecification
`SpotProvisioningSpecification` is a subproperty of the `InstanceFleetProvisioningSpecifications` property type. `SpotProvisioningSpecification` determines the launch specification for Spot instances in the instance fleet, which includes the defined duration and provisioning timeout behavior.
**Note**
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AllocationStrategy](#cfn-emr-cluster-spotprovisioningspecification-allocationstrategy)" : String,
"[BlockDurationMinutes](#cfn-emr-cluster-spotprovisioningspecification-blockdurationminutes)" : Integer,
"[TimeoutAction](#cfn-emr-cluster-spotprovisioningspecification-timeoutaction)" : String,
"[TimeoutDurationMinutes](#cfn-emr-cluster-spotprovisioningspecification-timeoutdurationminutes)" : Integer
}
```
### YAML
```
[AllocationStrategy](#cfn-emr-cluster-spotprovisioningspecification-allocationstrategy): String
[BlockDurationMinutes](#cfn-emr-cluster-spotprovisioningspecification-blockdurationminutes): Integer
[TimeoutAction](#cfn-emr-cluster-spotprovisioningspecification-timeoutaction): String
[TimeoutDurationMinutes](#cfn-emr-cluster-spotprovisioningspecification-timeoutdurationminutes): Integer
```
## Properties
`AllocationStrategy`
Specifies one of the following strategies to launch Spot Instance fleets: `capacity-optimized`, `price-capacity-optimized`, `lowest-price`, or `diversified`, and `capacity-optimized-prioritized`. For more information on the provisioning strategies, see [Allocation strategies for Spot Instances](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-fleet-allocation-strategy.html) in the *Amazon EC2 User Guide for Linux Instances*.
When you launch a Spot Instance fleet with the old console, it automatically launches with the `capacity-optimized` strategy. You can't change the allocation strategy from the old console.
*Required*: No
*Type*: String
*Allowed values*: `capacity-optimized | price-capacity-optimized | lowest-price | diversified | capacity-optimized-prioritized`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`BlockDurationMinutes`
The defined duration for Spot Instances (also known as Spot blocks) in minutes. When specified, the Spot Instance does not terminate before the defined duration expires, and defined duration pricing for Spot Instances applies. Valid values are 60, 120, 180, 240, 300, or 360. The duration period starts as soon as a Spot Instance receives its instance ID. At the end of the duration, Amazon EC2 marks the Spot Instance for termination and provides a Spot Instance termination notice, which gives the instance a two-minute warning before it terminates.
Spot Instances with a defined duration (also known as Spot blocks) are no longer available to new customers from July 1, 2021. For customers who have previously used the feature, we will continue to support Spot Instances with a defined duration until December 31, 2022.
*Required*: No
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TimeoutAction`
The action to take when `TargetSpotCapacity` has not been fulfilled when the `TimeoutDurationMinutes` has expired; that is, when all Spot Instances could not be provisioned within the Spot provisioning timeout. Valid values are `TERMINATE_CLUSTER` and `SWITCH_TO_ON_DEMAND`. SWITCH\$1TO\$1ON\$1DEMAND specifies that if no Spot Instances are available, On-Demand Instances should be provisioned to fulfill any remaining Spot capacity.
*Required*: Yes
*Type*: String
*Allowed values*: `SWITCH_TO_ON_DEMAND | TERMINATE_CLUSTER`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TimeoutDurationMinutes`
The Spot provisioning timeout period in minutes. If Spot Instances are not provisioned within this time period, the `TimeOutAction` is taken. Minimum value is 5 and maximum value is 1440. The timeout applies only during initial provisioning, when the cluster is first created.
*Required*: Yes
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster SpotResizingSpecification
The resize specification for Spot Instances in the instance fleet, which contains the resize timeout period.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[AllocationStrategy](#cfn-emr-cluster-spotresizingspecification-allocationstrategy)" : String,
"[TimeoutDurationMinutes](#cfn-emr-cluster-spotresizingspecification-timeoutdurationminutes)" : Integer
}
```
### YAML
```
[AllocationStrategy](#cfn-emr-cluster-spotresizingspecification-allocationstrategy): String
[TimeoutDurationMinutes](#cfn-emr-cluster-spotresizingspecification-timeoutdurationminutes): Integer
```
## Properties
`AllocationStrategy`
Specifies the allocation strategy to use to launch Spot instances during a resize. If you run Amazon EMR releases 6.9.0 or higher, the default is `price-capacity-optimized`. If you run Amazon EMR releases 6.8.0 or lower, the default is `capacity-optimized`.
*Required*: No
*Type*: String
*Allowed values*: `capacity-optimized | price-capacity-optimized | lowest-price | diversified | capacity-optimized-prioritized`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`TimeoutDurationMinutes`
Spot resize timeout in minutes. If Spot Instances are not provisioned within this time, the resize workflow will stop provisioning of Spot instances. Minimum value is 5 minutes and maximum value is 10,080 minutes (7 days). The timeout applies to all resize workflows on the Instance Fleet. The resize could be triggered by Amazon EMR Managed Scaling or by the customer (via Amazon EMR Console, Amazon EMR CLI modify-instance-fleet or Amazon EMR SDK ModifyInstanceFleet API) or by Amazon EMR due to Amazon EC2 Spot Reclamation.
*Required*: No
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster StepConfig
`StepConfig` is a property of the `AWS::EMR::Cluster` resource. The `StepConfig` property type specifies a cluster (job flow) step, which runs only on the master node. Steps are used to submit data processing jobs to the cluster.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[ActionOnFailure](#cfn-emr-cluster-stepconfig-actiononfailure)" : String,
"[HadoopJarStep](#cfn-emr-cluster-stepconfig-hadoopjarstep)" : HadoopJarStepConfig,
"[Name](#cfn-emr-cluster-stepconfig-name)" : String
}
```
### YAML
```
[ActionOnFailure](#cfn-emr-cluster-stepconfig-actiononfailure): String
[HadoopJarStep](#cfn-emr-cluster-stepconfig-hadoopjarstep):
HadoopJarStepConfig
[Name](#cfn-emr-cluster-stepconfig-name): String
```
## Properties
`ActionOnFailure`
The action to take when the cluster step fails. Possible values are `CANCEL_AND_WAIT` and `CONTINUE`.
*Required*: No
*Type*: String
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`HadoopJarStep`
The JAR file used for the step.
*Required*: Yes
*Type*: [HadoopJarStepConfig](aws-properties-emr-cluster-hadoopjarstepconfig.md)
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`Name`
The name of the step.
*Required*: Yes
*Type*: String
*Pattern*: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*`
*Minimum*: `0`
*Maximum*: `256`
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
# AWS::EMR::Cluster Tag
A key-value pair containing user-defined metadata that you can associate with an Amazon EMR resource. Tags make it easier to associate clusters in various ways, such as grouping clusters to track your Amazon EMR resource allocation costs. For more information, see [Tag Clusters](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html).
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Key](#cfn-emr-cluster-tag-key)" : String,
"[Value](#cfn-emr-cluster-tag-value)" : String
}
```
### YAML
```
[Key](#cfn-emr-cluster-tag-key): String
[Value](#cfn-emr-cluster-tag-value): String
```
## Properties
`Key`
A user-defined key, which is the minimum required information for a valid tag. For more information, see [Tag](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html).
*Required*: Yes
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Value`
A user-defined value, which is optional in a tag. For more information, see [Tag Clusters](https://docs.aws.amazon.com/emr/latest/ManagementGuide/emr-plan-tags.html).
*Required*: Yes
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
# AWS::EMR::Cluster VolumeSpecification
`VolumeSpecification` is a subproperty of the `EbsBlockDeviceConfig` property type. `VolumeSecification` determines the volume type, IOPS, and size (GiB) for EBS volumes attached to EC2 instances.
## Syntax
To declare this entity in your CloudFormation template, use the following syntax:
### JSON
```
{
"[Iops](#cfn-emr-cluster-volumespecification-iops)" : Integer,
"[SizeInGB](#cfn-emr-cluster-volumespecification-sizeingb)" : Integer,
"[Throughput](#cfn-emr-cluster-volumespecification-throughput)" : Integer,
"[VolumeType](#cfn-emr-cluster-volumespecification-volumetype)" : String
}
```
### YAML
```
[Iops](#cfn-emr-cluster-volumespecification-iops): Integer
[SizeInGB](#cfn-emr-cluster-volumespecification-sizeingb): Integer
[Throughput](#cfn-emr-cluster-volumespecification-throughput): Integer
[VolumeType](#cfn-emr-cluster-volumespecification-volumetype): String
```
## Properties
`Iops`
The number of I/O operations per second (IOPS) that the volume supports.
*Required*: No
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`SizeInGB`
The volume size, in gibibytes (GiB). This can be a number from 1 - 1024. If the volume type is EBS-optimized, the minimum value is 10.
*Required*: Yes
*Type*: Integer
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`Throughput`
The throughput, in mebibyte per second (MiB/s). This optional parameter can be a number from 125 - 1000 and is valid only for gp3 volumes.
*Required*: No
*Type*: Integer
*Minimum*: `0`
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)
`VolumeType`
The volume type. Volume types supported are gp3, gp2, io1, st1, sc1, and standard.
*Required*: Yes
*Type*: String
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)