aws-sdk-dynamodb 1.65.0 → 1.69.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
@@ -365,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
     #
@@ -385,6 +410,7 @@ module Aws::DynamoDB
     #         consistent_read: false,
     #       },
     #     ],
+    #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
     #   })
     #
     # @example Response structure
@@ -395,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
     #
@@ -556,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
@@ -805,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
@@ -1094,6 +1136,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.global_table_description.global_table_arn #=> String
     #   resp.global_table_description.creation_date_time #=> Time
     #   resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
@@ -1109,9 +1153,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
@@ -1328,6 +1372,10 @@ module Aws::DynamoDB
     #
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html
     #
+    # @option params [String] :table_class
+    #   The table class of the new table. Valid values are `STANDARD` and
+    #   `STANDARD_INFREQUENT_ACCESS`.
+    #
     # @return [Types::CreateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTableOutput#table_description #table_description} => Types::TableDescription
@@ -1470,6 +1518,7 @@ module Aws::DynamoDB
     #         value: "TagValueString", # required
     #       },
     #     ],
+    #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #   })
     #
     # @example Response structure
@@ -1539,6 +1588,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.table_description.restore_summary.source_backup_arn #=> String
     #   resp.table_description.restore_summary.source_table_arn #=> String
     #   resp.table_description.restore_summary.restore_date_time #=> Time
@@ -1550,6 +1601,8 @@ module Aws::DynamoDB
     #   resp.table_description.archival_summary.archival_date_time #=> Time
     #   resp.table_description.archival_summary.archival_reason #=> String
     #   resp.table_description.archival_summary.archival_backup_arn #=> String
+    #   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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTable AWS API Documentation
     #
@@ -1698,8 +1751,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
@@ -2034,6 +2087,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.table_description.restore_summary.source_backup_arn #=> String
     #   resp.table_description.restore_summary.source_table_arn #=> String
     #   resp.table_description.restore_summary.restore_date_time #=> Time
@@ -2045,6 +2100,8 @@ module Aws::DynamoDB
     #   resp.table_description.archival_summary.archival_date_time #=> Time
     #   resp.table_description.archival_summary.archival_reason #=> String
     #   resp.table_description.archival_summary.archival_backup_arn #=> String
+    #   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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTable AWS API Documentation
     #
@@ -2328,6 +2385,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.global_table_description.global_table_arn #=> String
     #   resp.global_table_description.creation_date_time #=> Time
     #   resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
@@ -2422,6 +2481,8 @@ module Aws::DynamoDB
     #   resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_in_cooldown #=> Integer
     #   resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_out_cooldown #=> Integer
     #   resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.target_value #=> Float
+    #   resp.replica_settings[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
+    #   resp.replica_settings[0].replica_table_class_summary.last_update_date_time #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeGlobalTableSettings AWS API Documentation
     #
@@ -2465,25 +2526,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.
@@ -2712,6 +2774,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.table.restore_summary.source_backup_arn #=> String
     #   resp.table.restore_summary.source_table_arn #=> String
     #   resp.table.restore_summary.restore_date_time #=> Time
@@ -2723,6 +2787,8 @@ module Aws::DynamoDB
     #   resp.table.archival_summary.archival_date_time #=> Time
     #   resp.table.archival_summary.archival_reason #=> String
     #   resp.table.archival_summary.archival_backup_arn #=> String
+    #   resp.table.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
+    #   resp.table.table_class_summary.last_update_date_time #=> Time
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -2949,10 +3015,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
     #
@@ -2961,6 +3045,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
@@ -2969,6 +3054,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
     #
@@ -2982,6 +3082,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.
     #
@@ -2992,9 +3104,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
     #
@@ -3006,6 +3129,7 @@ module Aws::DynamoDB
     #       },
     #     ],
     #     client_request_token: "ClientRequestToken",
+    #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
     #   })
     #
     # @example Response structure
@@ -3013,6 +3137,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
     #
