software.amazon.awssdk.services.redshift.model.DescribeClusterParameterGroupsRequest Maven / Gradle / Ivy
Show all versions of redshift 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.redshift.model;
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 software.amazon.awssdk.annotations.Generated;
import software.amazon.awssdk.awscore.AwsRequestOverrideConfiguration;
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;
/**
*
*/
@Generated("software.amazon.awssdk:codegen")
public final class DescribeClusterParameterGroupsRequest extends RedshiftRequest implements
ToCopyableBuilder {
private static final SdkField PARAMETER_GROUP_NAME_FIELD = SdkField. builder(MarshallingType.STRING)
.memberName("ParameterGroupName").getter(getter(DescribeClusterParameterGroupsRequest::parameterGroupName))
.setter(setter(Builder::parameterGroupName))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("ParameterGroupName").build())
.build();
private static final SdkField MAX_RECORDS_FIELD = SdkField. builder(MarshallingType.INTEGER)
.memberName("MaxRecords").getter(getter(DescribeClusterParameterGroupsRequest::maxRecords))
.setter(setter(Builder::maxRecords))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("MaxRecords").build()).build();
private static final SdkField MARKER_FIELD = SdkField. builder(MarshallingType.STRING).memberName("Marker")
.getter(getter(DescribeClusterParameterGroupsRequest::marker)).setter(setter(Builder::marker))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("Marker").build()).build();
private static final SdkField> TAG_KEYS_FIELD = SdkField
.> builder(MarshallingType.LIST)
.memberName("TagKeys")
.getter(getter(DescribeClusterParameterGroupsRequest::tagKeys))
.setter(setter(Builder::tagKeys))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("TagKeys").build(),
ListTrait
.builder()
.memberLocationName("TagKey")
.memberFieldInfo(
SdkField. builder(MarshallingType.STRING)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD)
.locationName("TagKey").build()).build()).build()).build();
private static final SdkField> TAG_VALUES_FIELD = SdkField
.> builder(MarshallingType.LIST)
.memberName("TagValues")
.getter(getter(DescribeClusterParameterGroupsRequest::tagValues))
.setter(setter(Builder::tagValues))
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD).locationName("TagValues").build(),
ListTrait
.builder()
.memberLocationName("TagValue")
.memberFieldInfo(
SdkField. builder(MarshallingType.STRING)
.traits(LocationTrait.builder().location(MarshallLocation.PAYLOAD)
.locationName("TagValue").build()).build()).build()).build();
private static final List> SDK_FIELDS = Collections.unmodifiableList(Arrays.asList(PARAMETER_GROUP_NAME_FIELD,
MAX_RECORDS_FIELD, MARKER_FIELD, TAG_KEYS_FIELD, TAG_VALUES_FIELD));
private final String parameterGroupName;
private final Integer maxRecords;
private final String marker;
private final List tagKeys;
private final List tagValues;
private DescribeClusterParameterGroupsRequest(BuilderImpl builder) {
super(builder);
this.parameterGroupName = builder.parameterGroupName;
this.maxRecords = builder.maxRecords;
this.marker = builder.marker;
this.tagKeys = builder.tagKeys;
this.tagValues = builder.tagValues;
}
/**
*
* The name of a specific parameter group for which to return details. By default, details about all parameter
* groups and the default parameter group are returned.
*
*
* @return The name of a specific parameter group for which to return details. By default, details about all
* parameter groups and the default parameter group are returned.
*/
public final String parameterGroupName() {
return parameterGroupName;
}
/**
*
* The maximum number of response records to return in each call. If the number of remaining response records
* exceeds the specified MaxRecords value, a value is returned in a marker field of the
* response. You can retrieve the next set of records by retrying the command with the returned marker value.
*
*
* Default: 100
*
*
* Constraints: minimum 20, maximum 100.
*
*
* @return The maximum number of response records to return in each call. If the number of remaining response
* records exceeds the specified MaxRecords value, a value is returned in a marker
* field of the response. You can retrieve the next set of records by retrying the command with the returned
* marker value.
*
* Default: 100
*
*
* Constraints: minimum 20, maximum 100.
*/
public final Integer maxRecords() {
return maxRecords;
}
/**
*
* An optional parameter that specifies the starting point to return a set of response records. When the results of
* a DescribeClusterParameterGroups request exceed the value specified in MaxRecords, Amazon Web
* Services returns a value in the Marker field of the response. You can retrieve the next set of
* response records by providing the returned marker value in the Marker parameter and retrying the
* request.
*
*
* @return An optional parameter that specifies the starting point to return a set of response records. When the
* results of a DescribeClusterParameterGroups request exceed the value specified in
* MaxRecords, Amazon Web Services returns a value in the Marker field of the
* response. You can retrieve the next set of response records by providing the returned marker value in the
* Marker parameter and retrying the request.
*/
public final String marker() {
return marker;
}
/**
* For responses, this returns true if the service returned a value for the TagKeys 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 hasTagKeys() {
return tagKeys != null && !(tagKeys instanceof SdkAutoConstructList);
}
/**
*
* A tag key or keys for which you want to return all matching cluster parameter groups that are associated with the
* specified key or keys. For example, suppose that you have parameter groups that are tagged with keys called
* owner and environment. If you specify both of these tag keys in the request, Amazon
* Redshift returns a response with the parameter groups that have either or both of these tag keys associated with
* them.
*
*
* 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 #hasTagKeys} method.
*
*
* @return A tag key or keys for which you want to return all matching cluster parameter groups that are associated
* with the specified key or keys. For example, suppose that you have parameter groups that are tagged with
* keys called owner and environment. If you specify both of these tag keys in the
* request, Amazon Redshift returns a response with the parameter groups that have either or both of these
* tag keys associated with them.
*/
public final List tagKeys() {
return tagKeys;
}
/**
* For responses, this returns true if the service returned a value for the TagValues 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 hasTagValues() {
return tagValues != null && !(tagValues instanceof SdkAutoConstructList);
}
/**
*
* A tag value or values for which you want to return all matching cluster parameter groups that are associated with
* the specified tag value or values. For example, suppose that you have parameter groups that are tagged with
* values called admin and test. If you specify both of these tag values in the request,
* Amazon Redshift returns a response with the parameter groups that have either or both of these tag values
* associated with them.
*
*
* 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 #hasTagValues} method.
*
*
* @return A tag value or values for which you want to return all matching cluster parameter groups that are
* associated with the specified tag value or values. For example, suppose that you have parameter groups
* that are tagged with values called admin and test. If you specify both of these
* tag values in the request, Amazon Redshift returns a response with the parameter groups that have either
* or both of these tag values associated with them.
*/
public final List tagValues() {
return tagValues;
}
@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 + super.hashCode();
hashCode = 31 * hashCode + Objects.hashCode(parameterGroupName());
hashCode = 31 * hashCode + Objects.hashCode(maxRecords());
hashCode = 31 * hashCode + Objects.hashCode(marker());
hashCode = 31 * hashCode + Objects.hashCode(hasTagKeys() ? tagKeys() : null);
hashCode = 31 * hashCode + Objects.hashCode(hasTagValues() ? tagValues() : null);
return hashCode;
}
@Override
public final boolean equals(Object obj) {
return super.equals(obj) && equalsBySdkFields(obj);
}
@Override
public final boolean equalsBySdkFields(Object obj) {
if (this == obj) {
return true;
}
if (obj == null) {
return false;
}
if (!(obj instanceof DescribeClusterParameterGroupsRequest)) {
return false;
}
DescribeClusterParameterGroupsRequest other = (DescribeClusterParameterGroupsRequest) obj;
return Objects.equals(parameterGroupName(), other.parameterGroupName())
&& Objects.equals(maxRecords(), other.maxRecords()) && Objects.equals(marker(), other.marker())
&& hasTagKeys() == other.hasTagKeys() && Objects.equals(tagKeys(), other.tagKeys())
&& hasTagValues() == other.hasTagValues() && Objects.equals(tagValues(), other.tagValues());
}
/**
* 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("DescribeClusterParameterGroupsRequest").add("ParameterGroupName", parameterGroupName())
.add("MaxRecords", maxRecords()).add("Marker", marker()).add("TagKeys", hasTagKeys() ? tagKeys() : null)
.add("TagValues", hasTagValues() ? tagValues() : null).build();
}
public final Optional getValueForField(String fieldName, Class clazz) {
switch (fieldName) {
case "ParameterGroupName":
return Optional.ofNullable(clazz.cast(parameterGroupName()));
case "MaxRecords":
return Optional.ofNullable(clazz.cast(maxRecords()));
case "Marker":
return Optional.ofNullable(clazz.cast(marker()));
case "TagKeys":
return Optional.ofNullable(clazz.cast(tagKeys()));
case "TagValues":
return Optional.ofNullable(clazz.cast(tagValues()));
default:
return Optional.empty();
}
}
@Override
public final List> sdkFields() {
return SDK_FIELDS;
}
private static Function getter(Function g) {
return obj -> g.apply((DescribeClusterParameterGroupsRequest) obj);
}
private static BiConsumer setter(BiConsumer s) {
return (obj, val) -> s.accept((Builder) obj, val);
}
public interface Builder extends RedshiftRequest.Builder, SdkPojo,
CopyableBuilder {
/**
*
* The name of a specific parameter group for which to return details. By default, details about all parameter
* groups and the default parameter group are returned.
*
*
* @param parameterGroupName
* The name of a specific parameter group for which to return details. By default, details about all
* parameter groups and the default parameter group are returned.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder parameterGroupName(String parameterGroupName);
/**
*
* The maximum number of response records to return in each call. If the number of remaining response records
* exceeds the specified MaxRecords value, a value is returned in a marker field of
* the response. You can retrieve the next set of records by retrying the command with the returned marker
* value.
*
*
* Default: 100
*
*
* Constraints: minimum 20, maximum 100.
*
*
* @param maxRecords
* The maximum number of response records to return in each call. If the number of remaining response
* records exceeds the specified MaxRecords value, a value is returned in a
* marker field of the response. You can retrieve the next set of records by retrying the
* command with the returned marker value.
*
* Default: 100
*
*
* Constraints: minimum 20, maximum 100.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder maxRecords(Integer maxRecords);
/**
*
* An optional parameter that specifies the starting point to return a set of response records. When the results
* of a DescribeClusterParameterGroups request exceed the value specified in MaxRecords,
* Amazon Web Services returns a value in the Marker field of the response. You can retrieve the
* next set of response records by providing the returned marker value in the Marker parameter and
* retrying the request.
*
*
* @param marker
* An optional parameter that specifies the starting point to return a set of response records. When the
* results of a DescribeClusterParameterGroups request exceed the value specified in
* MaxRecords, Amazon Web Services returns a value in the Marker field of the
* response. You can retrieve the next set of response records by providing the returned marker value in
* the Marker parameter and retrying the request.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder marker(String marker);
/**
*
* A tag key or keys for which you want to return all matching cluster parameter groups that are associated with
* the specified key or keys. For example, suppose that you have parameter groups that are tagged with keys
* called owner and environment. If you specify both of these tag keys in the request,
* Amazon Redshift returns a response with the parameter groups that have either or both of these tag keys
* associated with them.
*
*
* @param tagKeys
* A tag key or keys for which you want to return all matching cluster parameter groups that are
* associated with the specified key or keys. For example, suppose that you have parameter groups that
* are tagged with keys called owner and environment. If you specify both of
* these tag keys in the request, Amazon Redshift returns a response with the parameter groups that have
* either or both of these tag keys associated with them.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder tagKeys(Collection tagKeys);
/**
*
* A tag key or keys for which you want to return all matching cluster parameter groups that are associated with
* the specified key or keys. For example, suppose that you have parameter groups that are tagged with keys
* called owner and environment. If you specify both of these tag keys in the request,
* Amazon Redshift returns a response with the parameter groups that have either or both of these tag keys
* associated with them.
*
*
* @param tagKeys
* A tag key or keys for which you want to return all matching cluster parameter groups that are
* associated with the specified key or keys. For example, suppose that you have parameter groups that
* are tagged with keys called owner and environment. If you specify both of
* these tag keys in the request, Amazon Redshift returns a response with the parameter groups that have
* either or both of these tag keys associated with them.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder tagKeys(String... tagKeys);
/**
*
* A tag value or values for which you want to return all matching cluster parameter groups that are associated
* with the specified tag value or values. For example, suppose that you have parameter groups that are tagged
* with values called admin and test. If you specify both of these tag values in the
* request, Amazon Redshift returns a response with the parameter groups that have either or both of these tag
* values associated with them.
*
*
* @param tagValues
* A tag value or values for which you want to return all matching cluster parameter groups that are
* associated with the specified tag value or values. For example, suppose that you have parameter groups
* that are tagged with values called admin and test. If you specify both of
* these tag values in the request, Amazon Redshift returns a response with the parameter groups that
* have either or both of these tag values associated with them.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder tagValues(Collection tagValues);
/**
*
* A tag value or values for which you want to return all matching cluster parameter groups that are associated
* with the specified tag value or values. For example, suppose that you have parameter groups that are tagged
* with values called admin and test. If you specify both of these tag values in the
* request, Amazon Redshift returns a response with the parameter groups that have either or both of these tag
* values associated with them.
*
*
* @param tagValues
* A tag value or values for which you want to return all matching cluster parameter groups that are
* associated with the specified tag value or values. For example, suppose that you have parameter groups
* that are tagged with values called admin and test. If you specify both of
* these tag values in the request, Amazon Redshift returns a response with the parameter groups that
* have either or both of these tag values associated with them.
* @return Returns a reference to this object so that method calls can be chained together.
*/
Builder tagValues(String... tagValues);
@Override
Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration);
@Override
Builder overrideConfiguration(Consumer builderConsumer);
}
static final class BuilderImpl extends RedshiftRequest.BuilderImpl implements Builder {
private String parameterGroupName;
private Integer maxRecords;
private String marker;
private List tagKeys = DefaultSdkAutoConstructList.getInstance();
private List tagValues = DefaultSdkAutoConstructList.getInstance();
private BuilderImpl() {
}
private BuilderImpl(DescribeClusterParameterGroupsRequest model) {
super(model);
parameterGroupName(model.parameterGroupName);
maxRecords(model.maxRecords);
marker(model.marker);
tagKeys(model.tagKeys);
tagValues(model.tagValues);
}
public final String getParameterGroupName() {
return parameterGroupName;
}
public final void setParameterGroupName(String parameterGroupName) {
this.parameterGroupName = parameterGroupName;
}
@Override
public final Builder parameterGroupName(String parameterGroupName) {
this.parameterGroupName = parameterGroupName;
return this;
}
public final Integer getMaxRecords() {
return maxRecords;
}
public final void setMaxRecords(Integer maxRecords) {
this.maxRecords = maxRecords;
}
@Override
public final Builder maxRecords(Integer maxRecords) {
this.maxRecords = maxRecords;
return this;
}
public final String getMarker() {
return marker;
}
public final void setMarker(String marker) {
this.marker = marker;
}
@Override
public final Builder marker(String marker) {
this.marker = marker;
return this;
}
public final Collection getTagKeys() {
if (tagKeys instanceof SdkAutoConstructList) {
return null;
}
return tagKeys;
}
public final void setTagKeys(Collection tagKeys) {
this.tagKeys = TagKeyListCopier.copy(tagKeys);
}
@Override
public final Builder tagKeys(Collection tagKeys) {
this.tagKeys = TagKeyListCopier.copy(tagKeys);
return this;
}
@Override
@SafeVarargs
public final Builder tagKeys(String... tagKeys) {
tagKeys(Arrays.asList(tagKeys));
return this;
}
public final Collection getTagValues() {
if (tagValues instanceof SdkAutoConstructList) {
return null;
}
return tagValues;
}
public final void setTagValues(Collection tagValues) {
this.tagValues = TagValueListCopier.copy(tagValues);
}
@Override
public final Builder tagValues(Collection tagValues) {
this.tagValues = TagValueListCopier.copy(tagValues);
return this;
}
@Override
@SafeVarargs
public final Builder tagValues(String... tagValues) {
tagValues(Arrays.asList(tagValues));
return this;
}
@Override
public Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) {
super.overrideConfiguration(overrideConfiguration);
return this;
}
@Override
public Builder overrideConfiguration(Consumer builderConsumer) {
super.overrideConfiguration(builderConsumer);
return this;
}
@Override
public DescribeClusterParameterGroupsRequest build() {
return new DescribeClusterParameterGroupsRequest(this);
}
@Override
public List> sdkFields() {
return SDK_FIELDS;
}
}
}