InstanceGroupDetail - Amazon EMR

InstanceGroupDetail

Detailed information about an instance group.

Contents

CreationDateTime

The date/time the instance group was created.

Type: Timestamp

Required: Yes

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

Amazon 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

Market

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

Type: String

Valid Values: ON_DEMAND | SPOT

Required: Yes

State

State of instance group. The following values are no longer supported: STARTING, TERMINATED, and FAILED.

Type: String

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

Required: Yes

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

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

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

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

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

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

See Also

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