Menu
Amazon Elastic MapReduce
API Reference (API Version 2009-03-31)

InstanceGroupDetail

Detailed information about an instance group.

Contents

BidPrice

Bid price for EC2 Instances when launching nodes as Spot Instances, 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

CreationDateTime

The date/time the instance group was created.

Type: Timestamp

Required: Yes

EndDateTime

The date/time the instance group was terminated.

Type: Timestamp

Required: No

InstanceGroupId

Unique identifier for 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

InstanceRequestCount

Target number of instances to run in the instance group.

Type: Integer

Required: Yes

InstanceRole

Instance group role in the cluster

Type: String

Valid Values: MASTER | CORE | TASK

Required: Yes

InstanceRunningCount

Actual count of running instances.

Type: Integer

Required: Yes

InstanceType

EC2 instance type.

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

LastStateChangeReason

Details regarding the state of the instance group.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 10280.

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

Required: No

Market

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

Type: String

Valid Values: ON_DEMAND | SPOT

Required: Yes

Name

Friendly name for 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

ReadyDateTime

The date/time the instance group was available to the cluster.

Type: Timestamp

Required: No

StartDateTime

The date/time the instance group was started.

Type: Timestamp

Required: No

State

State of instance group. The following values are deprecated: STARTING, TERMINATED, and FAILED.

Type: String

Valid Values: PROVISIONING | BOOTSTRAPPING | RUNNING | RESIZING | SUSPENDED | TERMINATING | TERMINATED | ARRESTED | SHUTTING_DOWN | ENDED

Required: Yes

See Also

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

On this page: