AWS::EMR::Cluster InstanceTypeConfig - AWS CloudFormation
SyntaxProperties

This is the new AWS CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

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 AWS CloudFormation template, use the following syntax:

JSON

{
  "BidPrice" : String,
  "BidPriceAsPercentageOfOnDemandPrice" : Number,
  "Configurations" : [ Configuration, ... ],
  "CustomAmiId" : String,
  "EbsConfiguration" : EbsConfiguration,
  "InstanceType" : String,
  "Priority" : Number,
  "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

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

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

Update requires: No interruption

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

EbsConfiguration

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

Required: No

Type: EbsConfiguration

Update requires: No interruption

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

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

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