aws-sdk-kinesis 1.108.0 → 1.109.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fa0c7c9dd053dd91a458987b50bc140af825aa01d63001d19663b1b2a1654c00
-  data.tar.gz: 2afeae6cbe69b218689abd8d2509923ebda46d29b9264a435187f525f0ccab43
+  metadata.gz: 9a238b3a30240e6b6cb0c0d9442b0ca10a20cc1cb5e31d94e3f6ad57cf9663cd
+  data.tar.gz: 5c0a5998d47fb8f4a8f5c3d514a45c7591294742a549b14eed5b2e80ca11244a
 SHA512:
-  metadata.gz: 31472576b4ee9a6855d32519d19d2897c2b9ac43cbe55d8b524383a45b572a47a80a927e05ce3cd63eebda95b5c6591a6c9e7c3951ecade40d8ab98787b2cc5f
-  data.tar.gz: 8353abf9f792f96d99f1337b8823009ee2524194496e768479873f8a935093546565d6b1344e2b2b70433fe7c0658b09d8cd0c0d7d6a67e1303fbb93aa2a6c76
+  metadata.gz: c25fe76ba4bfa8581982c210ff8a5f365841acbeb928f849ead5335e4a3b98d6977456a43b02d53fdeea738d73b8090f964ea9fb0d492c68571408cdfea9f15d
+  data.tar.gz: 897cdb5f5aa55f1ebd4765595fa645247499bfe39d54c3a96d3c33b688a4b44bf19dea5713ca1768c06d8bba33dff8bba4d2535d3b0ce0e0df487bf19e669366

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.109.0 (2026-09-23)
+------------------
+
+* Feature - Amazon Kinesis Data Streams now supports service managed record distribution for on demand streams. Set the record distribution strategy to AUTO to evenly distribute records across shards. Configure it at stream creation with CreateStream or update anytime with UpdateStreamRecordDistributionStrategy
+
 1.108.0 (2026-09-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.108.0
+1.109.0

data/lib/aws-sdk-kinesis/async_client.rb

@@ -761,7 +761,7 @@ module Aws::Kinesis
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-kinesis'
-      context[:gem_version] = '1.108.0'
+      context[:gem_version] = '1.109.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -592,14 +592,13 @@ module Aws::Kinesis
     #
     # @option params [Types::S3DestinationConfiguration] :s3_destination_configuration
     #   The configuration for delivery to a general purpose Amazon S3 bucket.
-    #   You must specify either `S3DestinationConfiguration` or
-    #   `S3TablesDestinationConfiguration`, but not both.
+    #   Specify this parameter when `S3TablesDestinationConfiguration` is not
+    #   specified.
     #
     # @option params [Types::S3TablesDestinationConfiguration] :s3_tables_destination_configuration
     #   The configuration for delivery to streaming tables on Apache Iceberg
-    #   in Amazon S3 Tables. You must specify either
-    #   `S3DestinationConfiguration` or `S3TablesDestinationConfiguration`,
-    #   but not both.
+    #   in Amazon S3 Tables. Specify this parameter when
+    #   `S3DestinationConfiguration` is not specified.
     #
     # @option params [Types::ChannelEncryptionConfiguration] :encryption_configuration
     #   The server-side encryption configuration that uses an Amazon Web
@@ -1029,6 +1028,24 @@ module Aws::Kinesis
     #   The maximum record size of a single record in kibibyte (KiB) that you
     #   can write to, and read from a stream.
     #
+    # @option params [String] :record_distribution_strategy
+    #   The record distribution strategy for the stream, which determines how
+    #   Amazon Kinesis Data Streams distributes records across shards. Specify
+    #   one of the following values:
+    #
+    #   * `AUTO` – Amazon Kinesis Data Streams distributes records evenly
+    #     across shards and ignores any partition key and `ExplicitHashKey`
+    #     that producers supply. Use this value for stateless workloads that
+    #     do not require partition-key ordering.
+    #
+    #   * `USER_PARTITION_KEY` – Producers must supply a partition key, which
+    #     Amazon Kinesis Data Streams uses to determine shard placement. This
+    #     is the default.
+    #
+    #   The record distribution strategy is only supported for streams that
+    #   use the on-demand capacity mode. If you do not specify this parameter,
+    #   the stream uses `USER_PARTITION_KEY`.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -1044,6 +1061,7 @@ module Aws::Kinesis
     #     },
     #     warm_throughput_mi_bps: 1,
     #     max_record_size_in_ki_b: 1,
+    #     record_distribution_strategy: "AUTO", # accepts AUTO, USER_PARTITION_KEY
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/CreateStream AWS API Documentation
@@ -1106,9 +1124,9 @@ module Aws::Kinesis
     # the source stream to the destination. Data already delivered to the
     # destination is not deleted.
     #
-    # A stream cannot be deleted while it has active channels. To delete the
-    # stream, first delete all channels attached to it. To find them, use
-    # ListChannels with a stream filter.
+    # A stream cannot be deleted while it has active channels. Use
+    # ListChannels with a stream filter to find the channels attached to a
+    # stream before deleting it.
     #
     # This operation has a call limit of 5 transactions per second (TPS) for
     # each Amazon Web Services account. Exceeding 5 TPS results in a
@@ -1727,6 +1745,7 @@ module Aws::Kinesis
     #   resp.stream_description_summary.warm_throughput.current_mi_bps #=> Integer
     #   resp.stream_description_summary.max_record_size_in_ki_b #=> Integer
     #   resp.stream_description_summary.channel_count #=> Integer
+    #   resp.stream_description_summary.record_distribution_strategy #=> String, one of "AUTO", "USER_PARTITION_KEY"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/DescribeStreamSummary AWS API Documentation
     #
@@ -2294,8 +2313,7 @@ module Aws::Kinesis
     #
     # @option params [String] :next_token
     #   The pagination token returned by a previous call. Specify this token
-    #   to retrieve the next page of results. This value is `null` when there
-    #   are no more results to return.
+    #   to retrieve the next page of results.
     #
     # @return [Types::ListChannelsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2983,7 +3001,7 @@ module Aws::Kinesis
     #   base64-encoding) is added to the partition key size, the total size
     #   must not exceed the maximum record size (10 MiB).
     #
-    # @option params [required, String] :partition_key
+    # @option params [String] :partition_key
     #   Determines which shard in the stream the data record is assigned to.
     #   Partition keys are Unicode strings with a maximum length limit of 256
     #   characters for each key. Amazon Kinesis Data Streams uses the
@@ -2994,6 +3012,15 @@ module Aws::Kinesis
     #   mechanism, all data records with the same partition key map to the
     #   same shard within the stream.
     #
+    #   If the stream uses the `USER_PARTITION_KEY` record distribution
+    #   strategy (the default), a partition key is required. If the stream
+    #   uses the `AUTO` record distribution strategy, the partition key is
+    #   optional and any value you provide is ignored, along with any
+    #   `ExplicitHashKey` you provide. In that case, Amazon Kinesis Data
+    #   Streams distributes the record across shards using service-managed
+    #   algorithms. For more information, see
+    #   `UpdateStreamRecordDistributionStrategy`.
+    #
     # @option params [String] :explicit_hash_key
     #   The hash value used to explicitly determine the shard the data record
     #   is assigned to by overriding the partition key hash.
@@ -3027,7 +3054,7 @@ module Aws::Kinesis
     #   resp = client.put_record({
     #     stream_name: "StreamName",
     #     data: "data", # required
-    #     partition_key: "PartitionKey", # required
+    #     partition_key: "PartitionKey",
     #     explicit_hash_key: "HashKey",
     #     sequence_number_for_ordering: "SequenceNumber",
     #     stream_arn: "StreamARN",
@@ -3166,7 +3193,7 @@ module Aws::Kinesis
     #       {
     #         data: "data", # required
     #         explicit_hash_key: "HashKey",
-    #         partition_key: "PartitionKey", # required
+    #         partition_key: "PartitionKey",
     #       },
     #     ],
     #     stream_name: "StreamName",
@@ -3796,11 +3823,14 @@ module Aws::Kinesis
     #
     # @option params [Types::S3DestinationUpdateInput] :s3_destination_configuration
     #   The updated configuration for a general purpose Amazon S3 destination.
-    #   Only `DataFreshnessInSeconds` can be updated.
+    #   Specify this parameter when the channel delivers to a general purpose
+    #   Amazon S3 bucket. Only `DataFreshnessInSeconds` can be updated.
     #
     # @option params [Types::S3TablesDestinationUpdateInput] :s3_tables_destination_configuration
-    #   The updated configuration for a streaming table destination. Only
-    #   `DataFreshnessInSeconds` can be updated.
+    #   The updated configuration for a streaming table destination. Specify
+    #   this parameter when the channel delivers to streaming tables on Apache
+    #   Iceberg in Amazon S3 Tables. Only `DataFreshnessInSeconds` can be
+    #   updated.
     #
     # @option params [Types::ChannelLoggingUpdateInput] :logging_configuration
     #   The updated Amazon CloudWatch Logs configuration for the channel.
@@ -4149,6 +4179,78 @@ module Aws::Kinesis
       req.send_request(options)
     end
 
+    # Updates the record distribution strategy for the specified Amazon
+    # Kinesis Data Streams on-demand data stream. The record distribution
+    # strategy determines how Amazon Kinesis Data Streams distributes
+    # records across the shards in a stream.
+    #
+    # <note markdown="1"> You must specify the stream using the `StreamARN` parameter.
+    #
+    #  </note>
+    #
+    # The record distribution strategy is a stream-level setting. You can
+    # switch between the following strategies at any time, and the change
+    # takes effect immediately without downtime, data loss, or disruption to
+    # producer or consumer applications:
+    #
+    # * `AUTO` – Amazon Kinesis Data Streams distributes records evenly
+    #   across shards using service-managed algorithms, and ignores any
+    #   partition key and `ExplicitHashKey` that a producer provides. Use
+    #   this strategy for stateless workloads that do not require
+    #   partition-key ordering.
+    #
+    # * `USER_PARTITION_KEY` – Producers must provide a partition key, and
+    #   Amazon Kinesis Data Streams uses the partition key to determine
+    #   shard placement. Records that share a partition key are sent to the
+    #   same shard. This is the default strategy.
+    #
+    # This operation is only supported for data streams that use the
+    # on-demand capacity mode. Provisioned capacity mode streams do not
+    # support the record distribution strategy setting. Attempting to set
+    # `AUTO` on a provisioned stream results in an
+    # `InvalidArgumentException`.
+    #
+    # New records that arrive after the change are distributed according to
+    # the new strategy. Records already in the stream keep their original
+    # shard assignments and are not redistributed.
+    #
+    # @option params [required, String] :stream_arn
+    #   The Amazon Resource Name (ARN) of the stream to update.
+    #
+    # @option params [String] :stream_id
+    #   Not Implemented. Reserved for future use.
+    #
+    # @option params [required, String] :record_distribution_strategy
+    #   The record distribution strategy to apply to the stream. Specify one
+    #   of the following values:
+    #
+    #   * `AUTO` – Amazon Kinesis Data Streams distributes records evenly
+    #     across shards and ignores any partition key and `ExplicitHashKey`
+    #     that producers supply.
+    #
+    #   * `USER_PARTITION_KEY` – Producers must supply a partition key, which
+    #     Amazon Kinesis Data Streams uses to determine shard placement. This
+    #     is the default.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_stream_record_distribution_strategy({
+    #     stream_arn: "StreamARN", # required
+    #     stream_id: "StreamId",
+    #     record_distribution_strategy: "AUTO", # required, accepts AUTO, USER_PARTITION_KEY
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/UpdateStreamRecordDistributionStrategy AWS API Documentation
+    #
+    # @overload update_stream_record_distribution_strategy(params = {})
+    # @param [Hash] params ({})
+    def update_stream_record_distribution_strategy(params = {}, options = {})
+      req = build_request(:update_stream_record_distribution_strategy, params)
+      req.send_request(options)
+    end
+
     # Updates the warm throughput configuration for the specified Amazon
     # Kinesis Data Streams on-demand data stream. Updates the warm
     # throughput configuration for the specified on-demand data stream. Use
@@ -4260,7 +4362,7 @@ module Aws::Kinesis
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-kinesis'
-      context[:gem_version] = '1.108.0'
+      context[:gem_version] = '1.109.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -158,6 +158,7 @@ module Aws::Kinesis
     PutResourcePolicyInput = Shapes::StructureShape.new(name: 'PutResourcePolicyInput')
     Record = Shapes::StructureShape.new(name: 'Record')
     RecordConfiguration = Shapes::StructureShape.new(name: 'RecordConfiguration')
+    RecordDistributionStrategy = Shapes::StringShape.new(name: 'RecordDistributionStrategy')
     RecordFormatType = Shapes::StringShape.new(name: 'RecordFormatType')
     RecordList = Shapes::ListShape.new(name: 'RecordList')
     RegisterStreamConsumerInput = Shapes::StructureShape.new(name: 'RegisterStreamConsumerInput')
@@ -235,6 +236,7 @@ module Aws::Kinesis
     UpdateShardCountInput = Shapes::StructureShape.new(name: 'UpdateShardCountInput')
     UpdateShardCountOutput = Shapes::StructureShape.new(name: 'UpdateShardCountOutput')
     UpdateStreamModeInput = Shapes::StructureShape.new(name: 'UpdateStreamModeInput')
+    UpdateStreamRecordDistributionStrategyInput = Shapes::StructureShape.new(name: 'UpdateStreamRecordDistributionStrategyInput')
     UpdateStreamWarmThroughputInput = Shapes::StructureShape.new(name: 'UpdateStreamWarmThroughputInput')
     UpdateStreamWarmThroughputOutput = Shapes::StructureShape.new(name: 'UpdateStreamWarmThroughputOutput')
     ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
@@ -355,6 +357,7 @@ module Aws::Kinesis
     CreateStreamInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "Tags"))
     CreateStreamInput.add_member(:warm_throughput_mi_bps, Shapes::ShapeRef.new(shape: NaturalIntegerObject, location_name: "WarmThroughputMiBps"))
     CreateStreamInput.add_member(:max_record_size_in_ki_b, Shapes::ShapeRef.new(shape: MaxRecordSizeInKiB, location_name: "MaxRecordSizeInKiB"))
+    CreateStreamInput.add_member(:record_distribution_strategy, Shapes::ShapeRef.new(shape: RecordDistributionStrategy, location_name: "RecordDistributionStrategy"))
     CreateStreamInput.struct_class = Types::CreateStreamInput
 
     DeadLetterQueueS3Configuration.add_member(:bucket_arn, Shapes::ShapeRef.new(shape: BucketARN, required: true, location_name: "BucketARN"))
@@ -632,7 +635,7 @@ module Aws::Kinesis
 
     PutRecordInput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, location_name: "StreamName"))
     PutRecordInput.add_member(:data, Shapes::ShapeRef.new(shape: Data, required: true, location_name: "Data"))
-    PutRecordInput.add_member(:partition_key, Shapes::ShapeRef.new(shape: PartitionKey, required: true, location_name: "PartitionKey"))
+    PutRecordInput.add_member(:partition_key, Shapes::ShapeRef.new(shape: PartitionKey, location_name: "PartitionKey"))
     PutRecordInput.add_member(:explicit_hash_key, Shapes::ShapeRef.new(shape: HashKey, location_name: "ExplicitHashKey"))
     PutRecordInput.add_member(:sequence_number_for_ordering, Shapes::ShapeRef.new(shape: SequenceNumber, location_name: "SequenceNumberForOrdering"))
     PutRecordInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: StreamARN, location_name: "StreamARN", metadata: {"contextParam" => {"name" => "StreamARN"}}))
@@ -659,7 +662,7 @@ module Aws::Kinesis
 
     PutRecordsRequestEntry.add_member(:data, Shapes::ShapeRef.new(shape: Data, required: true, location_name: "Data"))
     PutRecordsRequestEntry.add_member(:explicit_hash_key, Shapes::ShapeRef.new(shape: HashKey, location_name: "ExplicitHashKey"))
-    PutRecordsRequestEntry.add_member(:partition_key, Shapes::ShapeRef.new(shape: PartitionKey, required: true, location_name: "PartitionKey"))
+    PutRecordsRequestEntry.add_member(:partition_key, Shapes::ShapeRef.new(shape: PartitionKey, location_name: "PartitionKey"))
     PutRecordsRequestEntry.struct_class = Types::PutRecordsRequestEntry
 
     PutRecordsRequestEntryList.member = Shapes::ShapeRef.new(shape: PutRecordsRequestEntry)
@@ -680,7 +683,7 @@ module Aws::Kinesis
     Record.add_member(:sequence_number, Shapes::ShapeRef.new(shape: SequenceNumber, required: true, location_name: "SequenceNumber"))
     Record.add_member(:approximate_arrival_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "ApproximateArrivalTimestamp"))
     Record.add_member(:data, Shapes::ShapeRef.new(shape: Data, required: true, location_name: "Data"))
-    Record.add_member(:partition_key, Shapes::ShapeRef.new(shape: PartitionKey, required: true, location_name: "PartitionKey"))
+    Record.add_member(:partition_key, Shapes::ShapeRef.new(shape: PartitionKey, location_name: "PartitionKey"))
     Record.add_member(:encryption_type, Shapes::ShapeRef.new(shape: EncryptionType, location_name: "EncryptionType"))
     Record.struct_class = Types::Record
 
@@ -827,6 +830,7 @@ module Aws::Kinesis
     StreamDescriptionSummary.add_member(:warm_throughput, Shapes::ShapeRef.new(shape: WarmThroughputObject, location_name: "WarmThroughput"))
     StreamDescriptionSummary.add_member(:max_record_size_in_ki_b, Shapes::ShapeRef.new(shape: MaxRecordSizeInKiB, location_name: "MaxRecordSizeInKiB"))
     StreamDescriptionSummary.add_member(:channel_count, Shapes::ShapeRef.new(shape: ChannelCountObject, location_name: "ChannelCount"))
+    StreamDescriptionSummary.add_member(:record_distribution_strategy, Shapes::ShapeRef.new(shape: RecordDistributionStrategy, location_name: "RecordDistributionStrategy"))
     StreamDescriptionSummary.struct_class = Types::StreamDescriptionSummary
 
     StreamFilter.add_member(:stream_arn, Shapes::ShapeRef.new(shape: StreamARN, required: true, location_name: "StreamARN"))
@@ -937,6 +941,11 @@ module Aws::Kinesis
     UpdateStreamModeInput.add_member(:warm_throughput_mi_bps, Shapes::ShapeRef.new(shape: NaturalIntegerObject, location_name: "WarmThroughputMiBps"))
     UpdateStreamModeInput.struct_class = Types::UpdateStreamModeInput
 
+    UpdateStreamRecordDistributionStrategyInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: StreamARN, required: true, location_name: "StreamARN", metadata: {"contextParam" => {"name" => "StreamARN"}}))
+    UpdateStreamRecordDistributionStrategyInput.add_member(:stream_id, Shapes::ShapeRef.new(shape: StreamId, location_name: "StreamId", metadata: {"contextParam" => {"name" => "StreamId"}}))
+    UpdateStreamRecordDistributionStrategyInput.add_member(:record_distribution_strategy, Shapes::ShapeRef.new(shape: RecordDistributionStrategy, required: true, location_name: "RecordDistributionStrategy"))
+    UpdateStreamRecordDistributionStrategyInput.struct_class = Types::UpdateStreamRecordDistributionStrategyInput
+
     UpdateStreamWarmThroughputInput.add_member(:stream_arn, Shapes::ShapeRef.new(shape: StreamARN, location_name: "StreamARN", metadata: {"contextParam" => {"name" => "StreamARN"}}))
     UpdateStreamWarmThroughputInput.add_member(:stream_name, Shapes::ShapeRef.new(shape: StreamName, location_name: "StreamName"))
     UpdateStreamWarmThroughputInput.add_member(:stream_id, Shapes::ShapeRef.new(shape: StreamId, location_name: "StreamId", metadata: {"contextParam" => {"name" => "StreamId"}}))
@@ -1585,6 +1594,20 @@ module Aws::Kinesis
         o.errors << Shapes::ShapeRef.new(shape: ValidationException)
       end)
 
