Package software.amazon.awscdk.services.emr

Interface CfnClusterProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnClusterProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.126.0 (build 206d44b)",
           date="2026-02-09T14:39:11.154Z")
@Stability(Stable)
public interface CfnClusterProps
extends software.amazon.jsii.JsiiSerializable

Properties for defining a CfnCluster.

Example:

See Also:

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

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	CfnClusterProps.Builder	A builder for CfnClusterProps
static final class	CfnClusterProps.Jsii$Proxy	An implementation for CfnClusterProps

Method Summary

Modifier and Type	Method	Description
static CfnClusterProps.Builder	builder()
default Object	getAdditionalInfo()	A JSON string for selecting additional features.
default Object	getApplications()	The applications to install on this cluster, for example, Spark, Flink, Oozie, Zeppelin, and so on.
default String	getAutoScalingRole()	An IAM role for automatic scaling policies.
default Object	getAutoTerminationPolicy()	An auto-termination policy for an Amazon EMR cluster.
default Object	getBootstrapActions()	A list of bootstrap actions to run before Hadoop starts on the cluster nodes.
default Object	getConfigurations()	Applies only to Amazon EMR releases 4.x and later.
default String	getCustomAmiId()	Available only in Amazon EMR releases 5.7.0 and later.
default Number	getEbsRootVolumeIops()	The IOPS, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance.
default Number	getEbsRootVolumeSize()	The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance.
default Number	getEbsRootVolumeThroughput()	The throughput, in MiB/s, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance.
Object	getInstances()	A specification of the number and type of Amazon EC2 instances.
String	getJobFlowRole()	Also called instance profile and Amazon EC2 role.
default Object	getKerberosAttributes()	Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration.
default String	getLogEncryptionKmsKeyId()	The AWS KMS key used for encrypting log files.
default String	getLogUri()	The path to the Amazon S3 location where logs for this cluster are stored.
default Object	getManagedScalingPolicy()	Creates or updates a managed scaling policy for an Amazon EMR cluster.
String	getName()	The name of the cluster.
default String	getOsReleaseLabel()	The Amazon Linux release specified in a cluster launch RunJobFlow request.
default Object	getPlacementGroupConfigs()	Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnCluster.PlacementGroupConfigProperty>
default String	getReleaseLabel()	The Amazon EMR release label, which determines the version of open-source application packages installed on the cluster.
default String	getScaleDownBehavior()	The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized.
default String	getSecurityConfiguration()	The name of the security configuration applied to the cluster.
String	getServiceRole()	The IAM role that Amazon EMR assumes in order to access AWS resources on your behalf.
default Number	getStepConcurrencyLevel()	Specifies the number of steps that can be executed concurrently.
default Object	getSteps()	A list of steps to run.
default List<CfnTag>	getTags()	A list of tags associated with a cluster.
default Object	getVisibleToAllUsers()	Indicates whether the cluster is visible to all IAM users of the AWS account associated with the cluster.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getInstances

@Stability(Stable)
@NotNull
Object getInstances()

A specification of the number and type of Amazon EC2 instances.

Returns union: either IResolvable or CfnCluster.JobFlowInstancesConfigProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-instances

getJobFlowRole

@Stability(Stable)
@NotNull
String getJobFlowRole()

Also called instance profile and Amazon EC2 role.

An IAM role for an Amazon EMR cluster. The Amazon EC2 instances of the cluster assume this role. The default role is EMR_EC2_DefaultRole . In order to use the default role, you must have already created it using the AWS CLI or console.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-jobflowrole

getName

@Stability(Stable)
@NotNull
String getName()

The name of the cluster.

This parameter can't contain the characters <, >, $, |, or ` (backtick).

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-name

getServiceRole

@Stability(Stable)
@NotNull
String getServiceRole()

The IAM role that Amazon EMR assumes in order to access AWS resources on your behalf.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-servicerole

getAdditionalInfo

@Stability(Stable)
@Nullable
default Object getAdditionalInfo()

A JSON string for selecting additional features.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-additionalinfo

getApplications

@Stability(Stable)
@Nullable
default Object getApplications()

The applications to install on this cluster, for example, Spark, Flink, Oozie, Zeppelin, and so on.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnCluster.ApplicationProperty>

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-applications

getAutoScalingRole

@Stability(Stable)
@Nullable
default String getAutoScalingRole()

An IAM role for automatic scaling policies.

The default role is EMR_AutoScaling_DefaultRole . The IAM role provides permissions that the automatic scaling feature requires to launch and terminate Amazon EC2 instances in an instance group.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-autoscalingrole

getAutoTerminationPolicy

@Stability(Stable)
@Nullable
default Object getAutoTerminationPolicy()

An auto-termination policy for an Amazon EMR cluster.

An auto-termination policy defines the amount of idle time in seconds after which a cluster automatically terminates. For alternative cluster termination options, see Control cluster termination .

Returns union: either IResolvable or CfnCluster.AutoTerminationPolicyProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-autoterminationpolicy

getBootstrapActions

@Stability(Stable)
@Nullable
default Object getBootstrapActions()

A list of bootstrap actions to run before Hadoop starts on the cluster nodes.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnCluster.BootstrapActionConfigProperty>

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-bootstrapactions

getConfigurations

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

Applies only to Amazon EMR releases 4.x and later. The list of configurations that are supplied to the Amazon EMR cluster.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnCluster.ConfigurationProperty>

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-configurations

getCustomAmiId

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

Available only in Amazon EMR releases 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI if the cluster uses a custom AMI.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-customamiid

getEbsRootVolumeIops

@Stability(Stable)
@Nullable
default Number getEbsRootVolumeIops()

The IOPS, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance.

Available in Amazon EMR releases 6.15.0 and later.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-ebsrootvolumeiops

getEbsRootVolumeSize

@Stability(Stable)
@Nullable
default Number getEbsRootVolumeSize()

The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance.

Available in Amazon EMR releases 4.x and later.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-ebsrootvolumesize

getEbsRootVolumeThroughput

@Stability(Stable)
@Nullable
default Number getEbsRootVolumeThroughput()

The throughput, in MiB/s, of the Amazon EBS root device volume of the Linux AMI that is used for each Amazon EC2 instance.

Available in Amazon EMR releases 6.15.0 and later.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-ebsrootvolumethroughput

getKerberosAttributes

@Stability(Stable)
@Nullable
default Object getKerberosAttributes()

Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration.

For more information see Use Kerberos Authentication in the Amazon EMR Management Guide .

Returns union: either IResolvable or CfnCluster.KerberosAttributesProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-kerberosattributes

getLogEncryptionKmsKeyId

@Stability(Stable)
@Nullable
default String getLogEncryptionKmsKeyId()

The AWS KMS key used for encrypting log files.

This attribute is only available with Amazon EMR 5.30.0 and later, excluding Amazon EMR 6.0.0.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-logencryptionkmskeyid

getLogUri

@Stability(Stable)
@Nullable
default String getLogUri()

The path to the Amazon S3 location where logs for this cluster are stored.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-loguri

getManagedScalingPolicy

@Stability(Stable)
@Nullable
default Object getManagedScalingPolicy()

Creates or updates a managed scaling policy for an Amazon EMR cluster.

The managed scaling policy defines the limits for resources, such as Amazon EC2 instances that can be added or terminated from a cluster. The policy only applies to the core and task nodes. The master node cannot be scaled after initial configuration.

Returns union: either IResolvable or CfnCluster.ManagedScalingPolicyProperty

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-managedscalingpolicy

getOsReleaseLabel

@Stability(Stable)
@Nullable
default String getOsReleaseLabel()

The Amazon Linux release specified in a cluster launch RunJobFlow request.

If no Amazon Linux release was specified, the default Amazon Linux release is shown in the response.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-osreleaselabel

getPlacementGroupConfigs

@Stability(Stable)
@Nullable
default Object getPlacementGroupConfigs()

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnCluster.PlacementGroupConfigProperty>

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-placementgroupconfigs

getReleaseLabel

@Stability(Stable)
@Nullable
default String getReleaseLabel()

The Amazon EMR release label, which determines the version of open-source application packages installed on the cluster.

Release labels are in the form emr-x.x.x , where x.x.x is an Amazon EMR release version such as emr-5.14.0 . For more information about Amazon EMR release versions and included application versions and features, see . The release label applies only to Amazon EMR releases version 4.0 and later. Earlier versions use AmiVersion .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-releaselabel

getScaleDownBehavior

@Stability(Stable)
@Nullable
default String getScaleDownBehavior()

The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized.

TERMINATE_AT_INSTANCE_HOUR indicates that Amazon EMR terminates nodes at the instance-hour boundary, regardless of when the request to terminate the instance was submitted. This option is only available with Amazon EMR 5.1.0 and later and is the default for clusters created using that version. TERMINATE_AT_TASK_COMPLETION indicates that Amazon EMR adds nodes to a deny list and drains tasks from nodes before terminating the Amazon EC2 instances, regardless of the instance-hour boundary. With either behavior, Amazon EMR removes the least active nodes first and blocks instance termination if it could lead to HDFS corruption. TERMINATE_AT_TASK_COMPLETION is available only in Amazon EMR releases 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-scaledownbehavior

getSecurityConfiguration

@Stability(Stable)
@Nullable
default String getSecurityConfiguration()

The name of the security configuration applied to the cluster.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-securityconfiguration

getStepConcurrencyLevel

@Stability(Stable)
@Nullable
default Number getStepConcurrencyLevel()

Specifies the number of steps that can be executed concurrently.

The default value is 1 . The maximum value is 256 .

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-stepconcurrencylevel

getSteps

@Stability(Stable)
@Nullable
default Object getSteps()

A list of steps to run.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnCluster.StepConfigProperty>

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-steps

getTags

@Stability(Stable)
@Nullable
default List<CfnTag> getTags()

A list of tags associated with a cluster.

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-tags

getVisibleToAllUsers

@Stability(Stable)
@Nullable
default Object getVisibleToAllUsers()

Indicates whether the cluster is visible to all IAM users of the AWS account associated with the cluster.

If this value is set to true , all IAM users of that AWS account can view and manage the cluster if they have the proper policy permissions set. If this value is false , only the IAM user that created the cluster can view and manage it. This value can be changed using the SetVisibleToAllUsers action.

When you create clusters directly through the EMR console or API, this value is set to true by default. However, for AWS::EMR::Cluster resources in CloudFormation, the default is false .

Returns union: either Boolean or IResolvable

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-emr-cluster.html#cfn-emr-cluster-visibletoallusers

builder

@Stability(Stable)
static CfnClusterProps.Builder builder()

Returns:

a CfnClusterProps.Builder of CfnClusterProps