aws-sdk-dynamodbstreams 1.96.0 → 1.97.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 138bbf4a6f991b1f3d6cf676318e7fd11707340d9241715d63d7fde0625e9086
-  data.tar.gz: a7c32ca85c9ba8efe29d742703c253bdc700d0991ef202d63fe731d788d3c776
+  metadata.gz: 5adb35a1cbf040becd7bce5f39e0295a6930cb3ebe48d6a60cdc5e342cb16a7a
+  data.tar.gz: 94b94dbe14fe5a3276327f389c9982441a46d5959eac64fe8e30d7b0db4c0536
 SHA512:
-  metadata.gz: d0246244d062e2cd73de5e806c65a8017db6bb43b956a715b64573043b92612e0e6105dcefe278135d6ebb9f4d0fd6e0760c730a9cd5d406c5d9560e88291387
-  data.tar.gz: 32af545bc8778e2aab05b180cb93b0106f6aff7a0d261aeec07497527f94079b317aabedeab403a1c7ed2048352bb48abd64a5a181053ff35a0f17261d24ab44
+  metadata.gz: 489e5e33b71cad8e43010740da1b0dcaff4003836f4ae79dc4e64902f327aba7394cd67da8a09bd9d6c856162a5892cb97fa3e376827ad745e89431ddeac3717
+  data.tar.gz: b327510b12450af6d7dcf8ee7145ebd495756fe0ea99f26f3c638f92c09d4452a86b42f192276099035ab3f69be6aefe5212176cfe824139734a4ac2391788b6

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.97.0 (2026-10-14)
+------------------
+
+* Feature - Add support for a new iterator type (AT TIMESTAMP) for DynamoDB Streams GetShardIterator API that allows reading from a specific point in time from the stream.
+
 1.96.0 (2026-09-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.96.0
+1.97.0

data/lib/aws-sdk-dynamodbstreams/client.rb

@@ -807,10 +807,25 @@ module Aws::DynamoDBStreams
     #     the shard, so that you always read the most recent data in the
     #     shard.
     #
+    #   * `AT_TIMESTAMP` - Start reading from the position denoted by a
+    #     specific timestamp, provided in the parameter `Timestamp`.
+    #
     # @option params [String] :sequence_number
     #   The sequence number of a stream record in the shard from which to
     #   start reading.
     #
+    # @option params [Time,DateTime,Date,Integer,String] :timestamp
+    #   The timestamp of the stream record from which to start reading. Used
+    #   with shard iterator type `AT_TIMESTAMP`. A timestamp is the Unix epoch
+    #   date with precision in milliseconds. For example, `1791316726.480`.
+    #   The iterator points to the first stream record whose
+    #   `ApproximateCreationDateTime` is at or after the specified timestamp.
+    #   If no record with that exact timestamp exists, the iterator points to
+    #   the next (later) record. If the timestamp is older than the current
+    #   trim horizon, the iterator points to the oldest untrimmed stream
+    #   record (`TRIM_HORIZON`). If the timestamp is in the future, the
+    #   request returns a `ValidationException`.
+    #
     # @return [Types::GetShardIteratorOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetShardIteratorOutput#shard_iterator #shard_iterator} => String
@@ -836,8 +851,9 @@ module Aws::DynamoDBStreams
     #   resp = client.get_shard_iterator({
     #     stream_arn: "StreamArn", # required
     #     shard_id: "ShardId", # required
-    #     shard_iterator_type: "TRIM_HORIZON", # required, accepts TRIM_HORIZON, LATEST, AT_SEQUENCE_NUMBER, AFTER_SEQUENCE_NUMBER
+    #     shard_iterator_type: "TRIM_HORIZON", # required, accepts TRIM_HORIZON, LATEST, AT_SEQUENCE_NUMBER, AFTER_SEQUENCE_NUMBER, AT_TIMESTAMP
     #     sequence_number: "SequenceNumber",
+    #     timestamp: Time.now,
     #   })
     #
     # @example Response structure
@@ -950,7 +966,7 @@ module Aws::DynamoDBStreams
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-dynamodbstreams'
-      context[:gem_version] = '1.96.0'
+      context[:gem_version] = '1.97.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-dynamodbstreams/client_api.rb

@@ -69,6 +69,7 @@ module Aws::DynamoDBStreams
     StringAttributeValue = Shapes::StringShape.new(name: 'StringAttributeValue')
     StringSetAttributeValue = Shapes::ListShape.new(name: 'StringSetAttributeValue')
     TableName = Shapes::StringShape.new(name: 'TableName')
+    Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
     TrimmedDataAccessException = Shapes::StructureShape.new(name: 'TrimmedDataAccessException')
 
     AttributeMap.key = Shapes::ShapeRef.new(shape: AttributeName)
@@ -112,6 +113,7 @@ module Aws::DynamoDBStreams
     GetShardIteratorInput.add_member(:shard_id, Shapes::ShapeRef.new(shape: ShardId, required: true, location_name: "ShardId"))
     GetShardIteratorInput.add_member(:shard_iterator_type, Shapes::ShapeRef.new(shape: ShardIteratorType, required: true, location_name: "ShardIteratorType"))
     GetShardIteratorInput.add_member(:sequence_number, Shapes::ShapeRef.new(shape: SequenceNumber, location_name: "SequenceNumber"))
+    GetShardIteratorInput.add_member(:timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "Timestamp"))
     GetShardIteratorInput.struct_class = Types::GetShardIteratorInput
 
     GetShardIteratorOutput.add_member(:shard_iterator, Shapes::ShapeRef.new(shape: ShardIterator, location_name: "ShardIterator"))

