InstanceTypeSpecification - Amazon EMR

InstanceTypeSpecification

The configuration specification for each instance type in an instance fleet.

Note

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

Contents

BidPrice

The bid price for each Amazon EC2 Spot Instance type as defined by InstanceType. Expressed in USD.

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%).

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 bundled with Amazon EMR.

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

EbsBlockDevices

The configuration of Amazon Elastic Block Store (Amazon EBS) attached to each instance as defined by InstanceType.

Type: Array of EbsBlockDevice objects

Required: No

EbsOptimized

Evaluates to TRUE when the specified InstanceType is EBS-optimized.

Type: Boolean

Required: No

InstanceType

The Amazon EC2 instance type, for example 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: 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. Capacity values represent performance characteristics such as vCPUs, memory, or I/O. If not specified, the default value is 1.

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: