aws-sdk-keyspacesstreams 1.17.0 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69d7b7dbf2c0df8be9ff9ee15de6bda72ce9ca259cacfadf2f56dfc3c88e619e
-  data.tar.gz: 2347bca60aa1fe82980ed3bcc7352b2283da94cb077cfa2c31fe1fc2778efda7
+  metadata.gz: 4ceb604f390bfa96584f5883524d1b7793bda1d39016896fc20bb34983359202
+  data.tar.gz: efc9238a1922e1f6f0cb3f1ce61cfa452bba6370e35a744a47f995f57f46129f
 SHA512:
-  metadata.gz: b8180c8cf69d6b8e40885006e8452db17c69406a4a2b933e9cfba28bba9456f7f3713f71fad1c294814d00b8c7adb81ee222318b59edfda6b8ceaa59fcd561d1
-  data.tar.gz: a1bd560cceb8dfbb71fc1379877d90352443e87427888e353dd92aa5bd377c11983b9c5d6958b7ac37dec73e829656e2226d325fd7bc1068c2ab34559f42f397
+  metadata.gz: ab4df0a2316ac33f8afa5e5f1063873e9f460cc43acd6155435d4128413e3abcd058a5107a1a9256bbab9d0bf56149b9d04c8ca268a60a98173f15a326ec2ed8
+  data.tar.gz: e5b33ad6adbfd6b18faabff22156e4727bab8c6b6db91ea82dee581c3581d1a3464ce1c4e0e746815dfc4589e0cbbe476f45be0801983142e3a27acdee9fe16e

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.18.0 (2026-06-02)
+------------------
+
+* Feature - Added iterator description to the GetRecords API response for Amazon Keyspaces Change Data Capture (CDC) streams, enabling consumers to track their current position within the stream.
+
 1.17.0 (2026-05-26)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.17.0
+1.18.0

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

@@ -506,6 +506,7 @@ module Aws::KeyspacesStreams
     #
     #   * {Types::GetRecordsOutput#change_records #change_records} => Array<Types::Record>
     #   * {Types::GetRecordsOutput#next_shard_iterator #next_shard_iterator} => String
+    #   * {Types::GetRecordsOutput#iterator_description #iterator_description} => Types::IteratorDescription
     #
     # @example Request syntax with placeholder values
     #
@@ -760,6 +761,7 @@ module Aws::KeyspacesStreams
     #   resp.change_records[0].old_image.row_metadata.write_time #=> String
     #   resp.change_records[0].sequence_number #=> String
     #   resp.next_shard_iterator #=> String
+    #   resp.iterator_description.iterator_position #=> String, one of "AT_TIP", "BEHIND_TIP"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/keyspacesstreams-2024-09-09/GetRecords AWS API Documentation
     #
@@ -993,7 +995,7 @@ module Aws::KeyspacesStreams
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-keyspacesstreams'
-      context[:gem_version] = '1.17.0'
+      context[:gem_version] = '1.18.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -27,6 +27,8 @@ module Aws::KeyspacesStreams
     GetStreamInputMaxResultsInteger = Shapes::IntegerShape.new(name: 'GetStreamInputMaxResultsInteger')
     GetStreamOutput = Shapes::StructureShape.new(name: 'GetStreamOutput')
     InternalServerException = Shapes::StructureShape.new(name: 'InternalServerException')
+    IteratorDescription = Shapes::StructureShape.new(name: 'IteratorDescription')
+    IteratorPosition = Shapes::StringShape.new(name: 'IteratorPosition')
     KeyspaceName = Shapes::StringShape.new(name: 'KeyspaceName')
     KeyspacesCell = Shapes::StructureShape.new(name: 'KeyspacesCell')
     KeyspacesCellList = Shapes::ListShape.new(name: 'KeyspacesCellList')
@@ -77,6 +79,7 @@ module Aws::KeyspacesStreams
 
     GetRecordsOutput.add_member(:change_records, Shapes::ShapeRef.new(shape: RecordList, location_name: "changeRecords"))
     GetRecordsOutput.add_member(:next_shard_iterator, Shapes::ShapeRef.new(shape: ShardIterator, location_name: "nextShardIterator"))
+    GetRecordsOutput.add_member(:iterator_description, Shapes::ShapeRef.new(shape: IteratorDescription, location_name: "iteratorDescription"))
     GetRecordsOutput.struct_class = Types::GetRecordsOutput
 
     GetShardIteratorInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: StreamArn, required: true, location_name: "streamArn"))
@@ -108,6 +111,9 @@ module Aws::KeyspacesStreams
     InternalServerException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "message"))
     InternalServerException.struct_class = Types::InternalServerException
 
+    IteratorDescription.add_member(:iterator_position, Shapes::ShapeRef.new(shape: IteratorPosition, location_name: "iteratorPosition"))
+    IteratorDescription.struct_class = Types::IteratorDescription
+
     KeyspacesCell.add_member(:value, Shapes::ShapeRef.new(shape: KeyspacesCellValue, location_name: "value"))
     KeyspacesCell.add_member(:metadata, Shapes::ShapeRef.new(shape: KeyspacesMetadata, location_name: "metadata"))
     KeyspacesCell.struct_class = Types::KeyspacesCell

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

@@ -69,11 +69,17 @@ module Aws::KeyspacesStreams
     #   requested iterator will not return any more data.
     #   @return [String]
     #
+    # @!attribute [rw] iterator_description
+    #   Provides information about the current iterator at the time
+    #   GetRecords request was processed by Keyspaces.
+    #   @return [Types::IteratorDescription]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/keyspacesstreams-2024-09-09/GetRecordsOutput AWS API Documentation
     #
     class GetRecordsOutput < Struct.new(
       :change_records,
-      :next_shard_iterator)
+      :next_shard_iterator,
+      :iterator_description)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -275,6 +281,30 @@ module Aws::KeyspacesStreams
       include Aws::Structure
     end
 
+    # Provides information about the current iterator.
+    #
+    # @!attribute [rw] iterator_position
+    #   Indicates the current iterator's position within the shard. The
+    #   possible values are:
+    #
+    #   * `AT_TIP` - No more records are currently available.
+    #
+    #   * `BEHIND_TIP` - Additional records may be available.
+    #
+    #   Stream progresses in absence of customer records. `BEHIND_TIP` with
+    #   an empty `changeRecords` list indicates the stream is progressing
+    #   but no customer records are available at this position. Continue
+    #   polling normally.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/keyspacesstreams-2024-09-09/IteratorDescription AWS API Documentation
+    #
+    class IteratorDescription < Struct.new(
+      :iterator_position)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Represents a cell in an Amazon Keyspaces table, containing both the
     # value and metadata about the cell.
     #

data/lib/aws-sdk-keyspacesstreams.rb

@@ -54,7 +54,7 @@ module Aws::KeyspacesStreams
   autoload :EndpointProvider, 'aws-sdk-keyspacesstreams/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-keyspacesstreams/endpoints'
 
-  GEM_VERSION = '1.17.0'
+  GEM_VERSION = '1.18.0'
 
 end
 

data/sig/client.rbs

@@ -83,6 +83,7 @@ module Aws
         include ::Seahorse::Client::_ResponseSuccess[Types::GetRecordsOutput]
         def change_records: () -> ::Array[Types::Record]
         def next_shard_iterator: () -> ::String
+        def iterator_description: () -> Types::IteratorDescription
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/KeyspacesStreams/Client.html#get_records-instance_method
       def get_records: (

data/sig/types.rbs

@@ -22,6 +22,7 @@ module Aws::KeyspacesStreams
     class GetRecordsOutput
       attr_accessor change_records: ::Array[Types::Record]
       attr_accessor next_shard_iterator: ::String
+      attr_accessor iterator_description: Types::IteratorDescription
       SENSITIVE: []
     end
 
@@ -64,6 +65,11 @@ module Aws::KeyspacesStreams
       SENSITIVE: []
     end
 
+    class IteratorDescription
+      attr_accessor iterator_position: ("AT_TIP" | "BEHIND_TIP")
+      SENSITIVE: []
+    end
+
     class KeyspacesCell
       attr_accessor value: Types::KeyspacesCellValue
       attr_accessor metadata: Types::KeyspacesMetadata

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-keyspacesstreams
 version: !ruby/object:Gem::Version
-  version: 1.17.0
+  version: 1.18.0
 platform: ruby
 authors:
 - Amazon Web Services