data/lib/aws-sdk-dynamodbstreams/types.rb

@@ -249,6 +249,9 @@ module Aws::DynamoDBStreams
     #   * `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.
+    #
+    #   * `AT_TIMESTAMP` - Start reading from the position denoted by a
+    #     specific timestamp, provided in the parameter `Timestamp`.
     #   @return [String]
     #
     # @!attribute [rw] sequence_number
@@ -256,13 +259,27 @@ module Aws::DynamoDBStreams
     #   start reading.
     #   @return [String]
     #
+    # @!attribute [rw] timestamp
+    #   The timestamp of the stream record from which to start reading. Used
+    #   with shard iterator type `AT_TIMESTAMP`. A timestamp is the Unix
+    #   epoch date with precision in milliseconds. For example,
+    #   `1791316726.480`. The iterator points to the first stream record
+    #   whose `ApproximateCreationDateTime` is at or after the specified
+    #   timestamp. If no record with that exact timestamp exists, the
+    #   iterator points to the next (later) record. If the timestamp is
+    #   older than the current trim horizon, the iterator points to the
+    #   oldest untrimmed stream record (`TRIM_HORIZON`). If the timestamp is
+    #   in the future, the request returns a `ValidationException`.
+    #   @return [Time]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/streams-dynamodb-2012-08-10/GetShardIteratorInput AWS API Documentation
     #
     class GetShardIteratorInput < Struct.new(
       :stream_arn,
       :shard_id,
       :shard_iterator_type,
-      :sequence_number)
+      :sequence_number,
+      :timestamp)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -754,11 +771,14 @@ module Aws::DynamoDBStreams
     #
     # @!attribute [rw] approximate_creation_date_time
     #   The approximate date and time when the stream record was created, in
-    #   [ISO 8601][1] format and rounded down to the closest second.
+    #   [UNIX epoch time][1] format and rounded down to the closest second.
+    #   Some tools and SDKs may convert this value to a different format,
+    #   such as [ISO 8601][2].
     #
     #
     #
-    #   [1]: https://www.iso.org/iso-8601-date-and-time-format.html
+    #   [1]: http://www.epochconverter.com/
+    #   [2]: https://www.iso.org/iso-8601-date-and-time-format.html
     #   @return [Time]
     #
     # @!attribute [rw] keys

data/lib/aws-sdk-dynamodbstreams.rb

@@ -54,7 +54,7 @@ module Aws::DynamoDBStreams
   autoload :EndpointProvider, 'aws-sdk-dynamodbstreams/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-dynamodbstreams/endpoints'
 
-  GEM_VERSION = '1.96.0'
+  GEM_VERSION = '1.97.0'
 
 end
 

data/sig/client.rbs

@@ -116,8 +116,9 @@ module Aws
       def get_shard_iterator: (
                                 stream_arn: ::String,
                                 shard_id: ::String,
-                                shard_iterator_type: ("TRIM_HORIZON" | "LATEST" | "AT_SEQUENCE_NUMBER" | "AFTER_SEQUENCE_NUMBER"),
-                                ?sequence_number: ::String
+                                shard_iterator_type: ("TRIM_HORIZON" | "LATEST" | "AT_SEQUENCE_NUMBER" | "AFTER_SEQUENCE_NUMBER" | "AT_TIMESTAMP"),
+                                ?sequence_number: ::String,
+                                ?timestamp: ::Time
                               ) -> _GetShardIteratorResponseSuccess
                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _GetShardIteratorResponseSuccess
 

data/sig/types.rbs

@@ -55,8 +55,9 @@ module Aws::DynamoDBStreams
     class GetShardIteratorInput
       attr_accessor stream_arn: ::String
       attr_accessor shard_id: ::String
-      attr_accessor shard_iterator_type: ("TRIM_HORIZON" | "LATEST" | "AT_SEQUENCE_NUMBER" | "AFTER_SEQUENCE_NUMBER")
+      attr_accessor shard_iterator_type: ("TRIM_HORIZON" | "LATEST" | "AT_SEQUENCE_NUMBER" | "AFTER_SEQUENCE_NUMBER" | "AT_TIMESTAMP")
       attr_accessor sequence_number: ::String
+      attr_accessor timestamp: ::Time
       SENSITIVE: []
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-dynamodbstreams
 version: !ruby/object:Gem::Version
-  version: 1.96.0
+  version: 1.97.0
 platform: ruby
 authors:
 - Amazon Web Services