Class ShardFilter
- java.lang.Object
-
- software.amazon.awssdk.services.kinesis.model.ShardFilter
-
- All Implemented Interfaces:
Serializable,SdkPojo,ToCopyableBuilder<ShardFilter.Builder,ShardFilter>
@Generated("software.amazon.awssdk:codegen") public final class ShardFilter extends Object implements SdkPojo, Serializable, ToCopyableBuilder<ShardFilter.Builder,ShardFilter>
The request parameter used to filter out the response of the
ListShardsAPI.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceShardFilter.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static ShardFilter.Builderbuilder()booleanequals(Object obj)booleanequalsBySdkFields(Object obj)<T> Optional<T>getValueForField(String fieldName, Class<T> clazz)inthashCode()Map<String,SdkField<?>>sdkFieldNameToField()List<SdkField<?>>sdkFields()static Class<? extends ShardFilter.Builder>serializableBuilderClass()StringshardId()The exclusive startshardIDspeified in theShardFilterparameter.Instanttimestamp()The timestamps specified in theShardFilterparameter.ShardFilter.BuildertoBuilder()StringtoString()Returns a string representation of this object.ShardFilterTypetype()The shard type specified in theShardFilterparameter.StringtypeAsString()The shard type specified in theShardFilterparameter.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
type
public final ShardFilterType type()
The shard type specified in the
ShardFilterparameter. This is a required property of theShardFilterparameter.You can specify the following valid values:
-
AFTER_SHARD_ID- the response includes all the shards, starting with the shard whose ID immediately follows theShardIdthat you provided. -
AT_TRIM_HORIZON- the response includes all the shards that were open atTRIM_HORIZON. -
FROM_TRIM_HORIZON- (default), the response includes all the shards within the retention period of the data stream (trim to tip). -
AT_LATEST- the response includes only the currently open shards of the data stream. -
AT_TIMESTAMP- the response includes all shards whose start timestamp is less than or equal to the given timestamp and end timestamp is greater than or equal to the given timestamp or still open. -
FROM_TIMESTAMP- the response incldues all closed shards whose end timestamp is greater than or equal to the given timestamp and also all open shards. Corrected toTRIM_HORIZONof the data stream ifFROM_TIMESTAMPis less than theTRIM_HORIZONvalue.
If the service returns an enum value that is not available in the current SDK version,
typewill returnShardFilterType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtypeAsString().- Returns:
- The shard type specified in the
ShardFilterparameter. This is a required property of theShardFilterparameter.You can specify the following valid values:
-
AFTER_SHARD_ID- the response includes all the shards, starting with the shard whose ID immediately follows theShardIdthat you provided. -
AT_TRIM_HORIZON- the response includes all the shards that were open atTRIM_HORIZON. -
FROM_TRIM_HORIZON- (default), the response includes all the shards within the retention period of the data stream (trim to tip). -
AT_LATEST- the response includes only the currently open shards of the data stream. -
AT_TIMESTAMP- the response includes all shards whose start timestamp is less than or equal to the given timestamp and end timestamp is greater than or equal to the given timestamp or still open. -
FROM_TIMESTAMP- the response incldues all closed shards whose end timestamp is greater than or equal to the given timestamp and also all open shards. Corrected toTRIM_HORIZONof the data stream ifFROM_TIMESTAMPis less than theTRIM_HORIZONvalue.
-
- See Also:
ShardFilterType
-
-
typeAsString
public final String typeAsString()
The shard type specified in the
ShardFilterparameter. This is a required property of theShardFilterparameter.You can specify the following valid values:
-
AFTER_SHARD_ID- the response includes all the shards, starting with the shard whose ID immediately follows theShardIdthat you provided. -
AT_TRIM_HORIZON- the response includes all the shards that were open atTRIM_HORIZON. -
FROM_TRIM_HORIZON- (default), the response includes all the shards within the retention period of the data stream (trim to tip). -
AT_LATEST- the response includes only the currently open shards of the data stream. -
AT_TIMESTAMP- the response includes all shards whose start timestamp is less than or equal to the given timestamp and end timestamp is greater than or equal to the given timestamp or still open. -
FROM_TIMESTAMP- the response incldues all closed shards whose end timestamp is greater than or equal to the given timestamp and also all open shards. Corrected toTRIM_HORIZONof the data stream ifFROM_TIMESTAMPis less than theTRIM_HORIZONvalue.
If the service returns an enum value that is not available in the current SDK version,
typewill returnShardFilterType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available fromtypeAsString().- Returns:
- The shard type specified in the
ShardFilterparameter. This is a required property of theShardFilterparameter.You can specify the following valid values:
-
AFTER_SHARD_ID- the response includes all the shards, starting with the shard whose ID immediately follows theShardIdthat you provided. -
AT_TRIM_HORIZON- the response includes all the shards that were open atTRIM_HORIZON. -
FROM_TRIM_HORIZON- (default), the response includes all the shards within the retention period of the data stream (trim to tip). -
AT_LATEST- the response includes only the currently open shards of the data stream. -
AT_TIMESTAMP- the response includes all shards whose start timestamp is less than or equal to the given timestamp and end timestamp is greater than or equal to the given timestamp or still open. -
FROM_TIMESTAMP- the response incldues all closed shards whose end timestamp is greater than or equal to the given timestamp and also all open shards. Corrected toTRIM_HORIZONof the data stream ifFROM_TIMESTAMPis less than theTRIM_HORIZONvalue.
-
- See Also:
ShardFilterType
-
-
shardId
public final String shardId()
The exclusive start
shardIDspeified in theShardFilterparameter. This property can only be used if theAFTER_SHARD_IDshard type is specified.- Returns:
- The exclusive start
shardIDspeified in theShardFilterparameter. This property can only be used if theAFTER_SHARD_IDshard type is specified.
-
timestamp
public final Instant timestamp()
The timestamps specified in the
ShardFilterparameter. A timestamp is a Unix epoch date with precision in milliseconds. For example, 2016-04-04T19:58:46.480-00:00 or 1459799926.480. This property can only be used ifFROM_TIMESTAMPorAT_TIMESTAMPshard types are specified.- Returns:
- The timestamps specified in the
ShardFilterparameter. A timestamp is a Unix epoch date with precision in milliseconds. For example, 2016-04-04T19:58:46.480-00:00 or 1459799926.480. This property can only be used ifFROM_TIMESTAMPorAT_TIMESTAMPshard types are specified.
-
toBuilder
public ShardFilter.Builder toBuilder()
- Specified by:
toBuilderin interfaceToCopyableBuilder<ShardFilter.Builder,ShardFilter>
-
builder
public static ShardFilter.Builder builder()
-
serializableBuilderClass
public static Class<? extends ShardFilter.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFieldsin interfaceSdkPojo
-
toString
public final String toString()
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.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToFieldin interfaceSdkPojo
-
-