Package software.amazon.awscdk.services.emr

Class CfnInstanceGroupConfig

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.CfnElement

software.amazon.awscdk.CfnRefElement

software.amazon.awscdk.CfnResource

software.amazon.awscdk.services.emr.CfnInstanceGroupConfig

All Implemented Interfaces:

IInspectable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.104.0 (build e79254c)",
           date="2024-12-17T21:37:31.315Z")
@Stability(Stable)
public class CfnInstanceGroupConfig
extends CfnResource
implements IInspectable

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 .

You can currently only add task instance groups to a cluster with this resource. If you use this resource, CloudFormation waits for the cluster launch to complete before adding the task instance group to the cluster. In order to add task instance groups to the cluster as part of the cluster launch and minimize delays in provisioning task nodes, use the TaskInstanceGroups subproperty for the AWS::EMR::Cluster JobFlowInstancesConfig property instead. To use this subproperty, see AWS::EMR::Cluster for examples.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.emr.*;
 ConfigurationProperty configurationProperty_;
 CfnInstanceGroupConfig cfnInstanceGroupConfig = CfnInstanceGroupConfig.Builder.create(this, "MyCfnInstanceGroupConfig")
         .instanceCount(123)
         .instanceRole("instanceRole")
         .instanceType("instanceType")
         .jobFlowId("jobFlowId")
         // the properties below are optional
         .autoScalingPolicy(AutoScalingPolicyProperty.builder()
                 .constraints(ScalingConstraintsProperty.builder()
                         .maxCapacity(123)
                         .minCapacity(123)
                         .build())
                 .rules(List.of(ScalingRuleProperty.builder()
                         .action(ScalingActionProperty.builder()
                                 .simpleScalingPolicyConfiguration(SimpleScalingPolicyConfigurationProperty.builder()
                                         .scalingAdjustment(123)
                                         // the properties below are optional
                                         .adjustmentType("adjustmentType")
                                         .coolDown(123)
                                         .build())
                                 // the properties below are optional
                                 .market("market")
                                 .build())
                         .name("name")
                         .trigger(ScalingTriggerProperty.builder()
                                 .cloudWatchAlarmDefinition(CloudWatchAlarmDefinitionProperty.builder()
                                         .comparisonOperator("comparisonOperator")
                                         .metricName("metricName")
                                         .period(123)
                                         .threshold(123)
                                         // the properties below are optional
                                         .dimensions(List.of(MetricDimensionProperty.builder()
                                                 .key("key")
                                                 .value("value")
                                                 .build()))
                                         .evaluationPeriods(123)
                                         .namespace("namespace")
                                         .statistic("statistic")
                                         .unit("unit")
                                         .build())
                                 .build())
                         // the properties below are optional
                         .description("description")
                         .build()))
                 .build())
         .bidPrice("bidPrice")
         .configurations(List.of(ConfigurationProperty.builder()
                 .classification("classification")
                 .configurationProperties(Map.of(
                         "configurationPropertiesKey", "configurationProperties"))
                 .configurations(List.of(configurationProperty_))
                 .build()))
         .customAmiId("customAmiId")
         .ebsConfiguration(EbsConfigurationProperty.builder()
                 .ebsBlockDeviceConfigs(List.of(EbsBlockDeviceConfigProperty.builder()
                         .volumeSpecification(VolumeSpecificationProperty.builder()
                                 .sizeInGb(123)
                                 .volumeType("volumeType")
                                 // the properties below are optional
                                 .iops(123)
                                 .throughput(123)
                                 .build())
                         // the properties below are optional
                         .volumesPerInstance(123)
                         .build()))
                 .ebsOptimized(false)
                 .build())
         .market("market")
         .name("name")
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-instancegroupconfig.html

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CfnInstanceGroupConfig.AutoScalingPolicyProperty	AutoScalingPolicy defines how an instance group dynamically adds and terminates EC2 instances in response to the value of a CloudWatch metric.
static final class	CfnInstanceGroupConfig.Builder	A fluent builder for CfnInstanceGroupConfig.
static interface	CfnInstanceGroupConfig.CloudWatchAlarmDefinitionProperty	CloudWatchAlarmDefinition is a subproperty of the ScalingTrigger property, which determines when to trigger an automatic scaling activity.
static interface	CfnInstanceGroupConfig.ConfigurationProperty	Configurations is a property of the AWS::EMR::Cluster resource that specifies the configuration of applications on an Amazon EMR cluster.
static interface	CfnInstanceGroupConfig.EbsBlockDeviceConfigProperty	Configuration of requested EBS block device associated with the instance group with count of volumes that are associated to every instance.
static interface	CfnInstanceGroupConfig.EbsConfigurationProperty	The Amazon EBS configuration of a cluster instance.
static interface	CfnInstanceGroupConfig.MetricDimensionProperty	MetricDimension is a subproperty of the CloudWatchAlarmDefinition property type.
static interface	CfnInstanceGroupConfig.ScalingActionProperty	ScalingAction is a subproperty of the ScalingRule property type.
static interface	CfnInstanceGroupConfig.ScalingConstraintsProperty	ScalingConstraints is a subproperty of the AutoScalingPolicy property type.
static interface	CfnInstanceGroupConfig.ScalingRuleProperty	ScalingRule is a subproperty of the AutoScalingPolicy property type.
static interface	CfnInstanceGroupConfig.ScalingTriggerProperty	ScalingTrigger is a subproperty of the ScalingRule property type.
static interface	CfnInstanceGroupConfig.SimpleScalingPolicyConfigurationProperty	SimpleScalingPolicyConfiguration is a subproperty of the ScalingAction property type.
static interface	CfnInstanceGroupConfig.VolumeSpecificationProperty	VolumeSpecification is a subproperty of the EbsBlockDeviceConfig property type.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CFN_RESOURCE_TYPE_NAME	The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CfnInstanceGroupConfig(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnInstanceGroupConfig(software.amazon.jsii.JsiiObjectRef objRef)
	CfnInstanceGroupConfig(software.constructs.Construct scope, String id, CfnInstanceGroupConfigProps props)

Method Summary

Modifier and Type	Method	Description
String	getAttrId()
Object	getAutoScalingPolicy()	AutoScalingPolicy is a subproperty of InstanceGroupConfig .
String	getBidPrice()	If specified, indicates that the instance group uses Spot Instances.
protected Map<String,Object>	getCfnProperties()
Object	getConfigurations()
String	getCustomAmiId()	The custom AMI ID to use for the provisioned instance group.
Object	getEbsConfiguration()	EbsConfiguration determines the EBS volumes to attach to EMR cluster instances.
Number	getInstanceCount()	Target number of instances for the instance group.
String	getInstanceRole()	The role of the instance group in the cluster.
String	getInstanceType()	The Amazon EC2 instance type for all instances in the instance group.
String	getJobFlowId()	The ID of an Amazon EMR cluster that you want to associate this instance group with.
String	getMarket()	Market type of the Amazon EC2 instances used to create a cluster node.
String	getName()	Friendly name given to the instance group.
void	inspect(TreeInspector inspector)	Examines the CloudFormation resource and discloses attributes.
protected Map<String,Object>	renderProperties(Map<String,Object> props)
void	setAutoScalingPolicy(IResolvable value)	AutoScalingPolicy is a subproperty of InstanceGroupConfig .
void	setAutoScalingPolicy(CfnInstanceGroupConfig.AutoScalingPolicyProperty value)	AutoScalingPolicy is a subproperty of InstanceGroupConfig .
void	setBidPrice(String value)	If specified, indicates that the instance group uses Spot Instances.
void	setConfigurations(List<Object> value)
void	setConfigurations(IResolvable value)
void	setCustomAmiId(String value)	The custom AMI ID to use for the provisioned instance group.
void	setEbsConfiguration(IResolvable value)	EbsConfiguration determines the EBS volumes to attach to EMR cluster instances.
void	setEbsConfiguration(CfnInstanceGroupConfig.EbsConfigurationProperty value)	EbsConfiguration determines the EBS volumes to attach to EMR cluster instances.
void	setInstanceCount(Number value)	Target number of instances for the instance group.
void	setInstanceRole(String value)	The role of the instance group in the cluster.
void	setInstanceType(String value)	The Amazon EC2 instance type for all instances in the instance group.
void	setJobFlowId(String value)	The ID of an Amazon EMR cluster that you want to associate this instance group with.
void	setMarket(String value)	Market type of the Amazon EC2 instances used to create a cluster node.
void	setName(String value)	Friendly name given to the instance group.

Methods inherited from class software.amazon.awscdk.CfnResource

addDeletionOverride, addDependency, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, obtainDependencies, obtainResourceDependencies, removeDependency, replaceDependency, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.constructs.Construct

getNode, isConstruct

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

CFN_RESOURCE_TYPE_NAME

@Stability(Stable)
public static final String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Details

CfnInstanceGroupConfig

protected CfnInstanceGroupConfig(software.amazon.jsii.JsiiObjectRef objRef)

CfnInstanceGroupConfig

protected CfnInstanceGroupConfig(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CfnInstanceGroupConfig

@Stability(Stable)
public CfnInstanceGroupConfig(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 CfnInstanceGroupConfigProps props)

Parameters:

scope - Scope in which this resource is defined. This parameter is required.

id - Construct identifier for this resource (unique in its scope). This parameter is required.

props - Resource properties. This parameter is required.

Method Details

inspect

@Stability(Stable)
public void inspect(@NotNull
 TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - tree inspector to collect and process attributes. This parameter is required.

renderProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> renderProperties(@NotNull
 Map<String,Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getAttrId

@Stability(Stable)
@NotNull
public String getAttrId()

getCfnProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getInstanceCount

@Stability(Stable)
@NotNull
public Number getInstanceCount()

Target number of instances for the instance group.

setInstanceCount

@Stability(Stable)
public void setInstanceCount(@NotNull
 Number value)

Target number of instances for the instance group.

getInstanceRole

@Stability(Stable)
@NotNull
public String getInstanceRole()

The role of the instance group in the cluster.

setInstanceRole

@Stability(Stable)
public void setInstanceRole(@NotNull
 String value)

The role of the instance group in the cluster.

getInstanceType

@Stability(Stable)
@NotNull
public String getInstanceType()

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

setInstanceType

@Stability(Stable)
public void setInstanceType(@NotNull
 String value)

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

getJobFlowId

@Stability(Stable)
@NotNull
public String getJobFlowId()

The ID of an Amazon EMR cluster that you want to associate this instance group with.

setJobFlowId

@Stability(Stable)
public void setJobFlowId(@NotNull
 String value)

The ID of an Amazon EMR cluster that you want to associate this instance group with.

getAutoScalingPolicy

@Stability(Stable)
@Nullable
public Object getAutoScalingPolicy()

AutoScalingPolicy is a subproperty of InstanceGroupConfig .

setAutoScalingPolicy

@Stability(Stable)
public void setAutoScalingPolicy(@Nullable
 IResolvable value)

AutoScalingPolicy is a subproperty of InstanceGroupConfig .

setAutoScalingPolicy

@Stability(Stable)
public void setAutoScalingPolicy(@Nullable
 CfnInstanceGroupConfig.AutoScalingPolicyProperty value)

AutoScalingPolicy is a subproperty of InstanceGroupConfig .

getBidPrice

@Stability(Stable)
@Nullable
public String getBidPrice()

If specified, indicates that the instance group uses Spot Instances.

setBidPrice

@Stability(Stable)
public void setBidPrice(@Nullable
 String value)

If specified, indicates that the instance group uses Spot Instances.

getConfigurations

@Stability(Stable)
@Nullable
public Object getConfigurations()

Amazon EMR releases 4.x or later.

setConfigurations

@Stability(Stable)
public void setConfigurations(@Nullable
 IResolvable value)

Amazon EMR releases 4.x or later.

setConfigurations

@Stability(Stable)
public void setConfigurations(@Nullable
 List<Object> value)

Amazon EMR releases 4.x or later.

getCustomAmiId

@Stability(Stable)
@Nullable
public String getCustomAmiId()

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

setCustomAmiId

@Stability(Stable)
public void setCustomAmiId(@Nullable
 String value)

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

getEbsConfiguration

@Stability(Stable)
@Nullable
public Object getEbsConfiguration()

EbsConfiguration determines the EBS volumes to attach to EMR cluster instances.

setEbsConfiguration

@Stability(Stable)
public void setEbsConfiguration(@Nullable
 IResolvable value)

EbsConfiguration determines the EBS volumes to attach to EMR cluster instances.

setEbsConfiguration

@Stability(Stable)
public void setEbsConfiguration(@Nullable
 CfnInstanceGroupConfig.EbsConfigurationProperty value)

EbsConfiguration determines the EBS volumes to attach to EMR cluster instances.

getMarket

@Stability(Stable)
@Nullable
public String getMarket()

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

setMarket

@Stability(Stable)
public void setMarket(@Nullable
 String value)

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

getName

@Stability(Stable)
@Nullable
public String getName()

Friendly name given to the instance group.

setName

@Stability(Stable)
public void setName(@Nullable
 String value)

Friendly name given to the instance group.