aws-sdk-dynamodb 1.81.0 → 1.82.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6cd7fd0494ab2f1fc9ecf5ae9f710878776f5bca2da717f4337d94cc4cf2945d
-  data.tar.gz: 5aa9b171740370a8fdc1b413be5b31d6a3ca41d802a106b5c84ef65ff98801b8
+  metadata.gz: dfc9197d05e4115ac3b250ab9a2790c327199b36d20cb0dcd652c78c6a20f7bf
+  data.tar.gz: dcba8dc0a49f1249f752e1c5ef88744f0ef8b127c9c788c14a6e9fbf4a18f45f
 SHA512:
-  metadata.gz: 8675be1a64038f174cb51a16e0e45a0d25dcc09bdee0a09ea35bdfefa1c3f4771c4745d8ec0d7070048d9a7bf6c2f27e229b308d438ea470651f5c90695fc550
-  data.tar.gz: '099f941b83b515de7ce13b96c40be03a26fc7eb3df03e5ffb275d25df1c7befaf623d2c1665293bda5718da0f6e86bed8c57c60c0d3e67641fafb6c8d41e4156'
+  metadata.gz: b8d368fb5b441aca4fd4600d68605aa8b59a8eaba7f90eb999f01b96ab204a80cb9eae90562502091250a250a73caae85b4a33bfa0e29ee5880b1c3fe2684289
+  data.tar.gz: 56d8bc440a87f10c933a5dc75800f7c02687d6e513091652e11f7c5f64a82fa4c36aaed6ffeb14778ec42ccf7ace002c0eacbeb96a73047d1f8040b79fad9ea0

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.82.0 (2023-03-03)
+------------------
+
+* Feature - Documentation updates for DynamoDB.
+
 1.81.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.81.0
+1.82.0

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

@@ -1104,10 +1104,14 @@ module Aws::DynamoDB
     # a replication relationship between two or more DynamoDB tables with
     # the same table name in the provided Regions.
     #
-    # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
-    # tables.
-    #
-    #  </note>
+    # 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].
     #
     # If you want to add a new replica table to a global table, each of the
     # following conditions must be true:
@@ -1151,6 +1155,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
     #
     # @option params [required, String] :global_table_name
     #   The global table name.
@@ -1760,7 +1767,7 @@ module Aws::DynamoDB
     #   A map of attribute names to `AttributeValue` objects, representing the
     #   primary key of the item to delete.
     #
-    #   For the primary key, you must provide all of the attributes. For
+    #   For the primary key, you must provide all of the key attributes. For
     #   example, with a simple primary key, you only need to provide a value
     #   for the partition key. For a composite primary key, you must provide
     #   values for both the partition key and the sort key.
@@ -2023,6 +2030,9 @@ 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.
+    #
     # <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.
@@ -2037,6 +2047,10 @@ module Aws::DynamoDB
     #
     # Use the `DescribeTable` action to check the status of the table.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
+    #
     # @option params [required, String] :table_name
     #   The name of the table to delete.
     #
@@ -2287,7 +2301,7 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # Returns information about contributor insights, for a given table or
+    # Returns information about contributor insights for a given table or
     # global secondary index.
     #
     # @option params [required, String] :table_name
@@ -2332,7 +2346,14 @@ module Aws::DynamoDB
       req.send_request(options)
     end
 
-    # Returns the regional endpoint information.
+    # 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].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/inter-network-traffic-privacy.html#inter-network-traffic-DescribeEndpoints
     #
     # @return [Types::DescribeEndpointsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -2401,17 +2422,21 @@ module Aws::DynamoDB
 
     # Returns information about the specified global table.
     #
-    # <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][3] instead.
-    #
-    #  </note>
+    # 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].
     #
     #
     #
     # [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/APIReference/API_DescribeTable.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
     #
     # @option params [required, String] :global_table_name
     #   The name of the global table.
@@ -2457,14 +2482,21 @@ module Aws::DynamoDB
 
     # Describes Region-specific settings for a global table.
     #
-    # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
-    # tables.
-    #
-    #  </note>
+    # 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].
     #
     #
     #
     # [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
     #
     # @option params [required, String] :global_table_name
     #   The name of the global table to describe.
@@ -2767,6 +2799,9 @@ 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.
+    #
     # <note markdown="1"> If you issue a `DescribeTable` request immediately after a
     # `CreateTable` request, DynamoDB might return a
     # `ResourceNotFoundException`. This is because `DescribeTable` uses an
@@ -2776,6 +2811,10 @@ 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.
     #
@@ -2935,10 +2974,8 @@ module Aws::DynamoDB
     # Describes auto scaling settings across replicas of the global table at
     # once.
     #
-    # <note markdown="1"> This operation only applies to [Version 2019.11.21][1] of global
-    # tables.
-    #
-    #  </note>
+    # This operation only applies to [Version 2019.11.21 (Current)][1] of
+    # global tables.
     #
     #
     #
@@ -3138,7 +3175,8 @@ module Aws::DynamoDB
     # number of items (if using the Limit parameter) or a maximum of 1 MB of
     # data (and then apply any filtering to the results using `WHERE`
     # clause). If `LastEvaluatedKey` is present in the response, you need to
-    # paginate the result set.
+    # paginate the result set. If `NextToken` is present, you need to
+    # paginate the result set and include `NextToken`.
     #
     # @option params [required, String] :statement
     #   The PartiQL statement representing the operation to run.
@@ -3956,14 +3994,21 @@ module Aws::DynamoDB
 
     # Lists all global tables that have a replica in the specified Region.
     #
-    # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
-    # tables.
-    #
-    #  </note>
+    # 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].
     #
     #
     #
     # [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
     #
     # @option params [String] :exclusive_start_global_table_name
     #   The first global table name that this operation will evaluate.
@@ -4582,7 +4627,9 @@ module Aws::DynamoDB
     #     is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity of
+    #     read capacity units as getting the items, and is subject to the same
+    #     item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
     #     `ProjectionExpression`. This return value is equivalent to
@@ -5536,7 +5583,9 @@ module Aws::DynamoDB
     #     is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity of
+    #     read capacity units as getting the items, and is subject to the same
+    #     item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
     #     `ProjectionExpression`. This return value is equivalent to
@@ -5952,8 +6001,7 @@ module Aws::DynamoDB
     #
     # * There is a user error, such as an invalid data format.
     #
-    # * The aggregate size of the items in the transaction cannot exceed 4
-    #   MB.
+    # * The aggregate size of the items in the transaction exceeded 4 MB.
     #
     # @option params [required, Array<Types::TransactGetItem>] :transact_items
     #   An ordered array of up to 100 `TransactGetItem` objects, each of which
@@ -6115,7 +6163,7 @@ module Aws::DynamoDB
     #
     #   Although multiple identical calls using the same client request token
     #   produce the same result on the server (no side effects), the responses
-    #   to the calls might not be the same. If the `ReturnConsumedCapacity>`
+    #   to the calls might not be the same. If the `ReturnConsumedCapacity`
     #   parameter is set, then the initial `TransactWriteItems` call returns
     #   the amount of write capacity units consumed in making the changes.
     #   Subsequent `TransactWriteItems` calls with the same client token
@@ -6381,7 +6429,20 @@ module Aws::DynamoDB
     # have the same key schema, have DynamoDB Streams enabled, and have the
     # same provisioned and maximum write capacity units.
     #
-    # <note markdown="1"> Although you can use `UpdateGlobalTable` to add replicas and remove
+    # 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].
+    #
+    # <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.
+    #
+    #  Although you can use `UpdateGlobalTable` to add replicas and remove
     # replicas in a single request, for simplicity we recommend that you
     # issue separate requests for adding or removing replicas.
     #
@@ -6398,6 +6459,14 @@ module Aws::DynamoDB
     # * The global secondary indexes must have the same provisioned and
     #   maximum write capacity units.
     #
+    #
+    #
+    # [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
+    #
     # @option params [required, String] :global_table_name
     #   The global table name.
     #
@@ -6456,6 +6525,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].
+    #
+    #
+    #
+    # [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
+    #
     # @option params [required, String] :global_table_name
     #   The name of the global table
     #
@@ -6703,8 +6788,8 @@ module Aws::DynamoDB
     #
     # @option params [String] :return_values
     #   Use `ReturnValues` if you want to get the item attributes as they
-    #   appear before or after they are updated. For `UpdateItem`, the valid
-    #   values are:
+    #   appear before or after they are successfully updated. For
+    #   `UpdateItem`, the valid values are:
     #
     #   * `NONE` - If `ReturnValues` is not specified, or if its value is
     #     `NONE`, then nothing is returned. (This setting is the default for
@@ -7049,6 +7134,9 @@ module Aws::DynamoDB
     # 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.
+    #
     # You can only perform one of the following operations at once:
     #
     # * Modify the provisioned throughput settings of the table.
@@ -7065,6 +7153,10 @@ module Aws::DynamoDB
     # 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,
@@ -7136,8 +7228,8 @@ 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][1] of global
-    #   tables.
+    #   <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
+    #   global tables.
     #
     #    </note>
     #
@@ -7394,10 +7486,8 @@ module Aws::DynamoDB
 
     # Updates auto scaling settings on your global tables at once.
     #
-    # <note markdown="1"> This operation only applies to [Version 2019.11.21][1] of global
-    # tables.
-    #
-    #  </note>
+    # This operation only applies to [Version 2019.11.21 (Current)][1] of
+    # global tables.
     #
     #
     #
@@ -7648,7 +7738,7 @@ module Aws::DynamoDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.81.0'
+      context[:gem_version] = '1.82.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -50,9 +50,6 @@ module Aws::DynamoDB
 
     def initialize(options = {})
       self[:region] = options[:region]
-      if self[:region].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :region"
-      end
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
       if self[:use_dual_stack].nil?

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

@@ -14,42 +14,45 @@ module Aws::DynamoDB
       use_dual_stack = parameters.use_dual_stack
       use_fips = parameters.use_fips
       endpoint = parameters.endpoint
-      if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
-        if Aws::Endpoints::Matchers.set?(endpoint)
+      if Aws::Endpoints::Matchers.set?(endpoint)
+        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
+          raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
+        end
+        if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+          raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
+        end
+        return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
+      end
+      if Aws::Endpoints::Matchers.set?(region)
+        if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
+          if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://dynamodb-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
+          end
           if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-            raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
+              if Aws::Endpoints::Matchers.string_equals?("aws-us-gov", Aws::Endpoints::Matchers.attr(partition_result, "name"))
+                return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.amazonaws.com", headers: {}, properties: {})
+              end
+              return Aws::Endpoints::Endpoint.new(url: "https://dynamodb-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            end
+            raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
           end
           if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-            raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
-          end
-          return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://dynamodb-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
-          end
-          raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
-            if Aws::Endpoints::Matchers.string_equals?("aws-us-gov", Aws::Endpoints::Matchers.attr(partition_result, "name"))
-              return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
+              return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
             end
-            return Aws::Endpoints::Endpoint.new(url: "https://dynamodb-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
+            raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
           end
-          raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
-        end
-        if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
-          if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
-            return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
+          if Aws::Endpoints::Matchers.string_equals?(region, "local")
+            return Aws::Endpoints::Endpoint.new(url: "http://localhost:8000", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingName"=>"dynamodb", "signingRegion"=>"us-east-1"}]})
           end
-          raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
-        end
-        if Aws::Endpoints::Matchers.string_equals?(region, "local")
-          return Aws::Endpoints::Endpoint.new(url: "http://localhost:8000", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingRegion"=>"us-east-1", "signingName"=>"dynamodb"}]})
+          return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
         end
-        return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
       end
+      raise ArgumentError, "Invalid Configuration: Missing Region"
       raise ArgumentError, 'No endpoint could be resolved'
 
     end

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

@@ -539,7 +539,7 @@ module Aws::DynamoDB
     #   A map of attribute names to `AttributeValue` objects, representing the
     #   primary key of the item to delete.
     #
-    #   For the primary key, you must provide all of the attributes. For
+    #   For the primary key, you must provide all of the key attributes. For
     #   example, with a simple primary key, you only need to provide a value
     #   for the partition key. For a composite primary key, you must provide
     #   values for both the partition key and the sort key.
@@ -1103,7 +1103,9 @@ module Aws::DynamoDB
     #     is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity of
+    #     read capacity units as getting the items, and is subject to the same
+    #     item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
     #     `ProjectionExpression`. This return value is equivalent to
@@ -1508,7 +1510,9 @@ module Aws::DynamoDB
     #     is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity of
+    #     read capacity units as getting the items, and is subject to the same
+    #     item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
     #     `ProjectionExpression`. This return value is equivalent to
@@ -1902,8 +1906,8 @@ 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][1] of global
-    #   tables.
+    #   <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
+    #   global tables.
     #
     #    </note>
     #
@@ -1992,8 +1996,8 @@ module Aws::DynamoDB
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html
     # @option options [String] :return_values
     #   Use `ReturnValues` if you want to get the item attributes as they
-    #   appear before or after they are updated. For `UpdateItem`, the valid
-    #   values are:
+    #   appear before or after they are successfully updated. For
+    #   `UpdateItem`, the valid values are:
     #
     #   * `NONE` - If `ReturnValues` is not specified, or if its value is
     #     `NONE`, then nothing is returned. (This setting is the default for

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

@@ -1462,16 +1462,32 @@ module Aws::DynamoDB
     #
     # @!attribute [rw] condition_expression
     #   A condition that must be satisfied in order for a conditional update
-    #   to succeed.
+    #   to succeed. For more information, see [Condition expressions][1] in
+    #   the *Amazon DynamoDB Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ConditionExpressions.html
     #   @return [String]
     #
     # @!attribute [rw] expression_attribute_names
     #   One or more substitution tokens for attribute names in an
-    #   expression.
+    #   expression. For more information, see [Expression attribute
+    #   names][1] in the *Amazon DynamoDB Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeNames.html
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] expression_attribute_values
-    #   One or more values that can be substituted in an expression.
+    #   One or more values that can be substituted in an expression. For
+    #   more information, see [Condition expressions][1] in the *Amazon
+    #   DynamoDB Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ConditionExpressions.html
     #   @return [Hash<String,Types::AttributeValue>]
     #
     # @!attribute [rw] return_values_on_condition_check_failure
@@ -2147,7 +2163,7 @@ module Aws::DynamoDB
     #   A map of attribute names to `AttributeValue` objects, representing
     #   the primary key of the item to delete.
     #
-    #   For the primary key, you must provide all of the attributes. For
+    #   For the primary key, you must provide all of the key attributes. For
     #   example, with a simple primary key, you only need to provide a value
     #   for the partition key. For a composite primary key, you must provide
     #   values for both the partition key and the sort key.
@@ -2359,7 +2375,7 @@ module Aws::DynamoDB
     #   with statistics for the table and any indexes involved in the
     #   operation. `ConsumedCapacity` is only returned if the
     #   `ReturnConsumedCapacity` parameter was specified. For more
-    #   information, see [Provisioned Mode][1] in the *Amazon DynamoDB
+    #   information, see [Provisioned Throughput][1] in the *Amazon DynamoDB
     #   Developer Guide*.
     #
     #
@@ -3791,12 +3807,12 @@ module Aws::DynamoDB
     #   with statistics for the table and any indexes involved in the
     #   operation. `ConsumedCapacity` is only returned if the
     #   `ReturnConsumedCapacity` parameter was specified. For more
-    #   information, see [Read/Write Capacity Mode][1] in the *Amazon
-    #   DynamoDB Developer Guide*.
+    #   information, see [Provisioned Throughput][1] in the *Amazon DynamoDB
+    #   Developer Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
     #   @return [Types::ConsumedCapacity]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItemOutput AWS API Documentation
@@ -5920,8 +5936,8 @@ module Aws::DynamoDB
     #   with statistics for the table and any indexes involved in the
     #   operation. `ConsumedCapacity` is only returned if the
     #   `ReturnConsumedCapacity` parameter was specified. For more
-    #   information, see [Read/Write Capacity Mode][1] in the *Amazon
-    #   DynamoDB Developer Guide*.
+    #   information, see [Provisioned Throughput][1] in the *Amazon DynamoDB
+    #   Developer Guide*.
     #
     #
     #
@@ -6013,7 +6029,9 @@ module Aws::DynamoDB
     #     value is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity
+    #     of read capacity units as getting the items, and is subject to the
+    #     same item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
     #     `ProjectionExpression`. This return value is equivalent to
@@ -7423,7 +7441,9 @@ module Aws::DynamoDB
     #     value is equivalent to specifying `ALL_ATTRIBUTES`.
     #
     #   * `COUNT` - Returns the number of matching items, rather than the
-    #     matching items themselves.
+    #     matching items themselves. Note that this uses the same quantity
+    #     of read capacity units as getting the items, and is subject to the
+    #     same item size calculations.
     #
     #   * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
     #     `ProjectionExpression`. This return value is equivalent to
@@ -7763,7 +7783,7 @@ module Aws::DynamoDB
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
     #   @return [Types::ConsumedCapacity]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ScanOutput AWS API Documentation
@@ -8627,7 +8647,7 @@ module Aws::DynamoDB
     #   Although multiple identical calls using the same client request
     #   token produce the same result on the server (no side effects), the
     #   responses to the calls might not be the same. If the
-    #   `ReturnConsumedCapacity>` parameter is set, then the initial
+    #   `ReturnConsumedCapacity` parameter is set, then the initial
     #   `TransactWriteItems` call returns the amount of write capacity units
     #   consumed in making the changes. Subsequent `TransactWriteItems`
     #   calls with the same client token return the number of read capacity
@@ -8798,7 +8818,7 @@ module Aws::DynamoDB
     #       secondary indexes. DynamoDB is automatically scaling your index
     #       so please try again shortly.
     #
-    #       <note markdown="1"> This message is returned when when writes get throttled on an
+    #       <note markdown="1"> This message is returned when writes get throttled on an
     #       On-Demand GSI as DynamoDB is automatically scaling the GSI.
     #
     #        </note>
@@ -8866,6 +8886,54 @@ module Aws::DynamoDB
 
     # The transaction with the given request token is already in progress.
     #
+    # Recommended Settings
+    #
+    # <note markdown="1"> This is a general recommendation for handling the
+    # `TransactionInProgressException`. These settings help ensure that the
+    # client retries will trigger completion of the ongoing
+    # `TransactWriteItems` request.
+    #
+    #  </note>
+    #
+    # * Set `clientExecutionTimeout` to a value that allows at least one
+    #   retry to be processed after 5 seconds have elapsed since the first
+    #   attempt for the `TransactWriteItems` operation.
+    #
+    # * Set `socketTimeout` to a value a little lower than the
+    #   `requestTimeout` setting.
+    #
+    # * `requestTimeout` should be set based on the time taken for the
+    #   individual retries of a single HTTP request for your use case, but
+    #   setting it to 1 second or higher should work well to reduce chances
+    #   of retries and `TransactionInProgressException` errors.
+    #
+    # * Use exponential backoff when retrying and tune backoff if needed.
+    #
+    # Assuming [default retry policy][1], example timeout settings based on
+    # the guidelines above are as follows:
+    #
+    # Example timeline:
+    #
+    # * 0-1000 first attempt
+    #
+    # * 1000-1500 first sleep/delay (default retry policy uses 500 ms as
+    #   base delay for 4xx errors)
+    #
+    # * 1500-2500 second attempt
+    #
+    # * 2500-3500 second sleep/delay (500 * 2, exponential backoff)
+    #
+    # * 3500-4500 third attempt
+    #
+    # * 4500-6500 third sleep/delay (500 * 2^2)
+    #
+    # * 6500-7500 fourth attempt (this can trigger inline recovery since 5
+    #   seconds have elapsed since the first attempt reached TC)
+    #
+    #
+    #
+    # [1]: https://github.com/aws/aws-sdk-java/blob/fd409dee8ae23fb8953e0bb4dbde65536a7e0514/aws-java-sdk-core/src/main/java/com/amazonaws/retry/PredefinedRetryPolicies.java#L97
+    #
     # @!attribute [rw] message
     #   @return [String]
     #
@@ -9201,8 +9269,8 @@ module Aws::DynamoDB
     #
     # @!attribute [rw] return_values
     #   Use `ReturnValues` if you want to get the item attributes as they
-    #   appear before or after they are updated. For `UpdateItem`, the valid
-    #   values are:
+    #   appear before or after they are successfully updated. For
+    #   `UpdateItem`, the valid values are:
     #
     #   * `NONE` - If `ReturnValues` is not specified, or if its value is
     #     `NONE`, then nothing is returned. (This setting is the default for
@@ -9480,9 +9548,9 @@ module Aws::DynamoDB
     #   `UpdateItem` operation, as determined by the `ReturnValues`
     #   parameter.
     #
-    #   The `Attributes` map is only present if `ReturnValues` was specified
-    #   as something other than `NONE` in the request. Each element
-    #   represents one attribute.
+    #   The `Attributes` map is only present if the update was successful
+    #   and `ReturnValues` was specified as something other than `NONE` in
+    #   the request. Each element represents one attribute.
     #   @return [Hash<String,Types::AttributeValue>]
     #
     # @!attribute [rw] consumed_capacity
@@ -9496,7 +9564,7 @@ module Aws::DynamoDB
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
+    #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
     #   @return [Types::ConsumedCapacity]
     #
     # @!attribute [rw] item_collection_metrics
@@ -9654,8 +9722,8 @@ 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][1] of global
-    #   tables.
+    #   <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
+    #   global tables.
     #
     #    </note>
     #

data/lib/aws-sdk-dynamodb.rb

@@ -54,6 +54,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
 # @!group service
 module Aws::DynamoDB
 
-  GEM_VERSION = '1.81.0'
+  GEM_VERSION = '1.82.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-dynamodb
 version: !ruby/object:Gem::Version
-  version: 1.81.0
+  version: 1.82.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-01-18 00:00:00.000000000 Z
+date: 2023-03-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core