/** * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. * SPDX-License-Identifier: Apache-2.0. */ #pragma once #include #include #include #include #include namespace Aws { namespace DynamoDBStreams { namespace Model { /** *

Represents the input of a GetShardIterator * operation.

See Also:

AWS * API Reference

*/ class GetShardIteratorRequest : public DynamoDBStreamsRequest { public: AWS_DYNAMODBSTREAMS_API GetShardIteratorRequest(); // Service request name is the Operation name which will send this request out, // each operation should has unique request name, so that we can get operation's name from this request. // Note: this is not true for response, multiple operations may have the same response name, // so we can not get operation's name from response. inline virtual const char* GetServiceRequestName() const override { return "GetShardIterator"; } AWS_DYNAMODBSTREAMS_API Aws::String SerializePayload() const override; AWS_DYNAMODBSTREAMS_API Aws::Http::HeaderValueCollection GetRequestSpecificHeaders() const override; /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline const Aws::String& GetStreamArn() const{ return m_streamArn; } /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline bool StreamArnHasBeenSet() const { return m_streamArnHasBeenSet; } /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline void SetStreamArn(const Aws::String& value) { m_streamArnHasBeenSet = true; m_streamArn = value; } /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline void SetStreamArn(Aws::String&& value) { m_streamArnHasBeenSet = true; m_streamArn = std::move(value); } /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline void SetStreamArn(const char* value) { m_streamArnHasBeenSet = true; m_streamArn.assign(value); } /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline GetShardIteratorRequest& WithStreamArn(const Aws::String& value) { SetStreamArn(value); return *this;} /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline GetShardIteratorRequest& WithStreamArn(Aws::String&& value) { SetStreamArn(std::move(value)); return *this;} /** *

The Amazon Resource Name (ARN) for the stream.

*/ inline GetShardIteratorRequest& WithStreamArn(const char* value) { SetStreamArn(value); return *this;} /** *

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

*/ inline const Aws::String& GetShardId() const{ return m_shardId; } /** *

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

*/ inline bool ShardIdHasBeenSet() const { return m_shardIdHasBeenSet; } /** *

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

*/ inline void SetShardId(const Aws::String& value) { m_shardIdHasBeenSet = true; m_shardId = value; } /** *

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

*/ inline void SetShardId(Aws::String&& value) { m_shardIdHasBeenSet = true; m_shardId = std::move(value); } /** *

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

*/ inline void SetShardId(const char* value) { m_shardIdHasBeenSet = true; m_shardId.assign(value); } /** *

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

*/ inline GetShardIteratorRequest& WithShardId(const Aws::String& value) { SetShardId(value); return *this;} /** *

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

*/ inline GetShardIteratorRequest& WithShardId(Aws::String&& value) { SetShardId(std::move(value)); return *this;} /** *

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

*/ inline GetShardIteratorRequest& WithShardId(const char* value) { SetShardId(value); return *this;} /** *

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.

*/ inline const ShardIteratorType& GetShardIteratorType() const{ return m_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.

*/ inline bool ShardIteratorTypeHasBeenSet() const { return m_shardIteratorTypeHasBeenSet; } /** *

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.

*/ inline void SetShardIteratorType(const ShardIteratorType& value) { m_shardIteratorTypeHasBeenSet = true; m_shardIteratorType = value; } /** *

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.

*/ inline void SetShardIteratorType(ShardIteratorType&& value) { m_shardIteratorTypeHasBeenSet = true; m_shardIteratorType = std::move(value); } /** *

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.

*/ inline GetShardIteratorRequest& WithShardIteratorType(const ShardIteratorType& value) { SetShardIteratorType(value); return *this;} /** *

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.

*/ inline GetShardIteratorRequest& WithShardIteratorType(ShardIteratorType&& value) { SetShardIteratorType(std::move(value)); return *this;} /** *

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

*/ inline const Aws::String& GetSequenceNumber() const{ return m_sequenceNumber; } /** *

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

*/ inline bool SequenceNumberHasBeenSet() const { return m_sequenceNumberHasBeenSet; } /** *

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

*/ inline void SetSequenceNumber(const Aws::String& value) { m_sequenceNumberHasBeenSet = true; m_sequenceNumber = value; } /** *

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

*/ inline void SetSequenceNumber(Aws::String&& value) { m_sequenceNumberHasBeenSet = true; m_sequenceNumber = std::move(value); } /** *

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

*/ inline void SetSequenceNumber(const char* value) { m_sequenceNumberHasBeenSet = true; m_sequenceNumber.assign(value); } /** *

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

*/ inline GetShardIteratorRequest& WithSequenceNumber(const Aws::String& value) { SetSequenceNumber(value); return *this;} /** *

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

*/ inline GetShardIteratorRequest& WithSequenceNumber(Aws::String&& value) { SetSequenceNumber(std::move(value)); return *this;} /** *

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

*/ inline GetShardIteratorRequest& WithSequenceNumber(const char* value) { SetSequenceNumber(value); return *this;} private: Aws::String m_streamArn; bool m_streamArnHasBeenSet = false; Aws::String m_shardId; bool m_shardIdHasBeenSet = false; ShardIteratorType m_shardIteratorType; bool m_shardIteratorTypeHasBeenSet = false; Aws::String m_sequenceNumber; bool m_sequenceNumberHasBeenSet = false; }; } // namespace Model } // namespace DynamoDBStreams } // namespace Aws