aws-sdk-kinesis 1.24.1 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ba4e8c14caa0cfe0abfbcd2731482d9ec682ef757a504720b6c85cdc1aca4a8
-  data.tar.gz: 5d0b6011eb09693dfcd138595c21d4f03c7d94c87c3a7d27a077b5b5af088a80
+  metadata.gz: 4d3e41e8ad4f80e3a6ad6e48be27974af9f4d40b742fc46dc33ece3e9cf2e46a
+  data.tar.gz: 81e9c3d4961f695133a02cb823a505f3835fce4a61c71ff460be696eec6e5c33
 SHA512:
-  metadata.gz: fba20d0897358701b310fc0dc6f3922bdb34d23901661dc49e9e2f28db959b06038b6e59557570317b77729a8ff9002868ee9ce5c9f917c5b41964161159071b
-  data.tar.gz: 685b57bd16364d77729cdd355ff3e97584f82fed1acb0fb031939f735fb9d2df6e4c2a7cf6b3ee7ea3369a2fa5396b299f520c25ac68ee592dd9a4f88654d45c
+  metadata.gz: 35304dc1b103d8e2958fcbe7b4a277e04b71922a6671984fb4ed76745b21777e1427682a63b8c7fc871cab73257a74e6a1943fd47ffc10513d35240800a20538
+  data.tar.gz: 04a30da97531424782644cb177a11eac471b510990d0a3e9bf8635e0f596809687217a2cfc3ef565763c02ae02db86776f11f426d4441d14df60b4d2a33916e0

data/lib/aws-sdk-kinesis.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -5,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -45,9 +48,9 @@ require_relative 'aws-sdk-kinesis/event_streams'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::Kinesis
 
-  GEM_VERSION = '1.24.1'
+  GEM_VERSION = '1.29.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -66,13 +68,28 @@ module Aws::Kinesis
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -82,10 +99,10 @@ module Aws::Kinesis
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -230,19 +247,36 @@ module Aws::Kinesis
 
     # @!group API Operations
 
-    # Call this operation from your consumer after you call
+    # This operation establishes an HTTP/2 connection between the consumer
+    # you specify in the `ConsumerARN` parameter and the shard you specify
+    # in the `ShardId` parameter. After the connection is successfully
+    # established, Kinesis Data Streams pushes records from the shard to the
+    # consumer over this connection. Before you call this operation, call
     # RegisterStreamConsumer to register the consumer with Kinesis Data
-    # Streams. If the call succeeds, your consumer starts receiving events
-    # of type SubscribeToShardEvent for up to 5 minutes, after which time
-    # you need to call `SubscribeToShard` again to renew the subscription if
-    # you want to continue to receive records.
-    #
-    # You can make one call to `SubscribeToShard` per second per
-    # `ConsumerARN`. If your call succeeds, and then you call the operation
-    # again less than 5 seconds later, the second call generates a
-    # ResourceInUseException. If you call the operation a second time more
-    # than 5 seconds after the first call succeeds, the second call succeeds
-    # and the first connection gets shut down.
+    # Streams.
+    #
+    # When the `SubscribeToShard` call succeeds, your consumer starts
+    # receiving events of type SubscribeToShardEvent over the HTTP/2
+    # connection for up to 5 minutes, after which time you need to call
+    # `SubscribeToShard` again to renew the subscription if you want to
+    # continue to receive records.
+    #
+    # You can make one call to `SubscribeToShard` per second per registered
+    # consumer per shard. For example, if you have a 4000 shard stream and
+    # two registered stream consumers, you can make one `SubscribeToShard`
+    # request per second for each combination of shard and registered
+    # consumer, allowing you to subscribe both consumers to all 4000 shards
+    # in one second.
+    #
+    # If you call `SubscribeToShard` again with the same `ConsumerARN` and
+    # `ShardId` within 5 seconds of a successful call, you'll get a
+    # `ResourceInUseException`. If you call `SubscribeToShard` 5 seconds or
+    # more after a successful call, the first connection will expire and the
+    # second call will take over the subscription.
+    #
+    # For an example of how to use this operations, see [Enhanced Fan-Out
+    # Using the Kinesis Data Streams
+    # API](/streams/latest/dev/building-enhanced-consumers-api.html).
     #
     # @option params [required, String] :consumer_arn
     #   For this parameter, use the value you obtained when you called
@@ -454,6 +488,12 @@ module Aws::Kinesis
     #   event.records[0].encryption_type #=> String, one of "NONE", "KMS"
     #   event.continuation_sequence_number #=> String
     #   event.millis_behind_latest #=> Integer
+    #   event.child_shards #=> Array
+    #   event.child_shards[0].shard_id #=> String
+    #   event.child_shards[0].parent_shards #=> Array
+    #   event.child_shards[0].parent_shards[0] #=> String
+    #   event.child_shards[0].hash_key_range.starting_hash_key #=> String
+    #   event.child_shards[0].hash_key_range.ending_hash_key #=> String
     #
     #   For :resource_not_found_exception event available at #on_resource_not_found_exception_event callback and response eventstream enumerator:
     #   event.message #=> String
@@ -518,7 +558,7 @@ module Aws::Kinesis
         http_response: Seahorse::Client::Http::AsyncResponse.new,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesis'
-      context[:gem_version] = '1.24.1'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -85,13 +87,28 @@ module Aws::Kinesis
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +118,10 @@ module Aws::Kinesis
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
+    #       are very aggressive. Construct and pass an instance of
+    #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -377,9 +394,9 @@ module Aws::Kinesis
     #
     # You specify and control the number of shards that a stream is composed
     # of. Each shard can support reads up to five transactions per second,
-    # up to a maximum data read total of 2 MB per second. Each shard can
+    # up to a maximum data read total of 2 MiB per second. Each shard can
     # support writes up to 1,000 records per second, up to a maximum data
-    # write total of 1 MB per second. If the amount of data input increases
+    # write total of 1 MiB per second. If the amount of data input increases
     # or decreases, you can add or remove shards.
     #
     # The stream name identifies the stream. The name is scoped to the AWS
@@ -413,8 +430,8 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
-    # [2]: http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
+    # [2]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
     #
     # @option params [required, String] :stream_name
     #   A name to identify the stream. The stream name is scoped to the AWS
@@ -428,8 +445,6 @@ module Aws::Kinesis
     #   stream is a function of the number of shards; more shards are required
     #   for greater provisioned throughput.
     #
-    #   DefaultShardLimit;
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -537,8 +552,7 @@ module Aws::Kinesis
     # all the consumers that are currently registered with a given data
     # stream. The description of a consumer contains its name and ARN.
     #
-    # This operation has a limit of five transactions per second per
-    # account.
+    # This operation has a limit of five transactions per second per stream.
     #
     # @option params [String] :stream_arn
     #   The ARN of the Kinesis data stream that the consumer is registered
@@ -628,7 +642,7 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-retrieve-shards.html
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-retrieve-shards.html
     #
     # @option params [required, String] :stream_name
     #   The name of the stream to describe.
@@ -701,7 +715,7 @@ module Aws::Kinesis
     # operation to get a list of the descriptions of all the consumers that
     # are currently registered with a given data stream.
     #
-    # This operation has a limit of 20 transactions per second per account.
+    # This operation has a limit of 20 transactions per second per stream.
     #
     # @option params [String] :stream_arn
     #   The ARN of the Kinesis data stream that the consumer is registered
@@ -755,6 +769,9 @@ module Aws::Kinesis
     # Name (ARN), status, record retention period, approximate creation
     # time, monitoring, encryption details, and open shard count.
     #
+    # DescribeStreamSummary has a limit of 20 transactions per second per
+    # account.
+    #
     # @option params [required, String] :stream_name
     #   The name of the stream to describe.
     #
@@ -826,7 +843,7 @@ module Aws::Kinesis
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
+    #   [1]: https://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
     #
     # @return [Types::EnhancedMonitoringOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -892,7 +909,7 @@ module Aws::Kinesis
     #
     #
     #
-    #   [1]: http://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
+    #   [1]: https://docs.aws.amazon.com/kinesis/latest/dev/monitoring-with-cloudwatch.html
     #
     # @return [Types::EnhancedMonitoringOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -983,13 +1000,12 @@ module Aws::Kinesis
     # always increasing. For example, records in a shard or across a stream
     # might have time stamps that are out of order.
     #
-    # This operation has a limit of five transactions per second per
-    # account.
+    # This operation has a limit of five transactions per second per shard.
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
-    # [2]: http://docs.aws.amazon.com/kinesis/latest/dev/monitoring.html
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
+    # [2]: https://docs.aws.amazon.com/kinesis/latest/dev/monitoring.html
     #
     # @option params [required, String] :shard_iterator
     #   The position in the shard from which you want to start sequentially
@@ -999,13 +1015,14 @@ module Aws::Kinesis
     # @option params [Integer] :limit
     #   The maximum number of records to return. Specify a value of up to
     #   10,000. If you specify a value that is greater than 10,000, GetRecords
-    #   throws `InvalidArgumentException`.
+    #   throws `InvalidArgumentException`. The default value is 10,000.
     #
     # @return [Types::GetRecordsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetRecordsOutput#records #records} => Array<Types::Record>
     #   * {Types::GetRecordsOutput#next_shard_iterator #next_shard_iterator} => String
     #   * {Types::GetRecordsOutput#millis_behind_latest #millis_behind_latest} => Integer
+    #   * {Types::GetRecordsOutput#child_shards #child_shards} => Array<Types::ChildShard>
     #
     # @example Request syntax with placeholder values
     #
@@ -1024,6 +1041,12 @@ module Aws::Kinesis
     #   resp.records[0].encryption_type #=> String, one of "NONE", "KMS"
     #   resp.next_shard_iterator #=> String
     #   resp.millis_behind_latest #=> Integer
+    #   resp.child_shards #=> Array
+    #   resp.child_shards[0].shard_id #=> String
+    #   resp.child_shards[0].parent_shards #=> Array
+    #   resp.child_shards[0].parent_shards[0] #=> String
+    #   resp.child_shards[0].hash_key_range.starting_hash_key #=> String
+    #   resp.child_shards[0].hash_key_range.ending_hash_key #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/GetRecords AWS API Documentation
     #
@@ -1079,7 +1102,7 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
     #
     # @option params [required, String] :stream_name
     #   The name of the Amazon Kinesis data stream.
@@ -1250,7 +1273,7 @@ module Aws::Kinesis
     # @option params [Integer] :max_results
     #   The maximum number of shards to return in a single call to
     #   `ListShards`. The minimum value you can specify for this parameter is
-    #   1, and the maximum is 1,000, which is also the default.
+    #   1, and the maximum is 10,000, which is also the default.
     #
     #   When the number of shards to be listed is greater than the value of
     #   `MaxResults`, the response contains a `NextToken` value that you can
@@ -1267,6 +1290,8 @@ module Aws::Kinesis
     #   You cannot specify this parameter if you specify the `NextToken`
     #   parameter.
     #
+    # @option params [Types::ShardFilter] :shard_filter
+    #
     # @return [Types::ListShardsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListShardsOutput#shards #shards} => Array<Types::Shard>
@@ -1280,6 +1305,11 @@ module Aws::Kinesis
     #     exclusive_start_shard_id: "ShardId",
     #     max_results: 1,
     #     stream_creation_timestamp: Time.now,
+    #     shard_filter: {
+    #       type: "AFTER_SHARD_ID", # required, accepts AFTER_SHARD_ID, AT_TRIM_HORIZON, FROM_TRIM_HORIZON, AT_LATEST, AT_TIMESTAMP, FROM_TIMESTAMP
+    #       shard_id: "ShardId",
+    #       timestamp: Time.now,
+    #     },
     #   })
     #
     # @example Response structure
@@ -1306,7 +1336,7 @@ module Aws::Kinesis
     # Lists the consumers registered to receive data from a stream using
     # enhanced fan-out, and provides information about each consumer.
     #
-    # This operation has a limit of 10 transactions per second per account.
+    # This operation has a limit of 5 transactions per second per stream.
     #
     # @option params [required, String] :stream_arn
     #   The ARN of the Kinesis data stream for which you want to list the
@@ -1535,7 +1565,7 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-merge.html
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-merge.html
     #
     # @option params [required, String] :stream_name
     #   The name of the stream for the merge.
@@ -1570,7 +1600,7 @@ module Aws::Kinesis
     # `PutRecord` to send data into the stream for real-time ingestion and
     # subsequent processing, one record at a time. Each shard can support
     # writes up to 1,000 records per second, up to a maximum data write
-    # total of 1 MB per second.
+    # total of 1 MiB per second.
     #
     # You must specify the name of the stream that captures, stores, and
     # transports the data; a partition key; and the data blob itself.
@@ -1604,6 +1634,9 @@ module Aws::Kinesis
     # [Adding Data to a Stream][1] in the *Amazon Kinesis Data Streams
     # Developer Guide*.
     #
+    # After you write a record to a stream, you cannot modify that record or
+    # its order within the stream.
+    #
     # If a `PutRecord` request cannot be processed because of insufficient
     # provisioned throughput on the shard involved in the request,
     # `PutRecord` throws `ProvisionedThroughputExceededException`.
@@ -1615,16 +1648,16 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
     #
     # @option params [required, String] :stream_name
     #   The name of the stream to put the data record into.
     #
-    # @option params [required, String, IO] :data
+    # @option params [required, String, StringIO, File] :data
     #   The data blob to put into the record, which is base64-encoded when the
     #   blob is serialized. When the data blob (the payload before
     #   base64-encoding) is added to the partition key size, the total size
-    #   must not exceed the maximum record size (1 MB).
+    #   must not exceed the maximum record size (1 MiB).
     #
     # @option params [required, String] :partition_key
     #   Determines which shard in the stream the data record is assigned to.
@@ -1685,10 +1718,10 @@ module Aws::Kinesis
     # to send data into the stream for data ingestion and processing.
     #
     # Each `PutRecords` request can support up to 500 records. Each record
-    # in the request can be as large as 1 MB, up to a limit of 5 MB for the
-    # entire request, including partition keys. Each shard can support
+    # in the request can be as large as 1 MiB, up to a limit of 5 MiB for
+    # the entire request, including partition keys. Each shard can support
     # writes up to 1,000 records per second, up to a maximum data write
-    # total of 1 MB per second.
+    # total of 1 MiB per second.
     #
     # You must specify the name of the stream that captures, stores, and
     # transports the data; and an array of request `Records`, with each
@@ -1725,7 +1758,10 @@ module Aws::Kinesis
     # The response `Records` array includes both successfully and
     # unsuccessfully processed records. Kinesis Data Streams attempts to
     # process all records in each `PutRecords` request. A single record
-    # failure does not stop the processing of subsequent records.
+    # failure does not stop the processing of subsequent records. As a
+    # result, PutRecords doesn't guarantee the ordering of records. If you
+    # need to read records in the same order they are written to the stream,
+    # use PutRecord instead of `PutRecords`, and write to the same shard.
     #
     # A successfully processed record includes `ShardId` and
     # `SequenceNumber` values. The `ShardId` parameter identifies the shard
@@ -1744,6 +1780,9 @@ module Aws::Kinesis
     # see [Adding Multiple Records with PutRecords][3] in the *Amazon
     # Kinesis Data Streams Developer Guide*.
     #
+    # After you write a record to a stream, you cannot modify that record or
+    # its order within the stream.
+    #
     # By default, data records are accessible for 24 hours from the time
     # that they are added to a stream. You can use
     # IncreaseStreamRetentionPeriod or DecreaseStreamRetentionPeriod to
@@ -1751,9 +1790,9 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
-    # [2]: http://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-putrecords
-    # [3]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-add-data-to-stream.html#kinesis-using-sdk-java-putrecords
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-add-data-to-stream
+    # [2]: https://docs.aws.amazon.com/kinesis/latest/dev/developing-producers-with-sdk.html#kinesis-using-sdk-java-putrecords
+    # [3]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-add-data-to-stream.html#kinesis-using-sdk-java-putrecords
     #
     # @option params [required, Array<Types::PutRecordsRequestEntry>] :records
     #   The records associated with the request.
@@ -1800,15 +1839,24 @@ module Aws::Kinesis
     end
 
     # Registers a consumer with a Kinesis data stream. When you use this
-    # operation, the consumer you register can read data from the stream at
-    # a rate of up to 2 MiB per second. This rate is unaffected by the total
-    # number of consumers that read from the same stream.
+    # operation, the consumer you register can then call SubscribeToShard to
+    # receive data from the stream using enhanced fan-out, at a rate of up
+    # to 2 MiB per second for every shard you subscribe to. This rate is
+    # unaffected by the total number of consumers that read from the same
+    # stream.
     #
-    # You can register up to 5 consumers per stream. A given consumer can
-    # only be registered with one stream.
+    # You can register up to 20 consumers per stream. A given consumer can
+    # only be registered with one stream at a time.
     #
-    # This operation has a limit of five transactions per second per
-    # account.
+    # For an example of how to use this operations, see [Enhanced Fan-Out
+    # Using the Kinesis Data Streams
+    # API](/streams/latest/dev/building-enhanced-consumers-api.html).
+    #
+    # The use of this operation has a limit of five transactions per second
+    # per account. Also, only 5 consumers can be created simultaneously. In
+    # other words, you cannot have more than 5 consumers in a `CREATING`
+    # status at the same time. Registering a 6th consumer while there are 5
+    # in a `CREATING` status results in a `LimitExceededException`.
     #
     # @option params [required, String] :stream_arn
     #   The ARN of the Kinesis data stream that you want to register the
@@ -1937,9 +1985,9 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-split.html
-    # [2]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
-    # [3]: http://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/kinesis-using-sdk-java-resharding-split.html
+    # [2]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
+    # [3]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html
     #
     # @option params [required, String] :stream_name
     #   The name of the stream for the shard split.
@@ -2120,14 +2168,19 @@ module Aws::Kinesis
     #
     # To update the shard count, Kinesis Data Streams performs splits or
     # merges on individual shards. This can cause short-lived shards to be
-    # created, in addition to the final shards. We recommend that you double
-    # or halve the shard count, as this results in the fewest number of
-    # splits or merges.
+    # created, in addition to the final shards. These short-lived shards
+    # count towards your total shard limit for your account in the Region.
+    #
+    # When using this operation, we recommend that you specify a target
+    # shard count that is a multiple of 25% (25%, 50%, 75%, 100%). You can
+    # specify any target value within your shard limit. However, if you
+    # specify a target that isn't a multiple of 25%, the scaling action
+    # might take longer to complete.
     #
     # This operation has the following default limits. By default, you
     # cannot do the following:
     #
-    # * Scale more than twice per rolling 24-hour period per stream
+    # * Scale more than ten times per rolling 24-hour period per stream
     #
     # * Scale up to more than double your current shard count for a stream
     #
@@ -2147,14 +2200,27 @@ module Aws::Kinesis
     #
     #
     #
-    # [1]: http://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
+    # [1]: https://docs.aws.amazon.com/kinesis/latest/dev/service-sizes-and-limits.html
     # [2]: https://console.aws.amazon.com/support/v1#/case/create?issueType=service-limit-increase&amp;limitType=service-code-kinesis
     #
     # @option params [required, String] :stream_name
     #   The name of the stream.
     #
     # @option params [required, Integer] :target_shard_count
-    #   The new number of shards.
+    #   The new number of shards. This value has the following default limits.
+    #   By default, you cannot do the following:
+    #
+    #   * Set this value to more than double your current shard count for a
+    #     stream.
+    #
+    #   * Set this value below half your current shard count for a stream.
+    #
+    #   * Set this value to more than 500 shards in a stream (the default
+    #     limit for shard count per stream is 500 per account per region),
+    #     unless you request a limit increase.
+    #
+    #   * Scale a stream with more than 500 shards down unless you set this
+    #     value to less than 500 shards.
     #
     # @option params [required, String] :scaling_type
     #   The scaling type. Uniform scaling creates shards of equal size.
@@ -2201,7 +2267,7 @@ module Aws::Kinesis
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesis'
-      context[:gem_version] = '1.24.1'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end