+      api.add_operation(:update_stream_record_distribution_strategy, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateStreamRecordDistributionStrategy"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: UpdateStreamRecordDistributionStrategyInput)
+        o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidArgumentException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceInUseException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+      end)
+
       api.add_operation(:update_stream_warm_throughput, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdateStreamWarmThroughput"
         o.http_method = "POST"

data/lib/aws-sdk-kinesis/endpoints.rb

@@ -470,6 +470,17 @@ module Aws::Kinesis
       end
     end
 
+    class UpdateStreamRecordDistributionStrategy
+      def self.build(context)
+        Aws::Kinesis::EndpointParameters.create(
+          context.config,
+          operation_type: "control",
+          stream_id: context.params[:stream_id],
+          stream_arn: context.params[:stream_arn],
+        )
+      end
+    end
+
     class UpdateStreamWarmThroughput
       def self.build(context)
         Aws::Kinesis::EndpointParameters.create(
@@ -570,6 +581,8 @@ module Aws::Kinesis
         UpdateShardCount.build(context)
       when :update_stream_mode
         UpdateStreamMode.build(context)
+      when :update_stream_record_distribution_strategy
+        UpdateStreamRecordDistributionStrategy.build(context)
       when :update_stream_warm_throughput
         UpdateStreamWarmThroughput.build(context)
       else

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

@@ -113,7 +113,9 @@ module Aws::Kinesis
     #   @return [Types::S3TablesDestinationDescription]
     #
     # @!attribute [rw] encryption_configuration
-    #   The server-side encryption configuration for the channel.
+    #   The Amazon Web Services KMS key configuration that Amazon Kinesis
+    #   Data Streams uses to encrypt data delivered to the channel's
+    #   destination.
     #   @return [Types::ChannelEncryptionConfiguration]
     #
     # @!attribute [rw] logging_configuration
@@ -179,7 +181,8 @@ module Aws::Kinesis
     # in UpdateChannel.
     #
     # @!attribute [rw] cloud_watch_logs
-    #   The updated Amazon CloudWatch Logs settings for the channel.
+    #   The updated Amazon CloudWatch Logs settings, including whether
+    #   logging is enabled and the target log group and log stream.
     #   @return [Types::CloudWatchLogsUpdateInput]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/ChannelLoggingUpdateInput AWS API Documentation
@@ -488,15 +491,14 @@ module Aws::Kinesis
     #
     # @!attribute [rw] s3_destination_configuration
     #   The configuration for delivery to a general purpose Amazon S3
-    #   bucket. You must specify either `S3DestinationConfiguration` or
-    #   `S3TablesDestinationConfiguration`, but not both.
+    #   bucket. Specify this parameter when
+    #   `S3TablesDestinationConfiguration` is not specified.
     #   @return [Types::S3DestinationConfiguration]
     #
     # @!attribute [rw] s3_tables_destination_configuration
     #   The configuration for delivery to streaming tables on Apache Iceberg
-    #   in Amazon S3 Tables. You must specify either
-    #   `S3DestinationConfiguration` or `S3TablesDestinationConfiguration`,
-    #   but not both.
+    #   in Amazon S3 Tables. Specify this parameter when
+    #   `S3DestinationConfiguration` is not specified.
     #   @return [Types::S3TablesDestinationConfiguration]
     #
     # @!attribute [rw] encryption_configuration
@@ -529,7 +531,9 @@ module Aws::Kinesis
     end
 
     # @!attribute [rw] channel_description
-    #   The configuration and current status of the channel.
+    #   The configuration and current status of the channel, including its
+    #   ARN, destination configuration, and lifecycle state. Immediately
+    #   after creation, the state is `CREATING`.
     #   @return [Types::ChannelDescription]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/CreateChannelOutput AWS API Documentation
@@ -580,6 +584,25 @@ module Aws::Kinesis
     #   you can write to, and read from a stream.
     #   @return [Integer]
     #
+    # @!attribute [rw] record_distribution_strategy
+    #   The record distribution strategy for the stream, which determines
+    #   how Amazon Kinesis Data Streams distributes records across shards.
+    #   Specify one of the following values:
+    #
+    #   * `AUTO` – Amazon Kinesis Data Streams distributes records evenly
+    #     across shards and ignores any partition key and `ExplicitHashKey`
+    #     that producers supply. Use this value for stateless workloads that
+    #     do not require partition-key ordering.
+    #
+    #   * `USER_PARTITION_KEY` – Producers must supply a partition key,
+    #     which Amazon Kinesis Data Streams uses to determine shard
+    #     placement. This is the default.
+    #
+    #   The record distribution strategy is only supported for streams that
+    #   use the on-demand capacity mode. If you do not specify this
+    #   parameter, the stream uses `USER_PARTITION_KEY`.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/CreateStreamInput AWS API Documentation
     #
     class CreateStreamInput < Struct.new(
@@ -588,7 +611,8 @@ module Aws::Kinesis
       :stream_mode_details,
       :tags,
       :warm_throughput_mi_bps,
-      :max_record_size_in_ki_b)
+      :max_record_size_in_ki_b,
+      :record_distribution_strategy)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -780,7 +804,8 @@ module Aws::Kinesis
     end
 
     # @!attribute [rw] channel_description
-    #   The configuration and current status of the channel.
+    #   The configuration and current status of the channel, including its
+    #   ARN, source stream, destination configuration, and lifecycle state.
     #   @return [Types::ChannelDescription]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/DescribeChannelOutput AWS API Documentation
@@ -1618,8 +1643,7 @@ module Aws::Kinesis
     #
     # @!attribute [rw] next_token
     #   The pagination token returned by a previous call. Specify this token
-    #   to retrieve the next page of results. This value is `null` when
-    #   there are no more results to return.
+    #   to retrieve the next page of results.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/ListChannelsInput AWS API Documentation
@@ -2226,6 +2250,15 @@ module Aws::Kinesis
     #   values and to map associated data records to shards. As a result of
     #   this hashing mechanism, all data records with the same partition key
     #   map to the same shard within the stream.
+    #
+    #   If the stream uses the `USER_PARTITION_KEY` record distribution
+    #   strategy (the default), a partition key is required. If the stream
+    #   uses the `AUTO` record distribution strategy, the partition key is
+    #   optional and any value you provide is ignored, along with any
+    #   `ExplicitHashKey` you provide. In that case, Amazon Kinesis Data
+    #   Streams distributes the record across shards using service-managed
+    #   algorithms. For more information, see
+    #   `UpdateStreamRecordDistributionStrategy`.
     #   @return [String]
     #
     # @!attribute [rw] explicit_hash_key
@@ -2397,6 +2430,15 @@ module Aws::Kinesis
     #   values and to map associated data records to shards. As a result of
     #   this hashing mechanism, all data records with the same partition key
     #   map to the same shard within the stream.
+    #
+    #   If the stream uses the `USER_PARTITION_KEY` record distribution
+    #   strategy (the default), a partition key is required for each record.
+    #   If the stream uses the `AUTO` record distribution strategy, the
+    #   partition key is optional and any value you provide is ignored,
+    #   along with any `ExplicitHashKey` you provide. In that case, Amazon
+    #   Kinesis Data Streams distributes records across shards using
+    #   service-managed algorithms. For more information, see
+    #   `UpdateStreamRecordDistributionStrategy`.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/PutRecordsRequestEntry AWS API Documentation
@@ -2493,6 +2535,12 @@ module Aws::Kinesis
     #
     # @!attribute [rw] partition_key
     #   Identifies which shard in the stream the data record is assigned to.
+    #
+    #   For a stream that uses the `AUTO` record distribution strategy, this
+    #   value is not returned if the producer did not provide a partition
+    #   key when writing the record. If the producer provided a partition
+    #   key, the original value is returned even though it was not used to
+    #   determine shard placement.
     #   @return [String]
     #
     # @!attribute [rw] encryption_type
@@ -2538,8 +2586,7 @@ module Aws::Kinesis
     # @!attribute [rw] gsr_schema_arn
     #   The Amazon Resource Name (ARN) of the Amazon Web Services Glue
     #   Schema Registry schema used to validate records. Required when the
-    #   channel destination is a streaming table (Amazon S3 Tables), for
-    #   both the `JSON` and `GSR_JSON` record formats.
+    #   channel destination is a streaming table.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/RecordConfiguration AWS API Documentation
@@ -2667,8 +2714,8 @@ module Aws::Kinesis
     # Used in CreateChannel.
     #
     # @!attribute [rw] data_freshness_in_seconds
-    #   The maximum age, in seconds, of undelivered data. Valid range is 300
-    #   to 900 seconds (5 to 15 minutes). The default value is 300 seconds.
+    #   The maximum age, in seconds, of undelivered data before the channel
+    #   delivers it to the destination. The default value is 300 seconds.
     #   @return [Integer]
     #
     # @!attribute [rw] dead_letter_queue_s3_configuration
@@ -2722,8 +2769,8 @@ module Aws::Kinesis
     # Used in UpdateChannel. Only `DataFreshnessInSeconds` can be updated.
     #
     # @!attribute [rw] data_freshness_in_seconds
-    #   The maximum age, in seconds, of undelivered data. Valid range is 300
-    #   to 900 seconds (5 to 15 minutes).
+    #   The maximum age, in seconds, of undelivered data before the channel
+    #   delivers it to the destination.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/S3DestinationUpdateInput AWS API Documentation
@@ -2755,8 +2802,8 @@ module Aws::Kinesis
     # @!attribute [rw] storage_class
     #   The Amazon S3 storage class for delivered objects. Valid values:
     #
-    #   * `STANDARD` - Default storage class for frequently accessed data.
-    #     (default)
+    #   * `STANDARD` - The default storage class, for frequently accessed
+    #     data.
     #
     #   * `INTELLIGENT_TIERING` - Automatically moves objects to the most
     #     cost-effective access tier based on usage patterns.
@@ -2832,8 +2879,8 @@ module Aws::Kinesis
     # Used in CreateChannel.
     #
     # @!attribute [rw] data_freshness_in_seconds
-    #   The maximum age, in seconds, of undelivered data. Valid range is 300
-    #   to 900 seconds (5 to 15 minutes). The default value is 300 seconds.
+    #   The maximum age, in seconds, of undelivered data before the channel
+    #   delivers it to the destination. The default value is 300 seconds.
     #   @return [Integer]
     #
     # @!attribute [rw] dead_letter_queue_s3_configuration
@@ -2886,8 +2933,8 @@ module Aws::Kinesis
     # UpdateChannel. Only `DataFreshnessInSeconds` can be updated.
     #
     # @!attribute [rw] data_freshness_in_seconds
-    #   The maximum age, in seconds, of undelivered data. Valid range is 300
-    #   to 900 seconds (5 to 15 minutes).
+    #   The maximum age, in seconds, of undelivered data before the channel
+    #   delivers it to the destination.
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/S3TablesDestinationUpdateInput AWS API Documentation
@@ -3416,6 +3463,15 @@ module Aws::Kinesis
     #   The number of channels associated with the stream.
     #   @return [Integer]
     #
+    # @!attribute [rw] record_distribution_strategy
+    #   The record distribution strategy that the stream currently uses. A
+    #   value of `AUTO` indicates that Amazon Kinesis Data Streams
+    #   distributes records across shards using service-managed algorithms.
+    #   A value of `USER_PARTITION_KEY` indicates that shard placement is
+    #   determined by the partition key that producers supply. This field is
+    #   only present for streams that use the on-demand capacity mode.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/StreamDescriptionSummary AWS API Documentation
     #
     class StreamDescriptionSummary < Struct.new(
@@ -3433,7 +3489,8 @@ module Aws::Kinesis
       :consumer_count,
       :warm_throughput,
       :max_record_size_in_ki_b,
-      :channel_count)
+      :channel_count,
+      :record_distribution_strategy)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3710,12 +3767,16 @@ module Aws::Kinesis
     #
     # @!attribute [rw] s3_destination_configuration
     #   The updated configuration for a general purpose Amazon S3
-    #   destination. Only `DataFreshnessInSeconds` can be updated.
+    #   destination. Specify this parameter when the channel delivers to a
+    #   general purpose Amazon S3 bucket. Only `DataFreshnessInSeconds` can
+    #   be updated.
     #   @return [Types::S3DestinationUpdateInput]
     #
     # @!attribute [rw] s3_tables_destination_configuration
-    #   The updated configuration for a streaming table destination. Only
-    #   `DataFreshnessInSeconds` can be updated.
+    #   The updated configuration for a streaming table destination. Specify
+    #   this parameter when the channel delivers to streaming tables on
+    #   Apache Iceberg in Amazon S3 Tables. Only `DataFreshnessInSeconds`
+    #   can be updated.
     #   @return [Types::S3TablesDestinationUpdateInput]
     #
     # @!attribute [rw] logging_configuration
@@ -3734,7 +3795,9 @@ module Aws::Kinesis
     end
 
     # @!attribute [rw] channel_description
-    #   The configuration and current status of the updated channel.
+    #   The configuration and current status of the channel after the
+    #   update, including its ARN, destination configuration, and lifecycle
+    #   state. Immediately after the request, the state is `UPDATING`.
     #   @return [Types::ChannelDescription]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/UpdateChannelOutput AWS API Documentation
