software.amazon.awssdk.services.emr.model.InstanceFleetConfig Maven / Gradle / Ivy
Show all versions of emr Show documentation
/*
* Copyright 2014-2019 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 software.amazon.awssdk.services.emr.model;
import java.io.Serializable;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.List;
import java.util.Objects;
import java.util.Optional;
import java.util.function.BiConsumer;
import java.util.function.Consumer;
import java.util.function.Function;
import java.util.stream.Collectors;
import java.util.stream.Stream;
import software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.core.SdkField;
import software.amazon.awssdk.core.SdkPojo;
import software.amazon.awssdk.core.protocol.MarshallLocation;
import software.amazon.awssdk.core.protocol.MarshallingType;
import software.amazon.awssdk.core.traits.ListTrait;
import software.amazon.awssdk.core.traits.LocationTrait;
import software.amazon.awssdk.core.util.DefaultSdkAutoConstructList;
import software.amazon.awssdk.utils.ToString;
import software.amazon.awssdk.utils.builder.CopyableBuilder;
import software.amazon.awssdk.utils.builder.ToCopyableBuilder;
/**
*
* The configuration that defines an instance fleet.
*
*
*
* The instance fleet configuration is available only in Amazon EMR versions 4.8.0 and later, excluding 5.0.x versions.
*
*
*/
@Generated("software.amazon.awssdk:codegen")
public final class InstanceFleetConfig implements SdkPojo, Serializable,
ToCopyableBuilder {
private static final SdkField NAME_FIELD = SdkField. builder(MarshallingType.STRING)
.getter(getter(InstanceFleetConfig::name)).setter(setter(Builder::name))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("Name").build()).build();
private static final SdkField INSTANCE_FLEET_TYPE_FIELD = SdkField. builder(MarshallingType.STRING)
.getter(getter(InstanceFleetConfig::instanceFleetTypeAsString)).setter(setter(Builder::instanceFleetType))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("InstanceFleetType").build()).build();
private static final SdkField TARGET_ON_DEMAND_CAPACITY_FIELD = SdkField. builder(MarshallingType.INTEGER)
.getter(getter(InstanceFleetConfig::targetOnDemandCapacity)).setter(setter(Builder::targetOnDemandCapacity))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("TargetOnDemandCapacity").build())
.build();
private static final SdkField TARGET_SPOT_CAPACITY_FIELD = SdkField. builder(MarshallingType.INTEGER)
.getter(getter(InstanceFleetConfig::targetSpotCapacity)).setter(setter(Builder::targetSpotCapacity))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("TargetSpotCapacity").build())
.build();
private static final SdkField> INSTANCE_TYPE_CONFIGS_FIELD = SdkField
.> builder(MarshallingType.LIST)
.getter(getter(InstanceFleetConfig::instanceTypeConfigs))
.setter(setter(Builder::instanceTypeConfigs))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("InstanceTypeConfigs").build(),
ListTrait
.builder()
.memberLocationName(null)
.memberFieldInfo(
SdkField. builder(MarshallingType.SDK_POJO)
.constructor(InstanceTypeConfig::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD)
.locationName("member").build()).build()).build()).build();
private static final SdkField LAUNCH_SPECIFICATIONS_FIELD = SdkField
. builder(MarshallingType.SDK_POJO)
.getter(getter(InstanceFleetConfig::launchSpecifications)).setter(setter(Builder::launchSpecifications))
.constructor(InstanceFleetProvisioningSpecifications::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("LaunchSpecifications").build())
.build();
private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(NAME_FIELD,
INSTANCE_FLEET_TYPE_FIELD, TARGET_ON_DEMAND_CAPACITY_FIELD, TARGET_SPOT_CAPACITY_FIELD, INSTANCE_TYPE_CONFIGS_FIELD,
LAUNCH_SPECIFICATIONS_FIELD));
private static final long serialVersionUID = 1L;
private final String name;
private final String instanceFleetType;
private final Integer targetOnDemandCapacity;
private final Integer targetSpotCapacity;
private final List instanceTypeConfigs;
private final InstanceFleetProvisioningSpecifications launchSpecifications;
private InstanceFleetConfig(BuilderImpl builder) {
this.name = builder.name;
this.instanceFleetType = builder.instanceFleetType;
this.targetOnDemandCapacity = builder.targetOnDemandCapacity;
this.targetSpotCapacity = builder.targetSpotCapacity;
this.instanceTypeConfigs = builder.instanceTypeConfigs;
this.launchSpecifications = builder.launchSpecifications;
}
/**
*
* The friendly name of the instance fleet.
*
*
* @return The friendly name of the instance fleet.
*/
public String name() {
return name;
}
/**
*
* The node type that the instance fleet hosts. Valid values are MASTER,CORE,and TASK.
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #instanceFleetType}
* will return {@link InstanceFleetType#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available
* from {@link #instanceFleetTypeAsString}.
*
*
* @return The node type that the instance fleet hosts. Valid values are MASTER,CORE,and TASK.
* @see InstanceFleetType
*/
public InstanceFleetType instanceFleetType() {
return InstanceFleetType.fromValue(instanceFleetType);
}
/**
*
* The node type that the instance fleet hosts. Valid values are MASTER,CORE,and TASK.
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #instanceFleetType}
* will return {@link InstanceFleetType#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available
* from {@link #instanceFleetTypeAsString}.
*
*
* @return The node type that the instance fleet hosts. Valid values are MASTER,CORE,and TASK.
* @see InstanceFleetType
*/
public String instanceFleetTypeAsString() {
return instanceFleetType;
}
/**
*
* The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand instances to
* provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand instances as specified by
* InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity
. When an
* On-Demand instance is provisioned, the WeightedCapacity
units count toward the target capacity.
* Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this results in an
* overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an
* instance with a WeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is
* exceeded by 3 units.
*
*
*
* If not specified or set to 0, only Spot instances are provisioned for the instance fleet using
* TargetSpotCapacity
. At least one of TargetSpotCapacity
and
* TargetOnDemandCapacity
should be greater than 0. For a master instance fleet, only one of
* TargetSpotCapacity
and TargetOnDemandCapacity
can be specified, and its value must be
* 1.
*
*
*
* @return The target capacity of On-Demand units for the instance fleet, which determines how many On-Demand
* instances to provision. When the instance fleet launches, Amazon EMR tries to provision On-Demand
* instances as specified by InstanceTypeConfig. Each instance configuration has a specified
* WeightedCapacity
. When an On-Demand instance is provisioned, the
* WeightedCapacity
units count toward the target capacity. Amazon EMR provisions instances
* until the target capacity is totally fulfilled, even if this results in an overage. For example, if there
* are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a
* WeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is
* exceeded by 3 units.
*
* If not specified or set to 0, only Spot instances are provisioned for the instance fleet using
* TargetSpotCapacity
. At least one of TargetSpotCapacity
and
* TargetOnDemandCapacity
should be greater than 0. For a master instance fleet, only one of
* TargetSpotCapacity
and TargetOnDemandCapacity
can be specified, and its value
* must be 1.
*
*/
public Integer targetOnDemandCapacity() {
return targetOnDemandCapacity;
}
/**
*
* The target capacity of Spot units for the instance fleet, which determines how many Spot instances to provision.
* When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified by
* InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity
. When a Spot
* instance is provisioned, the WeightedCapacity
units count toward the target capacity. Amazon EMR
* provisions instances until the target capacity is totally fulfilled, even if this results in an overage. For
* example, if there are 2 units remaining to fulfill capacity, and Amazon EMR can only provision an instance with a
* WeightedCapacity
of 5 units, the instance is provisioned, and the target capacity is exceeded by 3
* units.
*
*
*
* If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least one of
* TargetSpotCapacity
and TargetOnDemandCapacity
should be greater than 0. For a master
* instance fleet, only one of TargetSpotCapacity
and TargetOnDemandCapacity
can be
* specified, and its value must be 1.
*
*
*
* @return The target capacity of Spot units for the instance fleet, which determines how many Spot instances to
* provision. When the instance fleet launches, Amazon EMR tries to provision Spot instances as specified by
* InstanceTypeConfig. Each instance configuration has a specified WeightedCapacity
.
* When a Spot instance is provisioned, the WeightedCapacity
units count toward the target
* capacity. Amazon EMR provisions instances until the target capacity is totally fulfilled, even if this
* results in an overage. For example, if there are 2 units remaining to fulfill capacity, and Amazon EMR
* can only provision an instance with a WeightedCapacity
of 5 units, the instance is
* provisioned, and the target capacity is exceeded by 3 units.
*
* If not specified or set to 0, only On-Demand instances are provisioned for the instance fleet. At least
* one of TargetSpotCapacity
and TargetOnDemandCapacity
should be greater than 0.
* For a master instance fleet, only one of TargetSpotCapacity
and
* TargetOnDemandCapacity
can be specified, and its value must be 1.
*
*/
public Integer targetSpotCapacity() {
return targetSpotCapacity;
}
/**
*
* The instance type configurations that define the EC2 instances in the instance fleet.
*
*
* Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
*
*
* @return The instance type configurations that define the EC2 instances in the instance fleet.
*/
public List instanceTypeConfigs() {
return instanceTypeConfigs;
}
/**
*
* The launch specification for the instance fleet.
*
*
* @return The launch specification for the instance fleet.
*/
public InstanceFleetProvisioningSpecifications launchSpecifications() {
return launchSpecifications;
}
@Override
public Builder toBuilder() {
return new BuilderImpl(this);
}
public static Builder builder() {
return new BuilderImpl();
}
public static Class extends Builder> serializableBuilderClass() {
return BuilderImpl.class;
}
@Override
public int hashCode() {
int hashCode = 1;
hashCode = 31 * hashCode + Objects.hashCode(name());
hashCode = 31 * hashCode + Objects.hashCode(instanceFleetTypeAsString());
hashCode = 31 * hashCode + Objects.hashCode(targetOnDemandCapacity());
hashCode = 31 * hashCode + Objects.hashCode(targetSpotCapacity());
hashCode = 31 * hashCode + Objects.hashCode(instanceTypeConfigs());
hashCode = 31 * hashCode + Objects.hashCode(launchSpecifications());
return hashCode;
}
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj == null) {
return false;
}
if (!(obj instanceof InstanceFleetConfig)) {
return false;
}
InstanceFleetConfig other = (InstanceFleetConfig) obj;
return Objects.equals(name(), other.name())
&& Objects.equals(instanceFleetTypeAsString(), other.instanceFleetTypeAsString())
&& Objects.equals(targetOnDemandCapacity(), other.targetOnDemandCapacity())
&& Objects.equals(targetSpotCapacity(), other.targetSpotCapacity())
&& Objects.equals(instanceTypeConfigs(), other.instanceTypeConfigs())
&& Objects.equals(launchSpecifications(), other.launchSpecifications());
}
/**
* Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be
* redacted from this string using a placeholder value.
*/
@Override
public String toString() {
return ToString.builder("InstanceFleetConfig").add("Name", name()).add("InstanceFleetType", instanceFleetTypeAsString())
.add("TargetOnDemandCapacity", targetOnDemandCapacity()).add("TargetSpotCapacity", targetSpotCapacity())
.add("InstanceTypeConfigs", instanceTypeConfigs()).add("LaunchSpecifications", launchSpecifications()).build();
}
public Optional getValueForField(String fieldName, Class clazz) {
switch (fieldName) {
case "Name":
return Optional.ofNullable(clazz.cast(name()));
case "InstanceFleetType":
return Optional.ofNullable(clazz.cast(instanceFleetTypeAsString()));
case "TargetOnDemandCapacity":
return Optional.ofNullable(clazz.cast(targetOnDemandCapacity()));
case "TargetSpotCapacity":
return Optional.ofNullable(clazz.cast(targetSpotCapacity()));
case "InstanceTypeConfigs":
return Optional.ofNullable(clazz.cast(instanceTypeConfigs()));
case "LaunchSpecifications":
return Optional.ofNullable(clazz.cast(launchSpecifications()));
default:
return Optional.empty();
}
}
@Override
public List> sdkFields() {
return SDK_FIELDS;
}
private static Function