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 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 Amazon CloudFormation template, use the following syntax:
JSON
{ "InstanceTypeConfigs" :[ InstanceTypeConfig, ... ], "LaunchSpecifications" :InstanceFleetProvisioningSpecifications, "Name" :String, "TargetOnDemandCapacity" :Integer, "TargetSpotCapacity" :Integer}
YAML
InstanceTypeConfigs:- InstanceTypeConfigLaunchSpecifications:InstanceFleetProvisioningSpecificationsName:StringTargetOnDemandCapacity:IntegerTargetSpotCapacity:Integer
Properties
InstanceTypeConfigs-
The instance type configurations that define the Amazon EC2 instances in the instance fleet.
Required: No
Type: Array of InstanceTypeConfig
Update requires: No interruption
LaunchSpecifications-
The launch specification for the instance fleet.
Required: No
Type: InstanceFleetProvisioningSpecifications
Update requires: No interruption
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:
0Maximum:
256Update requires: No interruption
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 specifiedWeightedCapacity. When an On-Demand instance is provisioned, theWeightedCapacityunits 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 aWeightedCapacityof 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.Note
If not specified or set to 0, only Spot instances are provisioned for the instance fleet using
TargetSpotCapacity. At least one ofTargetSpotCapacityandTargetOnDemandCapacityshould be greater than 0. For a master instance fleet, only one ofTargetSpotCapacityandTargetOnDemandCapacitycan be specified, and its value must be 1.Required: No
Type: Integer
Minimum:
0Update requires: No interruption
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 specifiedWeightedCapacity. When a Spot instance is provisioned, theWeightedCapacityunits 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 aWeightedCapacityof 5 units, the instance is provisioned, and the target capacity is exceeded by 3 units.Note
If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least one of
TargetSpotCapacityandTargetOnDemandCapacityshould be greater than 0. For a master instance fleet, only one ofTargetSpotCapacityandTargetOnDemandCapacitycan be specified, and its value must be 1.Required: No
Type: Integer
Minimum:
0Update requires: No interruption