@@ -3877,6 +3940,37 @@ module Aws::Kinesis
       include Aws::Structure
     end
 
+    # @!attribute [rw] stream_arn
+    #   The Amazon Resource Name (ARN) of the stream to update.
+    #   @return [String]
+    #
+    # @!attribute [rw] stream_id
+    #   Not Implemented. Reserved for future use.
+    #   @return [String]
+    #
+    # @!attribute [rw] record_distribution_strategy
+    #   The record distribution strategy to apply to the stream. Specify one
+    #   of the following values:
+    #
+    #   * `AUTO` – Amazon Kinesis Data Streams distributes records evenly
+    #     across shards and ignores any partition key and `ExplicitHashKey`
+    #     that producers supply.
+    #
+    #   * `USER_PARTITION_KEY` – Producers must supply a partition key,
+    #     which Amazon Kinesis Data Streams uses to determine shard
+    #     placement. This is the default.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/UpdateStreamRecordDistributionStrategyInput AWS API Documentation
+    #
+    class UpdateStreamRecordDistributionStrategyInput < Struct.new(
+      :stream_arn,
+      :stream_id,
+      :record_distribution_strategy)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] stream_arn
     #   The ARN of the stream to be updated.
     #   @return [String]

data/lib/aws-sdk-kinesis.rb

@@ -73,7 +73,7 @@ module Aws::Kinesis
   autoload :AsyncClient, 'aws-sdk-kinesis/async_client'
   autoload :EventStreams, 'aws-sdk-kinesis/event_streams'
 
-  GEM_VERSION = '1.108.0'
+  GEM_VERSION = '1.109.0'
 
 end
 

data/sig/client.rbs

@@ -172,7 +172,8 @@ module Aws
                            },
                            ?tags: Hash[::String, ::String],
                            ?warm_throughput_mi_bps: ::Integer,
-                           ?max_record_size_in_ki_b: ::Integer
+                           ?max_record_size_in_ki_b: ::Integer,
+                           ?record_distribution_strategy: ("AUTO" | "USER_PARTITION_KEY")
                          ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
                        | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
 
@@ -490,7 +491,7 @@ module Aws
       def put_record: (
                         ?stream_name: ::String,
                         data: ::String,
-                        partition_key: ::String,
+                        ?partition_key: ::String,
                         ?explicit_hash_key: ::String,
                         ?sequence_number_for_ordering: ::String,
                         ?stream_arn: ::String,
@@ -511,7 +512,7 @@ module Aws
                            {
                              data: ::String,
                              explicit_hash_key: ::String?,
-                             partition_key: ::String
+                             partition_key: ::String?
                            }
                          ],
                          ?stream_name: ::String,
@@ -668,6 +669,14 @@ module Aws
                               ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
                             | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
 
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Kinesis/Client.html#update_stream_record_distribution_strategy-instance_method
+      def update_stream_record_distribution_strategy: (
+                                                        stream_arn: ::String,
+                                                        ?stream_id: ::String,
+                                                        record_distribution_strategy: ("AUTO" | "USER_PARTITION_KEY")
+                                                      ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
+                                                    | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
+
       interface _UpdateStreamWarmThroughputResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::UpdateStreamWarmThroughputOutput]
         def stream_arn: () -> ::String

data/sig/types.rbs

@@ -146,6 +146,7 @@ module Aws::Kinesis
       attr_accessor tags: ::Hash[::String, ::String]
       attr_accessor warm_throughput_mi_bps: ::Integer
       attr_accessor max_record_size_in_ki_b: ::Integer
+      attr_accessor record_distribution_strategy: ("AUTO" | "USER_PARTITION_KEY")
       SENSITIVE: []
     end
 
@@ -789,6 +790,7 @@ module Aws::Kinesis
       attr_accessor warm_throughput: Types::WarmThroughputObject
       attr_accessor max_record_size_in_ki_b: ::Integer
       attr_accessor channel_count: ::Integer
+      attr_accessor record_distribution_strategy: ("AUTO" | "USER_PARTITION_KEY")
       SENSITIVE: []
     end
 
@@ -910,6 +912,13 @@ module Aws::Kinesis
       SENSITIVE: []
     end
 
+    class UpdateStreamRecordDistributionStrategyInput
+      attr_accessor stream_arn: ::String
+      attr_accessor stream_id: ::String
+      attr_accessor record_distribution_strategy: ("AUTO" | "USER_PARTITION_KEY")
+      SENSITIVE: []
+    end
+
     class UpdateStreamWarmThroughputInput
       attr_accessor stream_arn: ::String
       attr_accessor stream_name: ::String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-kinesis
 version: !ruby/object:Gem::Version
-  version: 1.108.0
+  version: 1.109.0
 platform: ruby
 authors:
 - Amazon Web Services