com.amazonaws.services.kinesis.model.ListShardsRequest Maven / Gradle / Ivy
Show all versions of aws-java-sdk-kinesis Show documentation
/*
* Copyright 2019-2024 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.kinesis.model;
import java.io.Serializable;
import javax.annotation.Generated;
import com.amazonaws.AmazonWebServiceRequest;
/**
*
* @see AWS API
* Documentation
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public class ListShardsRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable {
/**
*
* The name of the data stream whose shards you want to list.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*/
private String streamName;
/**
*
* When the number of shards in the data stream is greater than the default value for the MaxResults
* parameter, or if you explicitly specify a value for MaxResults
that is less than the number of
* shards in the data stream, the response includes a pagination token named NextToken
. You can specify
* this NextToken
value in a subsequent call to ListShards
to list the next set of shards.
*
*
* Don't specify StreamName
or StreamCreationTimestamp
if you specify
* NextToken
because the latter unambiguously identifies the stream.
*
*
* You can optionally specify a value for the MaxResults
parameter when you specify
* NextToken
. If you specify a MaxResults
value that is less than the number of shards
* that the operation returns if you don't specify MaxResults
, the response will contain a new
* NextToken
value. You can use the new NextToken
value in a subsequent call to the
* ListShards
operation.
*
*
*
* Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a call to
* ListShards
, you have 300 seconds to use that value. If you specify an expired token in a call to
* ListShards
, you get ExpiredNextTokenException
.
*
*
*/
private String nextToken;
/**
*
* Specify this parameter to indicate that you want to list the shards starting with the shard whose ID immediately
* follows ExclusiveStartShardId
.
*
*
* If you don't specify this parameter, the default behavior is for ListShards
to list the shards
* starting with the first one in the stream.
*
*
* You cannot specify this parameter if you specify NextToken
.
*
*/
private String exclusiveStartShardId;
/**
*
* The maximum number of shards to return in a single call to ListShards
. The maximum number of shards
* to return in a single call. The default value is 1000. If you specify a value greater than 1000, at most 1000
* results are returned.
*
*
* When the number of shards to be listed is greater than the value of MaxResults
, the response
* contains a NextToken
value that you can use in a subsequent call to ListShards
to list
* the next set of shards.
*
*/
private Integer maxResults;
/**
*
* Specify this input parameter to distinguish data streams that have the same name. For example, if you create a
* data stream and then delete it, and you later create another data stream with the same name, you can use this
* input parameter to specify which of the two streams you want to list the shards for.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*/
private java.util.Date streamCreationTimestamp;
/**
*
* Enables you to filter out the response of the ListShards
API. You can only specify one filter at a
* time.
*
*
* If you use the ShardFilter
parameter when invoking the ListShards API, the Type
is the
* required property and must be specified. If you specify the AT_TRIM_HORIZON
,
* FROM_TRIM_HORIZON
, or AT_LATEST
types, you do not need to specify either the
* ShardId
or the Timestamp
optional properties.
*
*
* If you specify the AFTER_SHARD_ID
type, you must also provide the value for the optional
* ShardId
property. The ShardId
property is identical in fuctionality to the
* ExclusiveStartShardId
parameter of the ListShards
API. When ShardId
* property is specified, the response includes the shards starting with the shard whose ID immediately follows the
* ShardId
that you provided.
*
*
* If you specify the AT_TIMESTAMP
or FROM_TIMESTAMP_ID
type, you must also provide the
* value for the optional Timestamp
property. If you specify the AT_TIMESTAMP type, then all shards
* that were open at the provided timestamp are returned. If you specify the FROM_TIMESTAMP type, then all shards
* starting from the provided timestamp to TIP are returned.
*
*/
private ShardFilter shardFilter;
/**
*
* The ARN of the stream.
*
*/
private String streamARN;
/**
*
* The name of the data stream whose shards you want to list.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*
* @param streamName
* The name of the data stream whose shards you want to list.
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*/
public void setStreamName(String streamName) {
this.streamName = streamName;
}
/**
*
* The name of the data stream whose shards you want to list.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*
* @return The name of the data stream whose shards you want to list.
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*/
public String getStreamName() {
return this.streamName;
}
/**
*
* The name of the data stream whose shards you want to list.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*
* @param streamName
* The name of the data stream whose shards you want to list.
*
* You cannot specify this parameter if you specify the NextToken
parameter.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ListShardsRequest withStreamName(String streamName) {
setStreamName(streamName);
return this;
}
/**
*
* When the number of shards in the data stream is greater than the default value for the MaxResults
* parameter, or if you explicitly specify a value for MaxResults
that is less than the number of
* shards in the data stream, the response includes a pagination token named NextToken
. You can specify
* this NextToken
value in a subsequent call to ListShards
to list the next set of shards.
*
*
* Don't specify StreamName
or StreamCreationTimestamp
if you specify
* NextToken
because the latter unambiguously identifies the stream.
*
*
* You can optionally specify a value for the MaxResults
parameter when you specify
* NextToken
. If you specify a MaxResults
value that is less than the number of shards
* that the operation returns if you don't specify MaxResults
, the response will contain a new
* NextToken
value. You can use the new NextToken
value in a subsequent call to the
* ListShards
operation.
*
*
*
* Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a call to
* ListShards
, you have 300 seconds to use that value. If you specify an expired token in a call to
* ListShards
, you get ExpiredNextTokenException
.
*
*
*
* @param nextToken
* When the number of shards in the data stream is greater than the default value for the
* MaxResults
parameter, or if you explicitly specify a value for MaxResults
that
* is less than the number of shards in the data stream, the response includes a pagination token named
* NextToken
. You can specify this NextToken
value in a subsequent call to
* ListShards
to list the next set of shards.
*
* Don't specify StreamName
or StreamCreationTimestamp
if you specify
* NextToken
because the latter unambiguously identifies the stream.
*
*
* You can optionally specify a value for the MaxResults
parameter when you specify
* NextToken
. If you specify a MaxResults
value that is less than the number of
* shards that the operation returns if you don't specify MaxResults
, the response will contain
* a new NextToken
value. You can use the new NextToken
value in a subsequent call
* to the ListShards
operation.
*
*
*
* Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a
* call to ListShards
, you have 300 seconds to use that value. If you specify an expired token
* in a call to ListShards
, you get ExpiredNextTokenException
.
*
*/
public void setNextToken(String nextToken) {
this.nextToken = nextToken;
}
/**
*
* When the number of shards in the data stream is greater than the default value for the MaxResults
* parameter, or if you explicitly specify a value for MaxResults
that is less than the number of
* shards in the data stream, the response includes a pagination token named NextToken
. You can specify
* this NextToken
value in a subsequent call to ListShards
to list the next set of shards.
*
*
* Don't specify StreamName
or StreamCreationTimestamp
if you specify
* NextToken
because the latter unambiguously identifies the stream.
*
*
* You can optionally specify a value for the MaxResults
parameter when you specify
* NextToken
. If you specify a MaxResults
value that is less than the number of shards
* that the operation returns if you don't specify MaxResults
, the response will contain a new
* NextToken
value. You can use the new NextToken
value in a subsequent call to the
* ListShards
operation.
*
*
*
* Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a call to
* ListShards
, you have 300 seconds to use that value. If you specify an expired token in a call to
* ListShards
, you get ExpiredNextTokenException
.
*
*
*
* @return When the number of shards in the data stream is greater than the default value for the
* MaxResults
parameter, or if you explicitly specify a value for MaxResults
that
* is less than the number of shards in the data stream, the response includes a pagination token named
* NextToken
. You can specify this NextToken
value in a subsequent call to
* ListShards
to list the next set of shards.
*
* Don't specify StreamName
or StreamCreationTimestamp
if you specify
* NextToken
because the latter unambiguously identifies the stream.
*
*
* You can optionally specify a value for the MaxResults
parameter when you specify
* NextToken
. If you specify a MaxResults
value that is less than the number of
* shards that the operation returns if you don't specify MaxResults
, the response will contain
* a new NextToken
value. You can use the new NextToken
value in a subsequent call
* to the ListShards
operation.
*
*
*
* Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a
* call to ListShards
, you have 300 seconds to use that value. If you specify an expired token
* in a call to ListShards
, you get ExpiredNextTokenException
.
*
*/
public String getNextToken() {
return this.nextToken;
}
/**
*
* When the number of shards in the data stream is greater than the default value for the MaxResults
* parameter, or if you explicitly specify a value for MaxResults
that is less than the number of
* shards in the data stream, the response includes a pagination token named NextToken
. You can specify
* this NextToken
value in a subsequent call to ListShards
to list the next set of shards.
*
*
* Don't specify StreamName
or StreamCreationTimestamp
if you specify
* NextToken
because the latter unambiguously identifies the stream.
*
*
* You can optionally specify a value for the MaxResults
parameter when you specify
* NextToken
. If you specify a MaxResults
value that is less than the number of shards
* that the operation returns if you don't specify MaxResults
, the response will contain a new
* NextToken
value. You can use the new NextToken
value in a subsequent call to the
* ListShards
operation.
*
*
*
* Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a call to
* ListShards
, you have 300 seconds to use that value. If you specify an expired token in a call to
* ListShards
, you get ExpiredNextTokenException
.
*
*
*
* @param nextToken
* When the number of shards in the data stream is greater than the default value for the
* MaxResults
parameter, or if you explicitly specify a value for MaxResults
that
* is less than the number of shards in the data stream, the response includes a pagination token named
* NextToken
. You can specify this NextToken
value in a subsequent call to
* ListShards
to list the next set of shards.
*
* Don't specify StreamName
or StreamCreationTimestamp
if you specify
* NextToken
because the latter unambiguously identifies the stream.
*
*
* You can optionally specify a value for the MaxResults
parameter when you specify
* NextToken
. If you specify a MaxResults
value that is less than the number of
* shards that the operation returns if you don't specify MaxResults
, the response will contain
* a new NextToken
value. You can use the new NextToken
value in a subsequent call
* to the ListShards
operation.
*
*
*
* Tokens expire after 300 seconds. When you obtain a value for NextToken
in the response to a
* call to ListShards
, you have 300 seconds to use that value. If you specify an expired token
* in a call to ListShards
, you get ExpiredNextTokenException
.
*
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ListShardsRequest withNextToken(String nextToken) {
setNextToken(nextToken);
return this;
}
/**
*
* Specify this parameter to indicate that you want to list the shards starting with the shard whose ID immediately
* follows ExclusiveStartShardId
.
*
*
* If you don't specify this parameter, the default behavior is for ListShards
to list the shards
* starting with the first one in the stream.
*
*
* You cannot specify this parameter if you specify NextToken
.
*
*
* @param exclusiveStartShardId
* Specify this parameter to indicate that you want to list the shards starting with the shard whose ID
* immediately follows ExclusiveStartShardId
.
*
* If you don't specify this parameter, the default behavior is for ListShards
to list the
* shards starting with the first one in the stream.
*
*
* You cannot specify this parameter if you specify NextToken
.
*/
public void setExclusiveStartShardId(String exclusiveStartShardId) {
this.exclusiveStartShardId = exclusiveStartShardId;
}
/**
*
* Specify this parameter to indicate that you want to list the shards starting with the shard whose ID immediately
* follows ExclusiveStartShardId
.
*
*
* If you don't specify this parameter, the default behavior is for ListShards
to list the shards
* starting with the first one in the stream.
*
*
* You cannot specify this parameter if you specify NextToken
.
*
*
* @return Specify this parameter to indicate that you want to list the shards starting with the shard whose ID
* immediately follows ExclusiveStartShardId
.
*
* If you don't specify this parameter, the default behavior is for ListShards
to list the
* shards starting with the first one in the stream.
*
*
* You cannot specify this parameter if you specify NextToken
.
*/
public String getExclusiveStartShardId() {
return this.exclusiveStartShardId;
}
/**
*
* Specify this parameter to indicate that you want to list the shards starting with the shard whose ID immediately
* follows ExclusiveStartShardId
.
*
*
* If you don't specify this parameter, the default behavior is for ListShards
to list the shards
* starting with the first one in the stream.
*
*
* You cannot specify this parameter if you specify NextToken
.
*
*
* @param exclusiveStartShardId
* Specify this parameter to indicate that you want to list the shards starting with the shard whose ID
* immediately follows ExclusiveStartShardId
.
*
* If you don't specify this parameter, the default behavior is for ListShards
to list the
* shards starting with the first one in the stream.
*
*
* You cannot specify this parameter if you specify NextToken
.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ListShardsRequest withExclusiveStartShardId(String exclusiveStartShardId) {
setExclusiveStartShardId(exclusiveStartShardId);
return this;
}
/**
*
* The maximum number of shards to return in a single call to ListShards
. The maximum number of shards
* to return in a single call. The default value is 1000. If you specify a value greater than 1000, at most 1000
* results are returned.
*
*
* When the number of shards to be listed is greater than the value of MaxResults
, the response
* contains a NextToken
value that you can use in a subsequent call to ListShards
to list
* the next set of shards.
*
*
* @param maxResults
* The maximum number of shards to return in a single call to ListShards
. The maximum number of
* shards to return in a single call. The default value is 1000. If you specify a value greater than 1000, at
* most 1000 results are returned.
*
* When the number of shards to be listed is greater than the value of MaxResults
, the response
* contains a NextToken
value that you can use in a subsequent call to ListShards
* to list the next set of shards.
*/
public void setMaxResults(Integer maxResults) {
this.maxResults = maxResults;
}
/**
*
* The maximum number of shards to return in a single call to ListShards
. The maximum number of shards
* to return in a single call. The default value is 1000. If you specify a value greater than 1000, at most 1000
* results are returned.
*
*
* When the number of shards to be listed is greater than the value of MaxResults
, the response
* contains a NextToken
value that you can use in a subsequent call to ListShards
to list
* the next set of shards.
*
*
* @return The maximum number of shards to return in a single call to ListShards
. The maximum number of
* shards to return in a single call. The default value is 1000. If you specify a value greater than 1000,
* at most 1000 results are returned.
*
* When the number of shards to be listed is greater than the value of MaxResults
, the response
* contains a NextToken
value that you can use in a subsequent call to ListShards
* to list the next set of shards.
*/
public Integer getMaxResults() {
return this.maxResults;
}
/**
*
* The maximum number of shards to return in a single call to ListShards
. The maximum number of shards
* to return in a single call. The default value is 1000. If you specify a value greater than 1000, at most 1000
* results are returned.
*
*
* When the number of shards to be listed is greater than the value of MaxResults
, the response
* contains a NextToken
value that you can use in a subsequent call to ListShards
to list
* the next set of shards.
*
*
* @param maxResults
* The maximum number of shards to return in a single call to ListShards
. The maximum number of
* shards to return in a single call. The default value is 1000. If you specify a value greater than 1000, at
* most 1000 results are returned.
*
* When the number of shards to be listed is greater than the value of MaxResults
, the response
* contains a NextToken
value that you can use in a subsequent call to ListShards
* to list the next set of shards.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ListShardsRequest withMaxResults(Integer maxResults) {
setMaxResults(maxResults);
return this;
}
/**
*
* Specify this input parameter to distinguish data streams that have the same name. For example, if you create a
* data stream and then delete it, and you later create another data stream with the same name, you can use this
* input parameter to specify which of the two streams you want to list the shards for.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*
* @param streamCreationTimestamp
* Specify this input parameter to distinguish data streams that have the same name. For example, if you
* create a data stream and then delete it, and you later create another data stream with the same name, you
* can use this input parameter to specify which of the two streams you want to list the shards for.
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*/
public void setStreamCreationTimestamp(java.util.Date streamCreationTimestamp) {
this.streamCreationTimestamp = streamCreationTimestamp;
}
/**
*
* Specify this input parameter to distinguish data streams that have the same name. For example, if you create a
* data stream and then delete it, and you later create another data stream with the same name, you can use this
* input parameter to specify which of the two streams you want to list the shards for.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*
* @return Specify this input parameter to distinguish data streams that have the same name. For example, if you
* create a data stream and then delete it, and you later create another data stream with the same name, you
* can use this input parameter to specify which of the two streams you want to list the shards for.
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*/
public java.util.Date getStreamCreationTimestamp() {
return this.streamCreationTimestamp;
}
/**
*
* Specify this input parameter to distinguish data streams that have the same name. For example, if you create a
* data stream and then delete it, and you later create another data stream with the same name, you can use this
* input parameter to specify which of the two streams you want to list the shards for.
*
*
* You cannot specify this parameter if you specify the NextToken
parameter.
*
*
* @param streamCreationTimestamp
* Specify this input parameter to distinguish data streams that have the same name. For example, if you
* create a data stream and then delete it, and you later create another data stream with the same name, you
* can use this input parameter to specify which of the two streams you want to list the shards for.
*
* You cannot specify this parameter if you specify the NextToken
parameter.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ListShardsRequest withStreamCreationTimestamp(java.util.Date streamCreationTimestamp) {
setStreamCreationTimestamp(streamCreationTimestamp);
return this;
}
/**
*
* Enables you to filter out the response of the ListShards
API. You can only specify one filter at a
* time.
*
*
* If you use the ShardFilter
parameter when invoking the ListShards API, the Type
is the
* required property and must be specified. If you specify the AT_TRIM_HORIZON
,
* FROM_TRIM_HORIZON
, or AT_LATEST
types, you do not need to specify either the
* ShardId
or the Timestamp
optional properties.
*
*
* If you specify the AFTER_SHARD_ID
type, you must also provide the value for the optional
* ShardId
property. The ShardId
property is identical in fuctionality to the
* ExclusiveStartShardId
parameter of the ListShards
API. When ShardId
* property is specified, the response includes the shards starting with the shard whose ID immediately follows the
* ShardId
that you provided.
*
*
* If you specify the AT_TIMESTAMP
or FROM_TIMESTAMP_ID
type, you must also provide the
* value for the optional Timestamp
property. If you specify the AT_TIMESTAMP type, then all shards
* that were open at the provided timestamp are returned. If you specify the FROM_TIMESTAMP type, then all shards
* starting from the provided timestamp to TIP are returned.
*
*
* @param shardFilter
* Enables you to filter out the response of the ListShards
API. You can only specify one filter
* at a time.
*
* If you use the ShardFilter
parameter when invoking the ListShards API, the Type
* is the required property and must be specified. If you specify the AT_TRIM_HORIZON
,
* FROM_TRIM_HORIZON
, or AT_LATEST
types, you do not need to specify either the
* ShardId
or the Timestamp
optional properties.
*
*
* If you specify the AFTER_SHARD_ID
type, you must also provide the value for the optional
* ShardId
property. The ShardId
property is identical in fuctionality to the
* ExclusiveStartShardId
parameter of the ListShards
API. When ShardId
* property is specified, the response includes the shards starting with the shard whose ID immediately
* follows the ShardId
that you provided.
*
*
* If you specify the AT_TIMESTAMP
or FROM_TIMESTAMP_ID
type, you must also provide
* the value for the optional Timestamp
property. If you specify the AT_TIMESTAMP type, then all
* shards that were open at the provided timestamp are returned. If you specify the FROM_TIMESTAMP type, then
* all shards starting from the provided timestamp to TIP are returned.
*/
public void setShardFilter(ShardFilter shardFilter) {
this.shardFilter = shardFilter;
}
/**
*
* Enables you to filter out the response of the ListShards
API. You can only specify one filter at a
* time.
*
*
* If you use the ShardFilter
parameter when invoking the ListShards API, the Type
is the
* required property and must be specified. If you specify the AT_TRIM_HORIZON
,
* FROM_TRIM_HORIZON
, or AT_LATEST
types, you do not need to specify either the
* ShardId
or the Timestamp
optional properties.
*
*
* If you specify the AFTER_SHARD_ID
type, you must also provide the value for the optional
* ShardId
property. The ShardId
property is identical in fuctionality to the
* ExclusiveStartShardId
parameter of the ListShards
API. When ShardId
* property is specified, the response includes the shards starting with the shard whose ID immediately follows the
* ShardId
that you provided.
*
*
* If you specify the AT_TIMESTAMP
or FROM_TIMESTAMP_ID
type, you must also provide the
* value for the optional Timestamp
property. If you specify the AT_TIMESTAMP type, then all shards
* that were open at the provided timestamp are returned. If you specify the FROM_TIMESTAMP type, then all shards
* starting from the provided timestamp to TIP are returned.
*
*
* @return Enables you to filter out the response of the ListShards
API. You can only specify one
* filter at a time.
*
* If you use the ShardFilter
parameter when invoking the ListShards API, the Type
* is the required property and must be specified. If you specify the AT_TRIM_HORIZON
,
* FROM_TRIM_HORIZON
, or AT_LATEST
types, you do not need to specify either the
* ShardId
or the Timestamp
optional properties.
*
*
* If you specify the AFTER_SHARD_ID
type, you must also provide the value for the optional
* ShardId
property. The ShardId
property is identical in fuctionality to the
* ExclusiveStartShardId
parameter of the ListShards
API. When
* ShardId
property is specified, the response includes the shards starting with the shard
* whose ID immediately follows the ShardId
that you provided.
*
*
* If you specify the AT_TIMESTAMP
or FROM_TIMESTAMP_ID
type, you must also
* provide the value for the optional Timestamp
property. If you specify the AT_TIMESTAMP type,
* then all shards that were open at the provided timestamp are returned. If you specify the FROM_TIMESTAMP
* type, then all shards starting from the provided timestamp to TIP are returned.
*/
public ShardFilter getShardFilter() {
return this.shardFilter;
}
/**
*
* Enables you to filter out the response of the ListShards
API. You can only specify one filter at a
* time.
*
*
* If you use the ShardFilter
parameter when invoking the ListShards API, the Type
is the
* required property and must be specified. If you specify the AT_TRIM_HORIZON
,
* FROM_TRIM_HORIZON
, or AT_LATEST
types, you do not need to specify either the
* ShardId
or the Timestamp
optional properties.
*
*
* If you specify the AFTER_SHARD_ID
type, you must also provide the value for the optional
* ShardId
property. The ShardId
property is identical in fuctionality to the
* ExclusiveStartShardId
parameter of the ListShards
API. When ShardId
* property is specified, the response includes the shards starting with the shard whose ID immediately follows the
* ShardId
that you provided.
*
*
* If you specify the AT_TIMESTAMP
or FROM_TIMESTAMP_ID
type, you must also provide the
* value for the optional Timestamp
property. If you specify the AT_TIMESTAMP type, then all shards
* that were open at the provided timestamp are returned. If you specify the FROM_TIMESTAMP type, then all shards
* starting from the provided timestamp to TIP are returned.
*
*
* @param shardFilter
* Enables you to filter out the response of the ListShards
API. You can only specify one filter
* at a time.
*
* If you use the ShardFilter
parameter when invoking the ListShards API, the Type
* is the required property and must be specified. If you specify the AT_TRIM_HORIZON
,
* FROM_TRIM_HORIZON
, or AT_LATEST
types, you do not need to specify either the
* ShardId
or the Timestamp
optional properties.
*
*
* If you specify the AFTER_SHARD_ID
type, you must also provide the value for the optional
* ShardId
property. The ShardId
property is identical in fuctionality to the
* ExclusiveStartShardId
parameter of the ListShards
API. When ShardId
* property is specified, the response includes the shards starting with the shard whose ID immediately
* follows the ShardId
that you provided.
*
*
* If you specify the AT_TIMESTAMP
or FROM_TIMESTAMP_ID
type, you must also provide
* the value for the optional Timestamp
property. If you specify the AT_TIMESTAMP type, then all
* shards that were open at the provided timestamp are returned. If you specify the FROM_TIMESTAMP type, then
* all shards starting from the provided timestamp to TIP are returned.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ListShardsRequest withShardFilter(ShardFilter shardFilter) {
setShardFilter(shardFilter);
return this;
}
/**
*
* The ARN of the stream.
*
*
* @param streamARN
* The ARN of the stream.
*/
public void setStreamARN(String streamARN) {
this.streamARN = streamARN;
}
/**
*
* The ARN of the stream.
*
*
* @return The ARN of the stream.
*/
public String getStreamARN() {
return this.streamARN;
}
/**
*
* The ARN of the stream.
*
*
* @param streamARN
* The ARN of the stream.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ListShardsRequest withStreamARN(String streamARN) {
setStreamARN(streamARN);
return this;
}
/**
* 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.
*
* @return A string representation of this object.
*
* @see java.lang.Object#toString()
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("{");
if (getStreamName() != null)
sb.append("StreamName: ").append(getStreamName()).append(",");
if (getNextToken() != null)
sb.append("NextToken: ").append(getNextToken()).append(",");
if (getExclusiveStartShardId() != null)
sb.append("ExclusiveStartShardId: ").append(getExclusiveStartShardId()).append(",");
if (getMaxResults() != null)
sb.append("MaxResults: ").append(getMaxResults()).append(",");
if (getStreamCreationTimestamp() != null)
sb.append("StreamCreationTimestamp: ").append(getStreamCreationTimestamp()).append(",");
if (getShardFilter() != null)
sb.append("ShardFilter: ").append(getShardFilter()).append(",");
if (getStreamARN() != null)
sb.append("StreamARN: ").append(getStreamARN());
sb.append("}");
return sb.toString();
}
@Override
public boolean equals(Object obj) {
if (this == obj)
return true;
if (obj == null)
return false;
if (obj instanceof ListShardsRequest == false)
return false;
ListShardsRequest other = (ListShardsRequest) obj;
if (other.getStreamName() == null ^ this.getStreamName() == null)
return false;
if (other.getStreamName() != null && other.getStreamName().equals(this.getStreamName()) == false)
return false;
if (other.getNextToken() == null ^ this.getNextToken() == null)
return false;
if (other.getNextToken() != null && other.getNextToken().equals(this.getNextToken()) == false)
return false;
if (other.getExclusiveStartShardId() == null ^ this.getExclusiveStartShardId() == null)
return false;
if (other.getExclusiveStartShardId() != null && other.getExclusiveStartShardId().equals(this.getExclusiveStartShardId()) == false)
return false;
if (other.getMaxResults() == null ^ this.getMaxResults() == null)
return false;
if (other.getMaxResults() != null && other.getMaxResults().equals(this.getMaxResults()) == false)
return false;
if (other.getStreamCreationTimestamp() == null ^ this.getStreamCreationTimestamp() == null)
return false;
if (other.getStreamCreationTimestamp() != null && other.getStreamCreationTimestamp().equals(this.getStreamCreationTimestamp()) == false)
return false;
if (other.getShardFilter() == null ^ this.getShardFilter() == null)
return false;
if (other.getShardFilter() != null && other.getShardFilter().equals(this.getShardFilter()) == false)
return false;
if (other.getStreamARN() == null ^ this.getStreamARN() == null)
return false;
if (other.getStreamARN() != null && other.getStreamARN().equals(this.getStreamARN()) == false)
return false;
return true;
}
@Override
public int hashCode() {
final int prime = 31;
int hashCode = 1;
hashCode = prime * hashCode + ((getStreamName() == null) ? 0 : getStreamName().hashCode());
hashCode = prime * hashCode + ((getNextToken() == null) ? 0 : getNextToken().hashCode());
hashCode = prime * hashCode + ((getExclusiveStartShardId() == null) ? 0 : getExclusiveStartShardId().hashCode());
hashCode = prime * hashCode + ((getMaxResults() == null) ? 0 : getMaxResults().hashCode());
hashCode = prime * hashCode + ((getStreamCreationTimestamp() == null) ? 0 : getStreamCreationTimestamp().hashCode());
hashCode = prime * hashCode + ((getShardFilter() == null) ? 0 : getShardFilter().hashCode());
hashCode = prime * hashCode + ((getStreamARN() == null) ? 0 : getStreamARN().hashCode());
return hashCode;
}
@Override
public ListShardsRequest clone() {
return (ListShardsRequest) super.clone();
}
}