com.amazonaws.services.elasticmapreduce.model.Ec2InstanceAttributes Maven / Gradle / Ivy
Show all versions of aws-java-sdk-emr Show documentation
/*
* Copyright 2011-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.elasticmapreduce.model;
import java.io.Serializable;
/**
*
* 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 class Ec2InstanceAttributes implements Serializable, Cloneable {
/**
*
* The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named
* "hadoop".
*
*/
private String ec2KeyName;
/**
*
* To launch the job flow in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where you
* want the job flow to launch. If you do not specify this value, the job flow 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 job flow launched in a VPC.
*
*/
private String ec2SubnetId;
/**
*
* The Availability Zone in which the cluster will run.
*
*/
private String ec2AvailabilityZone;
/**
*
* The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume this
* role.
*
*/
private String iamInstanceProfile;
/**
*
* The identifier of the Amazon EC2 security group for the master node.
*
*/
private String emrManagedMasterSecurityGroup;
/**
*
* The identifier of the Amazon EC2 security group for the slave nodes.
*
*/
private String emrManagedSlaveSecurityGroup;
/**
*
* The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private
* subnets.
*
*/
private String serviceAccessSecurityGroup;
/**
*
* A list of additional Amazon EC2 security group IDs for the master node.
*
*/
private com.amazonaws.internal.SdkInternalList additionalMasterSecurityGroups;
/**
*
* A list of additional Amazon EC2 security group IDs for the slave nodes.
*
*/
private com.amazonaws.internal.SdkInternalList additionalSlaveSecurityGroups;
/**
*
* The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named
* "hadoop".
*
*
* @param ec2KeyName
* The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named
* "hadoop".
*/
public void setEc2KeyName(String ec2KeyName) {
this.ec2KeyName = ec2KeyName;
}
/**
*
* The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named
* "hadoop".
*
*
* @return The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named
* "hadoop".
*/
public String getEc2KeyName() {
return this.ec2KeyName;
}
/**
*
* The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named
* "hadoop".
*
*
* @param ec2KeyName
* The name of the Amazon EC2 key pair to use when connecting with SSH into the master node as a user named
* "hadoop".
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withEc2KeyName(String ec2KeyName) {
setEc2KeyName(ec2KeyName);
return this;
}
/**
*
* To launch the job flow in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where you
* want the job flow to launch. If you do not specify this value, the job flow 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 job flow launched in a VPC.
*
*
* @param ec2SubnetId
* To launch the job flow in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where
* you want the job flow to launch. If you do not specify this value, the job flow 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 job flow launched in a VPC.
*/
public void setEc2SubnetId(String ec2SubnetId) {
this.ec2SubnetId = ec2SubnetId;
}
/**
*
* To launch the job flow in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where you
* want the job flow to launch. If you do not specify this value, the job flow 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 job flow launched in a VPC.
*
*
* @return To launch the job flow in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where
* you want the job flow to launch. If you do not specify this value, the job flow 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 job flow launched in a VPC.
*/
public String getEc2SubnetId() {
return this.ec2SubnetId;
}
/**
*
* To launch the job flow in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where you
* want the job flow to launch. If you do not specify this value, the job flow 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 job flow launched in a VPC.
*
*
* @param ec2SubnetId
* To launch the job flow in Amazon VPC, set this parameter to the identifier of the Amazon VPC subnet where
* you want the job flow to launch. If you do not specify this value, the job flow 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 job flow launched in a VPC.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withEc2SubnetId(String ec2SubnetId) {
setEc2SubnetId(ec2SubnetId);
return this;
}
/**
*
* The Availability Zone in which the cluster will run.
*
*
* @param ec2AvailabilityZone
* The Availability Zone in which the cluster will run.
*/
public void setEc2AvailabilityZone(String ec2AvailabilityZone) {
this.ec2AvailabilityZone = ec2AvailabilityZone;
}
/**
*
* The Availability Zone in which the cluster will run.
*
*
* @return The Availability Zone in which the cluster will run.
*/
public String getEc2AvailabilityZone() {
return this.ec2AvailabilityZone;
}
/**
*
* The Availability Zone in which the cluster will run.
*
*
* @param ec2AvailabilityZone
* The Availability Zone in which the cluster will run.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withEc2AvailabilityZone(String ec2AvailabilityZone) {
setEc2AvailabilityZone(ec2AvailabilityZone);
return this;
}
/**
*
* The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume this
* role.
*
*
* @param iamInstanceProfile
* The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume
* this role.
*/
public void setIamInstanceProfile(String iamInstanceProfile) {
this.iamInstanceProfile = iamInstanceProfile;
}
/**
*
* The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume this
* role.
*
*
* @return The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume
* this role.
*/
public String getIamInstanceProfile() {
return this.iamInstanceProfile;
}
/**
*
* The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume this
* role.
*
*
* @param iamInstanceProfile
* The IAM role that was specified when the job flow was launched. The EC2 instances of the job flow assume
* this role.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withIamInstanceProfile(String iamInstanceProfile) {
setIamInstanceProfile(iamInstanceProfile);
return this;
}
/**
*
* The identifier of the Amazon EC2 security group for the master node.
*
*
* @param emrManagedMasterSecurityGroup
* The identifier of the Amazon EC2 security group for the master node.
*/
public void setEmrManagedMasterSecurityGroup(String emrManagedMasterSecurityGroup) {
this.emrManagedMasterSecurityGroup = emrManagedMasterSecurityGroup;
}
/**
*
* The identifier of the Amazon EC2 security group for the master node.
*
*
* @return The identifier of the Amazon EC2 security group for the master node.
*/
public String getEmrManagedMasterSecurityGroup() {
return this.emrManagedMasterSecurityGroup;
}
/**
*
* The identifier of the Amazon EC2 security group for the master node.
*
*
* @param emrManagedMasterSecurityGroup
* The identifier of the Amazon EC2 security group for the master node.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withEmrManagedMasterSecurityGroup(String emrManagedMasterSecurityGroup) {
setEmrManagedMasterSecurityGroup(emrManagedMasterSecurityGroup);
return this;
}
/**
*
* The identifier of the Amazon EC2 security group for the slave nodes.
*
*
* @param emrManagedSlaveSecurityGroup
* The identifier of the Amazon EC2 security group for the slave nodes.
*/
public void setEmrManagedSlaveSecurityGroup(String emrManagedSlaveSecurityGroup) {
this.emrManagedSlaveSecurityGroup = emrManagedSlaveSecurityGroup;
}
/**
*
* The identifier of the Amazon EC2 security group for the slave nodes.
*
*
* @return The identifier of the Amazon EC2 security group for the slave nodes.
*/
public String getEmrManagedSlaveSecurityGroup() {
return this.emrManagedSlaveSecurityGroup;
}
/**
*
* The identifier of the Amazon EC2 security group for the slave nodes.
*
*
* @param emrManagedSlaveSecurityGroup
* The identifier of the Amazon EC2 security group for the slave nodes.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withEmrManagedSlaveSecurityGroup(String emrManagedSlaveSecurityGroup) {
setEmrManagedSlaveSecurityGroup(emrManagedSlaveSecurityGroup);
return this;
}
/**
*
* The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private
* subnets.
*
*
* @param serviceAccessSecurityGroup
* The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC
* private subnets.
*/
public void setServiceAccessSecurityGroup(String serviceAccessSecurityGroup) {
this.serviceAccessSecurityGroup = serviceAccessSecurityGroup;
}
/**
*
* The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private
* subnets.
*
*
* @return The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC
* private subnets.
*/
public String getServiceAccessSecurityGroup() {
return this.serviceAccessSecurityGroup;
}
/**
*
* The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC private
* subnets.
*
*
* @param serviceAccessSecurityGroup
* The identifier of the Amazon EC2 security group for the Amazon EMR service to access clusters in VPC
* private subnets.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withServiceAccessSecurityGroup(String serviceAccessSecurityGroup) {
setServiceAccessSecurityGroup(serviceAccessSecurityGroup);
return this;
}
/**
*
* A list of additional Amazon EC2 security group IDs for the master node.
*
*
* @return A list of additional Amazon EC2 security group IDs for the master node.
*/
public java.util.List getAdditionalMasterSecurityGroups() {
if (additionalMasterSecurityGroups == null) {
additionalMasterSecurityGroups = new com.amazonaws.internal.SdkInternalList();
}
return additionalMasterSecurityGroups;
}
/**
*
* A list of additional Amazon EC2 security group IDs for the master node.
*
*
* @param additionalMasterSecurityGroups
* A list of additional Amazon EC2 security group IDs for the master node.
*/
public void setAdditionalMasterSecurityGroups(java.util.Collection additionalMasterSecurityGroups) {
if (additionalMasterSecurityGroups == null) {
this.additionalMasterSecurityGroups = null;
return;
}
this.additionalMasterSecurityGroups = new com.amazonaws.internal.SdkInternalList(additionalMasterSecurityGroups);
}
/**
*
* A list of additional Amazon EC2 security group IDs for the master node.
*
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setAdditionalMasterSecurityGroups(java.util.Collection)} or
* {@link #withAdditionalMasterSecurityGroups(java.util.Collection)} if you want to override the existing values.
*
*
* @param additionalMasterSecurityGroups
* A list of additional Amazon EC2 security group IDs for the master node.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withAdditionalMasterSecurityGroups(String... additionalMasterSecurityGroups) {
if (this.additionalMasterSecurityGroups == null) {
setAdditionalMasterSecurityGroups(new com.amazonaws.internal.SdkInternalList(additionalMasterSecurityGroups.length));
}
for (String ele : additionalMasterSecurityGroups) {
this.additionalMasterSecurityGroups.add(ele);
}
return this;
}
/**
*
* A list of additional Amazon EC2 security group IDs for the master node.
*
*
* @param additionalMasterSecurityGroups
* A list of additional Amazon EC2 security group IDs for the master node.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withAdditionalMasterSecurityGroups(java.util.Collection additionalMasterSecurityGroups) {
setAdditionalMasterSecurityGroups(additionalMasterSecurityGroups);
return this;
}
/**
*
* A list of additional Amazon EC2 security group IDs for the slave nodes.
*
*
* @return A list of additional Amazon EC2 security group IDs for the slave nodes.
*/
public java.util.List getAdditionalSlaveSecurityGroups() {
if (additionalSlaveSecurityGroups == null) {
additionalSlaveSecurityGroups = new com.amazonaws.internal.SdkInternalList();
}
return additionalSlaveSecurityGroups;
}
/**
*
* A list of additional Amazon EC2 security group IDs for the slave nodes.
*
*
* @param additionalSlaveSecurityGroups
* A list of additional Amazon EC2 security group IDs for the slave nodes.
*/
public void setAdditionalSlaveSecurityGroups(java.util.Collection additionalSlaveSecurityGroups) {
if (additionalSlaveSecurityGroups == null) {
this.additionalSlaveSecurityGroups = null;
return;
}
this.additionalSlaveSecurityGroups = new com.amazonaws.internal.SdkInternalList(additionalSlaveSecurityGroups);
}
/**
*
* A list of additional Amazon EC2 security group IDs for the slave nodes.
*
*
* NOTE: This method appends the values to the existing list (if any). Use
* {@link #setAdditionalSlaveSecurityGroups(java.util.Collection)} or
* {@link #withAdditionalSlaveSecurityGroups(java.util.Collection)} if you want to override the existing values.
*
*
* @param additionalSlaveSecurityGroups
* A list of additional Amazon EC2 security group IDs for the slave nodes.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withAdditionalSlaveSecurityGroups(String... additionalSlaveSecurityGroups) {
if (this.additionalSlaveSecurityGroups == null) {
setAdditionalSlaveSecurityGroups(new com.amazonaws.internal.SdkInternalList(additionalSlaveSecurityGroups.length));
}
for (String ele : additionalSlaveSecurityGroups) {
this.additionalSlaveSecurityGroups.add(ele);
}
return this;
}
/**
*
* A list of additional Amazon EC2 security group IDs for the slave nodes.
*
*
* @param additionalSlaveSecurityGroups
* A list of additional Amazon EC2 security group IDs for the slave nodes.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public Ec2InstanceAttributes withAdditionalSlaveSecurityGroups(java.util.Collection additionalSlaveSecurityGroups) {
setAdditionalSlaveSecurityGroups(additionalSlaveSecurityGroups);
return this;
}
/**
* Returns a string representation of this object; useful for testing and debugging.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getEc2KeyName() != null)
sb.append("Ec2KeyName: " + getEc2KeyName() + ",");
if (getEc2SubnetId() != null)
sb.append("Ec2SubnetId: " + getEc2SubnetId() + ",");
if (getEc2AvailabilityZone() != null)
sb.append("Ec2AvailabilityZone: " + getEc2AvailabilityZone() + ",");
if (getIamInstanceProfile() != null)
sb.append("IamInstanceProfile: " + getIamInstanceProfile() + ",");
if (getEmrManagedMasterSecurityGroup() != null)
sb.append("EmrManagedMasterSecurityGroup: " + getEmrManagedMasterSecurityGroup() + ",");
if (getEmrManagedSlaveSecurityGroup() != null)
sb.append("EmrManagedSlaveSecurityGroup: " + getEmrManagedSlaveSecurityGroup() + ",");
if (getServiceAccessSecurityGroup() != null)
sb.append("ServiceAccessSecurityGroup: " + getServiceAccessSecurityGroup() + ",");
if (getAdditionalMasterSecurityGroups() != null)
sb.append("AdditionalMasterSecurityGroups: " + getAdditionalMasterSecurityGroups() + ",");
if (getAdditionalSlaveSecurityGroups() != null)
sb.append("AdditionalSlaveSecurityGroups: " + getAdditionalSlaveSecurityGroups());
sb.append("}");
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof Ec2InstanceAttributes == false)
return false;
Ec2InstanceAttributes other = (Ec2InstanceAttributes) obj;
if (other.getEc2KeyName() == null ^ this.getEc2KeyName() == null)
return false;
if (other.getEc2KeyName() != null && other.getEc2KeyName().equals(this.getEc2KeyName()) == false)
return false;
if (other.getEc2SubnetId() == null ^ this.getEc2SubnetId() == null)
return false;
if (other.getEc2SubnetId() != null && other.getEc2SubnetId().equals(this.getEc2SubnetId()) == false)
return false;
if (other.getEc2AvailabilityZone() == null ^ this.getEc2AvailabilityZone() == null)
return false;
if (other.getEc2AvailabilityZone() != null && other.getEc2AvailabilityZone().equals(this.getEc2AvailabilityZone()) == false)
return false;
if (other.getIamInstanceProfile() == null ^ this.getIamInstanceProfile() == null)
return false;
if (other.getIamInstanceProfile() != null && other.getIamInstanceProfile().equals(this.getIamInstanceProfile()) == false)
return false;
if (other.getEmrManagedMasterSecurityGroup() == null ^ this.getEmrManagedMasterSecurityGroup() == null)
return false;
if (other.getEmrManagedMasterSecurityGroup() != null
&& other.getEmrManagedMasterSecurityGroup().equals(this.getEmrManagedMasterSecurityGroup()) == false)
return false;
if (other.getEmrManagedSlaveSecurityGroup() == null ^ this.getEmrManagedSlaveSecurityGroup() == null)
return false;
if (other.getEmrManagedSlaveSecurityGroup() != null && other.getEmrManagedSlaveSecurityGroup().equals(this.getEmrManagedSlaveSecurityGroup()) == false)
return false;
if (other.getServiceAccessSecurityGroup() == null ^ this.getServiceAccessSecurityGroup() == null)
return false;
if (other.getServiceAccessSecurityGroup() != null && other.getServiceAccessSecurityGroup().equals(this.getServiceAccessSecurityGroup()) == false)
return false;
if (other.getAdditionalMasterSecurityGroups() == null ^ this.getAdditionalMasterSecurityGroups() == null)
return false;
if (other.getAdditionalMasterSecurityGroups() != null
&& other.getAdditionalMasterSecurityGroups().equals(this.getAdditionalMasterSecurityGroups()) == false)
return false;
if (other.getAdditionalSlaveSecurityGroups() == null ^ this.getAdditionalSlaveSecurityGroups() == null)
return false;
if (other.getAdditionalSlaveSecurityGroups() != null
&& other.getAdditionalSlaveSecurityGroups().equals(this.getAdditionalSlaveSecurityGroups()) == false)
return false;
return true;
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getEc2KeyName() == null) ? 0 : getEc2KeyName().hashCode());
hashCode = prime * hashCode + ((getEc2SubnetId() == null) ? 0 : getEc2SubnetId().hashCode());
hashCode = prime * hashCode + ((getEc2AvailabilityZone() == null) ? 0 : getEc2AvailabilityZone().hashCode());
hashCode = prime * hashCode + ((getIamInstanceProfile() == null) ? 0 : getIamInstanceProfile().hashCode());
hashCode = prime * hashCode + ((getEmrManagedMasterSecurityGroup() == null) ? 0 : getEmrManagedMasterSecurityGroup().hashCode());
hashCode = prime * hashCode + ((getEmrManagedSlaveSecurityGroup() == null) ? 0 : getEmrManagedSlaveSecurityGroup().hashCode());
hashCode = prime * hashCode + ((getServiceAccessSecurityGroup() == null) ? 0 : getServiceAccessSecurityGroup().hashCode());
hashCode = prime * hashCode + ((getAdditionalMasterSecurityGroups() == null) ? 0 : getAdditionalMasterSecurityGroups().hashCode());
hashCode = prime * hashCode + ((getAdditionalSlaveSecurityGroups() == null) ? 0 : getAdditionalSlaveSecurityGroups().hashCode());
return hashCode;
}
@Override
public Ec2InstanceAttributes clone() {
try {
return (Ec2InstanceAttributes) super.clone();
} catch (CloneNotSupportedException e) {
throw new IllegalStateException("Got a CloneNotSupportedException from Object.clone() " + "even though we're Cloneable!", e);
}
}
}