Class GetShardIteratorRequest

java.lang.Object
software.amazon.awssdk.core.SdkRequest
software.amazon.awssdk.awscore.AwsRequest
software.amazon.awssdk.services.keyspacesstreams.model.KeyspacesStreamsRequest
software.amazon.awssdk.services.keyspacesstreams.model.GetShardIteratorRequest
All Implemented Interfaces:
SdkPojo, ToCopyableBuilder<GetShardIteratorRequest.Builder,GetShardIteratorRequest>
@Generated("software.amazon.awssdk:codegen") public final class GetShardIteratorRequest extends KeyspacesStreamsRequest implements ToCopyableBuilder<GetShardIteratorRequest.Builder,GetShardIteratorRequest>

  • Method Details

    • streamArn

      public final String streamArn()

      The Amazon Resource Name (ARN) of the stream for which to get the shard iterator. The ARN uniquely identifies the stream within Amazon Keyspaces.

      Returns:
      The Amazon Resource Name (ARN) of the stream for which to get the shard iterator. The ARN uniquely identifies the stream within Amazon Keyspaces.

    • shardId

      public final String shardId()

      The identifier of the shard within the stream. The shard ID uniquely identifies a subset of the stream's data records that you want to access.

      Returns:
      The identifier of the shard within the stream. The shard ID uniquely identifies a subset of the stream's data records that you want to access.

    • shardIteratorType

      public final ShardIteratorType shardIteratorType()

      Determines how the shard iterator is positioned. Must be one of the following:

      • TRIM_HORIZON - Start reading at the last untrimmed record in the shard, which is the oldest data record in the shard.

      • AT_SEQUENCE_NUMBER - Start reading exactly from the specified sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the specified sequence number.

      • LATEST - Start reading just after the most recent record in the shard, so that you always read the most recent data.

      If the service returns an enum value that is not available in the current SDK version, shardIteratorType will return ShardIteratorType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from shardIteratorTypeAsString().

      Returns:
      Determines how the shard iterator is positioned. Must be one of the following:

      • TRIM_HORIZON - Start reading at the last untrimmed record in the shard, which is the oldest data record in the shard.

      • AT_SEQUENCE_NUMBER - Start reading exactly from the specified sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the specified sequence number.

      • LATEST - Start reading just after the most recent record in the shard, so that you always read the most recent data.

      See Also:

    • shardIteratorTypeAsString

      public final String shardIteratorTypeAsString()

      Determines how the shard iterator is positioned. Must be one of the following:

      • TRIM_HORIZON - Start reading at the last untrimmed record in the shard, which is the oldest data record in the shard.

      • AT_SEQUENCE_NUMBER - Start reading exactly from the specified sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the specified sequence number.

      • LATEST - Start reading just after the most recent record in the shard, so that you always read the most recent data.

      If the service returns an enum value that is not available in the current SDK version, shardIteratorType will return ShardIteratorType.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from shardIteratorTypeAsString().

      Returns:
      Determines how the shard iterator is positioned. Must be one of the following:

      • TRIM_HORIZON - Start reading at the last untrimmed record in the shard, which is the oldest data record in the shard.

      • AT_SEQUENCE_NUMBER - Start reading exactly from the specified sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the specified sequence number.

      • LATEST - Start reading just after the most recent record in the shard, so that you always read the most recent data.

      See Also:

    • sequenceNumber

      public final String sequenceNumber()

      The sequence number of the data record in the shard from which to start reading. Required if ShardIteratorType is AT_SEQUENCE_NUMBER or AFTER_SEQUENCE_NUMBER. This parameter is ignored for other iterator types.

      Returns:
      The sequence number of the data record in the shard from which to start reading. Required if ShardIteratorType is AT_SEQUENCE_NUMBER or AFTER_SEQUENCE_NUMBER. This parameter is ignored for other iterator types.

    • toBuilder

      public GetShardIteratorRequest.Builder toBuilder()
      Description copied from interface: ToCopyableBuilder
      Take this object and create a builder that contains all of the current property values of this object.
      Specified by:
      toBuilder in interface ToCopyableBuilder<GetShardIteratorRequest.Builder,GetShardIteratorRequest>
      Specified by:
      toBuilder in class KeyspacesStreamsRequest
      Returns:
      a builder for type T

    • builder

      public static GetShardIteratorRequest.Builder builder()

    • serializableBuilderClass

      public static Class<? extends GetShardIteratorRequest.Builder> serializableBuilderClass()

    • hashCode

      public final int hashCode()
      Overrides:
      hashCode in class AwsRequest

    • equals

      public final boolean equals(Object obj)
      Overrides:
      equals in class AwsRequest

    • equalsBySdkFields

      public final boolean equalsBySdkFields(Object obj)
      Description copied from interface: SdkPojo
      Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in an SdkPojo class, and is generated based on a service model.

      If an SdkPojo class does not have any inherited fields, equalsBySdkFields and equals are essentially the same.

      Specified by:
      equalsBySdkFields in interface SdkPojo
      Parameters:
      obj - the object to be compared with
      Returns:
      true if the other object equals to this object by sdk fields, false otherwise.

    • 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.
      Overrides:
      toString in class Object

    • getValueForField

      public final <T> Optional<T> getValueForField(String fieldName, Class<T> clazz)
      Description copied from class: SdkRequest
      Used to retrieve the value of a field from any class that extends SdkRequest. The field name specified should match the member name from the corresponding service-2.json model specified in the codegen-resources folder for a given service. The class specifies what class to cast the returned value to. If the returned value is also a modeled class, the SdkRequest.getValueForField(String, Class) method will again be available.
      Overrides:
      getValueForField in class SdkRequest
      Parameters:
      fieldName - The name of the member to be retrieved.
      clazz - The class to cast the returned object to.
      Returns:
      Optional containing the casted return value

    • sdkFields

      public final List<SdkField<?>> sdkFields()
      Specified by:
      sdkFields in interface SdkPojo
      Returns:
      List of SdkField in this POJO. May be empty list but should never be null.

    • sdkFieldNameToField

      public final Map<String,SdkField<?>> sdkFieldNameToField()
      Specified by:
      sdkFieldNameToField in interface SdkPojo
      Returns:
      The mapping between the field name and its corresponding field.