Package software.amazon.awssdk.services.dynamodb.model

Interface GetShardIteratorRequest.Builder

All Superinterfaces:
AwsRequest.Builder, Buildable, CopyableBuilder<GetShardIteratorRequest.Builder,GetShardIteratorRequest>, DynamoDbStreamsRequest.Builder, SdkBuilder<GetShardIteratorRequest.Builder,GetShardIteratorRequest>, SdkPojo, SdkRequest.Builder
Enclosing class:
GetShardIteratorRequest
public static interface GetShardIteratorRequest.Builder extends DynamoDbStreamsRequest.Builder, SdkPojo, CopyableBuilder<GetShardIteratorRequest.Builder,GetShardIteratorRequest>

  • Method Details

    • streamArn

      GetShardIteratorRequest.Builder streamArn(String streamArn)

      The Amazon Resource Name (ARN) for the stream.

      Parameters:
      streamArn - The Amazon Resource Name (ARN) for the stream.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • shardId

      GetShardIteratorRequest.Builder shardId(String shardId)

      The identifier of the shard. The iterator will be returned for this shard ID.

      Parameters:
      shardId - The identifier of the shard. The iterator will be returned for this shard ID.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • shardIteratorType

      GetShardIteratorRequest.Builder shardIteratorType(String shardIteratorType)

      Determines how the shard iterator is used to start reading stream records from the shard:

      • AT_SEQUENCE_NUMBER - Start reading exactly from the position denoted by a specific sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the position denoted by a specific sequence number.

      • TRIM_HORIZON - Start reading at the last (untrimmed) stream record, which is the oldest record in the shard. In DynamoDB Streams, there is a 24 hour limit on data retention. Stream records whose age exceeds this limit are subject to removal (trimming) from the stream.

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

      Parameters:
      shardIteratorType - Determines how the shard iterator is used to start reading stream records from the shard:

      • AT_SEQUENCE_NUMBER - Start reading exactly from the position denoted by a specific sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the position denoted by a specific sequence number.

      • TRIM_HORIZON - Start reading at the last (untrimmed) stream record, which is the oldest record in the shard. In DynamoDB Streams, there is a 24 hour limit on data retention. Stream records whose age exceeds this limit are subject to removal (trimming) from the stream.

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

      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • shardIteratorType

      GetShardIteratorRequest.Builder shardIteratorType(ShardIteratorType shardIteratorType)

      Determines how the shard iterator is used to start reading stream records from the shard:

      • AT_SEQUENCE_NUMBER - Start reading exactly from the position denoted by a specific sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the position denoted by a specific sequence number.

      • TRIM_HORIZON - Start reading at the last (untrimmed) stream record, which is the oldest record in the shard. In DynamoDB Streams, there is a 24 hour limit on data retention. Stream records whose age exceeds this limit are subject to removal (trimming) from the stream.

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

      Parameters:
      shardIteratorType - Determines how the shard iterator is used to start reading stream records from the shard:

      • AT_SEQUENCE_NUMBER - Start reading exactly from the position denoted by a specific sequence number.

      • AFTER_SEQUENCE_NUMBER - Start reading right after the position denoted by a specific sequence number.

      • TRIM_HORIZON - Start reading at the last (untrimmed) stream record, which is the oldest record in the shard. In DynamoDB Streams, there is a 24 hour limit on data retention. Stream records whose age exceeds this limit are subject to removal (trimming) from the stream.

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

      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:

    • sequenceNumber

      GetShardIteratorRequest.Builder sequenceNumber(String sequenceNumber)

      The sequence number of a stream record in the shard from which to start reading.

      Parameters:
      sequenceNumber - The sequence number of a stream record in the shard from which to start reading.
      Returns:
      Returns a reference to this object so that method calls can be chained together.

    • overrideConfiguration

      GetShardIteratorRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration)
      Description copied from interface: AwsRequest.Builder
      Add an optional request override configuration.
      Specified by:
      overrideConfiguration in interface AwsRequest.Builder
      Parameters:
      overrideConfiguration - The override configuration.
      Returns:
      This object for method chaining.

    • overrideConfiguration

      GetShardIteratorRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer)
      Description copied from interface: AwsRequest.Builder
      Add an optional request override configuration.
      Specified by:
      overrideConfiguration in interface AwsRequest.Builder
      Parameters:
      builderConsumer - A Consumer to which an empty AwsRequestOverrideConfiguration.Builder will be given.
      Returns:
      This object for method chaining.