@@ -3056,8 +3196,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
@@ -3069,10 +3209,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
@@ -3166,8 +3306,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
@@ -3323,10 +3463,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
@@ -3669,26 +3810,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.
@@ -3777,6 +3918,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`.
@@ -3784,8 +3927,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
@@ -4004,9 +4147,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
@@ -4213,8 +4357,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
@@ -4706,6 +4850,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.table_description.restore_summary.source_backup_arn #=> String
     #   resp.table_description.restore_summary.source_table_arn #=> String
     #   resp.table_description.restore_summary.restore_date_time #=> Time
@@ -4717,6 +4863,8 @@ module Aws::DynamoDB
     #   resp.table_description.archival_summary.archival_date_time #=> Time
     #   resp.table_description.archival_summary.archival_reason #=> String
     #   resp.table_description.archival_summary.archival_backup_arn #=> String
+    #   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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableFromBackup AWS API Documentation
     #
@@ -4929,6 +5077,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.table_description.restore_summary.source_backup_arn #=> String
     #   resp.table_description.restore_summary.source_table_arn #=> String
     #   resp.table_description.restore_summary.restore_date_time #=> Time
@@ -4940,6 +5090,8 @@ module Aws::DynamoDB
     #   resp.table_description.archival_summary.archival_date_time #=> Time
     #   resp.table_description.archival_summary.archival_reason #=> String
     #   resp.table_description.archival_summary.archival_backup_arn #=> String
+    #   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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableToPointInTime AWS API Documentation
     #
@@ -5101,8 +5253,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
@@ -5440,8 +5592,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:
@@ -5524,10 +5676,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
@@ -5584,12 +5736,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
@@ -5831,7 +5983,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.
@@ -5934,6 +6092,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.global_table_description.global_table_arn #=> String
     #   resp.global_table_description.creation_date_time #=> Time
     #   resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
@@ -6074,6 +6234,7 @@ module Aws::DynamoDB
     #             },
     #           },
     #         ],
+    #         replica_table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #       },
     #     ],
     #   })
@@ -6133,6 +6294,8 @@ module Aws::DynamoDB
     #   resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_in_cooldown #=> Integer
     #   resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_out_cooldown #=> Integer
     #   resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.target_value #=> Float
+    #   resp.replica_settings[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
+    #   resp.replica_settings[0].replica_table_class_summary.last_update_date_time #=> Time
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateGlobalTableSettings AWS API Documentation
     #
@@ -6220,8 +6383,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
@@ -6638,6 +6801,10 @@ module Aws::DynamoDB
     #
     #   [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`.
+    #
     # @return [Types::UpdateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateTableOutput#table_description #table_description} => Types::TableDescription
@@ -6763,6 +6930,7 @@ module Aws::DynamoDB
     #               },
     #             },
     #           ],
+    #           table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #         },
     #         update: {
     #           region_name: "RegionName", # required
@@ -6778,12 +6946,14 @@ module Aws::DynamoDB
     #               },
     #             },
     #           ],
+    #           table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #         },
     #         delete: {
     #           region_name: "RegionName", # required
     #         },
     #       },
     #     ],
+    #     table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
     #   })
     #
     # @example Response structure
@@ -6853,6 +7023,8 @@ module Aws::DynamoDB
     #   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].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
     #   resp.table_description.restore_summary.source_backup_arn #=> String
     #   resp.table_description.restore_summary.source_table_arn #=> String
     #   resp.table_description.restore_summary.restore_date_time #=> Time
@@ -6864,6 +7036,8 @@ module Aws::DynamoDB
     #   resp.table_description.archival_summary.archival_date_time #=> Time
     #   resp.table_description.archival_summary.archival_reason #=> String
     #   resp.table_description.archival_summary.archival_backup_arn #=> String
+    #   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
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTable AWS API Documentation
     #
@@ -7130,7 +7304,7 @@ module Aws::DynamoDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.65.0'
+      context[:gem_version] = '1.69.0'
       Seahorse::Client::Request.new(handlers, context)
     end