InstanceTypeConfig
An instance type configuration for each instance type in an instance fleet, which determines the Amazon EC2 instances Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities. When you use an allocation strategy, you can include a maximum of 30 instance type configurations for a fleet. For more information about how to use an allocation strategy, see Configure Instance Fleets. Without an allocation strategy, you may specify a maximum of five instance type configurations for a fleet.
Note
The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions.
Contents
- InstanceType
-
An Amazon EC2 instance type, such as
m3.xlarge.Type: String
Length Constraints: Minimum length of 1. Maximum length of 256.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: Yes
- BidPrice
-
The bid price for each Amazon EC2 Spot Instance type as defined by
InstanceType. Expressed in USD. If neitherBidPricenorBidPriceAsPercentageOfOnDemandPriceis provided,BidPriceAsPercentageOfOnDemandPricedefaults to 100%.Type: String
Length Constraints: Minimum length of 0. Maximum length of 256.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: No
- 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 neitherBidPricenorBidPriceAsPercentageOfOnDemandPriceis provided,BidPriceAsPercentageOfOnDemandPricedefaults to 100%.Type: Double
Valid Range: Minimum value of 0.0.
Required: No
- Configurations
-
A configuration classification that applies when provisioning cluster instances, which can include configurations for applications and software that run on the cluster.
Type: Array of Configuration objects
Required: No
- CustomAmiId
-
The custom AMI ID to use for the instance type.
Type: String
Length Constraints: Minimum length of 0. Maximum length of 256.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*Required: No
- EbsConfiguration
-
The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each instance as defined by
InstanceType.Type: EbsConfiguration object
Required: No
- 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.
Type: Double
Valid Range: Minimum value of 0.0.
Required: No
- 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.
Type: Integer
Valid Range: Minimum value of 0.
Required: No
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
