aws-sdk-dynamodb 1.72.0 → 1.75.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: b0ae31718a0b2d46c5a52ba9ab63b31ae5f64920ec35c791b0429ead01ca80ef
4
- data.tar.gz: '058396cdc0515871050fea88f1a2d1d829fe511a3c539523521e7b2d507f00a1'
3
+ metadata.gz: 79a8f7d90716096cc816bcaa1c94e20d4b25a45d9ef563d9ec4be2853733072b
4
+ data.tar.gz: ccdfc32c84f0a02de79fe8ebebc2ed58310eea7712679ea1215a26fc97e73537
5
5
  SHA512:
6
- metadata.gz: 2166f3374e7958567e203117297dd10d6258f7e0c36e9e157d62aa5ebe2fb7cc6e612abbc2ed497ee3712cbf00bf0bf0f818f67d35d2493d599515cd09272bab
7
- data.tar.gz: ac2bbb93fae8fb18f14891916183ea24154e29d1eb38106d0d92c39612b3e8c886d5fd857aace1255988943f75a491da9e7c014704a759fd2076d724ec193bde
6
+ metadata.gz: '08b4a399dd2811b5d8fcdc54b56276e84c66fc4d73bd4ba8a8f48169a4cea37378c80cbda6920973600805280c198fedc9e96128c091c0dddfbe1c4bbbdfdc7a'
7
+ data.tar.gz: 0661d453507bb416a6f1adfbc374d29cbb47e0950d933cb5a792f9809754eee5d50a8e71b708b6b5be02d6be0953f11e66bc8b005f29c282f519d70ad16a3454
data/CHANGELOG.md CHANGED
@@ -1,6 +1,21 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.75.0 (2022-06-17)
5
+ ------------------
6
+
7
+ * Feature - Doc only update for DynamoDB service
8
+
9
+ 1.74.0 (2022-02-24)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.73.0 (2022-02-21)
15
+ ------------------
16
+
17
+ * 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.
18
+
4
19
  1.72.0 (2022-02-03)
5
20
  ------------------
6
21
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.72.0
1
+ 1.75.0
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
27
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
29
  require 'aws-sdk-core/plugins/http_checksum.rb'
30
+ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
30
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
31
32
  require 'aws-sdk-core/plugins/recursion_detection.rb'
32
33
  require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -78,6 +79,7 @@ module Aws::DynamoDB
78
79
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
79
80
  add_plugin(Aws::Plugins::TransferEncoding)
80
81
  add_plugin(Aws::Plugins::HttpChecksum)
82
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
81
83
  add_plugin(Aws::Plugins::DefaultsMode)
82
84
  add_plugin(Aws::Plugins::RecursionDetection)
83
85
  add_plugin(Aws::Plugins::SignatureV4)
@@ -379,13 +381,25 @@ module Aws::DynamoDB
379
381
  # @!group API Operations
380
382
 
381
383
  # This operation allows you to perform batch reads or writes on data
382
- # stored in DynamoDB, using PartiQL.
384
+ # stored in DynamoDB, using PartiQL. Each read statement in a
385
+ # `BatchExecuteStatement` must specify an equality condition on all key
386
+ # attributes. This enforces that each `SELECT` statement in a batch
387
+ # returns at most a single item.
383
388
  #
384
389
  # <note markdown="1"> The entire batch must consist of either read statements or write
385
390
  # statements, you cannot mix both in one batch.
386
391
  #
387
392
  # </note>
388
393
  #
394
+ # A HTTP 200 response does not mean that all statements in the
395
+ # BatchExecuteStatement succeeded. Error details for individual
396
+ # statements can be found under the [Error][1] field of the
397
+ # `BatchStatementResponse` for each statement.
398
+ #
399
+ #
400
+ #
401
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchStatementResponse.html#DDB-Type-BatchStatementResponse-Error
402
+ #
389
403
  # @option params [required, Array<Types::BatchStatementRequest>] :statements
390
404
  # The list of PartiQL statements representing the batch to run.
391
405
  #
@@ -1760,6 +1774,10 @@ module Aws::DynamoDB
1760
1774
  #
1761
1775
  # * `ALL_OLD` - The content of the old item is returned.
1762
1776
  #
1777
+ # There is no additional cost associated with requesting a return value
1778
+ # aside from the small network and processing overhead of receiving a
1779
+ # larger response. No read capacity units are consumed.
1780
+ #
1763
1781
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
1764
1782
  # however, `DeleteItem` does not recognize any values other than `NONE`
1765
1783
  # or `ALL_OLD`.
@@ -3016,6 +3034,19 @@ module Aws::DynamoDB
3016
3034
  # This operation allows you to perform reads and singleton writes on
3017
3035
  # data stored in DynamoDB, using PartiQL.
3018
3036
  #
3037
+ # For PartiQL reads (`SELECT` statement), if the total number of
3038
+ # processed items exceeds the maximum dataset size limit of 1 MB, the
3039
+ # read stops and results are returned to the user as a
3040
+ # `LastEvaluatedKey` value to continue the read in a subsequent
3041
+ # operation. If the filter criteria in `WHERE` clause does not match any
3042
+ # data, the read will return an empty result set.
3043
+ #
3044
+ # A single `SELECT` statement response can return up to the maximum
3045
+ # number of items (if using the Limit parameter) or a maximum of 1 MB of
3046
+ # data (and then apply any filtering to the results using `WHERE`
3047
+ # clause). If `LastEvaluatedKey` is present in the response, you need to
3048
+ # paginate the result set.
3049
+ #
3019
3050
  # @option params [required, String] :statement
3020
3051
  # The PartiQL statement representing the operation to run.
3021
3052
  #
@@ -3048,11 +3079,24 @@ module Aws::DynamoDB
3048
3079
  #
3049
3080
  # * `NONE` - No `ConsumedCapacity` details are included in the response.
3050
3081
  #
3082
+ # @option params [Integer] :limit
3083
+ # The maximum number of items to evaluate (not necessarily the number of
3084
+ # matching items). If DynamoDB processes the number of items up to the
3085
+ # limit while processing the results, it stops the operation and returns
3086
+ # the matching values up to that point, along with a key in
3087
+ # `LastEvaluatedKey` to apply in a subsequent operation so you can pick
3088
+ # up where you left off. Also, if the processed dataset size exceeds 1
3089
+ # MB before DynamoDB reaches this limit, it stops the operation and
3090
+ # returns the matching values up to the limit, and a key in
3091
+ # `LastEvaluatedKey` to apply in a subsequent operation to continue the
3092
+ # operation.
3093
+ #
3051
3094
  # @return [Types::ExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3052
3095
  #
3053
3096
  # * {Types::ExecuteStatementOutput#items #items} => Array&lt;Hash&lt;String,Types::AttributeValue&gt;&gt;
3054
3097
  # * {Types::ExecuteStatementOutput#next_token #next_token} => String
3055
3098
  # * {Types::ExecuteStatementOutput#consumed_capacity #consumed_capacity} => Types::ConsumedCapacity
3099
+ # * {Types::ExecuteStatementOutput#last_evaluated_key #last_evaluated_key} => Hash&lt;String,Types::AttributeValue&gt;
3056
3100
  #
3057
3101
  # @example Request syntax with placeholder values
3058
3102
  #
@@ -3062,6 +3106,7 @@ module Aws::DynamoDB
3062
3106
  # consistent_read: false,
3063
3107
  # next_token: "PartiQLNextToken",
3064
3108
  # return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
3109
+ # limit: 1,
3065
3110
  # })
3066
3111
  #
3067
3112
  # @example Response structure
@@ -3085,6 +3130,8 @@ module Aws::DynamoDB
3085
3130
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
3086
3131
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
3087
3132
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
3133
+ # resp.last_evaluated_key #=> Hash
3134
+ # resp.last_evaluated_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
3088
3135
  #
3089
3136
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatement AWS API Documentation
3090
3137
  #
@@ -3187,8 +3234,9 @@ module Aws::DynamoDB
3187
3234
  # The Amazon Resource Name (ARN) associated with the table to export.
3188
3235
  #
3189
3236
  # @option params [Time,DateTime,Date,Integer,String] :export_time
3190
- # Time in the past from which to export table data. The table export
3191
- # will be a snapshot of the table's state at this point in time.
3237
+ # Time in the past from which to export table data, counted in seconds
3238
+ # from the start of the Unix epoch. The table export will be a snapshot
3239
+ # of the table's state at this point in time.
3192
3240
  #
3193
3241
  # @option params [String] :client_token
3194
3242
  # Providing a `ClientToken` makes the call to
@@ -3517,7 +3565,8 @@ module Aws::DynamoDB
3517
3565
  #
3518
3566
  # Where `BackupType` can be:
3519
3567
  #
3520
- # * `USER` - On-demand backup created by you.
3568
+ # * `USER` - On-demand backup created by you. (The default setting if no
3569
+ # other backup types are specified.)
3521
3570
  #
3522
3571
  # * `SYSTEM` - On-demand backup automatically created by DynamoDB.
3523
3572
  #
@@ -3824,29 +3873,6 @@ module Aws::DynamoDB
3824
3873
  # item's attribute values in the same operation, using the
3825
3874
  # `ReturnValues` parameter.
3826
3875
  #
3827
- # This topic provides general information about the `PutItem` API.
3828
- #
3829
- # For information on how to call the `PutItem` API using the Amazon Web
3830
- # Services SDK in specific languages, see the following:
3831
- #
3832
- # * [ PutItem in the Command Line Interface][1]
3833
- #
3834
- # * [ PutItem in the SDK for .NET][2]
3835
- #
3836
- # * [ PutItem in the SDK for C++][3]
3837
- #
3838
- # * [ PutItem in the SDK for Go][4]
3839
- #
3840
- # * [ PutItem in the SDK for Java][5]
3841
- #
3842
- # * [ PutItem in the SDK for JavaScript][6]
3843
- #
3844
- # * [ PutItem in the SDK for PHP V3][7]
3845
- #
3846
- # * [ PutItem in the SDK for Python (Boto)][8]
3847
- #
3848
- # * [ PutItem in the SDK for Ruby V2][9]
3849
- #
3850
3876
  # When you add an item, the primary key attributes are the only required
3851
3877
  # attributes. Attribute values cannot be null.
3852
3878
  #
@@ -3867,21 +3893,12 @@ module Aws::DynamoDB
3867
3893
  #
3868
3894
  # </note>
3869
3895
  #
3870
- # For more information about `PutItem`, see [Working with Items][10] in
3896
+ # For more information about `PutItem`, see [Working with Items][1] in
3871
3897
  # the *Amazon DynamoDB Developer Guide*.
3872
3898
  #
3873
3899
  #
3874
3900
  #
3875
- # [1]: http://docs.aws.amazon.com/goto/aws-cli/dynamodb-2012-08-10/PutItem
3876
- # [2]: http://docs.aws.amazon.com/goto/DotNetSDKV3/dynamodb-2012-08-10/PutItem
3877
- # [3]: http://docs.aws.amazon.com/goto/SdkForCpp/dynamodb-2012-08-10/PutItem
3878
- # [4]: http://docs.aws.amazon.com/goto/SdkForGoV1/dynamodb-2012-08-10/PutItem
3879
- # [5]: http://docs.aws.amazon.com/goto/SdkForJava/dynamodb-2012-08-10/PutItem
3880
- # [6]: http://docs.aws.amazon.com/goto/AWSJavaScriptSDK/dynamodb-2012-08-10/PutItem
3881
- # [7]: http://docs.aws.amazon.com/goto/SdkForPHPV3/dynamodb-2012-08-10/PutItem
3882
- # [8]: http://docs.aws.amazon.com/goto/boto3/dynamodb-2012-08-10/PutItem
3883
- # [9]: http://docs.aws.amazon.com/goto/SdkForRubyV2/dynamodb-2012-08-10/PutItem
3884
- # [10]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html
3901
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html
3885
3902
  #
3886
3903
  # @option params [required, String] :table_name
3887
3904
  # The name of the table to contain the item.
@@ -3936,6 +3953,10 @@ module Aws::DynamoDB
3936
3953
  #
3937
3954
  # The values returned are strongly consistent.
3938
3955
  #
3956
+ # There is no additional cost associated with requesting a return value
3957
+ # aside from the small network and processing overhead of receiving a
3958
+ # larger response. No read capacity units are consumed.
3959
+ #
3939
3960
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
3940
3961
  # however, `PutItem` does not recognize any values other than `NONE` or
3941
3962
  # `ALL_OLD`.
@@ -4257,8 +4278,9 @@ module Aws::DynamoDB
4257
4278
  # matching items themselves.
4258
4279
  #
4259
4280
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
4260
- # `AttributesToGet`. This return value is equivalent to specifying
4261
- # `AttributesToGet` without specifying any value for `Select`.
4281
+ # `ProjectionExpression`. This return value is equivalent to
4282
+ # specifying `ProjectionExpression` without specifying any value for
4283
+ # `Select`.
4262
4284
  #
4263
4285
  # If you query or scan a local secondary index and request only
4264
4286
  # attributes that are projected into that index, the operation will
@@ -4271,12 +4293,12 @@ module Aws::DynamoDB
4271
4293
  # attributes that are projected into the index. Global secondary index
4272
4294
  # queries cannot fetch attributes from the parent table.
4273
4295
  #
4274
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
4296
+ # If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
4275
4297
  # defaults to `ALL_ATTRIBUTES` when accessing a table, and
4276
4298
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
4277
- # both `Select` and `AttributesToGet` together in a single request,
4299
+ # both `Select` and `ProjectionExpression` together in a single request,
4278
4300
  # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
4279
- # equivalent to specifying `AttributesToGet` without any value for
4301
+ # equivalent to specifying `ProjectionExpression` without any value for
4280
4302
  # `Select`.)
4281
4303
  #
4282
4304
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -4425,7 +4447,7 @@ module Aws::DynamoDB
4425
4447
  #
4426
4448
  #
4427
4449
  #
4428
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
4450
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
4429
4451
  #
4430
4452
  # @option params [String] :key_condition_expression
4431
4453
  # The condition that specifies the key values for items to be retrieved
@@ -5210,8 +5232,9 @@ module Aws::DynamoDB
5210
5232
  # matching items themselves.
5211
5233
  #
5212
5234
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
5213
- # `AttributesToGet`. This return value is equivalent to specifying
5214
- # `AttributesToGet` without specifying any value for `Select`.
5235
+ # `ProjectionExpression`. This return value is equivalent to
5236
+ # specifying `ProjectionExpression` without specifying any value for
5237
+ # `Select`.
5215
5238
  #
5216
5239
  # If you query or scan a local secondary index and request only
5217
5240
  # attributes that are projected into that index, the operation reads
@@ -5224,12 +5247,12 @@ module Aws::DynamoDB
5224
5247
  # attributes that are projected into the index. Global secondary index
5225
5248
  # queries cannot fetch attributes from the parent table.
5226
5249
  #
5227
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
5250
+ # If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
5228
5251
  # defaults to `ALL_ATTRIBUTES` when accessing a table, and
5229
5252
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
5230
- # both `Select` and `AttributesToGet` together in a single request,
5253
+ # both `Select` and `ProjectionExpression` together in a single request,
5231
5254
  # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
5232
- # equivalent to specifying `AttributesToGet` without any value for
5255
+ # equivalent to specifying `ProjectionExpression` without any value for
5233
5256
  # `Select`.)
5234
5257
  #
5235
5258
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -5350,7 +5373,7 @@ module Aws::DynamoDB
5350
5373
  #
5351
5374
  #
5352
5375
  #
5353
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
5376
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
5354
5377
  #
5355
5378
  # @option params [Hash<String,String>] :expression_attribute_names
5356
5379
  # One or more substitution tokens for attribute names in an expression.
@@ -6723,8 +6746,6 @@ module Aws::DynamoDB
6723
6746
  #
6724
6747
  # * Modify the provisioned throughput settings of the table.
6725
6748
  #
6726
- # * Enable or disable DynamoDB Streams on the table.
6727
- #
6728
6749
  # * Remove a global secondary index from the table.
6729
6750
  #
6730
6751
  # * Create a new global secondary index on the table. After the index
@@ -7320,7 +7341,7 @@ module Aws::DynamoDB
7320
7341
  params: params,
7321
7342
  config: config)
7322
7343
  context[:gem_name] = 'aws-sdk-dynamodb'
7323
- context[:gem_version] = '1.72.0'
7344
+ context[:gem_version] = '1.75.0'
7324
7345
  Seahorse::Client::Request.new(handlers, context)
7325
7346
  end
7326
7347
 
@@ -835,11 +835,13 @@ module Aws::DynamoDB
835
835
  ExecuteStatementInput.add_member(:consistent_read, Shapes::ShapeRef.new(shape: ConsistentRead, location_name: "ConsistentRead"))
836
836
  ExecuteStatementInput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
837
837
  ExecuteStatementInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
838
+ ExecuteStatementInput.add_member(:limit, Shapes::ShapeRef.new(shape: PositiveIntegerObject, location_name: "Limit"))
838
839
  ExecuteStatementInput.struct_class = Types::ExecuteStatementInput
839
840
 
840
841
  ExecuteStatementOutput.add_member(:items, Shapes::ShapeRef.new(shape: ItemList, location_name: "Items"))
841
842
  ExecuteStatementOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
842
843
  ExecuteStatementOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacity, location_name: "ConsumedCapacity"))
844
+ ExecuteStatementOutput.add_member(:last_evaluated_key, Shapes::ShapeRef.new(shape: Key, location_name: "LastEvaluatedKey"))
843
845
  ExecuteStatementOutput.struct_class = Types::ExecuteStatementOutput
844
846
 
845
847
  ExecuteTransactionInput.add_member(:transact_statements, Shapes::ShapeRef.new(shape: ParameterizedStatements, required: true, location_name: "TransactStatements"))
@@ -194,9 +194,9 @@ module Aws::DynamoDB
194
194
  # * `NonKeyAttributes` - A list of one or more non-key attribute names
195
195
  # that are projected into the secondary index. The total count of
196
196
  # attributes provided in `NonKeyAttributes`, summed across all of
197
- # the secondary indexes, must not exceed 20. If you project the same
198
- # attribute into two different indexes, this counts as two distinct
199
- # attributes when determining the total.
197
+ # the secondary indexes, must not exceed 100. If you project the
198
+ # same attribute into two different indexes, this counts as two
199
+ # distinct attributes when determining the total.
200
200
  #
201
201
  # * `IndexSizeBytes` - Represents the total size of the index, in bytes.
202
202
  # DynamoDB updates this value approximately every six hours. Recent
@@ -275,9 +275,9 @@ module Aws::DynamoDB
275
275
  # * `NonKeyAttributes` - A list of one or more non-key attribute names
276
276
  # that are projected into the secondary index. The total count of
277
277
  # attributes provided in `NonKeyAttributes`, summed across all of
278
- # the secondary indexes, must not exceed 20. If you project the same
279
- # attribute into two different indexes, this counts as two distinct
280
- # attributes when determining the total.
278
+ # the secondary indexes, must not exceed 100. If you project the
279
+ # same attribute into two different indexes, this counts as two
280
+ # distinct attributes when determining the total.
281
281
  #
282
282
  # * `ProvisionedThroughput` - The provisioned throughput settings for
283
283
  # the global secondary index, consisting of read and write capacity
@@ -569,6 +569,10 @@ module Aws::DynamoDB
569
569
  #
570
570
  # * `ALL_OLD` - The content of the old item is returned.
571
571
  #
572
+ # There is no additional cost associated with requesting a return value
573
+ # aside from the small network and processing overhead of receiving a
574
+ # larger response. No read capacity units are consumed.
575
+ #
572
576
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
573
577
  # however, `DeleteItem` does not recognize any values other than `NONE`
574
578
  # or `ALL_OLD`.
@@ -897,6 +901,10 @@ module Aws::DynamoDB
897
901
  #
898
902
  # The values returned are strongly consistent.
899
903
  #
904
+ # There is no additional cost associated with requesting a return value
905
+ # aside from the small network and processing overhead of receiving a
906
+ # larger response. No read capacity units are consumed.
907
+ #
900
908
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
901
909
  # however, `PutItem` does not recognize any values other than `NONE` or
902
910
  # `ALL_OLD`.
@@ -1097,8 +1105,9 @@ module Aws::DynamoDB
1097
1105
  # matching items themselves.
1098
1106
  #
1099
1107
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
1100
- # `AttributesToGet`. This return value is equivalent to specifying
1101
- # `AttributesToGet` without specifying any value for `Select`.
1108
+ # `ProjectionExpression`. This return value is equivalent to
1109
+ # specifying `ProjectionExpression` without specifying any value for
1110
+ # `Select`.
1102
1111
  #
1103
1112
  # If you query or scan a local secondary index and request only
1104
1113
  # attributes that are projected into that index, the operation will
@@ -1111,12 +1120,12 @@ module Aws::DynamoDB
1111
1120
  # attributes that are projected into the index. Global secondary index
1112
1121
  # queries cannot fetch attributes from the parent table.
1113
1122
  #
1114
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
1123
+ # If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
1115
1124
  # defaults to `ALL_ATTRIBUTES` when accessing a table, and
1116
1125
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
1117
- # both `Select` and `AttributesToGet` together in a single request,
1126
+ # both `Select` and `ProjectionExpression` together in a single request,
1118
1127
  # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
1119
- # equivalent to specifying `AttributesToGet` without any value for
1128
+ # equivalent to specifying `ProjectionExpression` without any value for
1120
1129
  # `Select`.)
1121
1130
  #
1122
1131
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -1254,7 +1263,7 @@ module Aws::DynamoDB
1254
1263
  #
1255
1264
  #
1256
1265
  #
1257
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
1266
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
1258
1267
  # @option options [String] :key_condition_expression
1259
1268
  # The condition that specifies the key values for items to be retrieved
1260
1269
  # by the `Query` action.
@@ -1501,8 +1510,9 @@ module Aws::DynamoDB
1501
1510
  # matching items themselves.
1502
1511
  #
1503
1512
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
1504
- # `AttributesToGet`. This return value is equivalent to specifying
1505
- # `AttributesToGet` without specifying any value for `Select`.
1513
+ # `ProjectionExpression`. This return value is equivalent to
1514
+ # specifying `ProjectionExpression` without specifying any value for
1515
+ # `Select`.
1506
1516
  #
1507
1517
  # If you query or scan a local secondary index and request only
1508
1518
  # attributes that are projected into that index, the operation reads
@@ -1515,12 +1525,12 @@ module Aws::DynamoDB
1515
1525
  # attributes that are projected into the index. Global secondary index
1516
1526
  # queries cannot fetch attributes from the parent table.
1517
1527
  #
1518
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
1528
+ # If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
1519
1529
  # defaults to `ALL_ATTRIBUTES` when accessing a table, and
1520
1530
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
1521
- # both `Select` and `AttributesToGet` together in a single request,
1531
+ # both `Select` and `ProjectionExpression` together in a single request,
1522
1532
  # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
1523
- # equivalent to specifying `AttributesToGet` without any value for
1533
+ # equivalent to specifying `ProjectionExpression` without any value for
1524
1534
  # `Select`.)
1525
1535
  #
1526
1536
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -1633,7 +1643,7 @@ module Aws::DynamoDB
1633
1643
  #
1634
1644
  #
1635
1645
  #
1636
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
1646
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
1637
1647
  # @option options [Hash<String,String>] :expression_attribute_names
1638
1648
  # One or more substitution tokens for attribute names in an expression.
1639
1649
  # The following are some use cases for using
@@ -164,7 +164,7 @@ module Aws::DynamoDB
164
164
  # @!attribute [rw] l
165
165
  # An attribute of type List. For example:
166
166
  #
167
- # `"L": [ \{"S": "Cookies"\} , \{"S": "Coffee"\}, \{"N", "3.14159"\}]`
167
+ # `"L": [ \{"S": "Cookies"\} , \{"S": "Coffee"\}, \{"N": "3.14159"\}]`
168
168
  # @return [Array<Types::AttributeValue>]
169
169
  #
170
170
  # @!attribute [rw] null
@@ -304,10 +304,9 @@ module Aws::DynamoDB
304
304
  #
305
305
  # * `DELETE` - Nothing happens; there is no attribute to delete.
306
306
  #
307
- # * `ADD` - DynamoDB creates an item with the supplied primary key and
308
- # number (or set of numbers) for the attribute value. The only data
309
- # types allowed are number and number set; no other data types can
310
- # be specified.
307
+ # * `ADD` - DynamoDB creates a new item with the supplied primary key
308
+ # and number (or set) for the attribute value. The only data types
309
+ # allowed are number, number set, string set or binary set.
311
310
  # @return [String]
312
311
  #
313
312
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/AttributeValueUpdate AWS API Documentation
@@ -605,7 +604,9 @@ module Aws::DynamoDB
605
604
  # @return [String]
606
605
  #
607
606
  # @!attribute [rw] backup_size_bytes
608
- # Size of the backup in bytes.
607
+ # Size of the backup in bytes. DynamoDB updates this value
608
+ # approximately every six hours. Recent changes might not be reflected
609
+ # in this value.
609
610
  # @return [Integer]
610
611
  #
611
612
  # @!attribute [rw] backup_status
@@ -2522,6 +2523,10 @@ module Aws::DynamoDB
2522
2523
  #
2523
2524
  # * `ALL_OLD` - The content of the old item is returned.
2524
2525
  #
2526
+ # There is no additional cost associated with requesting a return
2527
+ # value aside from the small network and processing overhead of
2528
+ # receiving a larger response. No read capacity units are consumed.
2529
+ #
2525
2530
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
2526
2531
  # however, `DeleteItem` does not recognize any values other than
2527
2532
  # `NONE` or `ALL_OLD`.
@@ -3316,6 +3321,7 @@ module Aws::DynamoDB
3316
3321
  # consistent_read: false,
3317
3322
  # next_token: "PartiQLNextToken",
3318
3323
  # return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
3324
+ # limit: 1,
3319
3325
  # }
3320
3326
  #
3321
3327
  # @!attribute [rw] statement
@@ -3357,6 +3363,19 @@ module Aws::DynamoDB
3357
3363
  # response.
3358
3364
  # @return [String]
3359
3365
  #
3366
+ # @!attribute [rw] limit
3367
+ # The maximum number of items to evaluate (not necessarily the number
3368
+ # of matching items). If DynamoDB processes the number of items up to
3369
+ # the limit while processing the results, it stops the operation and
3370
+ # returns the matching values up to that point, along with a key in
3371
+ # `LastEvaluatedKey` to apply in a subsequent operation so you can
3372
+ # pick up where you left off. Also, if the processed dataset size
3373
+ # exceeds 1 MB before DynamoDB reaches this limit, it stops the
3374
+ # operation and returns the matching values up to the limit, and a key
3375
+ # in `LastEvaluatedKey` to apply in a subsequent operation to continue
3376
+ # the operation.
3377
+ # @return [Integer]
3378
+ #
3360
3379
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatementInput AWS API Documentation
3361
3380
  #
3362
3381
  class ExecuteStatementInput < Struct.new(
@@ -3364,7 +3383,8 @@ module Aws::DynamoDB
3364
3383
  :parameters,
3365
3384
  :consistent_read,
3366
3385
  :next_token,
3367
- :return_consumed_capacity)
3386
+ :return_consumed_capacity,
3387
+ :limit)
3368
3388
  SENSITIVE = []
3369
3389
  include Aws::Structure
3370
3390
  end
@@ -3395,12 +3415,24 @@ module Aws::DynamoDB
3395
3415
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
3396
3416
  # @return [Types::ConsumedCapacity]
3397
3417
  #
3418
+ # @!attribute [rw] last_evaluated_key
3419
+ # The primary key of the item where the operation stopped, inclusive
3420
+ # of the previous result set. Use this value to start a new operation,
3421
+ # excluding this value in the new request. If `LastEvaluatedKey` is
3422
+ # empty, then the "last page" of results has been processed and
3423
+ # there is no more data to be retrieved. If `LastEvaluatedKey` is not
3424
+ # empty, it does not necessarily mean that there is more data in the
3425
+ # result set. The only way to know when you have reached the end of
3426
+ # the result set is when `LastEvaluatedKey` is empty.
3427
+ # @return [Hash<String,Types::AttributeValue>]
3428
+ #
3398
3429
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatementOutput AWS API Documentation
3399
3430
  #
3400
3431
  class ExecuteStatementOutput < Struct.new(
3401
3432
  :items,
3402
3433
  :next_token,
3403
- :consumed_capacity)
3434
+ :consumed_capacity,
3435
+ :last_evaluated_key)
3404
3436
  SENSITIVE = []
3405
3437
  include Aws::Structure
3406
3438
  end
@@ -3931,8 +3963,9 @@ module Aws::DynamoDB
3931
3963
  # @return [String]
3932
3964
  #
3933
3965
  # @!attribute [rw] export_time
3934
- # Time in the past from which to export table data. The table export
3935
- # will be a snapshot of the table's state at this point in time.
3966
+ # Time in the past from which to export table data, counted in seconds
3967
+ # from the start of the Unix epoch. The table export will be a
3968
+ # snapshot of the table's state at this point in time.
3936
3969
  # @return [Time]
3937
3970
  #
3938
3971
  # @!attribute [rw] client_token
@@ -5161,17 +5194,17 @@ module Aws::DynamoDB
5161
5194
  # There is no limit to the number of daily on-demand backups that can be
5162
5195
  # taken.
5163
5196
  #
5164
- # Up to 50 simultaneous table operations are allowed per account. These
5197
+ # Up to 500 simultaneous table operations are allowed per account. These
5165
5198
  # operations include `CreateTable`, `UpdateTable`,
5166
5199
  # `DeleteTable`,`UpdateTimeToLive`, `RestoreTableFromBackup`, and
5167
5200
  # `RestoreTableToPointInTime`.
5168
5201
  #
5169
5202
  # The only exception is when you are creating a table with one or more
5170
- # secondary indexes. You can have up to 25 such requests running at a
5203
+ # secondary indexes. You can have up to 250 such requests running at a
5171
5204
  # time; however, if the table or index specifications are complex,
5172
5205
  # DynamoDB might temporarily reduce the number of concurrent operations.
5173
5206
  #
5174
- # There is a soft account quota of 256 tables.
5207
+ # There is a soft account quota of 2,500 tables.
5175
5208
  #
5176
5209
  # @!attribute [rw] message
5177
5210
  # Too many operations for a given subscriber.
@@ -5228,7 +5261,8 @@ module Aws::DynamoDB
5228
5261
  #
5229
5262
  # Where `BackupType` can be:
5230
5263
  #
5231
- # * `USER` - On-demand backup created by you.
5264
+ # * `USER` - On-demand backup created by you. (The default setting if
5265
+ # no other backup types are specified.)
5232
5266
  #
5233
5267
  # * `SYSTEM` - On-demand backup automatically created by DynamoDB.
5234
5268
  #
@@ -5832,7 +5866,7 @@ module Aws::DynamoDB
5832
5866
  #
5833
5867
  # For local secondary indexes, the total count of `NonKeyAttributes`
5834
5868
  # summed across all of the local secondary indexes, must not exceed
5835
- # 20. If you project the same attribute into two different indexes,
5869
+ # 100. If you project the same attribute into two different indexes,
5836
5870
  # this counts as two distinct attributes when determining the total.
5837
5871
  # @return [Array<String>]
5838
5872
  #
@@ -6153,6 +6187,10 @@ module Aws::DynamoDB
6153
6187
  #
6154
6188
  # The values returned are strongly consistent.
6155
6189
  #
6190
+ # There is no additional cost associated with requesting a return
6191
+ # value aside from the small network and processing overhead of
6192
+ # receiving a larger response. No read capacity units are consumed.
6193
+ #
6156
6194
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
6157
6195
  # however, `PutItem` does not recognize any values other than `NONE`
6158
6196
  # or `ALL_OLD`.
@@ -6478,8 +6516,9 @@ module Aws::DynamoDB
6478
6516
  # matching items themselves.
6479
6517
  #
6480
6518
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
6481
- # `AttributesToGet`. This return value is equivalent to specifying
6482
- # `AttributesToGet` without specifying any value for `Select`.
6519
+ # `ProjectionExpression`. This return value is equivalent to
6520
+ # specifying `ProjectionExpression` without specifying any value for
6521
+ # `Select`.
6483
6522
  #
6484
6523
  # If you query or scan a local secondary index and request only
6485
6524
  # attributes that are projected into that index, the operation will
@@ -6493,13 +6532,13 @@ module Aws::DynamoDB
6493
6532
  # secondary index queries cannot fetch attributes from the parent
6494
6533
  # table.
6495
6534
  #
6496
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
6497
- # defaults to `ALL_ATTRIBUTES` when accessing a table, and
6535
+ # If neither `Select` nor `ProjectionExpression` are specified,
6536
+ # DynamoDB defaults to `ALL_ATTRIBUTES` when accessing a table, and
6498
6537
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
6499
- # both `Select` and `AttributesToGet` together in a single request,
6500
- # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage
6501
- # is equivalent to specifying `AttributesToGet` without any value for
6502
- # `Select`.)
6538
+ # both `Select` and `ProjectionExpression` together in a single
6539
+ # request, unless the value for `Select` is `SPECIFIC_ATTRIBUTES`.
6540
+ # (This usage is equivalent to specifying `ProjectionExpression`
6541
+ # without any value for `Select`.)
6503
6542
  #
6504
6543
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
6505
6544
  # `Select` can only be `SPECIFIC_ATTRIBUTES`. Any other value for
@@ -6661,7 +6700,7 @@ module Aws::DynamoDB
6661
6700
  #
6662
6701
  #
6663
6702
  #
6664
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
6703
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
6665
6704
  # @return [String]
6666
6705
  #
6667
6706
  # @!attribute [rw] key_condition_expression
@@ -7631,6 +7670,12 @@ module Aws::DynamoDB
7631
7670
  # `DeleteTableReplica` action in the destination Region, deleting the
7632
7671
  # replica and all if its items in the destination Region.
7633
7672
  #
7673
+ # <note markdown="1"> When you manually remove a table or global table replica, you do not
7674
+ # automatically remove any associated scalable targets, scaling
7675
+ # policies, or CloudWatch alarms.
7676
+ #
7677
+ # </note>
7678
+ #
7634
7679
  # @note When making an API call, you may pass ReplicationGroupUpdate
7635
7680
  # data as a hash:
7636
7681
  #
@@ -8206,8 +8251,9 @@ module Aws::DynamoDB
8206
8251
  # matching items themselves.
8207
8252
  #
8208
8253
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
8209
- # `AttributesToGet`. This return value is equivalent to specifying
8210
- # `AttributesToGet` without specifying any value for `Select`.
8254
+ # `ProjectionExpression`. This return value is equivalent to
8255
+ # specifying `ProjectionExpression` without specifying any value for
8256
+ # `Select`.
8211
8257
  #
8212
8258
  # If you query or scan a local secondary index and request only
8213
8259
  # attributes that are projected into that index, the operation reads
@@ -8221,13 +8267,13 @@ module Aws::DynamoDB
8221
8267
  # secondary index queries cannot fetch attributes from the parent
8222
8268
  # table.
8223
8269
  #
8224
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
8225
- # defaults to `ALL_ATTRIBUTES` when accessing a table, and
8270
+ # If neither `Select` nor `ProjectionExpression` are specified,
8271
+ # DynamoDB defaults to `ALL_ATTRIBUTES` when accessing a table, and
8226
8272
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
8227
- # both `Select` and `AttributesToGet` together in a single request,
8228
- # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage
8229
- # is equivalent to specifying `AttributesToGet` without any value for
8230
- # `Select`.)
8273
+ # both `Select` and `ProjectionExpression` together in a single
8274
+ # request, unless the value for `Select` is `SPECIFIC_ATTRIBUTES`.
8275
+ # (This usage is equivalent to specifying `ProjectionExpression`
8276
+ # without any value for `Select`.)
8231
8277
  #
8232
8278
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
8233
8279
  # `Select` can only be `SPECIFIC_ATTRIBUTES`. Any other value for
@@ -8358,7 +8404,7 @@ module Aws::DynamoDB
8358
8404
  #
8359
8405
  #
8360
8406
  #
8361
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
8407
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
8362
8408
  # @return [String]
8363
8409
  #
8364
8410
  # @!attribute [rw] expression_attribute_names
@@ -8916,7 +8962,7 @@ module Aws::DynamoDB
8916
8962
  # * `NonKeyAttributes` - A list of one or more non-key attribute
8917
8963
  # names that are projected into the secondary index. The total
8918
8964
  # count of attributes provided in `NonKeyAttributes`, summed
8919
- # across all of the secondary indexes, must not exceed 20. If you
8965
+ # across all of the secondary indexes, must not exceed 100. If you
8920
8966
  # project the same attribute into two different indexes, this
8921
8967
  # counts as two distinct attributes when determining the total.
8922
8968
  #
@@ -8996,7 +9042,7 @@ module Aws::DynamoDB
8996
9042
  # * `NonKeyAttributes` - A list of one or more non-key attribute
8997
9043
  # names that are projected into the secondary index. The total
8998
9044
  # count of attributes provided in `NonKeyAttributes`, summed
8999
- # across all of the secondary indexes, must not exceed 20. If you
9045
+ # across all of the secondary indexes, must not exceed 100. If you
9000
9046
  # project the same attribute into two different indexes, this
9001
9047
  # counts as two distinct attributes when determining the total.
9002
9048
  #
@@ -9106,7 +9152,8 @@ module Aws::DynamoDB
9106
9152
  end
9107
9153
 
9108
9154
  # A source table with the name `TableName` does not currently exist
9109
- # within the subscriber's account.
9155
+ # within the subscriber's account or the subscriber is operating in the
9156
+ # wrong Amazon Web Services Region.
9110
9157
  #
9111
9158
  # @!attribute [rw] message
9112
9159
  # @return [String]
@@ -9648,7 +9695,7 @@ module Aws::DynamoDB
9648
9695
  # <note markdown="1"> If using Java, DynamoDB lists the cancellation reasons on the
9649
9696
  # `CancellationReasons` property. This property is not set for other
9650
9697
  # languages. Transaction cancellation reasons are ordered in the order
9651
- # of requested items, if an item has no error it will have `NONE` code
9698
+ # of requested items, if an item has no error it will have `None` code
9652
9699
  # and `Null` message.
9653
9700
  #
9654
9701
  # </note>
@@ -9657,7 +9704,7 @@ module Aws::DynamoDB
9657
9704
  #
9658
9705
  # * No Errors:
9659
9706
  #
9660
- # * Code: `NONE`
9707
+ # * Code: `None`
9661
9708
  #
9662
9709
  # * Message: `null`
9663
9710
  #
@@ -50,6 +50,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
50
50
  # @!group service
51
51
  module Aws::DynamoDB
52
52
 
53
- GEM_VERSION = '1.72.0'
53
+ GEM_VERSION = '1.75.0'
54
54
 
55
55
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-dynamodb
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.72.0
4
+ version: 1.75.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-02-03 00:00:00.000000000 Z
11
+ date: 2022-06-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.126.0
22
+ version: 3.127.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.126.0
32
+ version: 3.127.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement