public static interface Cluster.Builder extends CopyableBuilder<Cluster.Builder,Cluster>
Modifier and Type | Method and Description |
---|---|
Cluster.Builder |
applications(Application... applications)
The applications installed on this cluster.
|
Cluster.Builder |
applications(Collection<Application> applications)
The applications installed on this cluster.
|
Cluster.Builder |
applications(Consumer<Application.Builder>... applications)
The applications installed on this cluster.
|
Cluster.Builder |
autoScalingRole(String autoScalingRole)
An IAM role for automatic scaling policies.
|
Cluster.Builder |
autoTerminate(Boolean autoTerminate)
Specifies whether the cluster should terminate after completing all steps.
|
Cluster.Builder |
configurations(Collection<Configuration> configurations)
Applies only to Amazon EMR releases 4.x and later.
|
Cluster.Builder |
configurations(Configuration... configurations)
Applies only to Amazon EMR releases 4.x and later.
|
Cluster.Builder |
configurations(Consumer<Configuration.Builder>... configurations)
Applies only to Amazon EMR releases 4.x and later.
|
Cluster.Builder |
customAmiId(String customAmiId)
Available only in Amazon EMR version 5.7.0 and later.
|
Cluster.Builder |
ebsRootVolumeSize(Integer ebsRootVolumeSize)
The size, in GiB, of the EBS root device volume of the Linux AMI that is used for each EC2 instance.
|
default Cluster.Builder |
ec2InstanceAttributes(Consumer<Ec2InstanceAttributes.Builder> ec2InstanceAttributes)
Provides information about the EC2 instances in a cluster grouped by category.
|
Cluster.Builder |
ec2InstanceAttributes(Ec2InstanceAttributes ec2InstanceAttributes)
Provides information about the EC2 instances in a cluster grouped by category.
|
Cluster.Builder |
id(String id)
The unique identifier for the cluster.
|
Cluster.Builder |
instanceCollectionType(InstanceCollectionType instanceCollectionType)
|
Cluster.Builder |
instanceCollectionType(String instanceCollectionType)
|
Cluster.Builder |
logUri(String logUri)
The path to the Amazon S3 location where logs for this cluster are stored.
|
Cluster.Builder |
masterPublicDnsName(String masterPublicDnsName)
The public DNS name of the master EC2 instance.
|
Cluster.Builder |
name(String name)
The name of the cluster.
|
Cluster.Builder |
normalizedInstanceHours(Integer normalizedInstanceHours)
An approximation of the cost of the cluster, represented in m1.small/hours.
|
Cluster.Builder |
releaseLabel(String releaseLabel)
The release label for the Amazon EMR release.
|
Cluster.Builder |
repoUpgradeOnBoot(RepoUpgradeOnBoot repoUpgradeOnBoot)
Applies only when
CustomAmiID is used. |
Cluster.Builder |
repoUpgradeOnBoot(String repoUpgradeOnBoot)
Applies only when
CustomAmiID is used. |
Cluster.Builder |
requestedAmiVersion(String requestedAmiVersion)
The AMI version requested for this cluster.
|
Cluster.Builder |
runningAmiVersion(String runningAmiVersion)
The AMI version running on this cluster.
|
Cluster.Builder |
scaleDownBehavior(ScaleDownBehavior scaleDownBehavior)
The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an
instance group is resized.
|
Cluster.Builder |
scaleDownBehavior(String scaleDownBehavior)
The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an
instance group is resized.
|
Cluster.Builder |
securityConfiguration(String securityConfiguration)
The name of the security configuration applied to the cluster.
|
Cluster.Builder |
serviceRole(String serviceRole)
The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.
|
Cluster.Builder |
status(ClusterStatus status)
The current status details about the cluster.
|
default Cluster.Builder |
status(Consumer<ClusterStatus.Builder> status)
The current status details about the cluster.
|
Cluster.Builder |
tags(Collection<Tag> tags)
A list of tags associated with a cluster.
|
Cluster.Builder |
tags(Consumer<Tag.Builder>... tags)
A list of tags associated with a cluster.
|
Cluster.Builder |
tags(Tag... tags)
A list of tags associated with a cluster.
|
Cluster.Builder |
terminationProtected(Boolean terminationProtected)
Indicates whether Amazon EMR will lock the cluster to prevent the EC2 instances from being terminated by an
API call or user intervention, or in the event of a cluster error.
|
Cluster.Builder |
visibleToAllUsers(Boolean visibleToAllUsers)
Indicates whether the cluster is visible to all IAM users of the AWS account associated with the cluster.
|
copy
applyMutation, build
Cluster.Builder id(String id)
The unique identifier for the cluster.
id
- The unique identifier for the cluster.Cluster.Builder name(String name)
The name of the cluster.
name
- The name of the cluster.Cluster.Builder status(ClusterStatus status)
The current status details about the cluster.
status
- The current status details about the cluster.default Cluster.Builder status(Consumer<ClusterStatus.Builder> status)
The current status details about the cluster.
This is a convenience that creates an instance of theClusterStatus.Builder
avoiding the need to
create one manually via ClusterStatus.builder()
.
When the Consumer
completes, SdkBuilder.build()
is called immediately and its
result is passed to status(ClusterStatus)
.status
- a consumer that will call methods on ClusterStatus.Builder
status(ClusterStatus)
Cluster.Builder ec2InstanceAttributes(Ec2InstanceAttributes ec2InstanceAttributes)
Provides information about the EC2 instances in a cluster grouped by category. For example, key name, subnet ID, IAM instance profile, and so on.
ec2InstanceAttributes
- Provides information about the EC2 instances in a cluster grouped by category. For example, key name,
subnet ID, IAM instance profile, and so on.default Cluster.Builder ec2InstanceAttributes(Consumer<Ec2InstanceAttributes.Builder> ec2InstanceAttributes)
Provides information about the EC2 instances in a cluster grouped by category. For example, key name, subnet ID, IAM instance profile, and so on.
This is a convenience that creates an instance of theEc2InstanceAttributes.Builder
avoiding the need
to create one manually via Ec2InstanceAttributes.builder()
.
When the Consumer
completes, SdkBuilder.build()
is called immediately and
its result is passed to ec2InstanceAttributes(Ec2InstanceAttributes)
.ec2InstanceAttributes
- a consumer that will call methods on Ec2InstanceAttributes.Builder
ec2InstanceAttributes(Ec2InstanceAttributes)
Cluster.Builder instanceCollectionType(String instanceCollectionType)
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
The instance group configuration of the cluster. A value of INSTANCE_GROUP
indicates a uniform
instance group configuration. A value of INSTANCE_FLEET
indicates an instance fleets
configuration.
instanceCollectionType
- The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
The instance group configuration of the cluster. A value of INSTANCE_GROUP
indicates a
uniform instance group configuration. A value of INSTANCE_FLEET
indicates an instance
fleets configuration.
InstanceCollectionType
,
InstanceCollectionType
Cluster.Builder instanceCollectionType(InstanceCollectionType instanceCollectionType)
The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
The instance group configuration of the cluster. A value of INSTANCE_GROUP
indicates a uniform
instance group configuration. A value of INSTANCE_FLEET
indicates an instance fleets
configuration.
instanceCollectionType
- The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
The instance group configuration of the cluster. A value of INSTANCE_GROUP
indicates a
uniform instance group configuration. A value of INSTANCE_FLEET
indicates an instance
fleets configuration.
InstanceCollectionType
,
InstanceCollectionType
Cluster.Builder logUri(String logUri)
The path to the Amazon S3 location where logs for this cluster are stored.
logUri
- The path to the Amazon S3 location where logs for this cluster are stored.Cluster.Builder requestedAmiVersion(String requestedAmiVersion)
The AMI version requested for this cluster.
requestedAmiVersion
- The AMI version requested for this cluster.Cluster.Builder runningAmiVersion(String runningAmiVersion)
The AMI version running on this cluster.
runningAmiVersion
- The AMI version running on this cluster.Cluster.Builder releaseLabel(String releaseLabel)
The release label for the Amazon EMR release.
releaseLabel
- The release label for the Amazon EMR release.Cluster.Builder autoTerminate(Boolean autoTerminate)
Specifies whether the cluster should terminate after completing all steps.
autoTerminate
- Specifies whether the cluster should terminate after completing all steps.Cluster.Builder terminationProtected(Boolean terminationProtected)
Indicates whether Amazon EMR will lock the cluster to prevent the EC2 instances from being terminated by an API call or user intervention, or in the event of a cluster error.
terminationProtected
- Indicates whether Amazon EMR will lock the cluster to prevent the EC2 instances from being terminated
by an API call or user intervention, or in the event of a cluster error.Cluster.Builder visibleToAllUsers(Boolean visibleToAllUsers)
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.
visibleToAllUsers
- 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.Cluster.Builder applications(Collection<Application> applications)
The applications installed on this cluster.
applications
- The applications installed on this cluster.Cluster.Builder applications(Application... applications)
The applications installed on this cluster.
applications
- The applications installed on this cluster.Cluster.Builder applications(Consumer<Application.Builder>... applications)
The applications installed on this cluster.
This is a convenience that creates an instance of theList.Builder
avoiding the need to
create one manually via List#builder()
.
When the Consumer
completes, List.Builder#build()
is called immediately and its
result is passed to #applications(List)
.applications
- a consumer that will call methods on List.Builder
#applications(List)
Cluster.Builder tags(Collection<Tag> tags)
A list of tags associated with a cluster.
tags
- A list of tags associated with a cluster.Cluster.Builder tags(Tag... tags)
A list of tags associated with a cluster.
tags
- A list of tags associated with a cluster.Cluster.Builder tags(Consumer<Tag.Builder>... tags)
A list of tags associated with a cluster.
This is a convenience that creates an instance of theList.Builder
avoiding the need to create
one manually via List#builder()
.
When the Consumer
completes, List.Builder#build()
is called immediately and its result
is passed to #tags(List)
.tags
- a consumer that will call methods on List.Builder
#tags(List)
Cluster.Builder serviceRole(String serviceRole)
The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.
serviceRole
- The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.Cluster.Builder normalizedInstanceHours(Integer normalizedInstanceHours)
An approximation of the cost of the cluster, represented in m1.small/hours. This value is incremented one time for every hour an m1.small instance runs. Larger instances are weighted more, so an EC2 instance that is roughly four times more expensive would result in the normalized instance hours being incremented by four. This result is only an approximation and does not reflect the actual billing rate.
normalizedInstanceHours
- An approximation of the cost of the cluster, represented in m1.small/hours. This value is incremented
one time for every hour an m1.small instance runs. Larger instances are weighted more, so an EC2
instance that is roughly four times more expensive would result in the normalized instance hours being
incremented by four. This result is only an approximation and does not reflect the actual billing
rate.Cluster.Builder masterPublicDnsName(String masterPublicDnsName)
The public DNS name of the master EC2 instance.
masterPublicDnsName
- The public DNS name of the master EC2 instance.Cluster.Builder configurations(Collection<Configuration> configurations)
Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR cluster.
configurations
- Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR
cluster.Cluster.Builder configurations(Configuration... configurations)
Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR cluster.
configurations
- Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR
cluster.Cluster.Builder configurations(Consumer<Configuration.Builder>... configurations)
Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR cluster.
This is a convenience that creates an instance of theList.Builder
avoiding the need
to create one manually via List#builder()
.
When the Consumer
completes, List.Builder#build()
is called immediately and
its result is passed to #configurations(List)
.configurations
- a consumer that will call methods on List.Builder
#configurations(List)
Cluster.Builder securityConfiguration(String securityConfiguration)
The name of the security configuration applied to the cluster.
securityConfiguration
- The name of the security configuration applied to the cluster.Cluster.Builder autoScalingRole(String autoScalingRole)
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 EC2
instances in an instance group.
autoScalingRole
- 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 EC2 instances in an instance group.Cluster.Builder scaleDownBehavior(String scaleDownBehavior)
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 blacklists 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.
scaleDownBehavior
- 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 blacklists 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.ScaleDownBehavior
,
ScaleDownBehavior
Cluster.Builder scaleDownBehavior(ScaleDownBehavior scaleDownBehavior)
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 blacklists 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.
scaleDownBehavior
- 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 blacklists 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.ScaleDownBehavior
,
ScaleDownBehavior
Cluster.Builder customAmiId(String customAmiId)
Available only in Amazon EMR version 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI if the cluster uses a custom AMI.
customAmiId
- Available only in Amazon EMR version 5.7.0 and later. The ID of a custom Amazon EBS-backed Linux AMI
if the cluster uses a custom AMI.Cluster.Builder ebsRootVolumeSize(Integer ebsRootVolumeSize)
The size, in GiB, of the EBS root device volume of the Linux AMI that is used for each EC2 instance. Available in Amazon EMR version 4.x and later.
ebsRootVolumeSize
- The size, in GiB, of the EBS root device volume of the Linux AMI that is used for each EC2 instance.
Available in Amazon EMR version 4.x and later.Cluster.Builder repoUpgradeOnBoot(String repoUpgradeOnBoot)
Applies only when CustomAmiID
is used. Specifies the type of updates that are applied from the
Amazon Linux AMI package repositories when an instance boots using the AMI.
repoUpgradeOnBoot
- Applies only when CustomAmiID
is used. Specifies the type of updates that are applied
from the Amazon Linux AMI package repositories when an instance boots using the AMI.RepoUpgradeOnBoot
,
RepoUpgradeOnBoot
Cluster.Builder repoUpgradeOnBoot(RepoUpgradeOnBoot repoUpgradeOnBoot)
Applies only when CustomAmiID
is used. Specifies the type of updates that are applied from the
Amazon Linux AMI package repositories when an instance boots using the AMI.
repoUpgradeOnBoot
- Applies only when CustomAmiID
is used. Specifies the type of updates that are applied
from the Amazon Linux AMI package repositories when an instance boots using the AMI.RepoUpgradeOnBoot
,
RepoUpgradeOnBoot
Copyright © 2017 Amazon Web Services, Inc. All Rights Reserved.