AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

The detailed description of the cluster.

Inheritance Hierarchy


Namespace: Amazon.ElasticMapReduce.Model
Assembly: AWSSDK.ElasticMapReduce.dll
Version: 3.x.y.z


public class Cluster

The Cluster type exposes the following members


Public Method Cluster()


Public Property Applications System.Collections.Generic.List<Amazon.ElasticMapReduce.Model.Application>

Gets and sets the property Applications.

The applications installed on this cluster.

Public Property AutoScalingRole System.String

Gets and sets the property 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.

Public Property AutoTerminate System.Boolean

Gets and sets the property AutoTerminate.

Specifies whether the cluster should terminate after completing all steps.

Public Property Configurations System.Collections.Generic.List<Amazon.ElasticMapReduce.Model.Configuration>

Gets and sets the property Configurations.

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

Public Property CustomAmiId System.String

Gets and sets the property 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.

Public Property EbsRootVolumeSize System.Int32

Gets and sets the property 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.

Public Property Ec2InstanceAttributes Amazon.ElasticMapReduce.Model.Ec2InstanceAttributes

Gets and sets the property 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.

Public Property Id System.String

Gets and sets the property Id.

The unique identifier for the cluster.

Public Property InstanceCollectionType Amazon.ElasticMapReduce.InstanceCollectionType

Gets and sets the property 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.

Public Property KerberosAttributes Amazon.ElasticMapReduce.Model.KerberosAttributes

Gets and sets the property KerberosAttributes.

Attributes for Kerberos configuration when Kerberos authentication is enabled using a security configuration. For more information see Use Kerberos Authentication in the EMR Management Guide.

Public Property LogUri System.String

Gets and sets the property LogUri.

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

Public Property MasterPublicDnsName System.String

Gets and sets the property MasterPublicDnsName.

The DNS name of the master node. If the cluster is on a private subnet, this is the private DNS name. On a public subnet, this is the public DNS name.

Public Property Name System.String

Gets and sets the property Name.

The name of the cluster.

Public Property NormalizedInstanceHours System.Int32

Gets and sets the property 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.

Public Property ReleaseLabel System.String

Gets and sets the property ReleaseLabel.

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, for example, 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 versions 4.x and later. Earlier versions use AmiVersion.

Public Property RepoUpgradeOnBoot Amazon.ElasticMapReduce.RepoUpgradeOnBoot

Gets and sets the property 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.

Public Property RequestedAmiVersion System.String

Gets and sets the property RequestedAmiVersion.

The AMI version requested for this cluster.

Public Property RunningAmiVersion System.String

Gets and sets the property RunningAmiVersion.

The AMI version running on this cluster.

Public Property ScaleDownBehavior Amazon.ElasticMapReduce.ScaleDownBehavior

Gets and sets the property 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.

Public Property SecurityConfiguration System.String

Gets and sets the property SecurityConfiguration.

The name of the security configuration applied to the cluster.

Public Property ServiceRole System.String

Gets and sets the property ServiceRole.

The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.

Public Property Status Amazon.ElasticMapReduce.Model.ClusterStatus

Gets and sets the property Status.

The current status details about the cluster.

Public Property Tags System.Collections.Generic.List<Amazon.ElasticMapReduce.Model.Tag>

Gets and sets the property Tags.

A list of tags associated with a cluster.

Public Property TerminationProtected System.Boolean

Gets and sets the property 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.

Public Property VisibleToAllUsers System.Boolean

Gets and sets the property 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.

Version Information

.NET Standard:
Supported in: 1.3

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms