aws-sdk-kinesis 1.36.0 → 1.40.0

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

@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 require 'aws-sdk-core/plugins/event_stream_configuration.rb'
@@ -74,6 +76,8 @@ module Aws::Kinesis
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
     add_plugin(Aws::Plugins::EventStreamConfiguration)
@@ -121,7 +125,9 @@ module Aws::Kinesis
     #     * 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.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -175,6 +181,10 @@ module Aws::Kinesis
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -296,6 +306,15 @@ module Aws::Kinesis
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Boolean] :use_dualstack_endpoint
+    #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
+    #     will be used if available.
+    #
+    #   @option options [Boolean] :use_fips_endpoint
+    #     When set to `true`, fips compatible endpoints will be used if available.
+    #     When a `fips` region is used, the region is normalized and this config
+    #     is set to `true`.
+    #
     #   @option options [Boolean] :validate_params (true)
     #     When `true`, request parameters are validated before
     #     sending the request.
@@ -307,7 +326,7 @@ module Aws::Kinesis
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -323,6 +342,9 @@ module Aws::Kinesis
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -348,10 +370,8 @@ module Aws::Kinesis
 
     # @!group API Operations
 
-    # Adds or updates tags for the specified Kinesis data stream. Each time
-    # you invoke this operation, you can specify up to 10 tags. If you want
-    # to add more than 10 tags to your stream, you can invoke this operation
-    # multiple times. In total, each stream can have up to 50 tags.
+    # Adds or updates tags for the specified Kinesis data stream. You can
+    # assign up to 50 tags to a data stream.
     #
     # If tags have already been assigned to the stream, `AddTagsToStream`
     # overwrites any existing tags that correspond to the specified tag
@@ -399,11 +419,11 @@ module Aws::Kinesis
     # 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
-    # account used by the application. It is also scoped by AWS Region. That
-    # is, two streams in two different accounts can have the same name, and
-    # two streams in the same account, but in two different Regions, can
-    # have the same name.
+    # The stream name identifies the stream. The name is scoped to the
+    # Amazon Web Services account used by the application. It is also scoped
+    # by Amazon Web Services Region. That is, two streams in two different
+    # accounts can have the same name, and two streams in the same account,
+    # but in two different Regions, can have the same name.
     #
     # `CreateStream` is an asynchronous operation. Upon receiving a
     # `CreateStream` request, Kinesis Data Streams immediately returns and
@@ -419,11 +439,12 @@ module Aws::Kinesis
     #
     # * Create more shards than are authorized for your account.
     #
-    # For the default shard limit for an AWS account, see [Amazon Kinesis
-    # Data Streams Limits][1] in the *Amazon Kinesis Data Streams Developer
-    # Guide*. To increase this limit, [contact AWS Support][2].
+    # For the default shard limit for an Amazon Web Services account, see
+    # [Amazon Kinesis Data Streams Limits][1] in the *Amazon Kinesis Data
+    # Streams Developer Guide*. To increase this limit, [contact Amazon Web
+    # Services Support][2].
     #
-    # You can use `DescribeStream` to check the stream status, which is
+    # You can use DescribeStreamSummary to check the stream status, which is
     # returned in `StreamStatus`.
     #
     # CreateStream has a limit of five transactions per second per account.
@@ -434,24 +455,33 @@ module Aws::Kinesis
     # [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
-    #   account used by the application that creates the stream. It is also
-    #   scoped by AWS Region. That is, two streams in two different AWS
-    #   accounts can have the same name. Two streams in the same AWS account
-    #   but in two different Regions can also have the same name.
-    #
-    # @option params [required, Integer] :shard_count
+    #   A name to identify the stream. The stream name is scoped to the Amazon
+    #   Web Services account used by the application that creates the stream.
+    #   It is also scoped by Amazon Web Services Region. That is, two streams
+    #   in two different Amazon Web Services accounts can have the same name.
+    #   Two streams in the same Amazon Web Services account but in two
+    #   different Regions can also have the same name.
+    #
+    # @option params [Integer] :shard_count
     #   The number of shards that the stream will use. The throughput of the
     #   stream is a function of the number of shards; more shards are required
     #   for greater provisioned throughput.
     #
