software.amazon.awssdk.services.computeoptimizer.model.VolumeRecommendation Maven / Gradle / Ivy
Show all versions of computeoptimizer Show documentation
/*
* Copyright 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.computeoptimizer.model;
import java.io.Serializable;
import java.time.Instant;
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.core.util.SdkAutoConstructList;
import software.amazon.awssdk.utils.ToString;
import software.amazon.awssdk.utils.builder.CopyableBuilder;
import software.amazon.awssdk.utils.builder.ToCopyableBuilder;
/**
*
* Describes an Amazon Elastic Block Store (Amazon EBS) volume recommendation.
*
*/
@Generated("software.amazon.awssdk:codegen")
public final class VolumeRecommendation implements SdkPojo, Serializable,
ToCopyableBuilder {
private static final SdkField VOLUME_ARN_FIELD = SdkField. builder(MarshallingType.STRING)
.memberName("volumeArn").getter(getter(VolumeRecommendation::volumeArn)).setter(setter(Builder::volumeArn))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("volumeArn").build()).build();
private static final SdkField ACCOUNT_ID_FIELD = SdkField. builder(MarshallingType.STRING)
.memberName("accountId").getter(getter(VolumeRecommendation::accountId)).setter(setter(Builder::accountId))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("accountId").build()).build();
private static final SdkField CURRENT_CONFIGURATION_FIELD = SdkField
. builder(MarshallingType.SDK_POJO).memberName("currentConfiguration")
.getter(getter(VolumeRecommendation::currentConfiguration)).setter(setter(Builder::currentConfiguration))
.constructor(VolumeConfiguration::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("currentConfiguration").build())
.build();
private static final SdkField FINDING_FIELD = SdkField. builder(MarshallingType.STRING).memberName("finding")
.getter(getter(VolumeRecommendation::findingAsString)).setter(setter(Builder::finding))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("finding").build()).build();
private static final SdkField> UTILIZATION_METRICS_FIELD = SdkField
.> builder(MarshallingType.LIST)
.memberName("utilizationMetrics")
.getter(getter(VolumeRecommendation::utilizationMetrics))
.setter(setter(Builder::utilizationMetrics))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("utilizationMetrics").build(),
ListTrait
.builder()
.memberLocationName(null)
.memberFieldInfo(
SdkField. builder(MarshallingType.SDK_POJO)
.constructor(EBSUtilizationMetric::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD)
.locationName("member").build()).build()).build()).build();
private static final SdkField LOOK_BACK_PERIOD_IN_DAYS_FIELD = SdkField. builder(MarshallingType.DOUBLE)
.memberName("lookBackPeriodInDays").getter(getter(VolumeRecommendation::lookBackPeriodInDays))
.setter(setter(Builder::lookBackPeriodInDays))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("lookBackPeriodInDays").build())
.build();
private static final SdkField> VOLUME_RECOMMENDATION_OPTIONS_FIELD = SdkField
.> builder(MarshallingType.LIST)
.memberName("volumeRecommendationOptions")
.getter(getter(VolumeRecommendation::volumeRecommendationOptions))
.setter(setter(Builder::volumeRecommendationOptions))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("volumeRecommendationOptions")
.build(),
ListTrait
.builder()
.memberLocationName(null)
.memberFieldInfo(
SdkField. builder(MarshallingType.SDK_POJO)
.constructor(VolumeRecommendationOption::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD)
.locationName("member").build()).build()).build()).build();
private static final SdkField LAST_REFRESH_TIMESTAMP_FIELD = SdkField. builder(MarshallingType.INSTANT)
.memberName("lastRefreshTimestamp").getter(getter(VolumeRecommendation::lastRefreshTimestamp))
.setter(setter(Builder::lastRefreshTimestamp))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("lastRefreshTimestamp").build())
.build();
private static final SdkField CURRENT_PERFORMANCE_RISK_FIELD = SdkField. builder(MarshallingType.STRING)
.memberName("currentPerformanceRisk").getter(getter(VolumeRecommendation::currentPerformanceRiskAsString))
.setter(setter(Builder::currentPerformanceRisk))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("currentPerformanceRisk").build())
.build();
private static final SdkField EFFECTIVE_RECOMMENDATION_PREFERENCES_FIELD = SdkField
. builder(MarshallingType.SDK_POJO)
.memberName("effectiveRecommendationPreferences")
.getter(getter(VolumeRecommendation::effectiveRecommendationPreferences))
.setter(setter(Builder::effectiveRecommendationPreferences))
.constructor(EBSEffectiveRecommendationPreferences::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("effectiveRecommendationPreferences")
.build()).build();
private static final SdkField> TAGS_FIELD = SdkField
.> builder(MarshallingType.LIST)
.memberName("tags")
.getter(getter(VolumeRecommendation::tags))
.setter(setter(Builder::tags))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("tags").build(),
ListTrait
.builder()
.memberLocationName(null)
.memberFieldInfo(
SdkField. builder(MarshallingType.SDK_POJO)
.constructor(Tag::builder)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD)
.locationName("member").build()).build()).build()).build();
private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(VOLUME_ARN_FIELD,
ACCOUNT_ID_FIELD, CURRENT_CONFIGURATION_FIELD, FINDING_FIELD, UTILIZATION_METRICS_FIELD,
LOOK_BACK_PERIOD_IN_DAYS_FIELD, VOLUME_RECOMMENDATION_OPTIONS_FIELD, LAST_REFRESH_TIMESTAMP_FIELD,
CURRENT_PERFORMANCE_RISK_FIELD, EFFECTIVE_RECOMMENDATION_PREFERENCES_FIELD, TAGS_FIELD));
private static final long serialVersionUID = 1L;
private final String volumeArn;
private final String accountId;
private final VolumeConfiguration currentConfiguration;
private final String finding;
private final List utilizationMetrics;
private final Double lookBackPeriodInDays;
private final List volumeRecommendationOptions;
private final Instant lastRefreshTimestamp;
private final String currentPerformanceRisk;
private final EBSEffectiveRecommendationPreferences effectiveRecommendationPreferences;
private final List tags;
private VolumeRecommendation(BuilderImpl builder) {
this.volumeArn = builder.volumeArn;
this.accountId = builder.accountId;
this.currentConfiguration = builder.currentConfiguration;
this.finding = builder.finding;
this.utilizationMetrics = builder.utilizationMetrics;
this.lookBackPeriodInDays = builder.lookBackPeriodInDays;
this.volumeRecommendationOptions = builder.volumeRecommendationOptions;
this.lastRefreshTimestamp = builder.lastRefreshTimestamp;
this.currentPerformanceRisk = builder.currentPerformanceRisk;
this.effectiveRecommendationPreferences = builder.effectiveRecommendationPreferences;
this.tags = builder.tags;
}
/**
*
* The Amazon Resource Name (ARN) of the current volume.
*
*
* @return The Amazon Resource Name (ARN) of the current volume.
*/
public final String volumeArn() {
return volumeArn;
}
/**
*
* The Amazon Web Services account ID of the volume.
*
*
* @return The Amazon Web Services account ID of the volume.
*/
public final String accountId() {
return accountId;
}
/**
*
* An array of objects that describe the current configuration of the volume.
*
*
* @return An array of objects that describe the current configuration of the volume.
*/
public final VolumeConfiguration currentConfiguration() {
return currentConfiguration;
}
/**
*
* The finding classification of the volume.
*
*
* Findings for volumes include:
*
*
* -
*
* NotOptimized
—A volume is considered not optimized when Compute Optimizer identifies a
* recommendation that can provide better performance for your workload.
*
*
* -
*
* Optimized
—An volume is considered optimized when Compute Optimizer determines that the
* volume is correctly provisioned to run your workload based on the chosen volume type. For optimized resources,
* Compute Optimizer might recommend a new generation volume type.
*
*
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #finding} will
* return {@link EBSFinding#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from
* {@link #findingAsString}.
*
*
* @return The finding classification of the volume.
*
* Findings for volumes include:
*
*
* -
*
* NotOptimized
—A volume is considered not optimized when Compute Optimizer identifies
* a recommendation that can provide better performance for your workload.
*
*
* -
*
* Optimized
—An volume is considered optimized when Compute Optimizer determines that
* the volume is correctly provisioned to run your workload based on the chosen volume type. For optimized
* resources, Compute Optimizer might recommend a new generation volume type.
*
*
* @see EBSFinding
*/
public final EBSFinding finding() {
return EBSFinding.fromValue(finding);
}
/**
*
* The finding classification of the volume.
*
*
* Findings for volumes include:
*
*
* -
*
* NotOptimized
—A volume is considered not optimized when Compute Optimizer identifies a
* recommendation that can provide better performance for your workload.
*
*
* -
*
* Optimized
—An volume is considered optimized when Compute Optimizer determines that the
* volume is correctly provisioned to run your workload based on the chosen volume type. For optimized resources,
* Compute Optimizer might recommend a new generation volume type.
*
*
*
*
* If the service returns an enum value that is not available in the current SDK version, {@link #finding} will
* return {@link EBSFinding#UNKNOWN_TO_SDK_VERSION}. The raw value returned by the service is available from
* {@link #findingAsString}.
*
*
* @return The finding classification of the volume.
*
* Findings for volumes include:
*
*
* -
*
* NotOptimized
—A volume is considered not optimized when Compute Optimizer identifies
* a recommendation that can provide better performance for your workload.
*
*
* -
*
* Optimized
—An volume is considered optimized when Compute Optimizer determines that
* the volume is correctly provisioned to run your workload based on the chosen volume type. For optimized
* resources, Compute Optimizer might recommend a new generation volume type.
*
*
* @see EBSFinding
*/
public final String findingAsString() {
return finding;
}
/**
* For responses, this returns true if the service returned a value for the UtilizationMetrics property. This DOES
* NOT check that the value is non-empty (for which, you should check the {@code isEmpty()} method on the property).
* This is useful because the SDK will never return a null collection or map, but you may need to differentiate
* between the service returning nothing (or null) and the service returning an empty collection or map. For
* requests, this returns true if a value for the property was specified in the request builder, and false if a
* value was not specified.
*/
public final boolean hasUtilizationMetrics() {
return utilizationMetrics != null && !(utilizationMetrics instanceof SdkAutoConstructList);
}
/**
*
* An array of objects that describe the utilization metrics of the volume.
*
*
* Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
*
*
* This method will never return null. If you would like to know whether the service returned this field (so that
* you can differentiate between null and empty), you can use the {@link #hasUtilizationMetrics} method.
*
*
* @return An array of objects that describe the utilization metrics of the volume.
*/
public final List utilizationMetrics() {
return utilizationMetrics;
}
/**
*
* The number of days for which utilization metrics were analyzed for the volume.
*
*
* @return The number of days for which utilization metrics were analyzed for the volume.
*/
public final Double lookBackPeriodInDays() {
return lookBackPeriodInDays;
}
/**
* For responses, this returns true if the service returned a value for the VolumeRecommendationOptions property.
* This DOES NOT check that the value is non-empty (for which, you should check the {@code isEmpty()} method on the
* property). This is useful because the SDK will never return a null collection or map, but you may need to
* differentiate between the service returning nothing (or null) and the service returning an empty collection or
* map. For requests, this returns true if a value for the property was specified in the request builder, and false
* if a value was not specified.
*/
public final boolean hasVolumeRecommendationOptions() {
return volumeRecommendationOptions != null && !(volumeRecommendationOptions instanceof SdkAutoConstructList);
}
/**
*
* An array of objects that describe the recommendation options for the volume.
*
*
* Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
*
*
* This method will never return null. If you would like to know whether the service returned this field (so that
* you can differentiate between null and empty), you can use the {@link #hasVolumeRecommendationOptions} method.
*
*
* @return An array of objects that describe the recommendation options for the volume.
*/
public final List volumeRecommendationOptions() {
return volumeRecommendationOptions;
}
/**
*
* The timestamp of when the volume recommendation was last generated.
*
*
* @return The timestamp of when the volume recommendation was last generated.
*/
public final Instant lastRefreshTimestamp() {
return lastRefreshTimestamp;
}
/**
*
* The risk of the current EBS volume not meeting the performance needs of its workloads. The higher the risk, the
* more likely the current EBS volume doesn't have sufficient capacity.
*
*
* If the service returns an enum value that is not available in the current SDK version,
* {@link #currentPerformanceRisk} will return {@link CurrentPerformanceRisk#UNKNOWN_TO_SDK_VERSION}. The raw value
* returned by the service is available from {@link #currentPerformanceRiskAsString}.
*
*
* @return The risk of the current EBS volume not meeting the performance needs of its workloads. The higher the
* risk, the more likely the current EBS volume doesn't have sufficient capacity.
* @see CurrentPerformanceRisk
*/
public final CurrentPerformanceRisk currentPerformanceRisk() {
return CurrentPerformanceRisk.fromValue(currentPerformanceRisk);
}
/**
*
* The risk of the current EBS volume not meeting the performance needs of its workloads. The higher the risk, the
* more likely the current EBS volume doesn't have sufficient capacity.
*
*
* If the service returns an enum value that is not available in the current SDK version,
* {@link #currentPerformanceRisk} will return {@link CurrentPerformanceRisk#UNKNOWN_TO_SDK_VERSION}. The raw value
* returned by the service is available from {@link #currentPerformanceRiskAsString}.
*
*
* @return The risk of the current EBS volume not meeting the performance needs of its workloads. The higher the
* risk, the more likely the current EBS volume doesn't have sufficient capacity.
* @see CurrentPerformanceRisk
*/
public final String currentPerformanceRiskAsString() {
return currentPerformanceRisk;
}
/**
*
* Describes the effective recommendation preferences for Amazon EBS volume.
*
*
* @return Describes the effective recommendation preferences for Amazon EBS volume.
*/
public final EBSEffectiveRecommendationPreferences effectiveRecommendationPreferences() {
return effectiveRecommendationPreferences;
}
/**
* For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that
* the value is non-empty (for which, you should check the {@code isEmpty()} method on the property). This is useful
* because the SDK will never return a null collection or map, but you may need to differentiate between the service
* returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true
* if a value for the property was specified in the request builder, and false if a value was not specified.
*/
public final boolean hasTags() {
return tags != null && !(tags instanceof SdkAutoConstructList);
}
/**
*
* A list of tags assigned to your Amazon EBS volume recommendations.
*
*
* Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
*
*
* This method will never return null. If you would like to know whether the service returned this field (so that
* you can differentiate between null and empty), you can use the {@link #hasTags} method.
*
*
* @return A list of tags assigned to your Amazon EBS volume recommendations.
*/
public final List tags() {
return tags;
}
@Override
public Builder toBuilder() {
return new BuilderImpl(this);
}
public static Builder builder() {
return new BuilderImpl();
}
public static Class serializableBuilderClass() {
return BuilderImpl.class;
}
@Override
public final int hashCode() {
int hashCode = 1;
hashCode = 31 * hashCode + Objects.hashCode(volumeArn());
hashCode = 31 * hashCode + Objects.hashCode(accountId());
hashCode = 31 * hashCode + Objects.hashCode(currentConfiguration());
hashCode = 31 * hashCode + Objects.hashCode(findingAsString());
hashCode = 31 * hashCode + Objects.hashCode(hasUtilizationMetrics() ? utilizationMetrics() : null);
hashCode = 31 * hashCode + Objects.hashCode(lookBackPeriodInDays());
hashCode = 31 * hashCode + Objects.hashCode(hasVolumeRecommendationOptions() ? volumeRecommendationOptions() : null);
hashCode = 31 * hashCode + Objects.hashCode(lastRefreshTimestamp());
hashCode = 31 * hashCode + Objects.hashCode(currentPerformanceRiskAsString());
hashCode = 31 * hashCode + Objects.hashCode(effectiveRecommendationPreferences());
hashCode = 31 * hashCode + Objects.hashCode(hasTags() ? tags() : null);
return hashCode;
}
@Override
public final boolean equals(Object obj) {
return equalsBySdkFields(obj);
}
@Override
public final boolean equalsBySdkFields(Object obj) {
if (this == obj) {
return true;
}
if (obj == null) {
return false;
}
if (!(obj instanceof VolumeRecommendation)) {
return false;
}
VolumeRecommendation other = (VolumeRecommendation) obj;
return Objects.equals(volumeArn(), other.volumeArn()) && Objects.equals(accountId(), other.accountId())
&& Objects.equals(currentConfiguration(), other.currentConfiguration())
&& Objects.equals(findingAsString(), other.findingAsString())
&& hasUtilizationMetrics() == other.hasUtilizationMetrics()
&& Objects.equals(utilizationMetrics(), other.utilizationMetrics())
&& Objects.equals(lookBackPeriodInDays(), other.lookBackPeriodInDays())
&& hasVolumeRecommendationOptions() == other.hasVolumeRecommendationOptions()
&& Objects.equals(volumeRecommendationOptions(), other.volumeRecommendationOptions())
&& Objects.equals(lastRefreshTimestamp(), other.lastRefreshTimestamp())
&& Objects.equals(currentPerformanceRiskAsString(), other.currentPerformanceRiskAsString())
&& Objects.equals(effectiveRecommendationPreferences(), other.effectiveRecommendationPreferences())
&& hasTags() == other.hasTags() && Objects.equals(tags(), other.tags());
}
/**
* 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 final String toString() {
return ToString.builder("VolumeRecommendation").add("VolumeArn", volumeArn()).add("AccountId", accountId())
.add("CurrentConfiguration", currentConfiguration()).add("Finding", findingAsString())
.add("UtilizationMetrics", hasUtilizationMetrics() ? utilizationMetrics() : null)
.add("LookBackPeriodInDays", lookBackPeriodInDays())
.add("VolumeRecommendationOptions", hasVolumeRecommendationOptions() ? volumeRecommendationOptions() : null)
.add("LastRefreshTimestamp", lastRefreshTimestamp())
.add("CurrentPerformanceRisk", currentPerformanceRiskAsString())
.add("EffectiveRecommendationPreferences", effectiveRecommendationPreferences())
.add("Tags", hasTags() ? tags() : null).build();
}
public final Optional getValueForField(String fieldName, Class clazz) {
switch (fieldName) {
case "volumeArn":
return Optional.ofNullable(clazz.cast(volumeArn()));
case "accountId":
return Optional.ofNullable(clazz.cast(accountId()));
case "currentConfiguration":
return Optional.ofNullable(clazz.cast(currentConfiguration()));
case "finding":
return Optional.ofNullable(clazz.cast(findingAsString()));
case "utilizationMetrics":
return Optional.ofNullable(clazz.cast(utilizationMetrics()));
case "lookBackPeriodInDays":
return Optional.ofNullable(clazz.cast(lookBackPeriodInDays()));
case "volumeRecommendationOptions":
return Optional.ofNullable(clazz.cast(volumeRecommendationOptions()));
case "lastRefreshTimestamp":
return Optional.ofNullable(clazz.cast(lastRefreshTimestamp()));
case "currentPerformanceRisk":
return Optional.ofNullable(clazz.cast(currentPerformanceRiskAsString()));
case "effectiveRecommendationPreferences":
return Optional.ofNullable(clazz.cast(effectiveRecommendationPreferences()));
case "tags":
return Optional.ofNullable(clazz.cast(tags()));
default:
return Optional.empty();
}
}
@Override
public final List> sdkFields() {
return SDK_FIELDS;
}
private static Function