aws-sdk-dynamodb 1.64.0 → 1.68.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 38ec3df89d983cdd2b7499a81f4dfdc58db18d7147f320c3e0f0bd1edc3a7cef
-  data.tar.gz: ca2dfb651dabbec6fac5db86b6f7512781b9e5339cfd66df4c9f8eaa647e369f
+  metadata.gz: 97f6b144f04fae76f714c5c9fd5408fb6693dd67eae297ff6e04d84110f90d62
+  data.tar.gz: 725580524b672d63f0a61159060abc6e91d9b6074d53d5b5c361815b65885203
 SHA512:
-  metadata.gz: d94e44576ca5fcdd9b3969501eacac6a167bac2f2cbda8cabb96113fc56c00a113898fc699ae0dc53978521d7b24ce27b453c9e00238ebb28d5a347274a95103
-  data.tar.gz: d6396a29a8c2f055b1fe5b711ab7b2ae3898ec4a51a337f41d87eb7a94e8ab68f8d65b46370aa4d9d6e746e6ec66ae22580e07b5179169d0f41409d3ba5092d8
+  metadata.gz: d7519ed0d13b5c83a5e9dea46c33f3fd9125d7f5fcc01bf790ba7d4a5fb069407fc3a675cc5c018d1a280693432254046d12b26483479647e1d492062f9903ec
+  data.tar.gz: 1ba380b879de7ecffde002ea1a50366209f4dd83451d30d48bbb869d206495a738ae698b625b24806833dce3501e0e94823cac561be54ff25512ede883206e97

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.68.0 (2021-11-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.67.0 (2021-11-23)
+------------------
+
+* Feature - DynamoDB PartiQL now supports ReturnConsumedCapacity, which returns capacity units consumed by PartiQL APIs if the request specified returnConsumedCapacity parameter. PartiQL APIs include ExecuteStatement, BatchExecuteStatement, and ExecuteTransaction.
+
+1.66.0 (2021-11-11)
+------------------
+
+* Feature - Updated Help section for "dynamodb update-contributor-insights" API
+
+1.65.0 (2021-11-04)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.64.0 (2021-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.64.0
+1.68.0

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

@@ -125,7 +125,9 @@ module Aws::DynamoDB
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -304,6 +306,15 @@ module Aws::DynamoDB
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Boolean] :use_dualstack_endpoint
+    #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
+    #     will be used if available.
+    #
+    #   @option options [Boolean] :use_fips_endpoint
+    #     When set to `true`, fips compatible endpoints will be used if available.
+    #     When a `fips` region is used, the region is normalized and this config
+    #     is set to `true`.
+    #
     #   @option options [Boolean] :validate_params (true)
     #     When `true`, request parameters are validated before
     #     sending the request.
@@ -356,15 +367,38 @@ module Aws::DynamoDB
 
     # @!group API Operations
 
-    # This operation allows you to perform batch reads and writes on data
+    # This operation allows you to perform batch reads or writes on data
     # stored in DynamoDB, using PartiQL.
     #
+    # <note markdown="1"> The entire batch must consist of either read statements or write
+    # statements, you cannot mix both in one batch.
+    #
+    #  </note>
+    #
     # @option params [required, Array<Types::BatchStatementRequest>] :statements
     #   The list of PartiQL statements representing the batch to run.
     #
+    # @option params [String] :return_consumed_capacity
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
+    #
+    #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
+    #     for the operation, together with `ConsumedCapacity` for each table
+    #     and secondary index that was accessed.
+    #
+    #     Note that some operations, such as `GetItem` and `BatchGetItem`, do
+    #     not access any indexes at all. In these cases, specifying `INDEXES`
+    #     will only return `ConsumedCapacity` information for table(s).
+    #
+    #   * `TOTAL` - The response includes only the aggregate
+    #     `ConsumedCapacity` for the operation.
+    #
+    #   * `NONE` - No `ConsumedCapacity` details are included in the response.
+    #
     # @return [Types::BatchExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::BatchExecuteStatementOutput#responses #responses} => Array&lt;Types::BatchStatementResponse&gt;
+    #   * {Types::BatchExecuteStatementOutput#consumed_capacity #consumed_capacity} => Array&lt;Types::ConsumedCapacity&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -376,6 +410,7 @@ module Aws::DynamoDB
     #         consistent_read: false,
     #       },
     #     ],
+    #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
     #   })
     #
     # @example Response structure
@@ -386,6 +421,22 @@ module Aws::DynamoDB
     #   resp.responses[0].table_name #=> String
     #   resp.responses[0].item #=> Hash
     #   resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.consumed_capacity #=> Array
+    #   resp.consumed_capacity[0].table_name #=> String
+    #   resp.consumed_capacity[0].capacity_units #=> Float
+    #   resp.consumed_capacity[0].read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].table.read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].table.write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].table.capacity_units #=> Float
+    #   resp.consumed_capacity[0].local_secondary_indexes #=> Hash
+    #   resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
+    #   resp.consumed_capacity[0].global_secondary_indexes #=> Hash
+    #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchExecuteStatement AWS API Documentation
     #
@@ -547,8 +598,8 @@ module Aws::DynamoDB
     #   [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -796,8 +847,8 @@ module Aws::DynamoDB
     #       in the table's attribute definition.
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -1100,9 +1151,9 @@ module Aws::DynamoDB
     end
 
     # The `CreateTable` operation adds a new table to your account. In an
-    # AWS account, table names must be unique within each Region. That is,
-    # you can have two tables with same name if you create the tables in
-    # different Regions.
+    # Amazon Web Services account, table names must be unique within each
+    # Region. That is, you can have two tables with same name if you create
+    # the tables in different Regions.
     #
     # `CreateTable` is an asynchronous operation. Upon receiving a
     # `CreateTable` request, DynamoDB immediately returns a response with a
@@ -1689,8 +1740,8 @@ module Aws::DynamoDB
     #    </note>
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -2456,25 +2507,26 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # Returns the current provisioned-capacity quotas for your AWS account
-    # in a Region, both for the Region as a whole and for any one DynamoDB
-    # table that you create there.
-    #
-    # When you establish an AWS account, the account has initial quotas on
-    # the maximum read capacity units and write capacity units that you can
-    # provision across all of your DynamoDB tables in a given Region. Also,
-    # there are per-table quotas that apply when you create a table there.
-    # For more information, see [Service, Account, and Table Quotas][1] page
-    # in the *Amazon DynamoDB Developer Guide*.
-    #
-    # Although you can increase these quotas by filing a case at [AWS
-    # Support Center][2], obtaining the increase is not instantaneous. The
-    # `DescribeLimits` action lets you write code to compare the capacity
-    # you are currently using to those quotas imposed by your account so
-    # that you have enough time to apply for an increase before you hit a
-    # quota.
-    #
-    # For example, you could use one of the AWS SDKs to do the following:
+    # Returns the current provisioned-capacity quotas for your Amazon Web
+    # Services account in a Region, both for the Region as a whole and for
+    # any one DynamoDB table that you create there.
+    #
+    # When you establish an Amazon Web Services account, the account has
+    # initial quotas on the maximum read capacity units and write capacity
+    # units that you can provision across all of your DynamoDB tables in a
+    # given Region. Also, there are per-table quotas that apply when you
+    # create a table there. For more information, see [Service, Account, and
+    # Table Quotas][1] page in the *Amazon DynamoDB Developer Guide*.
+    #
+    # Although you can increase these quotas by filing a case at [Amazon Web
+    # Services Support Center][2], obtaining the increase is not
+    # instantaneous. The `DescribeLimits` action lets you write code to
+    # compare the capacity you are currently using to those quotas imposed
+    # by your account so that you have enough time to apply for an increase
+    # before you hit a quota.
+    #
+    # For example, you could use one of the Amazon Web Services SDKs to do
+    # the following:
     #
     # 1.  Call `DescribeLimits` for a particular Region to obtain your
     #     current account quotas on provisioned capacity there.
@@ -2940,10 +2992,28 @@ module Aws::DynamoDB
     #   Set this value to get remaining results, if `NextToken` was returned
     #   in the statement response.
     #
+    # @option params [String] :return_consumed_capacity
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
+    #
+    #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
+    #     for the operation, together with `ConsumedCapacity` for each table
+    #     and secondary index that was accessed.
+    #
+    #     Note that some operations, such as `GetItem` and `BatchGetItem`, do
+    #     not access any indexes at all. In these cases, specifying `INDEXES`
+    #     will only return `ConsumedCapacity` information for table(s).
+    #
+    #   * `TOTAL` - The response includes only the aggregate
+    #     `ConsumedCapacity` for the operation.
+    #
+    #   * `NONE` - No `ConsumedCapacity` details are included in the response.
+    #
     # @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;
     #   * {Types::ExecuteStatementOutput#next_token #next_token} => String
+    #   * {Types::ExecuteStatementOutput#consumed_capacity #consumed_capacity} => Types::ConsumedCapacity
     #
     # @example Request syntax with placeholder values
     #
@@ -2952,6 +3022,7 @@ module Aws::DynamoDB
     #     parameters: ["value"], # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #     consistent_read: false,
     #     next_token: "PartiQLNextToken",
+    #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
     #   })
     #
     # @example Response structure
@@ -2960,6 +3031,21 @@ module Aws::DynamoDB
     #   resp.items[0] #=> Hash
     #   resp.items[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #   resp.next_token #=> String
+    #   resp.consumed_capacity.table_name #=> String
+    #   resp.consumed_capacity.capacity_units #=> Float
+    #   resp.consumed_capacity.read_capacity_units #=> Float
+    #   resp.consumed_capacity.write_capacity_units #=> Float
+    #   resp.consumed_capacity.table.read_capacity_units #=> Float
+    #   resp.consumed_capacity.table.write_capacity_units #=> Float
+    #   resp.consumed_capacity.table.capacity_units #=> Float
+    #   resp.consumed_capacity.local_secondary_indexes #=> Hash
+    #   resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
+    #   resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
+    #   resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
+    #   resp.consumed_capacity.global_secondary_indexes #=> Hash
+    #   resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
+    #   resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
+    #   resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatement AWS API Documentation
     #
@@ -2973,6 +3059,18 @@ module Aws::DynamoDB
     # This operation allows you to perform transactional reads or writes on
     # data stored in DynamoDB, using PartiQL.
     #
+    # <note markdown="1"> The entire transaction must consist of either read statements or write
+    # statements, you cannot mix both in one transaction. The EXISTS
+    # function is an exception and can be used to check the condition of
+    # specific attributes of the item in a similar manner to
+    # `ConditionCheck` in the [TransactWriteItems][1] API.
+    #
+    #  </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html#transaction-apis-txwriteitems
+    #
     # @option params [required, Array<Types::ParameterizedStatement>] :transact_statements
     #   The list of PartiQL statements representing the transaction to run.
     #
@@ -2983,9 +3081,20 @@ module Aws::DynamoDB
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [String] :return_consumed_capacity
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response. For more
+    #   information, see [TransactGetItems][1] and [TransactWriteItems][2].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html
+    #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html
+    #
     # @return [Types::ExecuteTransactionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ExecuteTransactionOutput#responses #responses} => Array&lt;Types::ItemResponse&gt;
+    #   * {Types::ExecuteTransactionOutput#consumed_capacity #consumed_capacity} => Array&lt;Types::ConsumedCapacity&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -2997,6 +3106,7 @@ module Aws::DynamoDB
     #       },
     #     ],
     #     client_request_token: "ClientRequestToken",
+    #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
     #   })
     #
     # @example Response structure
@@ -3004,6 +3114,22 @@ module Aws::DynamoDB
     #   resp.responses #=> Array
     #   resp.responses[0].item #=> Hash
     #   resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
+    #   resp.consumed_capacity #=> Array
+    #   resp.consumed_capacity[0].table_name #=> String
+    #   resp.consumed_capacity[0].capacity_units #=> Float
+    #   resp.consumed_capacity[0].read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].table.read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].table.write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].table.capacity_units #=> Float
+    #   resp.consumed_capacity[0].local_secondary_indexes #=> Hash
+    #   resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
+    #   resp.consumed_capacity[0].global_secondary_indexes #=> Hash
+    #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
+    #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
+    #   resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteTransaction AWS API Documentation
     #
@@ -3047,8 +3173,8 @@ module Aws::DynamoDB
     #   The name of the Amazon S3 bucket to export the snapshot to.
     #
     # @option params [String] :s3_bucket_owner
-    #   The ID of the AWS account that owns the bucket the export will be
-    #   stored in.
+    #   The ID of the Amazon Web Services account that owns the bucket the
+    #   export will be stored in.
     #
     # @option params [String] :s3_prefix
     #   The Amazon S3 bucket prefix to use as the file name and path of the
@@ -3060,10 +3186,10 @@ module Aws::DynamoDB
     #
     #   * `AES256` - server-side encryption with Amazon S3 managed keys
     #
-    #   * `KMS` - server-side encryption with AWS KMS managed keys
+    #   * `KMS` - server-side encryption with KMS managed keys
     #
     # @option params [String] :s3_sse_kms_key_id
-    #   The ID of the AWS KMS managed key used to encrypt the S3 bucket where
+    #   The ID of the KMS managed key used to encrypt the S3 bucket where
     #   export data will be stored (if applicable).
     #
     # @option params [String] :export_format
@@ -3157,8 +3283,8 @@ module Aws::DynamoDB
     #   uses eventually consistent reads.
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -3314,10 +3440,11 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # List backups associated with an AWS 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 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.
     #
     # In the request, start time is inclusive, but end time is exclusive.
     # Note that these boundaries are for the time at which the original
@@ -3660,26 +3787,26 @@ module Aws::DynamoDB
     #
     # This topic provides general information about the `PutItem` API.
     #
-    #  For information on how to call the `PutItem` API using the AWS SDK in
-    # specific languages, see the following:
+    #  For information on how to call the `PutItem` API using the Amazon Web
+    # Services SDK in specific languages, see the following:
     #
-    #  * [ PutItem in the AWS Command Line Interface][1]
+    #  * [ PutItem in the Command Line Interface][1]
     #
-    # * [ PutItem in the AWS SDK for .NET][2]
+    # * [ PutItem in the SDK for .NET][2]
     #
-    # * [ PutItem in the AWS SDK for C++][3]
+    # * [ PutItem in the SDK for C++][3]
     #
-    # * [ PutItem in the AWS SDK for Go][4]
+    # * [ PutItem in the SDK for Go][4]
     #
-    # * [ PutItem in the AWS SDK for Java][5]
+    # * [ PutItem in the SDK for Java][5]
     #
-    # * [ PutItem in the AWS SDK for JavaScript][6]
+    # * [ PutItem in the SDK for JavaScript][6]
     #
-    # * [ PutItem in the AWS SDK for PHP V3][7]
+    # * [ PutItem in the SDK for PHP V3][7]
     #
-    # * [ PutItem in the AWS SDK for Python][8]
+    # * [ PutItem in the SDK for Python (Boto)][8]
     #
-    # * [ PutItem in the AWS SDK for Ruby V2][9]
+    # * [ PutItem in the SDK for Ruby V2][9]
     #
     # When you add an item, the primary key attributes are the only required
     # attributes. Attribute values cannot be null.
@@ -3768,6 +3895,8 @@ module Aws::DynamoDB
     #   * `ALL_OLD` - If `PutItem` overwrote an attribute name-value pair,
     #     then the content of the old item is returned.
     #
+    #   The values returned are strongly consistent.
+    #
     #   <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
     #   however, `PutItem` does not recognize any values other than `NONE` or
     #   `ALL_OLD`.
@@ -3775,8 +3904,8 @@ module Aws::DynamoDB
     #    </note>
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -3995,9 +4124,10 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # The `Query` operation finds items based on primary key values. You can
-    # query any table or secondary index that has a composite primary key (a
-    # partition key and a sort key).
+    # 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
+    # and use a comparison operator to refine the search results.
     #
     # Use the `KeyConditionExpression` parameter to provide a specific value
     # for the partition key. The `Query` operation will return all of the
@@ -4204,8 +4334,8 @@ module Aws::DynamoDB
     #   Binary. No set data types are allowed.
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -5092,8 +5222,8 @@ module Aws::DynamoDB
     #   corresponding value of `LastEvaluatedKey`.
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -5431,8 +5561,8 @@ module Aws::DynamoDB
     # contain up to 25 `TransactGetItem` objects, each of which contains a
     # `Get` structure that specifies an item to retrieve from a table in the
     # account and Region. A call to `TransactGetItems` cannot retrieve items
-    # from tables in more than one AWS account or Region. The aggregate size
-    # of the items in the transaction cannot exceed 4 MB.
+    # from tables in more than one Amazon Web Services account or Region.
+    # The aggregate size of the items in the transaction cannot exceed 4 MB.
     #
     # DynamoDB rejects the entire `TransactGetItems` request if any of the
     # following is true:
@@ -5515,10 +5645,10 @@ module Aws::DynamoDB
 
     # `TransactWriteItems` is a synchronous write operation that groups up
     # to 25 action requests. These actions can target items in different
-    # tables, but not in different AWS accounts or Regions, and no two
-    # actions can target the same item. For example, you cannot both
-    # `ConditionCheck` and `Update` the same item. The aggregate size of the
-    # items in the transaction cannot exceed 4 MB.
+    # tables, but not in different Amazon Web Services accounts or Regions,
+    # and no two actions can target the same item. For example, you cannot
+    # both `ConditionCheck` and `Update` the same item. The aggregate size
+    # of the items in the transaction cannot exceed 4 MB.
     #
     # The actions are completed atomically so that either all of them
     # succeed, or all of them fail. They are defined by the following
@@ -5575,12 +5705,12 @@ module Aws::DynamoDB
     #   An ordered array of up to 25 `TransactWriteItem` objects, each of
     #   which contains a `ConditionCheck`, `Put`, `Update`, or `Delete`
     #   object. These can operate on items in different tables, but the tables
-    #   must reside in the same AWS account and Region, and no two of them can
-    #   operate on the same item.
+    #   must reside in the same Amazon Web Services account and Region, and no
+    #   two of them can operate on the same item.
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -5822,7 +5952,13 @@ module Aws::DynamoDB
     end
 
     # Updates the status for contributor insights for a specific table or
-    # index.
+    # index. CloudWatch Contributor Insights for DynamoDB graphs display the
+    # partition key and (if applicable) sort key of frequently accessed
+    # items and frequently throttled items in plaintext. If you require the
+    # use of AWS Key Management Service (KMS) to encrypt this table’s
+    # partition key and sort key data with an AWS managed key or customer
+    # managed key, you should not enable CloudWatch Contributor Insights for
+    # DynamoDB for this table.
     #
     # @option params [required, String] :table_name
     #   The name of the table.
@@ -6211,8 +6347,8 @@ module Aws::DynamoDB
     #   The values returned are strongly consistent.
     #
     # @option params [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -7121,7 +7257,7 @@ module Aws::DynamoDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.64.0'
+      context[:gem_version] = '1.68.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -534,9 +534,11 @@ module Aws::DynamoDB
     BackupSummary.struct_class = Types::BackupSummary
 
     BatchExecuteStatementInput.add_member(:statements, Shapes::ShapeRef.new(shape: PartiQLBatchRequest, required: true, location_name: "Statements"))
+    BatchExecuteStatementInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
     BatchExecuteStatementInput.struct_class = Types::BatchExecuteStatementInput
 
     BatchExecuteStatementOutput.add_member(:responses, Shapes::ShapeRef.new(shape: PartiQLBatchResponse, location_name: "Responses"))
+    BatchExecuteStatementOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacityMultiple, location_name: "ConsumedCapacity"))
     BatchExecuteStatementOutput.struct_class = Types::BatchExecuteStatementOutput
 
     BatchGetItemInput.add_member(:request_items, Shapes::ShapeRef.new(shape: BatchGetRequestMap, required: true, location_name: "RequestItems"))
@@ -828,17 +830,21 @@ module Aws::DynamoDB
     ExecuteStatementInput.add_member(:parameters, Shapes::ShapeRef.new(shape: PreparedStatementParameters, location_name: "Parameters"))
     ExecuteStatementInput.add_member(:consistent_read, Shapes::ShapeRef.new(shape: ConsistentRead, location_name: "ConsistentRead"))
     ExecuteStatementInput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
+    ExecuteStatementInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
     ExecuteStatementInput.struct_class = Types::ExecuteStatementInput
 
     ExecuteStatementOutput.add_member(:items, Shapes::ShapeRef.new(shape: ItemList, location_name: "Items"))
     ExecuteStatementOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
+    ExecuteStatementOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacity, location_name: "ConsumedCapacity"))
     ExecuteStatementOutput.struct_class = Types::ExecuteStatementOutput
 
     ExecuteTransactionInput.add_member(:transact_statements, Shapes::ShapeRef.new(shape: ParameterizedStatements, required: true, location_name: "TransactStatements"))
     ExecuteTransactionInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken", metadata: {"idempotencyToken"=>true}))
+    ExecuteTransactionInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
     ExecuteTransactionInput.struct_class = Types::ExecuteTransactionInput
 
     ExecuteTransactionOutput.add_member(:responses, Shapes::ShapeRef.new(shape: ItemResponseList, location_name: "Responses"))
+    ExecuteTransactionOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacityMultiple, location_name: "ConsumedCapacity"))
     ExecuteTransactionOutput.struct_class = Types::ExecuteTransactionOutput
 
     ExpectedAttributeMap.key = Shapes::ShapeRef.new(shape: AttributeName)

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

@@ -143,8 +143,8 @@ module Aws::DynamoDB
     #   [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html
     #   [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table
@@ -219,8 +219,8 @@ module Aws::DynamoDB
     #       the data types for those attributes must match those of the schema
     #       in the table's attribute definition.
     # @option options [String] :return_consumed_capacity
-    #   Determines the level of detail about provisioned throughput
-    #   consumption that is returned in the response:
+    #   Determines the level of detail about either provisioned or on-demand
+    #   throughput consumption that is returned in the response:
     #
     #   * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
     #     for the operation, together with `ConsumedCapacity` for each table