AWS::EMR::Cluster InstanceGroupConfig - AWS CloudFormation
SyntaxProperties

AWS::EMR::Cluster InstanceGroupConfig

Use InstanceGroupConfig to define instance groups for an EMR cluster. A cluster can not use both instance groups and instance fleets. For more information, see Create a Cluster with Instance Fleets or Uniform Instance Groups in the Amazon EMR Management Guide.

Syntax

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

JSON

{
  "AutoScalingPolicy" : AutoScalingPolicy,
  "BidPrice" : String,
  "Configurations" : [ Configuration, ... ],
  "CustomAmiId" : String,
  "EbsConfiguration" : EbsConfiguration,
  "InstanceCount" : Integer,
  "InstanceType" : String,
  "Market" : String,
  "Name" : String
}

Properties

AutoScalingPolicy

AutoScalingPolicy is a subproperty of the InstanceGroupConfig property type that specifies the constraints and rules of an automatic scaling policy in Amazon EMR. The automatic scaling policy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric. Only core and task instance groups can use automatic scaling policies. For more information, see Using Automatic Scaling in Amazon EMR .

Required: No

Type: AutoScalingPolicy

Update requires: No interruption

BidPrice

If specified, indicates that the instance group uses Spot Instances. This is the maximum price you are willing to pay for Spot Instances. Specify OnDemandPrice to set the amount equal to the On-Demand price, or specify an amount in USD.

Required: No

Type: String

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Minimum: 0

Maximum: 256

Update requires: No interruption

Configurations
Note

Amazon EMR releases 4.x or later.

The list of configurations supplied for an Amazon EMR cluster instance group. You can specify a separate configuration for each instance group (master, core, and task).

Required: No

Type: Array of Configuration

Update requires: No interruption

CustomAmiId

The custom AMI ID to use for the provisioned instance group.

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

EBS configurations that will be attached to each Amazon EC2 instance in the instance group.

Required: No

Type: EbsConfiguration

Update requires: No interruption

InstanceCount

Target number of instances for the instance group.

Required: Yes

Type: Integer

Update requires: No interruption

InstanceType

The Amazon EC2 instance type for all instances in the instance group.

Required: Yes

Type: String

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Minimum: 1

Maximum: 256

Update requires: No interruption

Market

Market type of the Amazon EC2 instances used to create a cluster node.

Required: No

Type: String

Allowed values: ON_DEMAND | SPOT

Update requires: No interruption

Name

Friendly name given to the instance group.

Required: No

Type: String

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Minimum: 0

Maximum: 256

Update requires: No interruption