/* * Copyright 2010-2023 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.iot.model; import java.io.Serializable; import com.amazonaws.AmazonWebServiceRequest; /** *

* Groups the aggregated values that match the query into percentile groupings. * The default percentile groupings are: 1,5,25,50,75,95,99, although you can * specify your own when you call GetPercentiles. This function * returns a value for each percentile group specified (or the default * percentile groupings). The percentile group "1" contains the aggregated field * value that occurs in approximately one percent of the values that match the * query. The percentile group "5" contains the aggregated field value that * occurs in approximately five percent of the values that match the query, and * so on. The result is an approximation, the more values that match the query, * the more accurate the percentile values. *

*

* Requires permission to access the GetPercentiles action. *

*/ public class GetPercentilesRequest extends AmazonWebServiceRequest implements Serializable { /** *

* The name of the index to search. *

*

* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9:_-]+
*/ private String indexName; /** *

* The search query string. *

*

* Constraints:
* Length: 1 -
*/ private String queryString; /** *

* The field to aggregate. *

*

* Constraints:
* Length: 1 -
*/ private String aggregationField; /** *

* The query version. *

*/ private String queryVersion; /** *

* The percentile groups returned. *

*/ private java.util.List percents; /** *

* The name of the index to search. *

*

* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9:_-]+
* * @return

* The name of the index to search. *

*/ public String getIndexName() { return indexName; } /** *

* The name of the index to search. *

*

* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9:_-]+
* * @param indexName

* The name of the index to search. *

*/ public void setIndexName(String indexName) { this.indexName = indexName; } /** *

* The name of the index to search. *

*

* Returns a reference to this object so that method calls can be chained * together. *

* Constraints:
* Length: 1 - 128
* Pattern: [a-zA-Z0-9:_-]+
* * @param indexName

* The name of the index to search. *

* @return A reference to this updated object so that method calls can be * chained together. */ public GetPercentilesRequest withIndexName(String indexName) { this.indexName = indexName; return this; } /** *

* The search query string. *

*

* Constraints:
* Length: 1 -
* * @return

* The search query string. *

*/ public String getQueryString() { return queryString; } /** *

* The search query string. *

*

* Constraints:
* Length: 1 -
* * @param queryString

* The search query string. *

*/ public void setQueryString(String queryString) { this.queryString = queryString; } /** *

* The search query string. *

*

* Returns a reference to this object so that method calls can be chained * together. *

* Constraints:
* Length: 1 -
* * @param queryString

* The search query string. *

* @return A reference to this updated object so that method calls can be * chained together. */ public GetPercentilesRequest withQueryString(String queryString) { this.queryString = queryString; return this; } /** *

* The field to aggregate. *

*

* Constraints:
* Length: 1 -
* * @return

* The field to aggregate. *

*/ public String getAggregationField() { return aggregationField; } /** *

* The field to aggregate. *

*

* Constraints:
* Length: 1 -
* * @param aggregationField

* The field to aggregate. *

*/ public void setAggregationField(String aggregationField) { this.aggregationField = aggregationField; } /** *

* The field to aggregate. *

*

* Returns a reference to this object so that method calls can be chained * together. *

* Constraints:
* Length: 1 -
* * @param aggregationField

* The field to aggregate. *

* @return A reference to this updated object so that method calls can be * chained together. */ public GetPercentilesRequest withAggregationField(String aggregationField) { this.aggregationField = aggregationField; return this; } /** *

* The query version. *

* * @return

* The query version. *

*/ public String getQueryVersion() { return queryVersion; } /** *

* The query version. *

* * @param queryVersion

* The query version. *

*/ public void setQueryVersion(String queryVersion) { this.queryVersion = queryVersion; } /** *

* The query version. *

*

* Returns a reference to this object so that method calls can be chained * together. * * @param queryVersion

* The query version. *

* @return A reference to this updated object so that method calls can be * chained together. */ public GetPercentilesRequest withQueryVersion(String queryVersion) { this.queryVersion = queryVersion; return this; } /** *

* The percentile groups returned. *

* * @return

* The percentile groups returned. *

*/ public java.util.List getPercents() { return percents; } /** *

* The percentile groups returned. *

* * @param percents

* The percentile groups returned. *

*/ public void setPercents(java.util.Collection percents) { if (percents == null) { this.percents = null; return; } this.percents = new java.util.ArrayList(percents); } /** *

* The percentile groups returned. *

*

* Returns a reference to this object so that method calls can be chained * together. * * @param percents

* The percentile groups returned. *

* @return A reference to this updated object so that method calls can be * chained together. */ public GetPercentilesRequest withPercents(Double... percents) { if (getPercents() == null) { this.percents = new java.util.ArrayList(percents.length); } for (Double value : percents) { this.percents.add(value); } return this; } /** *

* The percentile groups returned. *

*

* Returns a reference to this object so that method calls can be chained * together. * * @param percents

* The percentile groups returned. *

* @return A reference to this updated object so that method calls can be * chained together. */ public GetPercentilesRequest withPercents(java.util.Collection percents) { setPercents(percents); 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 (getIndexName() != null) sb.append("indexName: " + getIndexName() + ","); if (getQueryString() != null) sb.append("queryString: " + getQueryString() + ","); if (getAggregationField() != null) sb.append("aggregationField: " + getAggregationField() + ","); if (getQueryVersion() != null) sb.append("queryVersion: " + getQueryVersion() + ","); if (getPercents() != null) sb.append("percents: " + getPercents()); sb.append("}"); return sb.toString(); } @Override public int hashCode() { final int prime = 31; int hashCode = 1; hashCode = prime * hashCode + ((getIndexName() == null) ? 0 : getIndexName().hashCode()); hashCode = prime * hashCode + ((getQueryString() == null) ? 0 : getQueryString().hashCode()); hashCode = prime * hashCode + ((getAggregationField() == null) ? 0 : getAggregationField().hashCode()); hashCode = prime * hashCode + ((getQueryVersion() == null) ? 0 : getQueryVersion().hashCode()); hashCode = prime * hashCode + ((getPercents() == null) ? 0 : getPercents().hashCode()); return hashCode; } @Override public boolean equals(Object obj) { if (this == obj) return true; if (obj == null) return false; if (obj instanceof GetPercentilesRequest == false) return false; GetPercentilesRequest other = (GetPercentilesRequest) obj; if (other.getIndexName() == null ^ this.getIndexName() == null) return false; if (other.getIndexName() != null && other.getIndexName().equals(this.getIndexName()) == false) return false; if (other.getQueryString() == null ^ this.getQueryString() == null) return false; if (other.getQueryString() != null && other.getQueryString().equals(this.getQueryString()) == false) return false; if (other.getAggregationField() == null ^ this.getAggregationField() == null) return false; if (other.getAggregationField() != null && other.getAggregationField().equals(this.getAggregationField()) == false) return false; if (other.getQueryVersion() == null ^ this.getQueryVersion() == null) return false; if (other.getQueryVersion() != null && other.getQueryVersion().equals(this.getQueryVersion()) == false) return false; if (other.getPercents() == null ^ this.getPercents() == null) return false; if (other.getPercents() != null && other.getPercents().equals(this.getPercents()) == false) return false; return true; } }