InstanceGroupConfig - Amazon EMR
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

InstanceGroupConfig

Configuration defining a new instance group.

Contents

InstanceCount

Target number of instances for the instance group.

Type: Integer

Required: Yes

InstanceRole

The role of the instance group in the cluster.

Type: String

Valid Values: MASTER | CORE | TASK

Required: Yes

InstanceType

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

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

AutoScalingPolicy

An automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster. The automatic scaling policy defines how an instance group dynamically adds and terminates Amazon EC2 instances in response to the value of a CloudWatch metric. See PutAutoScalingPolicy.

Type: AutoScalingPolicy object

Required: No

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.

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

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

Type: Array of Configuration objects

Required: No

CustomAmiId

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

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

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

Type: EbsConfiguration object

Required: No

Market

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

Type: String

Valid Values: ON_DEMAND | SPOT

Required: No

Name

Friendly name given to the instance group.

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

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: