aws-sdk-dynamodb 1.84.0 → 1.118.0

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

@@ -22,12 +22,14 @@ require 'aws-sdk-core/plugins/endpoint_pattern.rb'
 require 'aws-sdk-core/plugins/response_paging.rb'
 require 'aws-sdk-core/plugins/stub_responses.rb'
 require 'aws-sdk-core/plugins/idempotency_token.rb'
+require 'aws-sdk-core/plugins/invocation_id.rb'
 require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 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/checksum_algorithm.rb'
+require 'aws-sdk-core/plugins/request_compression.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/sign.rb'
@@ -74,12 +76,14 @@ module Aws::DynamoDB
     add_plugin(Aws::Plugins::ResponsePaging)
     add_plugin(Aws::Plugins::StubResponses)
     add_plugin(Aws::Plugins::IdempotencyToken)
+    add_plugin(Aws::Plugins::InvocationId)
     add_plugin(Aws::Plugins::JsonvalueConverter)
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::ChecksumAlgorithm)
+    add_plugin(Aws::Plugins::RequestCompression)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::Sign)
@@ -91,6 +95,11 @@ module Aws::DynamoDB
 
     # @overload initialize(options)
     #   @param [Hash] options
+    #
+    #   @option options [Array<Seahorse::Client::Plugin>] :plugins ([]])
+    #     A list of plugins to apply to the client. Each plugin is either a
+    #     class name or an instance of a plugin class.
+    #
     #   @option options [required, Aws::CredentialProvider] :credentials
     #     Your AWS credentials. This can be an instance of any one of the
     #     following classes:
@@ -202,10 +211,20 @@ module Aws::DynamoDB
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
     #
-    #   @option options [String] :endpoint
-    #     The client endpoint is normally constructed from the `:region`
-    #     option. You should only configure an `:endpoint` when connecting
-    #     to test or custom endpoints. This should be a valid HTTP(S) URI.
+    #   @option options [Boolean] :disable_request_compression (false)
+    #     When set to 'true' the request body will not be compressed
+    #     for supported operations.
+    #
+    #   @option options [String, URI::HTTPS, URI::HTTP] :endpoint
+    #     Normally you should not configure the `:endpoint` option
+    #     directly. This is normally constructed from the `:region`
+    #     option. Configuring `:endpoint` is normally reserved for
+    #     connecting to test or custom endpoints. The endpoint should
+    #     be a URI formatted like:
+    #
+    #         'http://example.com'
+    #         'https://example.com'
+    #         'http://example.com:123'
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -222,6 +241,10 @@ module Aws::DynamoDB
     #   @option options [Boolean] :endpoint_discovery (false)
     #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
+    #   @option options [Boolean] :ignore_configured_endpoint_urls
+    #     Setting to true disables use of endpoint URLs provided via environment
+    #     variables and the shared configuration file.
+    #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
     #
@@ -242,6 +265,11 @@ module Aws::DynamoDB
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Integer] :request_min_compression_size_bytes (10240)
+    #     The minimum size in bytes that triggers compression for request
+    #     bodies. The value must be non-negative integer value between 0
+    #     and 10485780 bytes inclusive.
+    #
     #   @option options [Proc] :retry_backoff
     #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
     #     This option is only used in the `legacy` retry mode.
@@ -285,11 +313,25 @@ module Aws::DynamoDB
     #       throttling.  This is a provisional mode that may change behavior
     #       in the future.
     #
+    #   @option options [String] :sdk_ua_app_id
+    #     A unique and opaque application ID that is appended to the
+    #     User-Agent header as app/sdk_ua_app_id. It should have a
+    #     maximum length of 50. This variable is sourced from environment
+    #     variable AWS_SDK_UA_APP_ID or the shared config profile attribute sdk_ua_app_id.
     #
     #   @option options [String] :secret_access_key
     #
     #   @option options [String] :session_token
     #
+    #   @option options [Array] :sigv4a_signing_region_set
+    #     A list of regions that should be signed with SigV4a signing. When
+    #     not passed, a default `:sigv4a_signing_region_set` is searched for
+    #     in the following locations:
+    #
+    #     * `Aws.config[:sigv4a_signing_region_set]`
+    #     * `ENV['AWS_SIGV4A_SIGNING_REGION_SET']`
+    #     * `~/.aws/config`
+    #
     #   @option options [Boolean] :simple_attributes (true)
     #     Enables working with DynamoDB attribute values using
     #     hashes, arrays, sets, integers, floats, booleans, and nil.
@@ -300,13 +342,10 @@ module Aws::DynamoDB
     #
     #   @option options [Boolean] :simple_json (false)
     #     Disables request parameter conversion, validation, and formatting.
-    #     Also disable response data type conversions. This option is useful
-    #     when you want to ensure the highest level of performance by
-    #     avoiding overhead of walking request parameters and response data
-    #     structures.
-    #
-    #     When `:simple_json` is enabled, the request parameters hash must
-    #     be formatted exactly as the DynamoDB API expects.
+    #     Also disables response data type conversions. The request parameters
+    #     hash must be formatted exactly as the API expects.This option is useful
+    #     when you want to ensure the highest level of performance by avoiding
+    #     overhead of walking request parameters and response data structures.
     #
     #   @option options [Boolean] :stub_responses (false)
     #     Causes the client to return stubbed responses. By default
@@ -346,50 +385,65 @@ module Aws::DynamoDB
     #   @option options [Aws::DynamoDB::EndpointProvider] :endpoint_provider
     #     The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::DynamoDB::EndpointParameters`
     #
-    #   @option options [URI::HTTP,String] :http_proxy A proxy to send
-    #     requests through.  Formatted like 'http://proxy.com:123'.
-    #
-    #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before raising a
-    #     `Timeout::Error`.
-    #
-    #   @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.
-    #
-    #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idle before it is
-    #     considered stale.  Stale connections are closed and removed
-    #     from the pool before making a request.
-    #
-    #   @option options [Float] :http_continue_timeout (1) The number of
-    #     seconds to wait for a 100-continue response before sending the
-    #     request body.  This option has no effect unless the request has
-    #     "Expect" header set to "100-continue".  Defaults to `nil` which
-    #     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 [Float] :http_continue_timeout (1)
+    #     The number of seconds to wait for a 100-continue response before sending the
+    #     request body.  This option has no effect unless the request has "Expect"
+    #     header set to "100-continue".  Defaults to `nil` which  disables this
+    #     behaviour.  This value can safely be set per request on the session.
+    #
+    #   @option options [Float] :http_idle_timeout (5)
+    #     The number of seconds a connection is allowed to sit idle before it
+    #     is considered stale.  Stale connections are closed and removed from the
+    #     pool before making a request.
+    #
+    #   @option options [Float] :http_open_timeout (15)
+    #     The default number of seconds to wait for response data.
+    #     This value can safely be set per-request on the session.
+    #
+    #   @option options [URI::HTTP,String] :http_proxy
+    #     A proxy to send requests through.  Formatted like 'http://proxy.com:123'.
+    #
+    #   @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.
+    #
+    #   @option options [Boolean] :http_wire_trace (false)
+    #     When `true`,  HTTP debug output will be sent to the `:logger`.
+    #
+    #   @option options [Proc] :on_chunk_received
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the response body is received. It provides three arguments: the chunk,
+    #     the number of bytes received, and the total number of
+    #     bytes in the response (or nil if the server did not send a `content-length`).
+    #
+    #   @option options [Proc] :on_chunk_sent
+    #     When a Proc object is provided, it will be used as callback when each chunk
+    #     of the request body is sent. It provides three arguments: the chunk,
+    #     the number of bytes read from the body, and the total number of
+    #     bytes in the body.
+    #
+    #   @option options [Boolean] :raise_response_errors (true)
+    #     When `true`, response errors are raised.
+    #
+    #   @option options [String] :ssl_ca_bundle
+    #     Full path to the SSL certificate authority bundle file that should be used when
+    #     verifying peer certificates.  If you do not pass `:ssl_ca_bundle` or
+    #     `:ssl_ca_directory` the the system default will be used if available.
+    #
+    #   @option options [String] :ssl_ca_directory
+    #     Full path of the directory that contains the unbundled SSL certificate
+    #     authority files for verifying peer certificates.  If you do
+    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the system
+    #     default will be used if available.
     #
-    #   @option options [Boolean] :http_wire_trace (false) When `true`,
-    #     HTTP debug output will be sent to the `:logger`.
+    #   @option options [String] :ssl_ca_store
+    #     Sets the X509::Store to verify peer certificate.
     #
-    #   @option options [Boolean] :ssl_verify_peer (true) When `true`,
-    #     SSL peer certificates are verified when establishing a
-    #     connection.
+    #   @option options [Float] :ssl_timeout
+    #     Sets the SSL timeout in seconds
     #
-    #   @option options [String] :ssl_ca_bundle Full path to the SSL
-    #     certificate authority bundle file that should be used when
-    #     verifying peer certificates.  If you do not pass
-    #     `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
-    #     will be used if available.
-    #
-    #   @option options [String] :ssl_ca_directory Full path of the
-    #     directory that contains the unbundled SSL certificate
-    #     authority files for verifying peer certificates.  If you do
-    #     not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
-    #     system default will be used if available.
+    #   @option options [Boolean] :ssl_verify_peer (true)
+    #     When `true`, SSL peer certificates are verified when establishing a connection.
     #
     def initialize(*args)
       super
@@ -401,7 +455,8 @@ module Aws::DynamoDB
     # stored in DynamoDB, using PartiQL. Each read statement in a
     # `BatchExecuteStatement` must specify an equality condition on all key
     # attributes. This enforces that each `SELECT` statement in a batch
-    # returns at most a single item.
+    # returns at most a single item. For more information, see [Running
+    # batch operations with PartiQL for DynamoDB ][1].
     #
     # <note markdown="1"> The entire batch must consist of either read statements or write
     # statements, you cannot mix both in one batch.
@@ -410,12 +465,13 @@ module Aws::DynamoDB
     #
     # A HTTP 200 response does not mean that all statements in the
     # BatchExecuteStatement succeeded. Error details for individual
-    # statements can be found under the [Error][1] field of the
+    # statements can be found under the [Error][2] field of the
     # `BatchStatementResponse` for each statement.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchStatementResponse.html#DDB-Type-BatchStatementResponse-Error
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ql-reference.multiplestatements.batching.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchStatementResponse.html#DDB-Type-BatchStatementResponse-Error
     #
     # @option params [required, Array<Types::BatchStatementRequest>] :statements
     #   The list of PartiQL statements representing the batch to run.
@@ -450,6 +506,7 @@ module Aws::DynamoDB
     #         statement: "PartiQLStatement", # required
     #         parameters: ["value"], # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #         consistent_read: false,
+    #         return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
     #       },
     #     ],
     #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
@@ -460,6 +517,8 @@ module Aws::DynamoDB
     #   resp.responses #=> Array
     #   resp.responses[0].error.code #=> String, one of "ConditionalCheckFailed", "ItemCollectionSizeLimitExceeded", "RequestLimitExceeded", "ValidationError", "ProvisionedThroughputExceeded", "TransactionConflict", "ThrottlingError", "InternalServerError", "ResourceNotFound", "AccessDenied", "DuplicateItem"
     #   resp.responses[0].error.message #=> String
+    #   resp.responses[0].error.item #=> Hash
+    #   resp.responses[0].error.item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #   resp.responses[0].table_name #=> String
     #   resp.responses[0].item #=> Hash
     #   resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
@@ -496,10 +555,10 @@ module Aws::DynamoDB
     # A single operation can retrieve up to 16 MB of data, which can contain
     # as many as 100 items. `BatchGetItem` returns a partial result if the
     # response size limit is exceeded, the table's provisioned throughput
-    # is exceeded, or an internal processing failure occurs. If a partial
-    # result is returned, the operation returns a value for
-    # `UnprocessedKeys`. You can use this value to retry the operation
-    # starting with the next item to get.
+    # is exceeded, more than 1MB per partition is requested, or an internal
+    # processing failure occurs. If a partial result is returned, the
+    # operation returns a value for `UnprocessedKeys`. You can use this
+    # value to retry the operation starting with the next item to get.
     #
     # If you request more than 100 items, `BatchGetItem` returns a
     # `ValidationException` with the message "Too many items requested for
@@ -553,9 +612,9 @@ module Aws::DynamoDB
     # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithTables.html#CapacityUnitCalculations
     #
     # @option params [required, Hash<String,Types::KeysAndAttributes>] :request_items
-    #   A map of one or more table names and, for each table, a map that
-    #   describes one or more items to retrieve from that table. Each table
-    #   name can be used only once per `BatchGetItem` request.
+    #   A map of one or more table names or table ARNs and, for each table, a
+    #   map that describes one or more items to retrieve from that table. Each
+    #   table name or ARN can be used only once per `BatchGetItem` request.
     #
     #   Each element in the map of items to retrieve consists of the
     #   following:
@@ -713,7 +772,7 @@ module Aws::DynamoDB
     #
     #   resp = client.batch_get_item({
     #     request_items: { # required
-    #       "TableName" => {
+    #       "TableArn" => {
     #         keys: [ # required
     #           {
     #             "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
@@ -733,19 +792,19 @@ module Aws::DynamoDB
     # @example Response structure
     #
     #   resp.responses #=> Hash
-    #   resp.responses["TableName"] #=> Array
-    #   resp.responses["TableName"][0] #=> Hash
-    #   resp.responses["TableName"][0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.responses["TableArn"] #=> Array
+    #   resp.responses["TableArn"][0] #=> Hash
+    #   resp.responses["TableArn"][0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #   resp.unprocessed_keys #=> Hash
-    #   resp.unprocessed_keys["TableName"].keys #=> Array
-    #   resp.unprocessed_keys["TableName"].keys[0] #=> Hash
-    #   resp.unprocessed_keys["TableName"].keys[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
-    #   resp.unprocessed_keys["TableName"].attributes_to_get #=> Array
-    #   resp.unprocessed_keys["TableName"].attributes_to_get[0] #=> String
-    #   resp.unprocessed_keys["TableName"].consistent_read #=> Boolean
-    #   resp.unprocessed_keys["TableName"].projection_expression #=> String
-    #   resp.unprocessed_keys["TableName"].expression_attribute_names #=> Hash
-    #   resp.unprocessed_keys["TableName"].expression_attribute_names["ExpressionAttributeNameVariable"] #=> String
+    #   resp.unprocessed_keys["TableArn"].keys #=> Array
+    #   resp.unprocessed_keys["TableArn"].keys[0] #=> Hash
+    #   resp.unprocessed_keys["TableArn"].keys[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.unprocessed_keys["TableArn"].attributes_to_get #=> Array
+    #   resp.unprocessed_keys["TableArn"].attributes_to_get[0] #=> String
+    #   resp.unprocessed_keys["TableArn"].consistent_read #=> Boolean
+    #   resp.unprocessed_keys["TableArn"].projection_expression #=> String
+    #   resp.unprocessed_keys["TableArn"].expression_attribute_names #=> Hash
+    #   resp.unprocessed_keys["TableArn"].expression_attribute_names["ExpressionAttributeNameVariable"] #=> String
     #   resp.consumed_capacity #=> Array
     #   resp.consumed_capacity[0].table_name #=> String
     #   resp.consumed_capacity[0].capacity_units #=> Float
@@ -800,9 +859,13 @@ module Aws::DynamoDB
     # request with those unprocessed items until all items have been
     # processed.
     #
-    # If *none* of the items can be processed due to insufficient
-    # provisioned throughput on all of the tables in the request, then
-    # `BatchWriteItem` returns a `ProvisionedThroughputExceededException`.
+    # For tables and indexes with provisioned capacity, if none of the items
+    # can be processed due to insufficient provisioned throughput on all of
+    # the tables in the request, then `BatchWriteItem` returns a
+    # `ProvisionedThroughputExceededException`. For all tables and indexes,
+    # if none of the items can be processed due to other throttling
+    # scenarios (such as exceeding partition level limits), then
+    # `BatchWriteItem` returns a `ThrottlingException`.
     #
     # If DynamoDB returns any unprocessed items, you should retry the batch
     # operation on those items. However, *we strongly recommend that you use
@@ -859,15 +922,19 @@ module Aws::DynamoDB
     #
     # * The total request size exceeds 16 MB.
     #
+    # * Any individual items with keys exceeding the key length limits. For
+    #   a partition key, the limit is 2048 bytes and for a sort key, the
+    #   limit is 1024 bytes.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html
     # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#Programming.Errors.BatchOperations
     #
     # @option params [required, Hash<String,Array>] :request_items
-    #   A map of one or more table names and, for each table, a list of
-    #   operations to be performed (`DeleteRequest` or `PutRequest`). Each
-    #   element in the map consists of the following:
+    #   A map of one or more table names or table ARNs and, for each table, a
+    #   list of operations to be performed (`DeleteRequest` or `PutRequest`).
+    #   Each element in the map consists of the following:
     #
     #   * `DeleteRequest` - Perform a `DeleteItem` operation on the specified
     #     item. The item to be deleted is identified by a `Key` subelement:
@@ -972,7 +1039,7 @@ module Aws::DynamoDB
     #
     #   resp = client.batch_write_item({
     #     request_items: { # required
-    #       "TableName" => [
+    #       "TableArn" => [
     #         {
     #           put_request: {
     #             item: { # required
@@ -994,17 +1061,17 @@ module Aws::DynamoDB
     # @example Response structure
     #
     #   resp.unprocessed_items #=> Hash
-    #   resp.unprocessed_items["TableName"] #=> Array
-    #   resp.unprocessed_items["TableName"][0].put_request.item #=> Hash
-    #   resp.unprocessed_items["TableName"][0].put_request.item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
-    #   resp.unprocessed_items["TableName"][0].delete_request.key #=> Hash
-    #   resp.unprocessed_items["TableName"][0].delete_request.key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.unprocessed_items["TableArn"] #=> Array
+    #   resp.unprocessed_items["TableArn"][0].put_request.item #=> Hash
+    #   resp.unprocessed_items["TableArn"][0].put_request.item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.unprocessed_items["TableArn"][0].delete_request.key #=> Hash
+    #   resp.unprocessed_items["TableArn"][0].delete_request.key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #   resp.item_collection_metrics #=> Hash
-    #   resp.item_collection_metrics["TableName"] #=> Array
-    #   resp.item_collection_metrics["TableName"][0].item_collection_key #=> Hash
-    #   resp.item_collection_metrics["TableName"][0].item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
-    #   resp.item_collection_metrics["TableName"][0].size_estimate_range_gb #=> Array
-    #   resp.item_collection_metrics["TableName"][0].size_estimate_range_gb[0] #=> Float
+    #   resp.item_collection_metrics["TableArn"] #=> Array
+    #   resp.item_collection_metrics["TableArn"][0].item_collection_key #=> Hash
+    #   resp.item_collection_metrics["TableArn"][0].item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.item_collection_metrics["TableArn"][0].size_estimate_range_gb #=> Array
+    #   resp.item_collection_metrics["TableArn"][0].size_estimate_range_gb[0] #=> Float
     #   resp.consumed_capacity #=> Array
     #   resp.consumed_capacity[0].table_name #=> String
     #   resp.consumed_capacity[0].capacity_units #=> Float
@@ -1065,7 +1132,8 @@ module Aws::DynamoDB
     # * Provisioned read and write capacity
     #
     # @option params [required, String] :table_name
-    #   The name of the table.
+    #   The name of the table. You can also provide the Amazon Resource Name
+    #   (ARN) of the table in this parameter.
     #
     # @option params [required, String] :backup_name
     #   Specified name for the backup.
@@ -1077,7 +1145,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_backup({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     backup_name: "BackupName", # required
     #   })
     #
@@ -1104,14 +1172,16 @@ module Aws::DynamoDB
     # a replication relationship between two or more DynamoDB tables with
     # the same table name in the provided Regions.
     #
-    # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
-    # global tables. We recommend using [Version 2019.11.21 (Current)][2]
-    # when creating new global tables, as it provides greater flexibility,
-    # higher efficiency and consumes less write capacity than 2017.11.29
-    # (Legacy). To determine which version you are using, see [Determining
-    # the version][3]. To update existing global tables from version
-    # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
-    # global tables][4].
+    # This documentation is for version 2017.11.29 (Legacy) of global
+    # tables, which should be avoided for new global tables. Customers
+    # should use [Global Tables version 2019.11.21 (Current)][1] when
+    # possible, because it provides greater flexibility, higher efficiency,
+    # and consumes less write capacity than 2017.11.29 (Legacy).
+    #
+    #  To determine which version you're using, see [Determining the global
+    # table version you are using][2]. To update existing global tables from
+    # version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see
+    # [Upgrading global tables][3].
     #
     # If you want to add a new replica table to a global table, each of the
     # following conditions must be true:
@@ -1154,10 +1224,9 @@ module Aws::DynamoDB
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
-    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
-    # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
+    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
     #
     # @option params [required, String] :global_table_name
     #   The global table name.
@@ -1189,9 +1258,11 @@ module Aws::DynamoDB
     #   resp.global_table_description.replication_group[0].replica_status_percent_progress #=> String
     #   resp.global_table_description.replication_group[0].kms_master_key_id #=> String
     #   resp.global_table_description.replication_group[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.global_table_description.replication_group[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.global_table_description.replication_group[0].global_secondary_indexes #=> Array
     #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
     #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
     #   resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -1233,7 +1304,8 @@ module Aws::DynamoDB
     #   indexes.
     #
     # @option params [required, String] :table_name
-    #   The name of the table to create.
+    #   The name of the table to create. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, Array<Types::KeySchemaElement>] :key_schema
     #   Specifies the attributes that make up the primary key for a table or
@@ -1367,16 +1439,16 @@ module Aws::DynamoDB
     #
     #   * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
     #     workloads. `PROVISIONED` sets the billing mode to [Provisioned
-    #     Mode][1].
+    #     capacity mode][1].
     #
     #   * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
     #     unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
-    #     [On-Demand Mode][2].
+    #     [On-demand capacity mode][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
-    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/provisioned-capacity-mode.html
+    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/on-demand-capacity-mode.html
     #
     # @option params [Types::ProvisionedThroughput] :provisioned_throughput
     #   Represents the provisioned throughput settings for a specified table
@@ -1437,6 +1509,34 @@ module Aws::DynamoDB
     #   Indicates whether deletion protection is to be enabled (true) or
     #   disabled (false) on the table.
     #
+    # @option params [String] :resource_policy
+    #   An Amazon Web Services resource-based policy document in JSON format
+    #   that will be attached to the table.
+    #
+    #   When you attach a resource-based policy while creating a table, the
+    #   policy application is *strongly consistent*.
+    #
+    #   The maximum size supported for a resource-based policy document is 20
+    #   KB. DynamoDB counts whitespaces when calculating the size of a policy
+    #   against this limit. For a full list of all considerations that apply
+    #   for resource-based policies, see [Resource-based policy
+    #   considerations][1].
+    #
+    #   <note markdown="1"> You need to specify the `CreateTable` and `PutResourcePolicy` IAM
+    #   actions for authorizing a user to create a table with a resource-based
+    #   policy.
+    #
+    #    </note>
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-considerations.html
+    #
+    # @option params [Types::OnDemandThroughput] :on_demand_throughput
+    #   Sets the maximum number of read and write units for the specified
+    #   table in on-demand capacity mode. If you use this parameter, you must
+    #   specify `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both.
+    #
     # @return [Types::CreateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTableOutput#table_description #table_description} => Types::TableDescription
@@ -1518,7 +1618,7 @@ module Aws::DynamoDB
     #         attribute_type: "S", # required, accepts S, N, B
     #       },
     #     ],
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     key_schema: [ # required
     #       {
     #         attribute_name: "KeySchemaAttributeName", # required
@@ -1557,6 +1657,10 @@ module Aws::DynamoDB
     #           read_capacity_units: 1, # required
     #           write_capacity_units: 1, # required
     #         },
+    #         on_demand_throughput: {
+    #           max_read_request_units: 1,
+    #           max_write_request_units: 1,
+    #         },
     #       },
     #     ],
     #     billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
@@ -1581,6 +1685,11 @@ module Aws::DynamoDB
     #     ],
     #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #     deletion_protection_enabled: false,
+    #     resource_policy: "ResourcePolicy",
+    #     on_demand_throughput: {
+    #       max_read_request_units: 1,
+    #       max_write_request_units: 1,
+    #     },
     #   })
     #
     # @example Response structure
@@ -1634,6 +1743,8 @@ module Aws::DynamoDB
     #   resp.table_description.global_secondary_indexes[0].index_size_bytes #=> Integer
     #   resp.table_description.global_secondary_indexes[0].item_count #=> Integer
     #   resp.table_description.global_secondary_indexes[0].index_arn #=> String
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.stream_specification.stream_enabled #=> Boolean
     #   resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.table_description.latest_stream_label #=> String
@@ -1646,9 +1757,11 @@ module Aws::DynamoDB
     #   resp.table_description.replicas[0].replica_status_percent_progress #=> String
     #   resp.table_description.replicas[0].kms_master_key_id #=> String
     #   resp.table_description.replicas[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].global_secondary_indexes #=> Array
     #   resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
     #   resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
     #   resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -1666,6 +1779,8 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTable AWS API Documentation
     #
@@ -1712,6 +1827,8 @@ module Aws::DynamoDB
     #   resp.backup_description.source_table_details.table_creation_date_time #=> Time
     #   resp.backup_description.source_table_details.provisioned_throughput.read_capacity_units #=> Integer
     #   resp.backup_description.source_table_details.provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.backup_description.source_table_details.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.backup_description.source_table_details.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.backup_description.source_table_details.item_count #=> Integer
     #   resp.backup_description.source_table_details.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
     #   resp.backup_description.source_table_feature_details.local_secondary_indexes #=> Array
@@ -1732,6 +1849,8 @@ module Aws::DynamoDB
     #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
     #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
     #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.backup_description.source_table_feature_details.stream_description.stream_enabled #=> Boolean
     #   resp.backup_description.source_table_feature_details.stream_description.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.backup_description.source_table_feature_details.time_to_live_description.time_to_live_status #=> String, one of "ENABLING", "DISABLING", "ENABLED", "DISABLED"
@@ -1767,7 +1886,8 @@ module Aws::DynamoDB
     # delete. Otherwise, the item is not deleted.
     #
     # @option params [required, String] :table_name
-    #   The name of the table from which to delete the item.
+    #   The name of the table from which to delete the item. You can also
+    #   provide the Amazon Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, Hash<String,Types::AttributeValue>] :key
     #   A map of attribute names to `AttributeValue` objects, representing the
@@ -1938,6 +2058,14 @@ module Aws::DynamoDB
     #
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html
     #
+    # @option params [String] :return_values_on_condition_check_failure
+    #   An optional parameter that returns the item attributes for a
+    #   `DeleteItem` operation that failed a condition check.
+    #
+    #   There is no additional cost associated with requesting a return value
+    #   aside from the small network and processing overhead of receiving a
+    #   larger response. No read capacity units are consumed.
+    #
     # @return [Types::DeleteItemOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteItemOutput#attributes #attributes} => Hash&lt;String,Types::AttributeValue&gt;
@@ -1968,7 +2096,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_item({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     key: { # required
     #       "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     },
@@ -1991,6 +2119,7 @@ module Aws::DynamoDB
     #     expression_attribute_values: {
     #       "ExpressionAttributeValueVariable" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     },
+    #     return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
     #   })
     #
     # @example Response structure
@@ -2026,6 +2155,67 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
+    # Deletes the resource-based policy attached to the resource, which can
+    # be a table or stream.
+    #
+    # `DeleteResourcePolicy` is an idempotent operation; running it multiple
+    # times on the same resource *doesn't* result in an error response,
+    # unless you specify an `ExpectedRevisionId`, which will then return a
+    # `PolicyNotFoundException`.
+    #
+    # To make sure that you don't inadvertently lock yourself out of your
+    # own resources, the root principal in your Amazon Web Services account
+    # can perform `DeleteResourcePolicy` requests, even if your
+    # resource-based policy explicitly denies the root principal's access.
+    #
+    # <note markdown="1"> `DeleteResourcePolicy` is an asynchronous operation. If you issue a
+    # `GetResourcePolicy` request immediately after running the
+    # `DeleteResourcePolicy` request, DynamoDB might still return the
+    # deleted policy. This is because the policy for your resource might not
+    # have been deleted yet. Wait for a few seconds, and then try the
+    # `GetResourcePolicy` request again.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the DynamoDB resource from which the
+    #   policy will be removed. The resources you can specify include tables
+    #   and streams. If you remove the policy of a table, it will also remove
+    #   the permissions for the table's indexes defined in that policy
+    #   document. This is because index permissions are defined in the
+    #   table's policy.
+    #
+    # @option params [String] :expected_revision_id
+    #   A string value that you can use to conditionally delete your policy.
+    #   When you provide an expected revision ID, if the revision ID of the
+    #   existing policy on the resource doesn't match or if there's no
+    #   policy attached to the resource, the request will fail and return a
+    #   `PolicyNotFoundException`.
+    #
+    # @return [Types::DeleteResourcePolicyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteResourcePolicyOutput#revision_id #revision_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_resource_policy({
+    #     resource_arn: "ResourceArnString", # required
+    #     expected_revision_id: "PolicyRevisionId",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.revision_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteResourcePolicy AWS API Documentation
+    #
+    # @overload delete_resource_policy(params = {})
+    # @param [Hash] params ({})
+    def delete_resource_policy(params = {}, options = {})
+      req = build_request(:delete_resource_policy, params)
+      req.send_request(options)
+    end
+
     # The `DeleteTable` operation deletes a table and all of its items.
     # After a `DeleteTable` request, the specified table is in the
     # `DELETING` state until DynamoDB completes the deletion. If the table
@@ -2035,12 +2225,13 @@ module Aws::DynamoDB
     # DynamoDB returns a `ResourceNotFoundException`. If table is already in
     # the `DELETING` state, no error is returned.
     #
-    # This operation only applies to [Version 2019.11.21 (Current)][1] of
-    # global tables.
+    # For global tables, this operation only applies to global tables using
+    # Version 2019.11.21 (Current version).
     #
     # <note markdown="1"> DynamoDB might continue to accept data read and write operations, such
     # as `GetItem` and `PutItem`, on a table in the `DELETING` state until
-    # the table deletion is complete.
+    # the table deletion is complete. For the full list of table states, see
+    # [TableStatus][1].
     #
     #  </note>
     #
@@ -2054,10 +2245,11 @@ module Aws::DynamoDB
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TableDescription.html#DDB-Type-TableDescription-TableStatus
     #
     # @option params [required, String] :table_name
-    #   The name of the table to delete.
+    #   The name of the table to delete. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @return [Types::DeleteTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2090,7 +2282,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_table({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #   })
     #
     # @example Response structure
@@ -2144,6 +2336,8 @@ module Aws::DynamoDB
     #   resp.table_description.global_secondary_indexes[0].index_size_bytes #=> Integer
     #   resp.table_description.global_secondary_indexes[0].item_count #=> Integer
     #   resp.table_description.global_secondary_indexes[0].index_arn #=> String
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.stream_specification.stream_enabled #=> Boolean
     #   resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.table_description.latest_stream_label #=> String
@@ -2156,9 +2350,11 @@ module Aws::DynamoDB
     #   resp.table_description.replicas[0].replica_status_percent_progress #=> String
     #   resp.table_description.replicas[0].kms_master_key_id #=> String
     #   resp.table_description.replicas[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].global_secondary_indexes #=> Array
     #   resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
     #   resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
     #   resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -2176,6 +2372,8 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTable AWS API Documentation
     #
@@ -2223,6 +2421,8 @@ module Aws::DynamoDB
     #   resp.backup_description.source_table_details.table_creation_date_time #=> Time
     #   resp.backup_description.source_table_details.provisioned_throughput.read_capacity_units #=> Integer
     #   resp.backup_description.source_table_details.provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.backup_description.source_table_details.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.backup_description.source_table_details.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.backup_description.source_table_details.item_count #=> Integer
     #   resp.backup_description.source_table_details.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
     #   resp.backup_description.source_table_feature_details.local_secondary_indexes #=> Array
@@ -2243,6 +2443,8 @@ module Aws::DynamoDB
     #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
     #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
     #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.backup_description.source_table_feature_details.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.backup_description.source_table_feature_details.stream_description.stream_enabled #=> Boolean
     #   resp.backup_description.source_table_feature_details.stream_description.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.backup_description.source_table_feature_details.time_to_live_description.time_to_live_status #=> String, one of "ENABLING", "DISABLING", "ENABLED", "DISABLED"
@@ -2281,6 +2483,9 @@ module Aws::DynamoDB
     #   Name of the table for which the customer wants to check the continuous
     #   backups and point in time recovery settings.
     #
+    #   You can also provide the Amazon Resource Name (ARN) of the table in
+    #   this parameter.
+    #
     # @return [Types::DescribeContinuousBackupsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeContinuousBackupsOutput#continuous_backups_description #continuous_backups_description} => Types::ContinuousBackupsDescription
@@ -2288,7 +2493,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_continuous_backups({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #   })
     #
     # @example Response structure
@@ -2311,7 +2516,8 @@ module Aws::DynamoDB
     # global secondary index.
     #
     # @option params [required, String] :table_name
-    #   The name of the table to describe.
+    #   The name of the table to describe. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @option params [String] :index_name
     #   The name of the global secondary index to describe, if applicable.
@@ -2328,7 +2534,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_contributor_insights({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     index_name: "IndexName",
     #   })
     #
@@ -2352,10 +2558,8 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # Returns the regional endpoint information. This action must be
-    # included in your VPC endpoint policies, or access to the
-    # DescribeEndpoints API will be denied. For more information on policy
-    # permissions, please see [Internetwork traffic privacy][1].
+    # Returns the regional endpoint information. For more information on
+    # policy permissions, please see [Internetwork traffic privacy][1].
     #
     #
     #
@@ -2416,6 +2620,10 @@ module Aws::DynamoDB
     #   resp.export_description.export_format #=> String, one of "DYNAMODB_JSON", "ION"
     #   resp.export_description.billed_size_bytes #=> Integer
     #   resp.export_description.item_count #=> Integer
+    #   resp.export_description.export_type #=> String, one of "FULL_EXPORT", "INCREMENTAL_EXPORT"
+    #   resp.export_description.incremental_export_specification.export_from_time #=> Time
+    #   resp.export_description.incremental_export_specification.export_to_time #=> Time
+    #   resp.export_description.incremental_export_specification.export_view_type #=> String, one of "NEW_IMAGE", "NEW_AND_OLD_IMAGES"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeExport AWS API Documentation
     #
@@ -2428,21 +2636,22 @@ module Aws::DynamoDB
 
     # Returns information about the specified global table.
     #
-    # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
-    # global tables. We recommend using [Version 2019.11.21 (Current)][2]
-    # when creating new global tables, as it provides greater flexibility,
-    # higher efficiency and consumes less write capacity than 2017.11.29
-    # (Legacy). To determine which version you are using, see [Determining
-    # the version][3]. To update existing global tables from version
-    # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
-    # global tables][4].
+    # This documentation is for version 2017.11.29 (Legacy) of global
+    # tables, which should be avoided for new global tables. Customers
+    # should use [Global Tables version 2019.11.21 (Current)][1] when
+    # possible, because it provides greater flexibility, higher efficiency,
+    # and consumes less write capacity than 2017.11.29 (Legacy).
+    #
+    #  To determine which version you're using, see [Determining the global
+    # table version you are using][2]. To update existing global tables from
+    # version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see
+    # [Upgrading global tables][3].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
-    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
-    # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
+    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
     #
     # @option params [required, String] :global_table_name
     #   The name of the global table.
@@ -2466,9 +2675,11 @@ module Aws::DynamoDB
     #   resp.global_table_description.replication_group[0].replica_status_percent_progress #=> String
     #   resp.global_table_description.replication_group[0].kms_master_key_id #=> String
     #   resp.global_table_description.replication_group[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.global_table_description.replication_group[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.global_table_description.replication_group[0].global_secondary_indexes #=> Array
     #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
     #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
     #   resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -2488,21 +2699,22 @@ module Aws::DynamoDB
 
     # Describes Region-specific settings for a global table.
     #
-    # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
-    # global tables. We recommend using [Version 2019.11.21 (Current)][2]
-    # when creating new global tables, as it provides greater flexibility,
-    # higher efficiency and consumes less write capacity than 2017.11.29
-    # (Legacy). To determine which version you are using, see [Determining
-    # the version][3]. To update existing global tables from version
-    # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
-    # global tables][4].
+    # This documentation is for version 2017.11.29 (Legacy) of global
+    # tables, which should be avoided for new global tables. Customers
+    # should use [Global Tables version 2019.11.21 (Current)][1] when
+    # possible, because it provides greater flexibility, higher efficiency,
+    # and consumes less write capacity than 2017.11.29 (Legacy).
     #
+    #  To determine which version you're using, see [Determining the global
+    # table version you are using][2]. To update existing global tables from
+    # version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see
+    # [Upgrading global tables][3].
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
-    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
-    # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
+    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
     #
     # @option params [required, String] :global_table_name
     #   The name of the global table to describe.
@@ -2628,6 +2840,8 @@ module Aws::DynamoDB
     #   resp.import_table_description.table_creation_parameters.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
     #   resp.import_table_description.table_creation_parameters.provisioned_throughput.read_capacity_units #=> Integer
     #   resp.import_table_description.table_creation_parameters.provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.import_table_description.table_creation_parameters.sse_specification.enabled #=> Boolean
     #   resp.import_table_description.table_creation_parameters.sse_specification.sse_type #=> String, one of "AES256", "KMS"
     #   resp.import_table_description.table_creation_parameters.sse_specification.kms_master_key_id #=> String
@@ -2641,6 +2855,8 @@ module Aws::DynamoDB
     #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
     #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
     #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.import_table_description.start_time #=> Time
     #   resp.import_table_description.end_time #=> Time
     #   resp.import_table_description.processed_size_bytes #=> Integer
@@ -2661,7 +2877,8 @@ module Aws::DynamoDB
     # Returns information about the status of Kinesis streaming.
     #
     # @option params [required, String] :table_name
-    #   The name of the table being described.
+    #   The name of the table being described. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @return [Types::DescribeKinesisStreamingDestinationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2671,7 +2888,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_kinesis_streaming_destination({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #   })
     #
     # @example Response structure
@@ -2679,8 +2896,9 @@ module Aws::DynamoDB
     #   resp.table_name #=> String
     #   resp.kinesis_data_stream_destinations #=> Array
     #   resp.kinesis_data_stream_destinations[0].stream_arn #=> String
-    #   resp.kinesis_data_stream_destinations[0].destination_status #=> String, one of "ENABLING", "ACTIVE", "DISABLING", "DISABLED", "ENABLE_FAILED"
+    #   resp.kinesis_data_stream_destinations[0].destination_status #=> String, one of "ENABLING", "ACTIVE", "DISABLING", "DISABLED", "ENABLE_FAILED", "UPDATING"
     #   resp.kinesis_data_stream_destinations[0].destination_status_description #=> String
+    #   resp.kinesis_data_stream_destinations[0].approximate_creation_date_time_precision #=> String, one of "MILLISECOND", "MICROSECOND"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeKinesisStreamingDestination AWS API Documentation
     #
@@ -2805,8 +3023,8 @@ module Aws::DynamoDB
     # the table, when it was created, the primary key schema, and any
     # indexes on the table.
     #
-    # This operation only applies to [Version 2019.11.21 (Current)][1] of
-    # global tables.
+    # For global tables, this operation only applies to global tables using
+    # Version 2019.11.21 (Current version).
     #
     # <note markdown="1"> If you issue a `DescribeTable` request immediately after a
     # `CreateTable` request, DynamoDB might return a
@@ -2817,12 +3035,9 @@ module Aws::DynamoDB
     #
     #  </note>
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    #
     # @option params [required, String] :table_name
-    #   The name of the table to describe.
+    #   The name of the table to describe. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @return [Types::DescribeTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2876,7 +3091,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_table({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #   })
     #
     # @example Response structure
@@ -2930,6 +3145,8 @@ module Aws::DynamoDB
     #   resp.table.global_secondary_indexes[0].index_size_bytes #=> Integer
     #   resp.table.global_secondary_indexes[0].item_count #=> Integer
     #   resp.table.global_secondary_indexes[0].index_arn #=> String
+    #   resp.table.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table.stream_specification.stream_enabled #=> Boolean
     #   resp.table.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.table.latest_stream_label #=> String
@@ -2942,9 +3159,11 @@ module Aws::DynamoDB
     #   resp.table.replicas[0].replica_status_percent_progress #=> String
     #   resp.table.replicas[0].kms_master_key_id #=> String
     #   resp.table.replicas[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table.replicas[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table.replicas[0].global_secondary_indexes #=> Array
     #   resp.table.replicas[0].global_secondary_indexes[0].index_name #=> String
     #   resp.table.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table.replicas[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table.replicas[0].replica_inaccessible_date_time #=> Time
     #   resp.table.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -2962,6 +3181,8 @@ module Aws::DynamoDB
     #   resp.table.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table.table_class_summary.last_update_date_time #=> Time
     #   resp.table.deletion_protection_enabled #=> Boolean
+    #   resp.table.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table.on_demand_throughput.max_write_request_units #=> Integer
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -2981,15 +3202,12 @@ module Aws::DynamoDB
     # Describes auto scaling settings across replicas of the global table at
     # once.
     #
-    # This operation only applies to [Version 2019.11.21 (Current)][1] of
-    # global tables.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
+    # For global tables, this operation only applies to global tables using
+    # Version 2019.11.21 (Current version).
     #
     # @option params [required, String] :table_name
-    #   The name of the table.
+    #   The name of the table. You can also provide the Amazon Resource Name
+    #   (ARN) of the table in this parameter.
     #
     # @return [Types::DescribeTableReplicaAutoScalingOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2998,7 +3216,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_table_replica_auto_scaling({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #   })
     #
     # @example Response structure
@@ -3065,7 +3283,8 @@ module Aws::DynamoDB
     # table.
     #
     # @option params [required, String] :table_name
-    #   The name of the table to be described.
+    #   The name of the table to be described. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @return [Types::DescribeTimeToLiveOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3074,7 +3293,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_time_to_live({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #   })
     #
     # @example Response structure
@@ -3095,29 +3314,39 @@ module Aws::DynamoDB
     # This is done without deleting either of the resources.
     #
     # @option params [required, String] :table_name
-    #   The name of the DynamoDB table.
+    #   The name of the DynamoDB table. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, String] :stream_arn
     #   The ARN for a Kinesis data stream.
     #
+    # @option params [Types::EnableKinesisStreamingConfiguration] :enable_kinesis_streaming_configuration
+    #   The source for the Kinesis streaming information that is being
+    #   enabled.
+    #
     # @return [Types::KinesisStreamingDestinationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::KinesisStreamingDestinationOutput#table_name #table_name} => String
     #   * {Types::KinesisStreamingDestinationOutput#stream_arn #stream_arn} => String
     #   * {Types::KinesisStreamingDestinationOutput#destination_status #destination_status} => String
+    #   * {Types::KinesisStreamingDestinationOutput#enable_kinesis_streaming_configuration #enable_kinesis_streaming_configuration} => Types::EnableKinesisStreamingConfiguration
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.disable_kinesis_streaming_destination({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     stream_arn: "StreamArn", # required
+    #     enable_kinesis_streaming_configuration: {
+    #       approximate_creation_date_time_precision: "MILLISECOND", # accepts MILLISECOND, MICROSECOND
+    #     },
     #   })
     #
     # @example Response structure
     #
     #   resp.table_name #=> String
     #   resp.stream_arn #=> String
-    #   resp.destination_status #=> String, one of "ENABLING", "ACTIVE", "DISABLING", "DISABLED", "ENABLE_FAILED"
+    #   resp.destination_status #=> String, one of "ENABLING", "ACTIVE", "DISABLING", "DISABLED", "ENABLE_FAILED", "UPDATING"
+    #   resp.enable_kinesis_streaming_configuration.approximate_creation_date_time_precision #=> String, one of "MILLISECOND", "MICROSECOND"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DisableKinesisStreamingDestination AWS API Documentation
     #
@@ -3135,29 +3364,39 @@ module Aws::DynamoDB
     # Kinesis data stream is ACTIVE.
     #
     # @option params [required, String] :table_name
-    #   The name of the DynamoDB table.
+    #   The name of the DynamoDB table. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, String] :stream_arn
     #   The ARN for a Kinesis data stream.
     #
+    # @option params [Types::EnableKinesisStreamingConfiguration] :enable_kinesis_streaming_configuration
+    #   The source for the Kinesis streaming information that is being
+    #   enabled.
+    #
     # @return [Types::KinesisStreamingDestinationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::KinesisStreamingDestinationOutput#table_name #table_name} => String
     #   * {Types::KinesisStreamingDestinationOutput#stream_arn #stream_arn} => String
     #   * {Types::KinesisStreamingDestinationOutput#destination_status #destination_status} => String
+    #   * {Types::KinesisStreamingDestinationOutput#enable_kinesis_streaming_configuration #enable_kinesis_streaming_configuration} => Types::EnableKinesisStreamingConfiguration
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.enable_kinesis_streaming_destination({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     stream_arn: "StreamArn", # required
+    #     enable_kinesis_streaming_configuration: {
+    #       approximate_creation_date_time_precision: "MILLISECOND", # accepts MILLISECOND, MICROSECOND
+    #     },
     #   })
     #
     # @example Response structure
     #
     #   resp.table_name #=> String
     #   resp.stream_arn #=> String
-    #   resp.destination_status #=> String, one of "ENABLING", "ACTIVE", "DISABLING", "DISABLED", "ENABLE_FAILED"
+    #   resp.destination_status #=> String, one of "ENABLING", "ACTIVE", "DISABLING", "DISABLED", "ENABLE_FAILED", "UPDATING"
+    #   resp.enable_kinesis_streaming_configuration.approximate_creation_date_time_precision #=> String, one of "MILLISECOND", "MICROSECOND"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/EnableKinesisStreamingDestination AWS API Documentation
     #
@@ -3229,6 +3468,14 @@ module Aws::DynamoDB
     #   `LastEvaluatedKey` to apply in a subsequent operation to continue the
     #   operation.
     #
+    # @option params [String] :return_values_on_condition_check_failure
+    #   An optional parameter that returns the item attributes for an
+    #   `ExecuteStatement` operation that failed a condition check.
+    #
+    #   There is no additional cost associated with requesting a return value
+    #   aside from the small network and processing overhead of receiving a
+    #   larger response. No read capacity units are consumed.
+    #
     # @return [Types::ExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ExecuteStatementOutput#items #items} => Array&lt;Hash&lt;String,Types::AttributeValue&gt;&gt;
@@ -3245,6 +3492,7 @@ module Aws::DynamoDB
     #     next_token: "PartiQLNextToken",
     #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
     #     limit: 1,
+    #     return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
     #   })
     #
     # @example Response structure
@@ -3327,6 +3575,7 @@ module Aws::DynamoDB
     #       {
     #         statement: "PartiQLStatement", # required
     #         parameters: ["value"], # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #         return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
     #       },
     #     ],
     #     client_request_token: "ClientRequestToken",
@@ -3401,6 +3650,11 @@ module Aws::DynamoDB
     #   The ID of the Amazon Web Services account that owns the bucket the
     #   export will be stored in.
     #
+    #   <note markdown="1"> S3BucketOwner is a required parameter when exporting to a S3 bucket in
+    #   another account.
+    #
+    #    </note>
+    #
     # @option params [String] :s3_prefix
     #   The Amazon S3 bucket prefix to use as the file name and path of the
     #   exported snapshot.
@@ -3421,6 +3675,16 @@ module Aws::DynamoDB
     #   The format for the exported data. Valid values for `ExportFormat` are
     #   `DYNAMODB_JSON` or `ION`.
     #
+    # @option params [String] :export_type
+    #   Choice of whether to execute as a full export or incremental export.
+    #   Valid values are FULL\_EXPORT or INCREMENTAL\_EXPORT. The default
+    #   value is FULL\_EXPORT. If INCREMENTAL\_EXPORT is provided, the
+    #   IncrementalExportSpecification must also be used.
+    #
+    # @option params [Types::IncrementalExportSpecification] :incremental_export_specification
+    #   Optional object containing the parameters specific to an incremental
+    #   export.
+    #
     # @return [Types::ExportTableToPointInTimeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ExportTableToPointInTimeOutput#export_description #export_description} => Types::ExportDescription
@@ -3437,6 +3701,12 @@ module Aws::DynamoDB
     #     s3_sse_algorithm: "AES256", # accepts AES256, KMS
     #     s3_sse_kms_key_id: "S3SseKmsKeyId",
     #     export_format: "DYNAMODB_JSON", # accepts DYNAMODB_JSON, ION
+    #     export_type: "FULL_EXPORT", # accepts FULL_EXPORT, INCREMENTAL_EXPORT
+    #     incremental_export_specification: {
+    #       export_from_time: Time.now,
+    #       export_to_time: Time.now,
+    #       export_view_type: "NEW_IMAGE", # accepts NEW_IMAGE, NEW_AND_OLD_IMAGES
+    #     },
     #   })
     #
     # @example Response structure
@@ -3460,6 +3730,10 @@ module Aws::DynamoDB
     #   resp.export_description.export_format #=> String, one of "DYNAMODB_JSON", "ION"
     #   resp.export_description.billed_size_bytes #=> Integer
     #   resp.export_description.item_count #=> Integer
+    #   resp.export_description.export_type #=> String, one of "FULL_EXPORT", "INCREMENTAL_EXPORT"
+    #   resp.export_description.incremental_export_specification.export_from_time #=> Time
+    #   resp.export_description.incremental_export_specification.export_to_time #=> Time
+    #   resp.export_description.incremental_export_specification.export_view_type #=> String, one of "NEW_IMAGE", "NEW_AND_OLD_IMAGES"
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExportTableToPointInTime AWS API Documentation
     #
@@ -3482,7 +3756,8 @@ module Aws::DynamoDB
     # value.
     #
     # @option params [required, String] :table_name
-    #   The name of the table containing the requested item.
+    #   The name of the table containing the requested item. You can also
+    #   provide the Amazon Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, Hash<String,Types::AttributeValue>] :key
     #   A map of attribute names to `AttributeValue` objects, representing the
@@ -3622,7 +3897,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_item({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     key: { # required
     #       "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     },
@@ -3664,6 +3939,73 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
+    # Returns the resource-based policy document attached to the resource,
+    # which can be a table or stream, in JSON format.
+    #
+    # `GetResourcePolicy` follows an [ *eventually consistent* ][1] model.
+    # The following list describes the outcomes when you issue the
+    # `GetResourcePolicy` request immediately after issuing another request:
+    #
+    # * If you issue a `GetResourcePolicy` request immediately after a
+    #   `PutResourcePolicy` request, DynamoDB might return a
+    #   `PolicyNotFoundException`.
+    #
+    # * If you issue a `GetResourcePolicy`request immediately after a
+    #   `DeleteResourcePolicy` request, DynamoDB might return the policy
+    #   that was present before the deletion request.
+    #
+    # * If you issue a `GetResourcePolicy` request immediately after a
+    #   `CreateTable` request, which includes a resource-based policy,
+    #   DynamoDB might return a `ResourceNotFoundException` or a
+    #   `PolicyNotFoundException`.
+    #
+    # Because `GetResourcePolicy` uses an *eventually consistent* query, the
+    # metadata for your policy or table might not be available at that
+    # moment. Wait for a few seconds, and then retry the `GetResourcePolicy`
+    # request.
+    #
+    # After a `GetResourcePolicy` request returns a policy created using the
+    # `PutResourcePolicy` request, the policy will be applied in the
+    # authorization of requests to the resource. Because this process is
+    # eventually consistent, it will take some time to apply the policy to
+    # all requests to a resource. Policies that you attach while creating a
+    # table using the `CreateTable` request will always be applied to all
+    # requests for that table.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadConsistency.html
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the DynamoDB resource to which the
+    #   policy is attached. The resources you can specify include tables and
+    #   streams.
+    #
+    # @return [Types::GetResourcePolicyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetResourcePolicyOutput#policy #policy} => String
+    #   * {Types::GetResourcePolicyOutput#revision_id #revision_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_resource_policy({
+    #     resource_arn: "ResourceArnString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.policy #=> String
+    #   resp.revision_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetResourcePolicy AWS API Documentation
+    #
+    # @overload get_resource_policy(params = {})
+    # @param [Hash] params ({})
+    def get_resource_policy(params = {}, options = {})
+      req = build_request(:get_resource_policy, params)
+      req.send_request(options)
+    end
+
     # Imports table data from an S3 bucket.
     #
     # @option params [String] :client_token
@@ -3741,6 +4083,10 @@ module Aws::DynamoDB
     #         read_capacity_units: 1, # required
     #         write_capacity_units: 1, # required
     #       },
+    #       on_demand_throughput: {
+    #         max_read_request_units: 1,
+    #         max_write_request_units: 1,
+    #       },
     #       sse_specification: {
     #         enabled: false,
     #         sse_type: "AES256", # accepts AES256, KMS
@@ -3763,6 +4109,10 @@ module Aws::DynamoDB
     #             read_capacity_units: 1, # required
     #             write_capacity_units: 1, # required
     #           },
+    #           on_demand_throughput: {
+    #             max_read_request_units: 1,
+    #             max_write_request_units: 1,
+    #           },
     #         },
     #       ],
     #     },
@@ -3795,6 +4145,8 @@ module Aws::DynamoDB
     #   resp.import_table_description.table_creation_parameters.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
     #   resp.import_table_description.table_creation_parameters.provisioned_throughput.read_capacity_units #=> Integer
     #   resp.import_table_description.table_creation_parameters.provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.on_demand_throughput.max_write_request_units #=> Integer
     #   resp.import_table_description.table_creation_parameters.sse_specification.enabled #=> Boolean
     #   resp.import_table_description.table_creation_parameters.sse_specification.sse_type #=> String, one of "AES256", "KMS"
     #   resp.import_table_description.table_creation_parameters.sse_specification.kms_master_key_id #=> String
@@ -3808,6 +4160,8 @@ module Aws::DynamoDB
     #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
     #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
     #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.import_table_description.start_time #=> Time
     #   resp.import_table_description.end_time #=> Time
     #   resp.import_table_description.processed_size_bytes #=> Integer
@@ -3825,11 +4179,12 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # List backups associated with an Amazon Web Services account. To list
-    # backups for a given table, specify `TableName`. `ListBackups` returns
-    # a paginated list of results with at most 1 MB worth of items in a
-    # page. You can also specify a maximum number of entries to be returned
-    # in a page.
+    # List DynamoDB backups that are associated with an Amazon Web Services
+    # account and weren't made with Amazon Web Services Backup. To list
+    # these backups for a given table, specify `TableName`. `ListBackups`
+    # returns a paginated list of results with at most 1 MB worth of items
+    # in a page. You can also specify a maximum number of entries to be
+    # returned in a page.
     #
     # In the request, start time is inclusive, but end time is exclusive.
     # Note that these boundaries are for the time at which the original
@@ -3837,8 +4192,17 @@ module Aws::DynamoDB
     #
     # You can call `ListBackups` a maximum of five times per second.
     #
+    # If you want to retrieve the complete list of backups made with Amazon
+    # Web Services Backup, use the [Amazon Web Services Backup list API.][1]
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ListBackupJobs.html
+    #
     # @option params [String] :table_name
-    #   The backups from the table specified by `TableName` are listed.
+    #   Lists the backups from the table specified in `TableName`. You can
+    #   also provide the Amazon Resource Name (ARN) of the table in this
+    #   parameter.
     #
     # @option params [Integer] :limit
     #   Maximum number of backups to return at once.
@@ -3878,7 +4242,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_backups({
-    #     table_name: "TableName",
+    #     table_name: "TableArn",
     #     limit: 1,
     #     time_range_lower_bound: Time.now,
     #     time_range_upper_bound: Time.now,
@@ -3914,7 +4278,8 @@ module Aws::DynamoDB
     # global secondary indexes.
     #
     # @option params [String] :table_name
-    #   The name of the table.
+    #   The name of the table. You can also provide the Amazon Resource Name
+    #   (ARN) of the table in this parameter.
     #
     # @option params [String] :next_token
     #   A token to for the desired page, if there is one.
@@ -3932,7 +4297,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_contributor_insights({
-    #     table_name: "TableName",
+    #     table_name: "TableArn",
     #     next_token: "NextTokenString",
     #     max_results: 1,
     #   })
@@ -3987,6 +4352,7 @@ module Aws::DynamoDB
     #   resp.export_summaries #=> Array
     #   resp.export_summaries[0].export_arn #=> String
     #   resp.export_summaries[0].export_status #=> String, one of "IN_PROGRESS", "COMPLETED", "FAILED"
+    #   resp.export_summaries[0].export_type #=> String, one of "FULL_EXPORT", "INCREMENTAL_EXPORT"
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListExports AWS API Documentation
@@ -4000,21 +4366,22 @@ module Aws::DynamoDB
 
     # Lists all global tables that have a replica in the specified Region.
     #
-    # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
-    # global tables. We recommend using [Version 2019.11.21 (Current)][2]
-    # when creating new global tables, as it provides greater flexibility,
-    # higher efficiency and consumes less write capacity than 2017.11.29
-    # (Legacy). To determine which version you are using, see [Determining
-    # the version][3]. To update existing global tables from version
-    # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
-    # global tables][4].
+    # This documentation is for version 2017.11.29 (Legacy) of global
+    # tables, which should be avoided for new global tables. Customers
+    # should use [Global Tables version 2019.11.21 (Current)][1] when
+    # possible, because it provides greater flexibility, higher efficiency,
+    # and consumes less write capacity than 2017.11.29 (Legacy).
     #
+    #  To determine which version you're using, see [Determining the global
+    # table version you are using][2]. To update existing global tables from
+    # version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see
+    # [Upgrading global tables][3].
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
-    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
-    # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
+    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
     #
     # @option params [String] :exclusive_start_global_table_name
     #   The first global table name that this operation will evaluate.
@@ -4259,7 +4626,8 @@ module Aws::DynamoDB
     # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html
     #
     # @option params [required, String] :table_name
-    #   The name of the table to contain the item.
+    #   The name of the table to contain the item. You can also provide the
+    #   Amazon Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, Hash<String,Types::AttributeValue>] :item
     #   A map of attribute name/value pairs, one for each attribute. Only the
@@ -4451,6 +4819,14 @@ module Aws::DynamoDB
     #
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html
     #
+    # @option params [String] :return_values_on_condition_check_failure
+    #   An optional parameter that returns the item attributes for a `PutItem`
+    #   operation that failed a condition check.
+    #
+    #   There is no additional cost associated with requesting a return value
+    #   aside from the small network and processing overhead of receiving a
+    #   larger response. No read capacity units are consumed.
+    #
     # @return [Types::PutItemOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::PutItemOutput#attributes #attributes} => Hash&lt;String,Types::AttributeValue&gt;
@@ -4483,7 +4859,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.put_item({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     item: { # required
     #       "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     },
@@ -4506,6 +4882,7 @@ module Aws::DynamoDB
     #     expression_attribute_values: {
     #       "ExpressionAttributeValueVariable" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     },
+    #     return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
     #   })
     #
     # @example Response structure
@@ -4541,6 +4918,107 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
+    # Attaches a resource-based policy document to the resource, which can
+    # be a table or stream. When you attach a resource-based policy using
+    # this API, the policy application is [ *eventually consistent* ][1].
+    #
+    # `PutResourcePolicy` is an idempotent operation; running it multiple
+    # times on the same resource using the same policy document will return
+    # the same revision ID. If you specify an `ExpectedRevisionId` that
+    # doesn't match the current policy's `RevisionId`, the
+    # `PolicyNotFoundException` will be returned.
+    #
+    # <note markdown="1"> `PutResourcePolicy` is an asynchronous operation. If you issue a
+    # `GetResourcePolicy` request immediately after a `PutResourcePolicy`
+    # request, DynamoDB might return your previous policy, if there was one,
+    # or return the `PolicyNotFoundException`. This is because
+    # `GetResourcePolicy` uses an eventually consistent query, and the
+    # metadata for your policy or table might not be available at that
+    # moment. Wait for a few seconds, and then try the `GetResourcePolicy`
+    # request again.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadConsistency.html
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the DynamoDB resource to which the
+    #   policy will be attached. The resources you can specify include tables
+    #   and streams.
+    #
+    #   You can control index permissions using the base table's policy. To
+    #   specify the same permission level for your table and its indexes, you
+    #   can provide both the table and index Amazon Resource Name (ARN)s in
+    #   the `Resource` field of a given `Statement` in your policy document.
+    #   Alternatively, to specify different permissions for your table,
+    #   indexes, or both, you can define multiple `Statement` fields in your
+    #   policy document.
+    #
+    # @option params [required, String] :policy
+    #   An Amazon Web Services resource-based policy document in JSON format.
+    #
+    #   * The maximum size supported for a resource-based policy document is
+    #     20 KB. DynamoDB counts whitespaces when calculating the size of a
+    #     policy against this limit.
+    #
+    #   * Within a resource-based policy, if the action for a DynamoDB
+    #     service-linked role (SLR) to replicate data for a global table is
+    #     denied, adding or deleting a replica will fail with an error.
+    #
+    #   For a full list of all considerations that apply while attaching a
+    #   resource-based policy, see [Resource-based policy considerations][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-considerations.html
+    #
+    # @option params [String] :expected_revision_id
+    #   A string value that you can use to conditionally update your policy.
+    #   You can provide the revision ID of your existing policy to make
+    #   mutating requests against that policy.
+    #
+    #   <note markdown="1"> When you provide an expected revision ID, if the revision ID of the
+    #   existing policy on the resource doesn't match or if there's no
+    #   policy attached to the resource, your request will be rejected with a
+    #   `PolicyNotFoundException`.
+    #
+    #    </note>
+    #
+    #   To conditionally attach a policy when no policy exists for the
+    #   resource, specify `NO_POLICY` for the revision ID.
+    #
+    # @option params [Boolean] :confirm_remove_self_resource_access
+    #   Set this parameter to `true` to confirm that you want to remove your
+    #   permissions to change the policy of this resource in the future.
+    #
+    # @return [Types::PutResourcePolicyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::PutResourcePolicyOutput#revision_id #revision_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.put_resource_policy({
+    #     resource_arn: "ResourceArnString", # required
+    #     policy: "ResourcePolicy", # required
+    #     expected_revision_id: "PolicyRevisionId",
+    #     confirm_remove_self_resource_access: false,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.revision_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/PutResourcePolicy AWS API Documentation
+    #
+    # @overload put_resource_policy(params = {})
+    # @param [Hash] params ({})
+    def put_resource_policy(params = {}, options = {})
+      req = build_request(:put_resource_policy, params)
+      req.send_request(options)
+    end
+
     # You must provide the name of the partition key attribute and a single
     # value for that attribute. `Query` returns all items with that
     # partition key value. Optionally, you can provide a sort key attribute
@@ -4606,7 +5084,8 @@ module Aws::DynamoDB
     # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html#Query.Pagination
     #
     # @option params [required, String] :table_name
-    #   The name of the table containing the requested items.
+    #   The name of the table containing the requested items. You can also
+    #   provide the Amazon Resource Name (ARN) of the table in this parameter.
     #
     # @option params [String] :index_name
     #   The name of an index to query. This index can be any local secondary
@@ -4806,7 +5285,7 @@ module Aws::DynamoDB
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.FilterExpression.html
     #
     # @option params [String] :key_condition_expression
     #   The condition that specifies the key values for items to be retrieved
@@ -5009,7 +5488,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.query({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     index_name: "IndexName",
     #     select: "ALL_ATTRIBUTES", # accepts ALL_ATTRIBUTES, ALL_PROJECTED_ATTRIBUTES, SPECIFIC_ATTRIBUTES, COUNT
     #     attributes_to_get: ["AttributeName"],
@@ -5121,6 +5600,11 @@ module Aws::DynamoDB
     # @option params [Types::ProvisionedThroughput] :provisioned_throughput_override
     #   Provisioned throughput settings for the restored table.
     #
+    # @option params [Types::OnDemandThroughput] :on_demand_throughput_override
+    #   Sets the maximum number of read and write units for the specified
+    #   on-demand table. If you use this parameter, you must specify
+    #   `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both.
+    #
     # @option params [Types::SSESpecification] :sse_specification_override
     #   The new server-side encryption settings for the restored table.
     #
@@ -5151,6 +5635,10 @@ module Aws::DynamoDB
     #           read_capacity_units: 1, # required
     #           write_capacity_units: 1, # required
     #         },
+    #         on_demand_throughput: {
+    #           max_read_request_units: 1,
+    #           max_write_request_units: 1,
+    #         },
     #       },
     #     ],
     #     local_secondary_index_override: [
@@ -5172,6 +5660,10 @@ module Aws::DynamoDB
     #       read_capacity_units: 1, # required
     #       write_capacity_units: 1, # required
     #     },
+    #     on_demand_throughput_override: {
+    #       max_read_request_units: 1,
+    #       max_write_request_units: 1,
+    #     },
     #     sse_specification_override: {
     #       enabled: false,
     #       sse_type: "AES256", # accepts AES256, KMS
@@ -5230,6 +5722,8 @@ module Aws::DynamoDB
     #   resp.table_description.global_secondary_indexes[0].index_size_bytes #=> Integer
     #   resp.table_description.global_secondary_indexes[0].item_count #=> Integer
     #   resp.table_description.global_secondary_indexes[0].index_arn #=> String
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.stream_specification.stream_enabled #=> Boolean
     #   resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.table_description.latest_stream_label #=> String
@@ -5242,9 +5736,11 @@ module Aws::DynamoDB
     #   resp.table_description.replicas[0].replica_status_percent_progress #=> String
     #   resp.table_description.replicas[0].kms_master_key_id #=> String
     #   resp.table_description.replicas[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].global_secondary_indexes #=> Array
     #   resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
     #   resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
     #   resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -5262,6 +5758,8 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableFromBackup AWS API Documentation
     #
@@ -5275,7 +5773,7 @@ module Aws::DynamoDB
     # Restores the specified table to the specified point in time within
     # `EarliestRestorableDateTime` and `LatestRestorableDateTime`. You can
     # restore your table to any point in time during the last 35 days. Any
-    # number of users can execute up to 4 concurrent restores (any type of
+    # number of users can execute up to 50 concurrent restores (any type of
     # restore) in a given account.
     #
     # When you restore using point in time recovery, DynamoDB restores your
@@ -5346,6 +5844,11 @@ module Aws::DynamoDB
     # @option params [Types::ProvisionedThroughput] :provisioned_throughput_override
     #   Provisioned throughput settings for the restored table.
     #
+    # @option params [Types::OnDemandThroughput] :on_demand_throughput_override
+    #   Sets the maximum number of read and write units for the specified
+    #   on-demand table. If you use this parameter, you must specify
+    #   `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both.
+    #
     # @option params [Types::SSESpecification] :sse_specification_override
     #   The new server-side encryption settings for the restored table.
     #
@@ -5379,6 +5882,10 @@ module Aws::DynamoDB
     #           read_capacity_units: 1, # required
     #           write_capacity_units: 1, # required
     #         },
+    #         on_demand_throughput: {
+    #           max_read_request_units: 1,
+    #           max_write_request_units: 1,
+    #         },
     #       },
     #     ],
     #     local_secondary_index_override: [
@@ -5400,6 +5907,10 @@ module Aws::DynamoDB
     #       read_capacity_units: 1, # required
     #       write_capacity_units: 1, # required
     #     },
+    #     on_demand_throughput_override: {
+    #       max_read_request_units: 1,
+    #       max_write_request_units: 1,
+    #     },
     #     sse_specification_override: {
     #       enabled: false,
     #       sse_type: "AES256", # accepts AES256, KMS
@@ -5458,6 +5969,8 @@ module Aws::DynamoDB
     #   resp.table_description.global_secondary_indexes[0].index_size_bytes #=> Integer
     #   resp.table_description.global_secondary_indexes[0].item_count #=> Integer
     #   resp.table_description.global_secondary_indexes[0].index_arn #=> String
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.stream_specification.stream_enabled #=> Boolean
     #   resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.table_description.latest_stream_label #=> String
@@ -5470,9 +5983,11 @@ module Aws::DynamoDB
     #   resp.table_description.replicas[0].replica_status_percent_progress #=> String
     #   resp.table_description.replicas[0].kms_master_key_id #=> String
     #   resp.table_description.replicas[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].global_secondary_indexes #=> Array
     #   resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
     #   resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
     #   resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -5490,6 +6005,8 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableToPointInTime AWS API Documentation
     #
@@ -5504,18 +6021,30 @@ module Aws::DynamoDB
     # accessing every item in a table or a secondary index. To have DynamoDB
     # return fewer items, you can provide a `FilterExpression` operation.
     #
-    # If the total number of scanned items exceeds the maximum dataset size
-    # limit of 1 MB, the scan stops and results are returned to the user as
-    # a `LastEvaluatedKey` value to continue the scan in a subsequent
-    # operation. The results also include the number of items exceeding the
-    # limit. A scan can result in no table data meeting the filter criteria.
+    # If the total size of scanned items exceeds the maximum dataset size
+    # limit of 1 MB, the scan completes and results are returned to the
+    # user. The `LastEvaluatedKey` value is also returned and the requestor
+    # can use the `LastEvaluatedKey` to continue the scan in a subsequent
+    # operation. Each scan response also includes number of items that were
+    # scanned (ScannedCount) as part of the request. If using a
+    # `FilterExpression`, a scan result can result in no items meeting the
+    # criteria and the `Count` will result in zero. If you did not use a
+    # `FilterExpression` in the scan request, then `Count` is the same as
+    # `ScannedCount`.
+    #
+    # <note markdown="1"> `Count` and `ScannedCount` only return the count of items specific to
+    # a single scan request and, unless the table is less than 1MB, do not
+    # represent the total number of items in the table.
     #
-    # A single `Scan` operation reads up to the maximum number of items set
-    # (if using the `Limit` parameter) or a maximum of 1 MB of data and then
-    # apply any filtering to the results using `FilterExpression`. If
-    # `LastEvaluatedKey` is present in the response, you need to paginate
-    # the result set. For more information, see [Paginating the Results][1]
-    # in the *Amazon DynamoDB Developer Guide*.
+    #  </note>
+    #
+    # A single `Scan` operation first reads up to the maximum number of
+    # items set (if using the `Limit` parameter) or a maximum of 1 MB of
+    # data and then applies any filtering to the results if a
+    # `FilterExpression` is provided. If `LastEvaluatedKey` is present in
+    # the response, pagination is required to complete the full table scan.
+    # For more information, see [Paginating the Results][1] in the *Amazon
+    # DynamoDB Developer Guide*.
     #
     # `Scan` operations proceed sequentially; however, for faster
     # performance on a large table or secondary index, applications can
@@ -5523,11 +6052,21 @@ module Aws::DynamoDB
     # `TotalSegments` parameters. For more information, see [Parallel
     # Scan][2] in the *Amazon DynamoDB Developer Guide*.
     #
-    # `Scan` uses eventually consistent reads when accessing the data in a
-    # table; therefore, the result set might not include the changes to data
-    # in the table immediately before the operation began. If you need a
-    # consistent copy of the data, as of the time that the `Scan` begins,
-    # you can set the `ConsistentRead` parameter to `true`.
+    # By default, a `Scan` uses eventually consistent reads when accessing
+    # the items in a table. Therefore, the results from an eventually
+    # consistent `Scan` may not include the latest item changes at the time
+    # the scan iterates through each item in the table. If you require a
+    # strongly consistent read of each item as the scan iterates through the
+    # items in the table, you can set the `ConsistentRead` parameter to
+    # true. Strong consistency only relates to the consistency of the read
+    # at the item level.
+    #
+    # <note markdown="1"> DynamoDB does not provide snapshot isolation for a scan operation when
+    # the `ConsistentRead` parameter is set to true. Thus, a DynamoDB scan
+    # operation does not guarantee that all reads in a scan see a consistent
+    # snapshot of the table when the scan operation was requested.
+    #
+    #  </note>
     #
     #
     #
@@ -5535,9 +6074,11 @@ module Aws::DynamoDB
     # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Scan.html#Scan.ParallelScan
     #
     # @option params [required, String] :table_name
-    #   The name of the table containing the requested items; or, if you
-    #   provide `IndexName`, the name of the table to which that index
-    #   belongs.
+    #   The name of the table containing the requested items or if you provide
+    #   `IndexName`, the name of the table to which that index belongs.
+    #
+    #   You can also provide the Amazon Resource Name (ARN) of the table in
+    #   this parameter.
     #
     # @option params [String] :index_name
     #   The name of a secondary index to scan. This index can be any local
@@ -5735,7 +6276,7 @@ module Aws::DynamoDB
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Scan.html#Scan.FilterExpression
     #
     # @option params [Hash<String,String>] :expression_attribute_names
     #   One or more substitution tokens for attribute names in an expression.
@@ -5881,7 +6422,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.scan({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     index_name: "IndexName",
     #     attributes_to_get: ["AttributeName"],
     #     limit: 1,
@@ -6031,7 +6572,7 @@ module Aws::DynamoDB
     #           key: { # required
     #             "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #           },
-    #           table_name: "TableName", # required
+    #           table_name: "TableArn", # required
     #           projection_expression: "ProjectionExpression",
     #           expression_attribute_names: {
     #             "ExpressionAttributeNameVariable" => "AttributeName",
@@ -6201,7 +6742,7 @@ module Aws::DynamoDB
     #           key: { # required
     #             "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #           },
-    #           table_name: "TableName", # required
+    #           table_name: "TableArn", # required
     #           condition_expression: "ConditionExpression", # required
     #           expression_attribute_names: {
     #             "ExpressionAttributeNameVariable" => "AttributeName",
@@ -6215,7 +6756,7 @@ module Aws::DynamoDB
     #           item: { # required
     #             "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #           },
-    #           table_name: "TableName", # required
+    #           table_name: "TableArn", # required
     #           condition_expression: "ConditionExpression",
     #           expression_attribute_names: {
     #             "ExpressionAttributeNameVariable" => "AttributeName",
@@ -6229,7 +6770,7 @@ module Aws::DynamoDB
     #           key: { # required
     #             "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #           },
-    #           table_name: "TableName", # required
+    #           table_name: "TableArn", # required
     #           condition_expression: "ConditionExpression",
     #           expression_attribute_names: {
     #             "ExpressionAttributeNameVariable" => "AttributeName",
@@ -6244,7 +6785,7 @@ module Aws::DynamoDB
     #             "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #           },
     #           update_expression: "UpdateExpression", # required
-    #           table_name: "TableName", # required
+    #           table_name: "TableArn", # required
     #           condition_expression: "ConditionExpression",
     #           expression_attribute_names: {
     #             "ExpressionAttributeNameVariable" => "AttributeName",
@@ -6280,11 +6821,11 @@ module Aws::DynamoDB
     #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
     #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
     #   resp.item_collection_metrics #=> Hash
-    #   resp.item_collection_metrics["TableName"] #=> Array
-    #   resp.item_collection_metrics["TableName"][0].item_collection_key #=> Hash
-    #   resp.item_collection_metrics["TableName"][0].item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
-    #   resp.item_collection_metrics["TableName"][0].size_estimate_range_gb #=> Array
-    #   resp.item_collection_metrics["TableName"][0].size_estimate_range_gb[0] #=> Float
+    #   resp.item_collection_metrics["TableArn"] #=> Array
+    #   resp.item_collection_metrics["TableArn"][0].item_collection_key #=> Hash
+    #   resp.item_collection_metrics["TableArn"][0].item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.item_collection_metrics["TableArn"][0].size_estimate_range_gb #=> Array
+    #   resp.item_collection_metrics["TableArn"][0].size_estimate_range_gb[0] #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TransactWriteItems AWS API Documentation
     #
@@ -6347,7 +6888,8 @@ module Aws::DynamoDB
     # 35 days.
     #
     # @option params [required, String] :table_name
-    #   The name of the table.
+    #   The name of the table. You can also provide the Amazon Resource Name
+    #   (ARN) of the table in this parameter.
     #
     # @option params [required, Types::PointInTimeRecoverySpecification] :point_in_time_recovery_specification
     #   Represents the settings used to enable point in time recovery.
@@ -6359,7 +6901,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_continuous_backups({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     point_in_time_recovery_specification: { # required
     #       point_in_time_recovery_enabled: false, # required
     #     },
@@ -6391,7 +6933,8 @@ module Aws::DynamoDB
     # CloudWatch Contributor Insights for DynamoDB for this table.
     #
     # @option params [required, String] :table_name
-    #   The name of the table.
+    #   The name of the table. You can also provide the Amazon Resource Name
+    #   (ARN) of the table in this parameter.
     #
     # @option params [String] :index_name
     #   The global secondary index name, if applicable.
@@ -6408,7 +6951,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_contributor_insights({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     index_name: "IndexName",
     #     contributor_insights_action: "ENABLE", # required, accepts ENABLE, DISABLE
     #   })
@@ -6434,18 +6977,20 @@ module Aws::DynamoDB
     # have the same key schema, have DynamoDB Streams enabled, and have the
     # same provisioned and maximum write capacity units.
     #
-    # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
-    # global tables. We recommend using [Version 2019.11.21 (Current)][2]
-    # when creating new global tables, as it provides greater flexibility,
-    # higher efficiency and consumes less write capacity than 2017.11.29
-    # (Legacy). To determine which version you are using, see [Determining
-    # the version][3]. To update existing global tables from version
-    # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
-    # global tables][4].
+    # This documentation is for version 2017.11.29 (Legacy) of global
+    # tables, which should be avoided for new global tables. Customers
+    # should use [Global Tables version 2019.11.21 (Current)][1] when
+    # possible, because it provides greater flexibility, higher efficiency,
+    # and consumes less write capacity than 2017.11.29 (Legacy).
+    #
+    #  To determine which version you're using, see [Determining the global
+    # table version you are using][2]. To update existing global tables from
+    # version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see
+    # [Upgrading global tables][3].
     #
-    # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
-    # tables. If you are using global tables [Version 2019.11.21][2] you can
-    # use [DescribeTable][5] instead.
+    # <note markdown="1"> For global tables, this operation only applies to global tables using
+    # Version 2019.11.21 (Current version). If you are using global tables
+    # [Version 2019.11.21][1] you can use [UpdateTable][4] instead.
     #
     #  Although you can use `UpdateGlobalTable` to add replicas and remove
     # replicas in a single request, for simplicity we recommend that you
@@ -6466,11 +7011,10 @@ module Aws::DynamoDB
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
-    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
-    # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
-    # [5]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
+    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
+    # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html
     #
     # @option params [required, String] :global_table_name
     #   The global table name.
@@ -6508,9 +7052,11 @@ module Aws::DynamoDB
     #   resp.global_table_description.replication_group[0].replica_status_percent_progress #=> String
     #   resp.global_table_description.replication_group[0].kms_master_key_id #=> String
     #   resp.global_table_description.replication_group[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.global_table_description.replication_group[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.global_table_description.replication_group[0].global_secondary_indexes #=> Array
     #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
     #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.global_table_description.replication_group[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
     #   resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -6530,21 +7076,22 @@ module Aws::DynamoDB
 
     # Updates settings for a global table.
     #
-    # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
-    # global tables. We recommend using [Version 2019.11.21 (Current)][2]
-    # when creating new global tables, as it provides greater flexibility,
-    # higher efficiency and consumes less write capacity than 2017.11.29
-    # (Legacy). To determine which version you are using, see [Determining
-    # the version][3]. To update existing global tables from version
-    # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
-    # global tables][4].
+    # This documentation is for version 2017.11.29 (Legacy) of global
+    # tables, which should be avoided for new global tables. Customers
+    # should use [Global Tables version 2019.11.21 (Current)][1] when
+    # possible, because it provides greater flexibility, higher efficiency,
+    # and consumes less write capacity than 2017.11.29 (Legacy).
     #
+    #  To determine which version you're using, see [Determining the global
+    # table version you are using][2]. To update existing global tables from
+    # version 2017.11.29 (Legacy) to version 2019.11.21 (Current), see
+    # [Upgrading global tables][3].
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
-    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
-    # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GlobalTables.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
+    # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
     #
     # @option params [required, String] :global_table_name
     #   The name of the global table
@@ -6556,16 +7103,16 @@ module Aws::DynamoDB
     #
     #   * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
     #     workloads. `PROVISIONED` sets the billing mode to [Provisioned
-    #     Mode][1].
+    #     capacity mode][1].
     #
     #   * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
     #     unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
-    #     [On-Demand Mode][2].
+    #     [On-demand capacity mode][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
-    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/provisioned-capacity-mode.html
+    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/on-demand-capacity-mode.html
     #
     # @option params [Integer] :global_table_provisioned_write_capacity_units
     #   The maximum number of writes consumed per second before DynamoDB
@@ -6753,7 +7300,8 @@ module Aws::DynamoDB
     # `UpdateItem` operation using the `ReturnValues` parameter.
     #
     # @option params [required, String] :table_name
-    #   The name of the table containing the item to update.
+    #   The name of the table containing the item to update. You can also
+    #   provide the Amazon Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, Hash<String,Types::AttributeValue>] :key
     #   The primary key of the item to be updated. Each element consists of an
@@ -7027,6 +7575,14 @@ module Aws::DynamoDB
     #
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.SpecifyingConditions.html
     #
+    # @option params [String] :return_values_on_condition_check_failure
+    #   An optional parameter that returns the item attributes for an
+    #   `UpdateItem` operation that failed a condition check.
+    #
+    #   There is no additional cost associated with requesting a return value
+    #   aside from the small network and processing overhead of receiving a
+    #   larger response. No read capacity units are consumed.
+    #
     # @return [Types::UpdateItemOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateItemOutput#attributes #attributes} => Hash&lt;String,Types::AttributeValue&gt;
@@ -7070,7 +7626,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_item({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     key: { # required
     #       "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     },
@@ -7100,6 +7656,7 @@ module Aws::DynamoDB
     #     expression_attribute_values: {
     #       "ExpressionAttributeValueVariable" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     },
+    #     return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
     #   })
     #
     # @example Response structure
@@ -7135,11 +7692,56 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
+    # The command to update the Kinesis stream destination.
+    #
+    # @option params [required, String] :table_name
+    #   The table name for the Kinesis streaming destination input. You can
+    #   also provide the ARN of the table in this parameter.
+    #
+    # @option params [required, String] :stream_arn
+    #   The Amazon Resource Name (ARN) for the Kinesis stream input.
+    #
+    # @option params [Types::UpdateKinesisStreamingConfiguration] :update_kinesis_streaming_configuration
+    #   The command to update the Kinesis stream configuration.
+    #
+    # @return [Types::UpdateKinesisStreamingDestinationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::UpdateKinesisStreamingDestinationOutput#table_name #table_name} => String
+    #   * {Types::UpdateKinesisStreamingDestinationOutput#stream_arn #stream_arn} => String
+    #   * {Types::UpdateKinesisStreamingDestinationOutput#destination_status #destination_status} => String
+    #   * {Types::UpdateKinesisStreamingDestinationOutput#update_kinesis_streaming_configuration #update_kinesis_streaming_configuration} => Types::UpdateKinesisStreamingConfiguration
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_kinesis_streaming_destination({
+    #     table_name: "TableArn", # required
+    #     stream_arn: "StreamArn", # required
+    #     update_kinesis_streaming_configuration: {
+    #       approximate_creation_date_time_precision: "MILLISECOND", # accepts MILLISECOND, MICROSECOND
+    #     },
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.table_name #=> String
+    #   resp.stream_arn #=> String
+    #   resp.destination_status #=> String, one of "ENABLING", "ACTIVE", "DISABLING", "DISABLED", "ENABLE_FAILED", "UPDATING"
+    #   resp.update_kinesis_streaming_configuration.approximate_creation_date_time_precision #=> String, one of "MILLISECOND", "MICROSECOND"
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateKinesisStreamingDestination AWS API Documentation
+    #
+    # @overload update_kinesis_streaming_destination(params = {})
+    # @param [Hash] params ({})
+    def update_kinesis_streaming_destination(params = {}, options = {})
+      req = build_request(:update_kinesis_streaming_destination, params)
+      req.send_request(options)
+    end
+
     # Modifies the provisioned throughput settings, global secondary
     # indexes, or DynamoDB Streams settings for a given table.
     #
-    # This operation only applies to [Version 2019.11.21 (Current)][1] of
-    # global tables.
+    # For global tables, this operation only applies to global tables using
+    # Version 2019.11.21 (Current version).
     #
     # You can only perform one of the following operations at once:
     #
@@ -7151,16 +7753,12 @@ module Aws::DynamoDB
     #   begins backfilling, you can use `UpdateTable` to perform other
     #   operations.
     #
-    # `UpdateTable` is an asynchronous operation; while it is executing, the
-    # table status changes from `ACTIVE` to `UPDATING`. While it is
-    # `UPDATING`, you cannot issue another `UpdateTable` request. When the
+    # `UpdateTable` is an asynchronous operation; while it's executing, the
+    # table status changes from `ACTIVE` to `UPDATING`. While it's
+    # `UPDATING`, you can't issue another `UpdateTable` request. When the
     # table returns to the `ACTIVE` state, the `UpdateTable` operation is
     # complete.
     #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    #
     # @option params [Array<Types::AttributeDefinition>] :attribute_definitions
     #   An array of attributes that describe the key schema for the table and
     #   indexes. If you are adding a new global secondary index to the table,
@@ -7168,7 +7766,8 @@ module Aws::DynamoDB
     #   index.
     #
     # @option params [required, String] :table_name
-    #   The name of the table to be updated.
+    #   The name of the table to be updated. You can also provide the Amazon
+    #   Resource Name (ARN) of the table in this parameter.
     #
     # @option params [String] :billing_mode
     #   Controls how you are charged for read and write throughput and how you
@@ -7180,16 +7779,16 @@ module Aws::DynamoDB
     #
     #   * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
     #     workloads. `PROVISIONED` sets the billing mode to [Provisioned
-    #     Mode][1].
+    #     capacity mode][1].
     #
     #   * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
     #     unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
-    #     [On-Demand Mode][2].
+    #     [On-demand capacity mode][2].
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
-    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/provisioned-capacity-mode.html
+    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/on-demand-capacity-mode.html
     #
     # @option params [Types::ProvisionedThroughput] :provisioned_throughput
     #   The new provisioned throughput settings for the specified table or
@@ -7219,9 +7818,9 @@ module Aws::DynamoDB
     # @option params [Types::StreamSpecification] :stream_specification
     #   Represents the DynamoDB Streams configuration for the table.
     #
-    #   <note markdown="1"> You receive a `ResourceInUseException` if you try to enable a stream
-    #   on a table that already has a stream, or if you try to disable a
-    #   stream on a table that doesn't have a stream.
+    #   <note markdown="1"> You receive a `ValidationException` if you try to enable a stream on a
+    #   table that already has a stream, or if you try to disable a stream on
+    #   a table that doesn't have a stream.
     #
     #    </note>
     #
@@ -7232,15 +7831,11 @@ module Aws::DynamoDB
     #   A list of replica update actions (create, delete, or update) for the
     #   table.
     #
-    #   <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
-    #   global tables.
+    #   <note markdown="1"> For global tables, this property only applies to global tables using
+    #   Version 2019.11.21 (Current version).
     #
     #    </note>
     #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
-    #
     # @option params [String] :table_class
     #   The table class of the table to be updated. Valid values are
     #   `STANDARD` and `STANDARD_INFREQUENT_ACCESS`.
@@ -7249,6 +7844,11 @@ module Aws::DynamoDB
     #   Indicates whether deletion protection is to be enabled (true) or
     #   disabled (false) on the table.
     #
+    # @option params [Types::OnDemandThroughput] :on_demand_throughput
+    #   Updates the maximum number of read and write units for the specified
+    #   table in on-demand capacity mode. If you use this parameter, you must
+    #   specify `MaxReadRequestUnits`, `MaxWriteRequestUnits`, or both.
+    #
     # @return [Types::UpdateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateTableOutput#table_description #table_description} => Types::TableDescription
@@ -7312,7 +7912,7 @@ module Aws::DynamoDB
     #         attribute_type: "S", # required, accepts S, N, B
     #       },
     #     ],
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
     #     provisioned_throughput: {
     #       read_capacity_units: 1, # required
@@ -7322,10 +7922,14 @@ module Aws::DynamoDB
     #       {
     #         update: {
     #           index_name: "IndexName", # required
-    #           provisioned_throughput: { # required
+    #           provisioned_throughput: {
     #             read_capacity_units: 1, # required
     #             write_capacity_units: 1, # required
     #           },
+    #           on_demand_throughput: {
+    #             max_read_request_units: 1,
+    #             max_write_request_units: 1,
+    #           },
     #         },
     #         create: {
     #           index_name: "IndexName", # required
@@ -7343,6 +7947,10 @@ module Aws::DynamoDB
     #             read_capacity_units: 1, # required
     #             write_capacity_units: 1, # required
     #           },
+    #           on_demand_throughput: {
+    #             max_read_request_units: 1,
+    #             max_write_request_units: 1,
+    #           },
     #         },
     #         delete: {
     #           index_name: "IndexName", # required
@@ -7366,12 +7974,18 @@ module Aws::DynamoDB
     #           provisioned_throughput_override: {
     #             read_capacity_units: 1,
     #           },
+    #           on_demand_throughput_override: {
+    #             max_read_request_units: 1,
+    #           },
     #           global_secondary_indexes: [
     #             {
     #               index_name: "IndexName", # required
     #               provisioned_throughput_override: {
     #                 read_capacity_units: 1,
     #               },
+    #               on_demand_throughput_override: {
+    #                 max_read_request_units: 1,
+    #               },
     #             },
     #           ],
     #           table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
@@ -7382,12 +7996,18 @@ module Aws::DynamoDB
     #           provisioned_throughput_override: {
     #             read_capacity_units: 1,
     #           },
+    #           on_demand_throughput_override: {
+    #             max_read_request_units: 1,
+    #           },
     #           global_secondary_indexes: [
     #             {
     #               index_name: "IndexName", # required
     #               provisioned_throughput_override: {
     #                 read_capacity_units: 1,
     #               },
+    #               on_demand_throughput_override: {
+    #                 max_read_request_units: 1,
+    #               },
     #             },
     #           ],
     #           table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
@@ -7399,6 +8019,10 @@ module Aws::DynamoDB
     #     ],
     #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #     deletion_protection_enabled: false,
+    #     on_demand_throughput: {
+    #       max_read_request_units: 1,
+    #       max_write_request_units: 1,
+    #     },
     #   })
     #
     # @example Response structure
@@ -7452,6 +8076,8 @@ module Aws::DynamoDB
     #   resp.table_description.global_secondary_indexes[0].index_size_bytes #=> Integer
     #   resp.table_description.global_secondary_indexes[0].item_count #=> Integer
     #   resp.table_description.global_secondary_indexes[0].index_arn #=> String
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.global_secondary_indexes[0].on_demand_throughput.max_write_request_units #=> Integer
     #   resp.table_description.stream_specification.stream_enabled #=> Boolean
     #   resp.table_description.stream_specification.stream_view_type #=> String, one of "NEW_IMAGE", "OLD_IMAGE", "NEW_AND_OLD_IMAGES", "KEYS_ONLY"
     #   resp.table_description.latest_stream_label #=> String
@@ -7464,9 +8090,11 @@ module Aws::DynamoDB
     #   resp.table_description.replicas[0].replica_status_percent_progress #=> String
     #   resp.table_description.replicas[0].kms_master_key_id #=> String
     #   resp.table_description.replicas[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].global_secondary_indexes #=> Array
     #   resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
     #   resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
+    #   resp.table_description.replicas[0].global_secondary_indexes[0].on_demand_throughput_override.max_read_request_units #=> Integer
     #   resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
     #   resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
@@ -7484,6 +8112,8 @@ module Aws::DynamoDB
     #   resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
     #   resp.table_description.table_class_summary.last_update_date_time #=> Time
     #   resp.table_description.deletion_protection_enabled #=> Boolean
+    #   resp.table_description.on_demand_throughput.max_read_request_units #=> Integer
+    #   resp.table_description.on_demand_throughput.max_write_request_units #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTable AWS API Documentation
     #
@@ -7496,19 +8126,16 @@ module Aws::DynamoDB
 
     # Updates auto scaling settings on your global tables at once.
     #
-    # This operation only applies to [Version 2019.11.21 (Current)][1] of
-    # global tables.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
+    # For global tables, this operation only applies to global tables using
+    # Version 2019.11.21 (Current version).
     #
     # @option params [Array<Types::GlobalSecondaryIndexAutoScalingUpdate>] :global_secondary_index_updates
     #   Represents the auto scaling settings of the global secondary indexes
     #   of the replica to be updated.
     #
     # @option params [required, String] :table_name
-    #   The name of the global table to be updated.
+    #   The name of the global table to be updated. You can also provide the
+    #   Amazon Resource Name (ARN) of the table in this parameter.
     #
     # @option params [Types::AutoScalingSettingsUpdate] :provisioned_write_capacity_auto_scaling_update
     #   Represents the auto scaling settings to be modified for a global table
@@ -7545,7 +8172,7 @@ module Aws::DynamoDB
     #         },
     #       },
     #     ],
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     provisioned_write_capacity_auto_scaling_update: {
     #       minimum_units: 1,
     #       maximum_units: 1,
@@ -7701,7 +8328,8 @@ module Aws::DynamoDB
     # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/TTL.html
     #
     # @option params [required, String] :table_name
-    #   The name of the table to be configured.
+    #   The name of the table to be configured. You can also provide the
+    #   Amazon Resource Name (ARN) of the table in this parameter.
     #
     # @option params [required, Types::TimeToLiveSpecification] :time_to_live_specification
     #   Represents the settings used to enable or disable Time to Live for the
@@ -7714,7 +8342,7 @@ module Aws::DynamoDB
     # @example Request syntax with placeholder values
     #
     #   resp = client.update_time_to_live({
-    #     table_name: "TableName", # required
+    #     table_name: "TableArn", # required
     #     time_to_live_specification: { # required
     #       enabled: false, # required
     #       attribute_name: "TimeToLiveAttributeName", # required
@@ -7748,7 +8376,7 @@ module Aws::DynamoDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.84.0'
+      context[:gem_version] = '1.118.0'
       Seahorse::Client::Request.new(handlers, context)
     end