@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)", date="2022-09-19T20:26:39.207Z") @Stability(value=Stable) public interface CfnClusterProps extends software.amazon.jsii.JsiiSerializable
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.*;
Object additionalInfo;
ConfigurationProperty configurationProperty_;
CfnClusterProps cfnClusterProps = CfnClusterProps.builder()
.instances(JobFlowInstancesConfigProperty.builder()
.additionalMasterSecurityGroups(List.of("additionalMasterSecurityGroups"))
.additionalSlaveSecurityGroups(List.of("additionalSlaveSecurityGroups"))
.coreInstanceFleet(InstanceFleetConfigProperty.builder()
.instanceTypeConfigs(List.of(InstanceTypeConfigProperty.builder()
.instanceType("instanceType")
// the properties below are optional
.bidPrice("bidPrice")
.bidPriceAsPercentageOfOnDemandPrice(123)
.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)
.build())
// the properties below are optional
.volumesPerInstance(123)
.build()))
.ebsOptimized(false)
.build())
.weightedCapacity(123)
.build()))
.launchSpecifications(InstanceFleetProvisioningSpecificationsProperty.builder()
.onDemandSpecification(OnDemandProvisioningSpecificationProperty.builder()
.allocationStrategy("allocationStrategy")
.build())
.spotSpecification(SpotProvisioningSpecificationProperty.builder()
.timeoutAction("timeoutAction")
.timeoutDurationMinutes(123)
// the properties below are optional
.allocationStrategy("allocationStrategy")
.blockDurationMinutes(123)
.build())
.build())
.name("name")
.targetOnDemandCapacity(123)
.targetSpotCapacity(123)
.build())
.coreInstanceGroup(InstanceGroupConfigProperty.builder()
.instanceCount(123)
.instanceType("instanceType")
// 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)
.build())
// the properties below are optional
.volumesPerInstance(123)
.build()))
.ebsOptimized(false)
.build())
.market("market")
.name("name")
.build())
.ec2KeyName("ec2KeyName")
.ec2SubnetId("ec2SubnetId")
.ec2SubnetIds(List.of("ec2SubnetIds"))
.emrManagedMasterSecurityGroup("emrManagedMasterSecurityGroup")
.emrManagedSlaveSecurityGroup("emrManagedSlaveSecurityGroup")
.hadoopVersion("hadoopVersion")
.keepJobFlowAliveWhenNoSteps(false)
.masterInstanceFleet(InstanceFleetConfigProperty.builder()
.instanceTypeConfigs(List.of(InstanceTypeConfigProperty.builder()
.instanceType("instanceType")
// the properties below are optional
.bidPrice("bidPrice")
.bidPriceAsPercentageOfOnDemandPrice(123)
.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)
.build())
// the properties below are optional
.volumesPerInstance(123)
.build()))
.ebsOptimized(false)
.build())
.weightedCapacity(123)
.build()))
.launchSpecifications(InstanceFleetProvisioningSpecificationsProperty.builder()
.onDemandSpecification(OnDemandProvisioningSpecificationProperty.builder()
.allocationStrategy("allocationStrategy")
.build())
.spotSpecification(SpotProvisioningSpecificationProperty.builder()
.timeoutAction("timeoutAction")
.timeoutDurationMinutes(123)
// the properties below are optional
.allocationStrategy("allocationStrategy")
.blockDurationMinutes(123)
.build())
.build())
.name("name")
.targetOnDemandCapacity(123)
.targetSpotCapacity(123)
.build())
.masterInstanceGroup(InstanceGroupConfigProperty.builder()
.instanceCount(123)
.instanceType("instanceType")
// 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)
.build())
// the properties below are optional
.volumesPerInstance(123)
.build()))
.ebsOptimized(false)
.build())
.market("market")
.name("name")
.build())
.placement(PlacementTypeProperty.builder()
.availabilityZone("availabilityZone")
.build())
.serviceAccessSecurityGroup("serviceAccessSecurityGroup")
.taskInstanceFleets(List.of(InstanceFleetConfigProperty.builder()
.instanceTypeConfigs(List.of(InstanceTypeConfigProperty.builder()
.instanceType("instanceType")
// the properties below are optional
.bidPrice("bidPrice")
.bidPriceAsPercentageOfOnDemandPrice(123)
.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)
.build())
// the properties below are optional
.volumesPerInstance(123)
.build()))
.ebsOptimized(false)
.build())
.weightedCapacity(123)
.build()))
.launchSpecifications(InstanceFleetProvisioningSpecificationsProperty.builder()
.onDemandSpecification(OnDemandProvisioningSpecificationProperty.builder()
.allocationStrategy("allocationStrategy")
.build())
.spotSpecification(SpotProvisioningSpecificationProperty.builder()
.timeoutAction("timeoutAction")
.timeoutDurationMinutes(123)
// the properties below are optional
.allocationStrategy("allocationStrategy")
.blockDurationMinutes(123)
.build())
.build())
.name("name")
.targetOnDemandCapacity(123)
.targetSpotCapacity(123)
.build()))
.taskInstanceGroups(List.of(InstanceGroupConfigProperty.builder()
.instanceCount(123)
.instanceType("instanceType")
// 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)
.build())
// the properties below are optional
.volumesPerInstance(123)
.build()))
.ebsOptimized(false)
.build())
.market("market")
.name("name")
.build()))
.terminationProtected(false)
.build())
.jobFlowRole("jobFlowRole")
.name("name")
.serviceRole("serviceRole")
// the properties below are optional
.additionalInfo(additionalInfo)
.applications(List.of(ApplicationProperty.builder()
.additionalInfo(Map.of(
"additionalInfoKey", "additionalInfo"))
.args(List.of("args"))
.name("name")
.version("version")
.build()))
.autoScalingRole("autoScalingRole")
.autoTerminationPolicy(AutoTerminationPolicyProperty.builder()
.idleTimeout(123)
.build())
.bootstrapActions(List.of(BootstrapActionConfigProperty.builder()
.name("name")
.scriptBootstrapAction(ScriptBootstrapActionConfigProperty.builder()
.path("path")
// the properties below are optional
.args(List.of("args"))
.build())
.build()))
.configurations(List.of(ConfigurationProperty.builder()
.classification("classification")
.configurationProperties(Map.of(
"configurationPropertiesKey", "configurationProperties"))
.configurations(List.of(configurationProperty_))
.build()))
.customAmiId("customAmiId")
.ebsRootVolumeSize(123)
.kerberosAttributes(KerberosAttributesProperty.builder()
.kdcAdminPassword("kdcAdminPassword")
.realm("realm")
// the properties below are optional
.adDomainJoinPassword("adDomainJoinPassword")
.adDomainJoinUser("adDomainJoinUser")
.crossRealmTrustPrincipalPassword("crossRealmTrustPrincipalPassword")
.build())
.logEncryptionKmsKeyId("logEncryptionKmsKeyId")
.logUri("logUri")
.managedScalingPolicy(ManagedScalingPolicyProperty.builder()
.computeLimits(ComputeLimitsProperty.builder()
.maximumCapacityUnits(123)
.minimumCapacityUnits(123)
.unitType("unitType")
// the properties below are optional
.maximumCoreCapacityUnits(123)
.maximumOnDemandCapacityUnits(123)
.build())
.build())
.releaseLabel("releaseLabel")
.scaleDownBehavior("scaleDownBehavior")
.securityConfiguration("securityConfiguration")
.stepConcurrencyLevel(123)
.steps(List.of(StepConfigProperty.builder()
.hadoopJarStep(HadoopJarStepConfigProperty.builder()
.jar("jar")
// the properties below are optional
.args(List.of("args"))
.mainClass("mainClass")
.stepProperties(List.of(KeyValueProperty.builder()
.key("key")
.value("value")
.build()))
.build())
.name("name")
// the properties below are optional
.actionOnFailure("actionOnFailure")
.build()))
.tags(List.of(CfnTag.builder()
.key("key")
.value("value")
.build()))
.visibleToAllUsers(false)
.build();
| Modifier and Type | Interface and Description |
|---|---|
static class |
CfnClusterProps.Builder
A builder for
CfnClusterProps |
static class |
CfnClusterProps.Jsii$Proxy
An implementation for
CfnClusterProps |
| Modifier and Type | Method and 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()
`AWS::EMR::Cluster.AutoTerminationPolicy`.
|
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 version 5.7.0 and later.
|
default Number |
getEbsRootVolumeSize()
The size, in GiB, of the Amazon EBS root device volume of the Linux AMI that is used for each EC2 instance.
|
Object |
getInstances()
A specification of the number and type of Amazon EC2 instances.
|
String |
getJobFlowRole()
Also called instance profile and 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 |
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.
|
@Stability(value=Stable) @NotNull Object getInstances()
@Stability(value=Stable) @NotNull String getJobFlowRole()
An IAM role for an EMR cluster. The 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 CLI or console.
@Stability(value=Stable) @NotNull String getName()
@Stability(value=Stable) @NotNull String getServiceRole()
@Stability(value=Stable) @Nullable default Object getAdditionalInfo()
@Stability(value=Stable) @Nullable default Object getApplications()
@Stability(value=Stable) @Nullable default String getAutoScalingRole()
The default role is EMR_AutoScaling_DefaultRole . The IAM role provides permissions that the automatic scaling feature requires to launch and terminate EC2 instances in an instance group.
@Stability(value=Stable) @Nullable default Object getAutoTerminationPolicy()
@Stability(value=Stable) @Nullable default Object getBootstrapActions()
@Stability(value=Stable) @Nullable default Object getConfigurations()
@Stability(value=Stable) @Nullable default String getCustomAmiId()
@Stability(value=Stable) @Nullable default Number getEbsRootVolumeSize()
Available in Amazon EMR version 4.x and later.
@Stability(value=Stable) @Nullable default Object getKerberosAttributes()
For more information see Use Kerberos Authentication in the Amazon EMR Management Guide .
@Stability(value=Stable) @Nullable default String getLogEncryptionKmsKeyId()
This attribute is only available with EMR version 5.30.0 and later, excluding EMR 6.0.0.
@Stability(value=Stable) @Nullable default String getLogUri()
@Stability(value=Stable) @Nullable default Object getManagedScalingPolicy()
The managed scaling policy defines the limits for resources, such as 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.
@Stability(value=Stable) @Nullable default String getReleaseLabel()
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 .
@Stability(value=Stable) @Nullable default String getScaleDownBehavior()
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 version 4.1.0 and later, and is the default for versions of Amazon EMR earlier than 5.1.0.
@Stability(value=Stable) @Nullable default String getSecurityConfiguration()
@Stability(value=Stable) @Nullable default Number getStepConcurrencyLevel()
The default value is 1 . The maximum value is 256 .
@Stability(value=Stable) @Nullable default Object getSteps()
@Stability(value=Stable) @Nullable default List<CfnTag> getTags()
@Stability(value=Stable) @Nullable default Object getVisibleToAllUsers()
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
trueby default. However, forAWS::EMR::Clusterresources in CloudFormation, the default isfalse.
@Stability(value=Stable) static CfnClusterProps.Builder builder()
CfnClusterProps.Builder of CfnClusterPropsCopyright © 2022. All rights reserved.