Menu
Amazon Elastic MapReduce
API Reference (API Version 2009-03-31)

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.

Contents

AdditionalMasterSecurityGroups

A list of additional Amazon EC2 security group IDs for the master node.

Type: Array of strings

Required: No

AdditionalSlaveSecurityGroups

A list of additional Amazon EC2 security group IDs for the slave nodes.

Type: Array of strings

Required: No

Ec2AvailabilityZone

The Availability Zone in which the cluster will run.

Type: String

Required: No

Ec2KeyName

The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named "hadoop".

Type: String

Required: No

Ec2SubnetId

To launch the cluster in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where you want the cluster to launch. If you do not specify this value, the cluster is launched in the normal AWS cloud, outside of a VPC.

Amazon VPC currently does not support cluster compute quadruple extra large (cc1.4xlarge) instances. Thus, you cannot specify the cc1.4xlarge instance type for nodes of a cluster launched in a VPC.

Type: String

Required: No

EmrManagedMasterSecurityGroup

The identifier of the Amazon EC2 security group for the master node.

Type: String

Required: No

EmrManagedSlaveSecurityGroup

The identifier of the Amazon EC2 security group for the slave nodes.

Type: String

Required: No

IamInstanceProfile

The IAM role that was specified when the cluster was launched. The EC2 instances of the cluster assume this role.

Type: String

Required: No

RequestedEc2AvailabilityZones

Applies to clusters configured with the instance fleets option. Specifies one or more Availability Zones in which to launch EC2 cluster instances when the EC2-Classic network configuration is supported. Amazon EMR chooses the Availability Zone with the best fit from among the list of RequestedEc2AvailabilityZones, and then launches all cluster instances within that Availability Zone. If you do not specify this value, Amazon EMR chooses the Availability Zone for you. RequestedEc2SubnetIDs and RequestedEc2AvailabilityZones cannot be specified together.

Type: Array of strings

Length Constraints: Minimum length of 0. Maximum length of 256.

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Required: No

RequestedEc2SubnetIds

Applies to clusters configured with the instance fleets option. Specifies the unique identifier of one or more Amazon EC2 subnets in which to launch EC2 cluster instances. Subnets must exist within the same VPC. Amazon EMR chooses the EC2 subnet with the best fit from among the list of RequestedEc2SubnetIds, and then launches all cluster instances within that Subnet. If this value is not specified, and the account and region support EC2-Classic networks, the cluster launches instances in the EC2-Classic network and uses RequestedEc2AvailabilityZones instead of this setting. If EC2-Classic is not supported, and no Subnet is specified, Amazon EMR chooses the subnet for you. RequestedEc2SubnetIDs and RequestedEc2AvailabilityZones cannot be specified together.

Type: Array of strings

Length Constraints: Minimum length of 0. Maximum length of 256.

Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Required: No

ServiceAccessSecurityGroup

The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private subnets.

Type: String

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: