aws-sdk-dynamodb 1.69.0 → 1.73.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e05476b82915f01a358d8bba79d357df0743d64d9c25e6c627285dc46c61ea79
-  data.tar.gz: 61308d48457d2b02cb269e79d0c3f440983eb82d050a25ac7cd18da2980aa950
+  metadata.gz: ded7d0deac349c81a16fb38f201285567cc8da4d710aae51d14d0d81ebee0bca
+  data.tar.gz: 256334b4d6e50bed034253e6c45377559c8ca3eacdbd29bf14c72cc25d53458a
 SHA512:
-  metadata.gz: c62190a339337d1c5e53481a2afb957868587eb9ece07ffe13df792e95bf094a38f88647bda00d678a627a630a4d21503994855466f548d9e68d9eff5df91bd9
-  data.tar.gz: 446fac3dae812b9c83ee7873a958c4439649b43894676efa1c751c460d2a454f68ffed064f067bbe47197998836e58b15ab792419b81f7e40bc91648a185f38d
+  metadata.gz: 015c03a66a00e906cd5d90783aca5e6fcce7a6176aa0d3b463f89e8a6b3e35045cc8460467aa86450055d50b198e54b4dc2c1208c1c745caee3107c44d0ce47d
+  data.tar.gz: '094f0881f19aad53e073e834c55ef66f04eab31c4d2864800b304a323c7db8475acff75d86d832accd18a0ec4c04e606bd6a2c0b1f0027b243f2cef9ab4bd229'

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.73.0 (2022-02-21)
+------------------
+
+* Feature - DynamoDB ExecuteStatement API now supports Limit as a request parameter to specify the maximum number of items to evaluate. If specified, the service will process up to the Limit and the results will include a LastEvaluatedKey value to continue the read in a subsequent operation.
+
+1.72.0 (2022-02-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.71.0 (2022-02-02)
+------------------
+
+* Feature - Documentation update for DynamoDB Java SDK.
+
+1.70.0 (2021-12-21)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.69.0 (2021-12-01)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.69.0
+1.73.0

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

@@ -27,6 +27,8 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 require 'aws-sdk-dynamodb/plugins/extended_retries.rb'
@@ -76,6 +78,8 @@ module Aws::DynamoDB
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
     add_plugin(Aws::DynamoDB::Plugins::ExtendedRetries)
@@ -187,6 +191,10 @@ module Aws::DynamoDB
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -326,7 +334,7 @@ module Aws::DynamoDB
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -342,6 +350,9 @@ module Aws::DynamoDB
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -731,9 +742,13 @@ module Aws::DynamoDB
     end
 
     # The `BatchWriteItem` operation puts or deletes multiple items in one
-    # or more tables. A single call to `BatchWriteItem` can write up to 16
-    # MB of data, which can comprise as many as 25 put or delete requests.
-    # Individual items to be written can be as large as 400 KB.
+    # or more tables. A single call to `BatchWriteItem` can transmit up to
+    # 16MB of data over the network, consisting of up to 25 item put or
+    # delete operations. While individual items can be up to 400 KB once
+    # stored, it's important to note that an item's representation might
+    # be greater than 400KB while being sent in DynamoDB's JSON format for
+    # the API call. For more details on this distinction, see [Naming Rules
+    # and Data Types][1].
     #
     # <note markdown="1"> `BatchWriteItem` cannot update items. To update items, use the
     # `UpdateItem` action.
@@ -763,7 +778,7 @@ module Aws::DynamoDB
     # operation using exponential backoff, the individual requests in the
     # batch are much more likely to succeed.
     #
-    #  For more information, see [Batch Operations and Error Handling][1] in
+    #  For more information, see [Batch Operations and Error Handling][2] in
     # the *Amazon DynamoDB Developer Guide*.
     #
     # With `BatchWriteItem`, you can efficiently write or delete large
@@ -812,7 +827,8 @@ module Aws::DynamoDB
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#Programming.Errors.BatchOperations
+    # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html
+    # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#Programming.Errors.BatchOperations
     #
     # @option params [required, Hash<String,Array>] :request_items
     #   A map of one or more table names and, for each table, a list of
@@ -3000,6 +3016,19 @@ module Aws::DynamoDB
     # This operation allows you to perform reads and singleton writes on
     # data stored in DynamoDB, using PartiQL.
     #
+    # For PartiQL reads (`SELECT` statement), if the total number of
+    # processed items exceeds the maximum dataset size limit of 1 MB, the
+    # read stops and results are returned to the user as a
+    # `LastEvaluatedKey` value to continue the read in a subsequent
+    # operation. If the filter criteria in `WHERE` clause does not match any
+    # data, the read will return an empty result set.
+    #
+    # A single `SELECT` statement response can return up to the maximum
+    # 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.
+    #
     # @option params [required, String] :statement
     #   The PartiQL statement representing the operation to run.
     #
@@ -3032,11 +3061,24 @@ module Aws::DynamoDB
     #
     #   * `NONE` - No `ConsumedCapacity` details are included in the response.
     #
+    # @option params [Integer] :limit
+    #   The maximum number of items to evaluate (not necessarily the number of
+    #   matching items). If DynamoDB processes the number of items up to the
+    #   limit while processing the results, it stops the operation and returns
+    #   the matching values up to that point, along with a key in
+    #   `LastEvaluatedKey` to apply in a subsequent operation so you can pick
+    #   up where you left off. Also, if the processed dataset size exceeds 1
+    #   MB before DynamoDB reaches this limit, it stops the operation and
+    #   returns the matching values up to the limit, and a key in
+    #   `LastEvaluatedKey` to apply in a subsequent operation to continue the
+    #   operation.
+    #
     # @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
+    #   * {Types::ExecuteStatementOutput#last_evaluated_key #last_evaluated_key} => Hash&lt;String,Types::AttributeValue&gt;
     #
     # @example Request syntax with placeholder values
     #
@@ -3046,6 +3088,7 @@ module Aws::DynamoDB
     #     consistent_read: false,
     #     next_token: "PartiQLNextToken",
     #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
+    #     limit: 1,
     #   })
     #
     # @example Response structure
@@ -3069,6 +3112,8 @@ module Aws::DynamoDB
     #   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
+    #   resp.last_evaluated_key #=> Hash
+    #   resp.last_evaluated_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatement AWS API Documentation
     #
@@ -5986,10 +6031,10 @@ module Aws::DynamoDB
     # 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.
+    # use of Amazon Web Services Key Management Service (KMS) to encrypt
+    # this table’s partition key and sort key data with an Amazon Web
+    # Services 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.
@@ -7304,7 +7349,7 @@ module Aws::DynamoDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.69.0'
+      context[:gem_version] = '1.73.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -835,11 +835,13 @@ module Aws::DynamoDB
     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.add_member(:limit, Shapes::ShapeRef.new(shape: PositiveIntegerObject, location_name: "Limit"))
     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.add_member(:last_evaluated_key, Shapes::ShapeRef.new(shape: Key, location_name: "LastEvaluatedKey"))
     ExecuteStatementOutput.struct_class = Types::ExecuteStatementOutput
 
     ExecuteTransactionInput.add_member(:transact_statements, Shapes::ShapeRef.new(shape: ParameterizedStatements, required: true, location_name: "TransactStatements"))

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

@@ -3316,6 +3316,7 @@ module Aws::DynamoDB
     #         consistent_read: false,
     #         next_token: "PartiQLNextToken",
     #         return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
+    #         limit: 1,
     #       }
     #
     # @!attribute [rw] statement
@@ -3357,6 +3358,19 @@ module Aws::DynamoDB
     #     response.
     #   @return [String]
     #
+    # @!attribute [rw] limit
+    #   The maximum number of items to evaluate (not necessarily the number
+    #   of matching items). If DynamoDB processes the number of items up to
+    #   the limit while processing the results, it stops the operation and
+    #   returns the matching values up to that point, along with a key in
+    #   `LastEvaluatedKey` to apply in a subsequent operation so you can
+    #   pick up where you left off. Also, if the processed dataset size
+    #   exceeds 1 MB before DynamoDB reaches this limit, it stops the
+    #   operation and returns the matching values up to the limit, and a key
+    #   in `LastEvaluatedKey` to apply in a subsequent operation to continue
+    #   the operation.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatementInput AWS API Documentation
     #
     class ExecuteStatementInput < Struct.new(
@@ -3364,7 +3378,8 @@ module Aws::DynamoDB
       :parameters,
       :consistent_read,
       :next_token,
-      :return_consumed_capacity)
+      :return_consumed_capacity,
+      :limit)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3395,12 +3410,24 @@ module Aws::DynamoDB
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
     #   @return [Types::ConsumedCapacity]
     #
+    # @!attribute [rw] last_evaluated_key
+    #   The primary key of the item where the operation stopped, inclusive
+    #   of the previous result set. Use this value to start a new operation,
+    #   excluding this value in the new request. If `LastEvaluatedKey` is
+    #   empty, then the "last page" of results has been processed and
+    #   there is no more data to be retrieved. If `LastEvaluatedKey` is not
+    #   empty, it does not necessarily mean that there is more data in the
+    #   result set. The only way to know when you have reached the end of
+    #   the result set is when `LastEvaluatedKey` is empty.
+    #   @return [Hash<String,Types::AttributeValue>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatementOutput AWS API Documentation
     #
     class ExecuteStatementOutput < Struct.new(
       :items,
       :next_token,
-      :consumed_capacity)
+      :consumed_capacity,
+      :last_evaluated_key)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5740,8 +5767,6 @@ module Aws::DynamoDB
     # @!attribute [rw] point_in_time_recovery_status
     #   The current state of point in time recovery:
     #
-    #   * `ENABLING` - Point in time recovery is being enabled.
-    #
     #   * `ENABLED` - Point in time recovery is enabled.
     #
     #   * `DISABLED` - Point in time recovery is disabled.

data/lib/aws-sdk-dynamodb.rb

@@ -50,6 +50,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
 # @!group service
 module Aws::DynamoDB
 
-  GEM_VERSION = '1.69.0'
+  GEM_VERSION = '1.73.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-dynamodb
 version: !ruby/object:Gem::Version
-  version: 1.69.0
+  version: 1.73.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-01 00:00:00.000000000 Z
+date: 2022-02-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.122.0
+        version: 3.126.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.122.0
+        version: 3.126.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement