Class: Aws::EMR::Types::Cluster
- Inherits:
-
Struct
- Object
- Struct
- Aws::EMR::Types::Cluster
- Includes:
- Structure
- Defined in:
- lib/aws-sdk-emr/types.rb
Overview
The detailed description of the cluster.
Instance Attribute Summary collapse
-
#applications ⇒ Array<Types::Application>
The applications installed on this cluster.
-
#auto_scaling_role ⇒ String
An IAM role for automatic scaling policies.
-
#auto_terminate ⇒ Boolean
Specifies whether the cluster should terminate after completing all steps.
-
#configurations ⇒ Array<Types::Configuration>
Applies only to Amazon EMR releases 4.x and later.
-
#custom_ami_id ⇒ String
Available only in Amazon EMR version 5.7.0 and later.
-
#ebs_root_volume_size ⇒ Integer
The size, in GiB, of the EBS root device volume of the Linux AMI that is used for each EC2 instance.
-
#ec2_instance_attributes ⇒ Types::Ec2InstanceAttributes
Provides information about the EC2 instances in a cluster grouped by category.
-
#id ⇒ String
The unique identifier for the cluster.
-
#instance_collection_type ⇒ String
<note markdown=“1”> The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
-
#log_uri ⇒ String
The path to the Amazon S3 location where logs for this cluster are stored.
-
#master_public_dns_name ⇒ String
The public DNS name of the master EC2 instance.
-
#name ⇒ String
The name of the cluster.
-
#normalized_instance_hours ⇒ Integer
An approximation of the cost of the cluster, represented in m1.small/hours.
-
#release_label ⇒ String
The release label for the Amazon EMR release.
-
#repo_upgrade_on_boot ⇒ String
Applies only when ‘CustomAmiID` is used.
-
#requested_ami_version ⇒ String
The AMI version requested for this cluster.
-
#running_ami_version ⇒ String
The AMI version running on this cluster.
-
#scale_down_behavior ⇒ String
The way that individual Amazon EC2 instances terminate when an automatic scale-in activity occurs or an instance group is resized.
-
#security_configuration ⇒ String
The name of the security configuration applied to the cluster.
-
#service_role ⇒ String
The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.
-
#status ⇒ Types::ClusterStatus
The current status details about the cluster.
-
#tags ⇒ Array<Types::Tag>
A list of tags associated with a cluster.
-
#termination_protected ⇒ Boolean
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.
-
#visible_to_all_users ⇒ Boolean
Indicates whether the cluster is visible to all IAM users of the AWS account associated with the cluster.
Instance Attribute Details
#applications ⇒ Array<Types::Application>
The applications installed on this cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#auto_scaling_role ⇒ String
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#auto_terminate ⇒ Boolean
Specifies whether the cluster should terminate after completing all steps.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#configurations ⇒ Array<Types::Configuration>
Applies only to Amazon EMR releases 4.x and later. The list of Configurations supplied to the EMR cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#custom_ami_id ⇒ String
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#ebs_root_volume_size ⇒ Integer
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#ec2_instance_attributes ⇒ Types::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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#id ⇒ String
The unique identifier for the cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#instance_collection_type ⇒ String
<note markdown=“1”> The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
</note>
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#log_uri ⇒ String
The path to the Amazon S3 location where logs for this cluster are stored.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#master_public_dns_name ⇒ String
The public DNS name of the master EC2 instance.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#name ⇒ String
The name of the cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#normalized_instance_hours ⇒ Integer
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#release_label ⇒ String
The release label for the Amazon EMR release.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#repo_upgrade_on_boot ⇒ String
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#requested_ami_version ⇒ String
The AMI version requested for this cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#running_ami_version ⇒ String
The AMI version running on this cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#scale_down_behavior ⇒ String
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#security_configuration ⇒ String
The name of the security configuration applied to the cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#service_role ⇒ String
The IAM role that will be assumed by the Amazon EMR service to access AWS resources on your behalf.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#status ⇒ Types::ClusterStatus
The current status details about the cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#tags ⇒ Array<Types::Tag>
A list of tags associated with a cluster.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#termination_protected ⇒ Boolean
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |
#visible_to_all_users ⇒ Boolean
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.
855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 |
# File 'lib/aws-sdk-emr/types.rb', line 855 class Cluster < Struct.new( :id, :name, :status, :ec2_instance_attributes, :instance_collection_type, :log_uri, :requested_ami_version, :running_ami_version, :release_label, :auto_terminate, :termination_protected, :visible_to_all_users, :applications, :tags, :service_role, :normalized_instance_hours, :master_public_dns_name, :configurations, :security_configuration, :auto_scaling_role, :scale_down_behavior, :custom_ami_id, :ebs_root_volume_size, :repo_upgrade_on_boot) include Aws::Structure end |