Class EmrCreateCluster
java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.services.stepfunctions.State
software.amazon.awscdk.services.stepfunctions.TaskStateBase
software.amazon.awscdk.services.stepfunctions.tasks.EmrCreateCluster
- All Implemented Interfaces:
IChainable,INextable,software.amazon.jsii.JsiiSerializable,software.constructs.IConstruct,software.constructs.IDependable
@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
date="2025-11-17T14:41:01.792Z")
@Stability(Stable)
public class EmrCreateCluster
extends TaskStateBase
A Step Functions Task to create an EMR Cluster.
The ClusterConfiguration is defined as Parameters in the state machine definition.
OUTPUT: the ClusterId.
Example:
EmrCreateCluster.Builder.create(this, "CreateCluster")
.instances(InstancesConfigProperty.builder()
.instanceFleets(List.of(InstanceFleetConfigProperty.builder()
.instanceFleetType(EmrCreateCluster.getInstanceRoleType().CORE)
.instanceTypeConfigs(List.of(InstanceTypeConfigProperty.builder()
.instanceType("m5.xlarge")
.build()))
.targetOnDemandCapacity(1)
.build(), InstanceFleetConfigProperty.builder()
.instanceFleetType(EmrCreateCluster.getInstanceRoleType().MASTER)
.instanceTypeConfigs(List.of(InstanceTypeConfigProperty.builder()
.instanceType("m5.xlarge")
.build()))
.targetOnDemandCapacity(1)
.build()))
.build())
.name("ClusterName")
.releaseLabel("emr-7.9.0")
.managedScalingPolicy(ManagedScalingPolicyProperty.builder()
.computeLimits(ManagedScalingComputeLimitsProperty.builder()
.unitType(EmrCreateCluster.getComputeLimitsUnitType().INSTANCE_FLEET_UNITS)
.maximumCapacityUnits(4)
.minimumCapacityUnits(1)
.maximumOnDemandCapacityUnits(4)
.maximumCoreCapacityUnits(2)
.build())
.build())
.build();
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic interfaceProperties for the EMR Cluster Applications.static interfaceAn automatic scaling policy for a core instance group or task instance group in an Amazon EMR cluster.static interfaceConfiguration of a bootstrap action.static final classA fluent builder forEmrCreateCluster.static enumCloudWatch Alarm Comparison Operators.static interfaceThe definition of a CloudWatch metric alarm, which determines when an automatic scaling activity is triggered.static enumCloudWatch Alarm Statistics.static enumCloudWatch Alarm Units.static enumThe unit type for managed scaling policy compute limits.static interfaceAn optional configuration specification to be used when provisioning cluster instances, which can include configurations for applications and software bundled with Amazon EMR.static interfaceConfiguration of requested EBS block device associated with the instance group with count of volumes that will be associated to every instance.static enumEBS Volume Types.static interfaceThe Amazon EBS configuration of a cluster instance.static enumThe Cluster ScaleDownBehavior specifies the way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized.static interfaceThe configuration that defines an instance fleet.static interfaceThe launch specification for On-Demand and Spot instances in the fleet, which determines the defined duration and provisioning timeout behavior, and allocation strategy.static interfaceConfiguration defining a new instance group.static enumEC2 Instance Market.static enumInstance Role Types.static interfaceA specification of the number and type of Amazon EC2 instances.static interfaceAn instance type configuration for each instance type in an instance fleet, which determines the EC2 instances Amazon EMR attempts to provision to fulfill On-Demand and Spot target capacities.static interfaceAttributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration.static interfaceThe EC2 unit limits for a managed scaling policy.static interfaceThe managed scaling policy for an Amazon EMR cluster.static interfaceA CloudWatch dimension, which is specified using a Key (known as a Name in CloudWatch), Value pair.static enumOn-Demand Allocation Strategies.static interfaceThe launch specification for On-Demand Instances in the instance fleet, which determines the allocation strategy.static interfaceThe Amazon EC2 Availability Zone configuration of the cluster (job flow).static interfaceThe type of adjustment the automatic scaling activity makes when triggered, and the periodicity of the adjustment.static enumAutoScaling Adjustment Type.static interfaceThe upper and lower EC2 instance limits for an automatic scaling policy.static interfaceA scale-in or scale-out rule that defines scaling activity, including the CloudWatch metric alarm that triggers activity, how EC2 instances are added or removed, and the periodicity of adjustments.static interfaceThe conditions that trigger an automatic scaling activity and the definition of a CloudWatch metric alarm.static interfaceConfiguration of the script to run during a bootstrap action.static interfaceAn automatic scaling configuration, which describes how the policy adds or removes instances, the cooldown period, and the number of EC2 instances that will be added each time the CloudWatch metric alarm condition is satisfied.static enumSpot Allocation Strategies.static interfaceThe launch specification for Spot instances in the instance fleet, which determines the defined duration and provisioning timeout behavior.static enumSpot Timeout Actions.static interfaceEBS volume specifications such as volume type, IOPS, and size (GiB) that will be requested for the EBS volume attached to an EC2 instance in the cluster.Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject
software.amazon.jsii.JsiiObject.InitializationModeNested classes/interfaces inherited from interface software.amazon.awscdk.services.stepfunctions.IChainable
IChainable.Jsii$DefaultNested classes/interfaces inherited from interface software.constructs.IConstruct
software.constructs.IConstruct.Jsii$DefaultNested classes/interfaces inherited from interface software.amazon.awscdk.services.stepfunctions.INextable
INextable.Jsii$Default -
Constructor Summary
ConstructorsModifierConstructorDescriptionprotectedEmrCreateCluster(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) protectedEmrCreateCluster(software.amazon.jsii.JsiiObjectRef objRef) EmrCreateCluster(software.constructs.Construct scope, String id, EmrCreateClusterProps props) -
Method Summary
Modifier and TypeMethodDescriptionThe autoscaling role for the EMR Cluster.The instance role for the EMR Cluster.The service role for the EMR Cluster.protected TaskMetricsConfigprotected List<PolicyStatement> static EmrCreateClusterjsonata(software.constructs.Construct scope, String id, EmrCreateClusterJsonataProps props) A Step Functions task using JSONata to create an EMR Cluster.static EmrCreateClusterjsonPath(software.constructs.Construct scope, String id, EmrCreateClusterJsonPathProps props) A Step Functions task using JSONPath to create an EMR Cluster.Methods inherited from class software.amazon.awscdk.services.stepfunctions.TaskStateBase
addCatch, addCatch, addRetry, addRetry, getEndStates, metric, metric, metricFailed, metricFailed, metricHeartbeatTimedOut, metricHeartbeatTimedOut, metricRunTime, metricRunTime, metricScheduled, metricScheduled, metricScheduleTime, metricScheduleTime, metricStarted, metricStarted, metricSucceeded, metricSucceeded, metricTime, metricTime, metricTimedOut, metricTimedOut, next, toStateJson, toStateJson, whenBoundToGraphMethods inherited from class software.amazon.awscdk.services.stepfunctions.State
addBranch, addChoice, addChoice, addItemProcessor, addItemProcessor, addIterator, addPrefix, bindToGraph, filterNextables, findReachableEndStates, findReachableEndStates, findReachableStates, findReachableStates, getArguments, getAssign, getBranches, getComment, getDefaultChoice, getId, getInputPath, getIteration, getOutputPath, getOutputs, getParameters, getProcessor, getProcessorConfig, getProcessorMode, getQueryLanguage, getResultPath, getResultSelector, getStartState, getStateId, getStateName, makeDefault, makeNext, prefixStates, renderAssign, renderAssign, renderBranches, renderChoices, renderChoices, renderInputOutput, renderItemProcessor, renderIterator, renderNextEnd, renderQueryLanguage, renderQueryLanguage, renderResultSelector, renderRetryCatch, renderRetryCatch, setDefaultChoice, setIteration, setProcessor, setProcessorConfig, setProcessorMode, validateStateMethods inherited from class software.constructs.Construct
getNode, isConstruct, toStringMethods inherited from class software.amazon.jsii.JsiiObject
jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSetMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface software.amazon.jsii.JsiiSerializable
$jsii$toJson
-
Constructor Details
-
EmrCreateCluster
protected EmrCreateCluster(software.amazon.jsii.JsiiObjectRef objRef) -
EmrCreateCluster
protected EmrCreateCluster(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) -
EmrCreateCluster
@Stability(Stable) public EmrCreateCluster(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull EmrCreateClusterProps props) - Parameters:
scope- This parameter is required.id- Descriptive identifier for this chainable. This parameter is required.props- This parameter is required.
-
-
Method Details
-
jsonata
@Stability(Stable) @NotNull public static EmrCreateCluster jsonata(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull EmrCreateClusterJsonataProps props) A Step Functions task using JSONata to create an EMR Cluster.This task creates a Lambda function to call cross-region AWS API and invokes it.
- Parameters:
scope- This parameter is required.id- This parameter is required.props- This parameter is required.
-
jsonPath
@Stability(Stable) @NotNull public static EmrCreateCluster jsonPath(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull EmrCreateClusterJsonPathProps props) A Step Functions task using JSONPath to create an EMR Cluster.This task creates a Lambda function to call cross-region AWS API and invokes it.
- Parameters:
scope- This parameter is required.id- This parameter is required.props- This parameter is required.
-
getAutoScalingRole
The autoscaling role for the EMR Cluster.Only available after task has been added to a state machine.
-
getClusterRole
The instance role for the EMR Cluster.Only available after task has been added to a state machine.
-
getServiceRole
The service role for the EMR Cluster.Only available after task has been added to a state machine.
-
getTaskMetrics
- Specified by:
getTaskMetricsin classTaskStateBase
-
getTaskPolicies
- Specified by:
getTaskPoliciesin classTaskStateBase
-