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::InstanceFleetConfig
<a name="aws-resource-emr-instancefleetconfig"></a>

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.

**Important**  
You can currently only add a task instance fleet to a cluster with this resource. If you use this resource, CloudFormation waits for the cluster launch to complete before adding the task instance fleet to the cluster. In order to add a task instance fleet to the cluster as part of the cluster launch and minimize delays in provisioning task nodes, use the `TaskInstanceFleets` subproperty for the [AWS::EMR::Cluster JobFlowInstancesConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-elasticmapreduce-cluster-jobflowinstancesconfig.html) property instead. To use this subproperty, see [AWS::EMR::Cluster](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticmapreduce-cluster.html) for examples.

## Syntax
<a name="aws-resource-emr-instancefleetconfig-syntax"></a>

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

### JSON
<a name="aws-resource-emr-instancefleetconfig-syntax.json"></a>

```
{
  "Type" : "AWS::EMR::InstanceFleetConfig",
  "Properties" : {
      "[ClusterId](#cfn-emr-instancefleetconfig-clusterid)" : String,
      "[InstanceFleetType](#cfn-emr-instancefleetconfig-instancefleettype)" : String,
      "[InstanceTypeConfigs](#cfn-emr-instancefleetconfig-instancetypeconfigs)" : [ InstanceTypeConfig, ... ],
      "[LaunchSpecifications](#cfn-emr-instancefleetconfig-launchspecifications)" : InstanceFleetProvisioningSpecifications,
      "[Name](#cfn-emr-instancefleetconfig-name)" : String,
      "[ResizeSpecifications](#cfn-emr-instancefleetconfig-resizespecifications)" : InstanceFleetResizingSpecifications,
      "[TargetOnDemandCapacity](#cfn-emr-instancefleetconfig-targetondemandcapacity)" : Integer,
      "[TargetSpotCapacity](#cfn-emr-instancefleetconfig-targetspotcapacity)" : Integer
    }
}
```

### YAML
<a name="aws-resource-emr-instancefleetconfig-syntax.yaml"></a>

```
Type: AWS::EMR::InstanceFleetConfig
Properties:
  [ClusterId](#cfn-emr-instancefleetconfig-clusterid): String
  [InstanceFleetType](#cfn-emr-instancefleetconfig-instancefleettype): String
  [InstanceTypeConfigs](#cfn-emr-instancefleetconfig-instancetypeconfigs): 
    - InstanceTypeConfig
  [LaunchSpecifications](#cfn-emr-instancefleetconfig-launchspecifications): 
    InstanceFleetProvisioningSpecifications
  [Name](#cfn-emr-instancefleetconfig-name): String
  [ResizeSpecifications](#cfn-emr-instancefleetconfig-resizespecifications): 
    InstanceFleetResizingSpecifications
  [TargetOnDemandCapacity](#cfn-emr-instancefleetconfig-targetondemandcapacity): Integer
  [TargetSpotCapacity](#cfn-emr-instancefleetconfig-targetspotcapacity): Integer
```

## Properties
<a name="aws-resource-emr-instancefleetconfig-properties"></a>

`ClusterId`  <a name="cfn-emr-instancefleetconfig-clusterid"></a>
The unique identifier of the EMR cluster.  
*Required*: Yes  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`InstanceFleetType`  <a name="cfn-emr-instancefleetconfig-instancefleettype"></a>
The node type that the instance fleet hosts.  
*Allowed Values*: TASK  
*Required*: Yes  
*Type*: String  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`InstanceTypeConfigs`  <a name="cfn-emr-instancefleetconfig-instancetypeconfigs"></a>
`InstanceTypeConfigs` determine the EC2 instances that Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.  
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
*Required*: No  
*Type*: Array of [InstanceTypeConfig](aws-properties-emr-instancefleetconfig-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`  <a name="cfn-emr-instancefleetconfig-launchspecifications"></a>
The launch specification for the instance fleet.  
*Required*: No  
*Type*: [InstanceFleetProvisioningSpecifications](aws-properties-emr-instancefleetconfig-instancefleetprovisioningspecifications.md)  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`Name`  <a name="cfn-emr-instancefleetconfig-name"></a>
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*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`ResizeSpecifications`  <a name="cfn-emr-instancefleetconfig-resizespecifications"></a>
The resize specification for the instance fleet.  
*Required*: No  
*Type*: [InstanceFleetResizingSpecifications](aws-properties-emr-instancefleetconfig-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`  <a name="cfn-emr-instancefleetconfig-targetondemandcapacity"></a>
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`  <a name="cfn-emr-instancefleetconfig-targetspotcapacity"></a>
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)

## Return values
<a name="aws-resource-emr-instancefleetconfig-return-values"></a>

### Ref
<a name="aws-resource-emr-instancefleetconfig-return-values-ref"></a>

When you pass the logical ID of this resource to the intrinsic `Ref` function, `Ref` returns returns the ID of the instance fleet.

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
<a name="aws-resource-emr-instancefleetconfig-return-values-fn--getatt"></a>