+    # @option params [Types::StreamModeDetails] :stream_mode_details
+    #   Indicates the capacity mode of the data stream. Currently, in Kinesis
+    #   Data Streams, you can choose between an **on-demand** capacity mode
+    #   and a **provisioned** capacity mode for your data streams.
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_stream({
     #     stream_name: "StreamName", # required
-    #     shard_count: 1, # required
+    #     shard_count: 1,
+    #     stream_mode_details: {
+    #       stream_mode: "PROVISIONED", # required, accepts PROVISIONED, ON_DEMAND
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/CreateStream AWS API Documentation
@@ -512,8 +542,8 @@ module Aws::Kinesis
     # When you delete a stream, any shards in that stream are also deleted,
     # and any tags are dissociated from the stream.
     #
-    # You can use the DescribeStream operation to check the state of the
-    # stream, which is returned in `StreamStatus`.
+    # You can use the DescribeStreamSummary operation to check the state of
+    # the stream, which is returned in `StreamStatus`.
     #
     # DeleteStream has a limit of five transactions per second per account.
     #
@@ -556,8 +586,8 @@ module Aws::Kinesis
     #
     # @option params [String] :stream_arn
     #   The ARN of the Kinesis data stream that the consumer is registered
-    #   with. For more information, see [Amazon Resource Names (ARNs) and AWS
-    #   Service Namespaces][1].
+    #   with. For more information, see [Amazon Resource Names (ARNs) and
+    #   Amazon Web Services Service Namespaces][1].
     #
     #
     #
@@ -604,11 +634,15 @@ module Aws::Kinesis
     #
     #   * {Types::DescribeLimitsOutput#shard_limit #shard_limit} => Integer
     #   * {Types::DescribeLimitsOutput#open_shard_count #open_shard_count} => Integer
+    #   * {Types::DescribeLimitsOutput#on_demand_stream_count #on_demand_stream_count} => Integer
+    #   * {Types::DescribeLimitsOutput#on_demand_stream_count_limit #on_demand_stream_count_limit} => Integer
     #
     # @example Response structure
     #
     #   resp.shard_limit #=> Integer
     #   resp.open_shard_count #=> Integer
+    #   resp.on_demand_stream_count #=> Integer
+    #   resp.on_demand_stream_count_limit #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/DescribeLimits AWS API Documentation
     #
@@ -621,6 +655,14 @@ module Aws::Kinesis
 
     # Describes the specified Kinesis data stream.
     #
+    # <note markdown="1"> This API has been revised. It's highly recommended that you use the
+    # DescribeStreamSummary API to get a summarized description of the
+    # specified Kinesis data stream and the ListShards API to list the
+    # shards in a specified data stream and obtain information about each
+    # shard.
+    #
+    #  </note>
+    #
     # The information returned includes the stream name, Amazon Resource
     # Name (ARN), creation time, enhanced metric configuration, and shard
     # map. The shard map is an array of shard objects. For each shard
@@ -650,11 +692,19 @@ module Aws::Kinesis
     # @option params [Integer] :limit
     #   The maximum number of shards to return in a single call. The default
     #   value is 100. If you specify a value greater than 100, at most 100
-    #   shards are returned.
+    #   results are returned.
     #
     # @option params [String] :exclusive_start_shard_id
     #   The shard ID of the shard to start with.
     #
+    #   Specify this parameter to indicate that you want to describe the
+    #   stream starting with the shard whose ID immediately follows
+    #   `ExclusiveStartShardId`.
+    #
+    #   If you don't specify this parameter, the default behavior for
+    #   `DescribeStream` is to describe the stream starting with the first
+    #   shard in the stream.
+    #
     # @return [Types::DescribeStreamOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeStreamOutput#stream_description #stream_description} => Types::StreamDescription
@@ -674,6 +724,7 @@ module Aws::Kinesis
     #   resp.stream_description.stream_name #=> String
     #   resp.stream_description.stream_arn #=> String
     #   resp.stream_description.stream_status #=> String, one of "CREATING", "DELETING", "ACTIVE", "UPDATING"
+    #   resp.stream_description.stream_mode_details.stream_mode #=> String, one of "PROVISIONED", "ON_DEMAND"
     #   resp.stream_description.shards #=> Array
     #   resp.stream_description.shards[0].shard_id #=> String
     #   resp.stream_description.shards[0].parent_shard_id #=> String
@@ -719,8 +770,8 @@ module Aws::Kinesis
     #
     # @option params [String] :stream_arn
     #   The ARN of the Kinesis data stream that the consumer is registered
-    #   with. For more information, see [Amazon Resource Names (ARNs) and AWS
-    #   Service Namespaces][1].
+    #   with. For more information, see [Amazon Resource Names (ARNs) and
+    #   Amazon Web Services Service Namespaces][1].
     #
     #
     #
@@ -790,6 +841,7 @@ module Aws::Kinesis
     #   resp.stream_description_summary.stream_name #=> String
     #   resp.stream_description_summary.stream_arn #=> String
     #   resp.stream_description_summary.stream_status #=> String, one of "CREATING", "DELETING", "ACTIVE", "UPDATING"
+    #   resp.stream_description_summary.stream_mode_details.stream_mode #=> String, one of "PROVISIONED", "ON_DEMAND"
     #   resp.stream_description_summary.retention_period_hours #=> Integer
     #   resp.stream_description_summary.stream_creation_timestamp #=> Time
     #   resp.stream_description_summary.enhanced_monitoring #=> Array
@@ -973,9 +1025,12 @@ module Aws::Kinesis
     # The maximum number of records that can be returned per call is 10,000.
     #
     # The size of the data returned by GetRecords varies depending on the
-    # utilization of the shard. The maximum size of data that GetRecords can
-    # return is 10 MiB. If a call returns this amount of data, subsequent
-    # calls made within the next 5 seconds throw
+    # utilization of the shard. It is recommended that consumer applications
+    # retrieve records via the `GetRecords` command using the 5 TPS limit to
+    # remain caught up. Retrieving records less frequently can lead to
+    # consumer applications falling behind. The maximum size of data that
+    # GetRecords can return is 10 MiB. If a call returns this amount of
+    # data, subsequent calls made within the next 5 seconds throw
     # `ProvisionedThroughputExceededException`. If there is insufficient
     # provisioned throughput on the stream, subsequent calls made within the
     # next 1 second throw `ProvisionedThroughputExceededException`.
@@ -1178,8 +1233,8 @@ module Aws::Kinesis
 
     # Increases the Kinesis data stream's retention period, which is the
     # length of time data records are accessible after they are added to the
-    # stream. The maximum value of a stream's retention period is 168 hours
-    # (7 days).
+    # stream. The maximum value of a stream's retention period is 8760
+    # hours (365 days).
     #
     # If you choose a longer stream retention period, this operation
     # increases the time period during which records that have not yet
@@ -1216,18 +1271,23 @@ module Aws::Kinesis
     end
 
     # Lists the shards in a stream and provides information about each
-    # shard. This operation has a limit of 100 transactions per second per
+    # shard. This operation has a limit of 1000 transactions per second per
     # data stream.
     #
+    # This action does not list expired shards. For information about
+    # expired shards, see [Data Routing, Data Persistence, and Shard State
+    # after a Reshard][1].
+    #
     # This API is a new operation that is used by the Amazon Kinesis Client
     # Library (KCL). If you have a fine-grained IAM policy that only allows
     # specific operations, you must update your policy to allow calls to
     # this API. For more information, see [Controlling Access to Amazon
-    # Kinesis Data Streams Resources Using IAM][1].
+    # Kinesis Data Streams Resources Using IAM][2].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/streams/latest/dev/controlling-access.html
+    # [1]: https://docs.aws.amazon.com/streams/latest/dev/kinesis-using-sdk-java-after-resharding.html#kinesis-using-sdk-java-resharding-data-routing
+    # [2]: https://docs.aws.amazon.com/streams/latest/dev/controlling-access.html
     #
     # @option params [String] :stream_name
     #   The name of the data stream whose shards you want to list.
@@ -1272,8 +1332,9 @@ 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 10,000, which is also the default.
+    #   `ListShards`. The maximum number of shards to return in a single call.
+    #   The default value is 1000. If you specify a value greater than 1000,
+    #   at most 1000 results are returned.
     #
     #   When the number of shards to be listed is greater than the value of
     #   `MaxResults`, the response contains a `NextToken` value that you can
@@ -1291,6 +1352,28 @@ module Aws::Kinesis
     #   parameter.
     #
     # @option params [Types::ShardFilter] :shard_filter
+    #   Enables you to filter out the response of the `ListShards` API. You
+    #   can only specify one filter at a time.
+    #
+    #   If you use the `ShardFilter` parameter when invoking the ListShards
+    #   API, the `Type` is the required property and must be specified. If you
+    #   specify the `AT_TRIM_HORIZON`, `FROM_TRIM_HORIZON`, or `AT_LATEST`
+    #   types, you do not need to specify either the `ShardId` or the
+    #   `Timestamp` optional properties.
+    #
+    #   If you specify the `AFTER_SHARD_ID` type, you must also provide the
+    #   value for the optional `ShardId` property. The `ShardId` property is
+    #   identical in fuctionality to the `ExclusiveStartShardId` parameter of
+    #   the `ListShards` API. When `ShardId` property is specified, the
+    #   response includes the shards starting with the shard whose ID
+    #   immediately follows the `ShardId` that you provided.
+    #
+    #   If you specify the `AT_TIMESTAMP` or `FROM_TIMESTAMP_ID` type, you
+    #   must also provide the value for the optional `Timestamp` property. If
+    #   you specify the AT\_TIMESTAMP type, then all shards that were open at
+    #   the provided timestamp are returned. If you specify the
+    #   FROM\_TIMESTAMP type, then all shards starting from the provided
+    #   timestamp to TIP are returned.
     #
     # @return [Types::ListShardsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1341,7 +1424,7 @@ module Aws::Kinesis
     # @option params [required, String] :stream_arn
     #   The ARN of the Kinesis data stream for which you want to list the
     #   registered consumers. For more information, see [Amazon Resource Names
-    #   (ARNs) and AWS Service Namespaces][1].
+    #   (ARNs) and Amazon Web Services Service Namespaces][1].
     #
     #
     #
@@ -1375,7 +1458,8 @@ module Aws::Kinesis
     #
     # @option params [Integer] :max_results
     #   The maximum number of consumers that you want a single call of
-    #   `ListStreamConsumers` to return.
+    #   `ListStreamConsumers` to return. The default value is 100. If you
+    #   specify a value greater than 100, at most 100 results are returned.
     #
     # @option params [Time,DateTime,Date,Integer,String] :stream_creation_timestamp
     #   Specify this input parameter to distinguish data streams that have the
@@ -1427,7 +1511,7 @@ module Aws::Kinesis
     # `ListStreams`. You can limit the number of returned streams using the
     # `Limit` parameter. If you do not specify a value for the `Limit`
     # parameter, Kinesis Data Streams uses the default limit, which is
-    # currently 10.
+    # currently 100.
     #
     # You can detect if there are more streams available to list by using
     # the `HasMoreStreams` flag from the returned output. If there are more
@@ -1441,7 +1525,9 @@ module Aws::Kinesis
     # ListStreams has a limit of five transactions per second per account.
     #
     # @option params [Integer] :limit
-    #   The maximum number of streams to list.
+    #   The maximum number of streams to list. The default value is 100. If
+    #   you specify a value greater than 100, at most 100 results are
+    #   returned.
     #
     # @option params [String] :exclusive_start_stream_name
     #   The name of the stream to start the list with.
@@ -1544,8 +1630,8 @@ module Aws::Kinesis
     # stream does not exist, `MergeShards` returns a
     # `ResourceNotFoundException`.
     #
-    # You can use DescribeStream to check the state of the stream, which is
-    # returned in `StreamStatus`.
+    # You can use DescribeStreamSummary to check the state of the stream,
+    # which is returned in `StreamStatus`.
     #
     # `MergeShards` is an asynchronous operation. Upon receiving a
     # `MergeShards` request, Amazon Kinesis Data Streams immediately returns
@@ -1554,8 +1640,8 @@ module Aws::Kinesis
     # to `ACTIVE`. Read and write operations continue to work while the
     # stream is in the `UPDATING` state.
     #
-    # You use DescribeStream to determine the shard IDs that are specified
-    # in the `MergeShards` request.
+    # You use DescribeStreamSummary and the ListShards APIs to determine the
+    # shard IDs that are specified in the `MergeShards` request.
     #
     # If you try to operate on too many streams in parallel using
     # CreateStream, DeleteStream, `MergeShards`, or SplitShard, you receive
@@ -1861,7 +1947,7 @@ module Aws::Kinesis
     # @option params [required, String] :stream_arn
     #   The ARN of the Kinesis data stream that you want to register the
     #   consumer with. For more info, see [Amazon Resource Names (ARNs) and
-    #   AWS Service Namespaces][1].
+    #   Amazon Web Services Service Namespaces][1].
     #
     #
     #
@@ -1952,9 +2038,10 @@ module Aws::Kinesis
     # mapped into the shard. For more information, see [Split a Shard][1] in
     # the *Amazon Kinesis Data Streams Developer Guide*.
     #
-    # You can use DescribeStream to determine the shard ID and hash key
-    # values for the `ShardToSplit` and `NewStartingHashKey` parameters that
-    # are specified in the `SplitShard` request.
+    # You can use DescribeStreamSummary and the ListShards APIs to determine
+    # the shard ID and hash key values for the `ShardToSplit` and
+    # `NewStartingHashKey` parameters that are specified in the `SplitShard`
+    # request.
     #
     # `SplitShard` is an asynchronous operation. Upon receiving a
     # `SplitShard` request, Kinesis Data Streams immediately returns a
@@ -1963,19 +2050,19 @@ module Aws::Kinesis
     # Read and write operations continue to work while the stream is in the
     # `UPDATING` state.
     #
-    # You can use `DescribeStream` to check the status of the stream, which
-    # is returned in `StreamStatus`. If the stream is in the `ACTIVE` state,
-    # you can call `SplitShard`. If a stream is in `CREATING` or `UPDATING`
-    # or `DELETING` states, `DescribeStream` returns a
-    # `ResourceInUseException`.
+    # You can use DescribeStreamSummary to check the status of the stream,
+    # which is returned in `StreamStatus`. If the stream is in the `ACTIVE`
+    # state, you can call `SplitShard`.
     #
-    # If the specified stream does not exist, `DescribeStream` returns a
-    # `ResourceNotFoundException`. If you try to create more shards than are
-    # authorized for your account, you receive a `LimitExceededException`.
+    # If the specified stream does not exist, DescribeStreamSummary returns
+    # a `ResourceNotFoundException`. If you try to create more shards than
+    # are authorized for your account, you receive a
+    # `LimitExceededException`.
     #
-    # For the default shard limit for an AWS account, see [Kinesis Data
-    # Streams Limits][2] in the *Amazon Kinesis Data Streams Developer
-    # Guide*. To increase this limit, [contact AWS Support][3].
+    # For the default shard limit for an Amazon Web Services account, see
+    # [Kinesis Data Streams Limits][2] in the *Amazon Kinesis Data Streams
+    # Developer Guide*. To increase this limit, [contact Amazon Web Services
+    # Support][3].
     #
     # If you try to operate on too many streams simultaneously using
     # CreateStream, DeleteStream, MergeShards, and/or SplitShard, you
@@ -2024,8 +2111,8 @@ module Aws::Kinesis
       req.send_request(options)
     end
 
-    # Enables or updates server-side encryption using an AWS KMS key for a
-    # specified stream.
+    # Enables or updates server-side encryption using an Amazon Web Services
+    # KMS key for a specified stream.
     #
     # Starting encryption is an asynchronous operation. Upon receiving the
     # request, Kinesis Data Streams returns immediately and sets the status
@@ -2036,8 +2123,8 @@ module Aws::Kinesis
     # stream while its status is `UPDATING`. Once the status of the stream
     # is `ACTIVE`, encryption begins for records written to the stream.
     #
-    # API Limits: You can successfully apply a new AWS KMS key for
-    # server-side encryption 25 times in a rolling 24-hour period.
+    # API Limits: You can successfully apply a new Amazon Web Services KMS
+    # key for server-side encryption 25 times in a rolling 24-hour period.
     #
     # Note: It can take up to 5 seconds after the stream is in an `ACTIVE`
     # status before all records written to the stream are encrypted. After
@@ -2051,11 +2138,12 @@ module Aws::Kinesis
     #   The encryption type to use. The only valid value is `KMS`.
     #
     # @option params [required, String] :key_id
-    #   The GUID for the customer-managed AWS KMS key to use for encryption.
-    #   This value can be a globally unique identifier, a fully specified
-    #   Amazon Resource Name (ARN) to either an alias or a key, or an alias
-    #   name prefixed by "alias/".You can also use a master key owned by
-    #   Kinesis Data Streams by specifying the alias `aws/kinesis`.
+    #   The GUID for the customer-managed Amazon Web Services KMS key to use
+    #   for encryption. This value can be a globally unique identifier, a
+    #   fully specified Amazon Resource Name (ARN) to either an alias or a
+    #   key, or an alias name prefixed by "alias/".You can also use a master
+    #   key owned by Kinesis Data Streams by specifying the alias
+    #   `aws/kinesis`.
     #
     #   * Key ARN example:
     #     `arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012`
@@ -2117,11 +2205,12 @@ module Aws::Kinesis
     #   The encryption type. The only valid value is `KMS`.
     #
     # @option params [required, String] :key_id
-    #   The GUID for the customer-managed AWS KMS key to use for encryption.
-    #   This value can be a globally unique identifier, a fully specified
-    #   Amazon Resource Name (ARN) to either an alias or a key, or an alias
-    #   name prefixed by "alias/".You can also use a master key owned by
-    #   Kinesis Data Streams by specifying the alias `aws/kinesis`.
+    #   The GUID for the customer-managed Amazon Web Services KMS key to use
+    #   for encryption. This value can be a globally unique identifier, a
+    #   fully specified Amazon Resource Name (ARN) to either an alias or a
+    #   key, or an alias name prefixed by "alias/".You can also use a master
+    #   key owned by Kinesis Data Streams by specifying the alias
+    #   `aws/kinesis`.
     #
     #   * Key ARN example:
     #     `arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012`
@@ -2186,17 +2275,17 @@ module Aws::Kinesis
     #
     # * Scale down below half your current shard count for a stream
     #
-    # * Scale up to more than 500 shards in a stream
+    # * Scale up to more than 10000 shards in a stream
     #
-    # * Scale a stream with more than 500 shards down unless the result is
-    #   less than 500 shards
+    # * Scale a stream with more than 10000 shards down unless the result is
+    #   less than 10000 shards
     #
     # * Scale up to more than the shard limit for your account
     #
-    # For the default limits for an AWS account, see [Streams Limits][1] in
-    # the *Amazon Kinesis Data Streams Developer Guide*. To request an
-    # increase in the call rate limit, the shard limit for this API, or your
-    # overall shard limit, use the [limits form][2].
+    # For the default limits for an Amazon Web Services account, see
+    # [Streams Limits][1] in the *Amazon Kinesis Data Streams Developer
+    # Guide*. To request an increase in the call rate limit, the shard limit
+    # for this API, or your overall shard limit, use the [limits form][2].
     #
     #
     #
@@ -2215,12 +2304,12 @@ module Aws::Kinesis
     #
     #   * 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),
+    #   * Set this value to more than 10000 shards in a stream (the default
+    #     limit for shard count per stream is 10000 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.
+    #   * Scale a stream with more than 10000 shards down unless you set this
+    #     value to less than 10000 shards.
     #
     # @option params [required, String] :scaling_type
     #   The scaling type. Uniform scaling creates shards of equal size.
@@ -2254,6 +2343,40 @@ module Aws::Kinesis
       req.send_request(options)
     end
 
+    # Updates the capacity mode of the data stream. Currently, in Kinesis
+    # Data Streams, you can choose between an **on-demand** capacity mode
+    # and a **provisioned** capacity mode for your data stream.
+    #
+    # @option params [required, String] :stream_arn
+    #   Specifies the ARN of the data stream whose capacity mode you want to
+    #   update.
+    #
+    # @option params [required, Types::StreamModeDetails] :stream_mode_details
+    #   Specifies the capacity mode to which you want to set your data stream.
+    #   Currently, in Kinesis Data Streams, you can choose between an
+    #   **on-demand** capacity mode and a **provisioned** capacity mode for
+    #   your data streams.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_stream_mode({
+    #     stream_arn: "StreamARN", # required
+    #     stream_mode_details: { # required
+    #       stream_mode: "PROVISIONED", # required, accepts PROVISIONED, ON_DEMAND
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/kinesis-2013-12-02/UpdateStreamMode AWS API Documentation
+    #
+    # @overload update_stream_mode(params = {})
+    # @param [Hash] params ({})
+    def update_stream_mode(params = {}, options = {})
+      req = build_request(:update_stream_mode, params)
+      req.send_request(options)
+    end
+
     # @!endgroup
 
     # @param params ({})
@@ -2267,7 +2390,7 @@ module Aws::Kinesis
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-kinesis'
-      context[:gem_version] = '1.36.0'
+      context[:gem_version] = '1.40.0'
       Seahorse::Client::Request.new(handlers, context)
     end