aws-sdk-dynamodb 1.80.0 → 1.82.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7b78cfc954b5c7a3bbfdfd7d76e91faf470b05f0a7726af33aa38123f02db795
4
- data.tar.gz: 6bb26fd1a69313ce095640af38f9524b1e7ab7fc51e91d40b5319b3cf2a91beb
3
+ metadata.gz: dfc9197d05e4115ac3b250ab9a2790c327199b36d20cb0dcd652c78c6a20f7bf
4
+ data.tar.gz: dcba8dc0a49f1249f752e1c5ef88744f0ef8b127c9c788c14a6e9fbf4a18f45f
5
5
  SHA512:
6
- metadata.gz: d9e83110759855cf503797a0f0f455b6d9bc55e806346c25a21ad2d11b6265febe58d58ef0939cd5b6a1b768c9b05a346f93833563347ff239f1004ba44c31a2
7
- data.tar.gz: 53bef726285c35a58ca60114d490e783f0675b1ace50832006833e4d21c6e19e8752e7731d3fbe4ea45381a4b95d9682c7bc0e353cccb77bd22083bd43e823e8
6
+ metadata.gz: b8d368fb5b441aca4fd4600d68605aa8b59a8eaba7f90eb999f01b96ab204a80cb9eae90562502091250a250a73caae85b4a33bfa0e29ee5880b1c3fe2684289
7
+ data.tar.gz: 56d8bc440a87f10c933a5dc75800f7c02687d6e513091652e11f7c5f64a82fa4c36aaed6ffeb14778ec42ccf7ace002c0eacbeb96a73047d1f8040b79fad9ea0
data/CHANGELOG.md CHANGED
@@ -1,6 +1,18 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.82.0 (2023-03-03)
5
+ ------------------
6
+
7
+ * Feature - Documentation updates for DynamoDB.
8
+
9
+ 1.81.0 (2023-01-18)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ * Issue - Replace runtime endpoint resolution approach with generated ruby code.
15
+
4
16
  1.80.0 (2022-12-06)
5
17
  ------------------
6
18
 
@@ -494,4 +506,4 @@ Unreleased Changes
494
506
  1.0.0.rc1 (2016-12-05)
495
507
  ------------------
496
508
 
497
- * Feature - Initial preview release of the `aws-sdk-dynamodb` gem.
509
+ * Feature - Initial preview release of the `aws-sdk-dynamodb` gem.
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.80.0
1
+ 1.82.0
@@ -1104,10 +1104,14 @@ module Aws::DynamoDB
1104
1104
  # a replication relationship between two or more DynamoDB tables with
1105
1105
  # the same table name in the provided Regions.
1106
1106
  #
1107
- # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
1108
- # tables.
1109
- #
1110
- # </note>
1107
+ # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
1108
+ # global tables. We recommend using [Version 2019.11.21 (Current)][2]
1109
+ # when creating new global tables, as it provides greater flexibility,
1110
+ # higher efficiency and consumes less write capacity than 2017.11.29
1111
+ # (Legacy). To determine which version you are using, see [Determining
1112
+ # the version][3]. To update existing global tables from version
1113
+ # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
1114
+ # global tables][4].
1111
1115
  #
1112
1116
  # If you want to add a new replica table to a global table, each of the
1113
1117
  # following conditions must be true:
@@ -1151,6 +1155,9 @@ module Aws::DynamoDB
1151
1155
  #
1152
1156
  #
1153
1157
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
1158
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
1159
+ # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
1160
+ # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
1154
1161
  #
1155
1162
  # @option params [required, String] :global_table_name
1156
1163
  # The global table name.
@@ -1760,7 +1767,7 @@ module Aws::DynamoDB
1760
1767
  # A map of attribute names to `AttributeValue` objects, representing the
1761
1768
  # primary key of the item to delete.
1762
1769
  #
1763
- # For the primary key, you must provide all of the attributes. For
1770
+ # For the primary key, you must provide all of the key attributes. For
1764
1771
  # example, with a simple primary key, you only need to provide a value
1765
1772
  # for the partition key. For a composite primary key, you must provide
1766
1773
  # values for both the partition key and the sort key.
@@ -2023,6 +2030,9 @@ module Aws::DynamoDB
2023
2030
  # DynamoDB returns a `ResourceNotFoundException`. If table is already in
2024
2031
  # the `DELETING` state, no error is returned.
2025
2032
  #
2033
+ # This operation only applies to [Version 2019.11.21 (Current)][1] of
2034
+ # global tables.
2035
+ #
2026
2036
  # <note markdown="1"> DynamoDB might continue to accept data read and write operations, such
2027
2037
  # as `GetItem` and `PutItem`, on a table in the `DELETING` state until
2028
2038
  # the table deletion is complete.
@@ -2037,6 +2047,10 @@ module Aws::DynamoDB
2037
2047
  #
2038
2048
  # Use the `DescribeTable` action to check the status of the table.
2039
2049
  #
2050
+ #
2051
+ #
2052
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
2053
+ #
2040
2054
  # @option params [required, String] :table_name
2041
2055
  # The name of the table to delete.
2042
2056
  #
@@ -2287,7 +2301,7 @@ module Aws::DynamoDB
2287
2301
  req.send_request(options)
2288
2302
  end
2289
2303
 
2290
- # Returns information about contributor insights, for a given table or
2304
+ # Returns information about contributor insights for a given table or
2291
2305
  # global secondary index.
2292
2306
  #
2293
2307
  # @option params [required, String] :table_name
@@ -2332,7 +2346,14 @@ module Aws::DynamoDB
2332
2346
  req.send_request(options)
2333
2347
  end
2334
2348
 
2335
- # Returns the regional endpoint information.
2349
+ # Returns the regional endpoint information. This action must be
2350
+ # included in your VPC endpoint policies, or access to the
2351
+ # DescribeEndpoints API will be denied. For more information on policy
2352
+ # permissions, please see [Internetwork traffic privacy][1].
2353
+ #
2354
+ #
2355
+ #
2356
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/inter-network-traffic-privacy.html#inter-network-traffic-DescribeEndpoints
2336
2357
  #
2337
2358
  # @return [Types::DescribeEndpointsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2338
2359
  #
@@ -2401,17 +2422,21 @@ module Aws::DynamoDB
2401
2422
 
2402
2423
  # Returns information about the specified global table.
2403
2424
  #
2404
- # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
2405
- # tables. If you are using global tables [Version 2019.11.21][2] you can
2406
- # use [DescribeTable][3] instead.
2407
- #
2408
- # </note>
2425
+ # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
2426
+ # global tables. We recommend using [Version 2019.11.21 (Current)][2]
2427
+ # when creating new global tables, as it provides greater flexibility,
2428
+ # higher efficiency and consumes less write capacity than 2017.11.29
2429
+ # (Legacy). To determine which version you are using, see [Determining
2430
+ # the version][3]. To update existing global tables from version
2431
+ # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
2432
+ # global tables][4].
2409
2433
  #
2410
2434
  #
2411
2435
  #
2412
2436
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
2413
2437
  # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
2414
- # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html
2438
+ # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
2439
+ # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
2415
2440
  #
2416
2441
  # @option params [required, String] :global_table_name
2417
2442
  # The name of the global table.
@@ -2457,14 +2482,21 @@ module Aws::DynamoDB
2457
2482
 
2458
2483
  # Describes Region-specific settings for a global table.
2459
2484
  #
2460
- # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
2461
- # tables.
2462
- #
2463
- # </note>
2485
+ # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
2486
+ # global tables. We recommend using [Version 2019.11.21 (Current)][2]
2487
+ # when creating new global tables, as it provides greater flexibility,
2488
+ # higher efficiency and consumes less write capacity than 2017.11.29
2489
+ # (Legacy). To determine which version you are using, see [Determining
2490
+ # the version][3]. To update existing global tables from version
2491
+ # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
2492
+ # global tables][4].
2464
2493
  #
2465
2494
  #
2466
2495
  #
2467
2496
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
2497
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
2498
+ # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
2499
+ # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
2468
2500
  #
2469
2501
  # @option params [required, String] :global_table_name
2470
2502
  # The name of the global table to describe.
@@ -2767,6 +2799,9 @@ module Aws::DynamoDB
2767
2799
  # the table, when it was created, the primary key schema, and any
2768
2800
  # indexes on the table.
2769
2801
  #
2802
+ # This operation only applies to [Version 2019.11.21 (Current)][1] of
2803
+ # global tables.
2804
+ #
2770
2805
  # <note markdown="1"> If you issue a `DescribeTable` request immediately after a
2771
2806
  # `CreateTable` request, DynamoDB might return a
2772
2807
  # `ResourceNotFoundException`. This is because `DescribeTable` uses an
@@ -2776,6 +2811,10 @@ module Aws::DynamoDB
2776
2811
  #
2777
2812
  # </note>
2778
2813
  #
2814
+ #
2815
+ #
2816
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
2817
+ #
2779
2818
  # @option params [required, String] :table_name
2780
2819
  # The name of the table to describe.
2781
2820
  #
@@ -2935,10 +2974,8 @@ module Aws::DynamoDB
2935
2974
  # Describes auto scaling settings across replicas of the global table at
2936
2975
  # once.
2937
2976
  #
2938
- # <note markdown="1"> This operation only applies to [Version 2019.11.21][1] of global
2939
- # tables.
2940
- #
2941
- # </note>
2977
+ # This operation only applies to [Version 2019.11.21 (Current)][1] of
2978
+ # global tables.
2942
2979
  #
2943
2980
  #
2944
2981
  #
@@ -3138,7 +3175,8 @@ module Aws::DynamoDB
3138
3175
  # number of items (if using the Limit parameter) or a maximum of 1 MB of
3139
3176
  # data (and then apply any filtering to the results using `WHERE`
3140
3177
  # clause). If `LastEvaluatedKey` is present in the response, you need to
3141
- # paginate the result set.
3178
+ # paginate the result set. If `NextToken` is present, you need to
3179
+ # paginate the result set and include `NextToken`.
3142
3180
  #
3143
3181
  # @option params [required, String] :statement
3144
3182
  # The PartiQL statement representing the operation to run.
@@ -3956,14 +3994,21 @@ module Aws::DynamoDB
3956
3994
 
3957
3995
  # Lists all global tables that have a replica in the specified Region.
3958
3996
  #
3959
- # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
3960
- # tables.
3961
- #
3962
- # </note>
3997
+ # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
3998
+ # global tables. We recommend using [Version 2019.11.21 (Current)][2]
3999
+ # when creating new global tables, as it provides greater flexibility,
4000
+ # higher efficiency and consumes less write capacity than 2017.11.29
4001
+ # (Legacy). To determine which version you are using, see [Determining
4002
+ # the version][3]. To update existing global tables from version
4003
+ # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
4004
+ # global tables][4].
3963
4005
  #
3964
4006
  #
3965
4007
  #
3966
4008
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
4009
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
4010
+ # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
4011
+ # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
3967
4012
  #
3968
4013
  # @option params [String] :exclusive_start_global_table_name
3969
4014
  # The first global table name that this operation will evaluate.
@@ -4582,7 +4627,9 @@ module Aws::DynamoDB
4582
4627
  # is equivalent to specifying `ALL_ATTRIBUTES`.
4583
4628
  #
4584
4629
  # * `COUNT` - Returns the number of matching items, rather than the
4585
- # matching items themselves.
4630
+ # matching items themselves. Note that this uses the same quantity of
4631
+ # read capacity units as getting the items, and is subject to the same
4632
+ # item size calculations.
4586
4633
  #
4587
4634
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
4588
4635
  # `ProjectionExpression`. This return value is equivalent to
@@ -5536,7 +5583,9 @@ module Aws::DynamoDB
5536
5583
  # is equivalent to specifying `ALL_ATTRIBUTES`.
5537
5584
  #
5538
5585
  # * `COUNT` - Returns the number of matching items, rather than the
5539
- # matching items themselves.
5586
+ # matching items themselves. Note that this uses the same quantity of
5587
+ # read capacity units as getting the items, and is subject to the same
5588
+ # item size calculations.
5540
5589
  #
5541
5590
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
5542
5591
  # `ProjectionExpression`. This return value is equivalent to
@@ -5952,8 +6001,7 @@ module Aws::DynamoDB
5952
6001
  #
5953
6002
  # * There is a user error, such as an invalid data format.
5954
6003
  #
5955
- # * The aggregate size of the items in the transaction cannot exceed 4
5956
- # MB.
6004
+ # * The aggregate size of the items in the transaction exceeded 4 MB.
5957
6005
  #
5958
6006
  # @option params [required, Array<Types::TransactGetItem>] :transact_items
5959
6007
  # An ordered array of up to 100 `TransactGetItem` objects, each of which
@@ -6115,7 +6163,7 @@ module Aws::DynamoDB
6115
6163
  #
6116
6164
  # Although multiple identical calls using the same client request token
6117
6165
  # produce the same result on the server (no side effects), the responses
6118
- # to the calls might not be the same. If the `ReturnConsumedCapacity>`
6166
+ # to the calls might not be the same. If the `ReturnConsumedCapacity`
6119
6167
  # parameter is set, then the initial `TransactWriteItems` call returns
6120
6168
  # the amount of write capacity units consumed in making the changes.
6121
6169
  # Subsequent `TransactWriteItems` calls with the same client token
@@ -6381,7 +6429,20 @@ module Aws::DynamoDB
6381
6429
  # have the same key schema, have DynamoDB Streams enabled, and have the
6382
6430
  # same provisioned and maximum write capacity units.
6383
6431
  #
6384
- # <note markdown="1"> Although you can use `UpdateGlobalTable` to add replicas and remove
6432
+ # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
6433
+ # global tables. We recommend using [Version 2019.11.21 (Current)][2]
6434
+ # when creating new global tables, as it provides greater flexibility,
6435
+ # higher efficiency and consumes less write capacity than 2017.11.29
6436
+ # (Legacy). To determine which version you are using, see [Determining
6437
+ # the version][3]. To update existing global tables from version
6438
+ # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
6439
+ # global tables][4].
6440
+ #
6441
+ # <note markdown="1"> This operation only applies to [Version 2017.11.29][1] of global
6442
+ # tables. If you are using global tables [Version 2019.11.21][2] you can
6443
+ # use [DescribeTable][5] instead.
6444
+ #
6445
+ # Although you can use `UpdateGlobalTable` to add replicas and remove
6385
6446
  # replicas in a single request, for simplicity we recommend that you
6386
6447
  # issue separate requests for adding or removing replicas.
6387
6448
  #
@@ -6398,6 +6459,14 @@ module Aws::DynamoDB
6398
6459
  # * The global secondary indexes must have the same provisioned and
6399
6460
  # maximum write capacity units.
6400
6461
  #
6462
+ #
6463
+ #
6464
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
6465
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
6466
+ # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
6467
+ # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
6468
+ # [5]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html
6469
+ #
6401
6470
  # @option params [required, String] :global_table_name
6402
6471
  # The global table name.
6403
6472
  #
@@ -6456,6 +6525,22 @@ module Aws::DynamoDB
6456
6525
 
6457
6526
  # Updates settings for a global table.
6458
6527
  #
6528
+ # This operation only applies to [Version 2017.11.29 (Legacy)][1] of
6529
+ # global tables. We recommend using [Version 2019.11.21 (Current)][2]
6530
+ # when creating new global tables, as it provides greater flexibility,
6531
+ # higher efficiency and consumes less write capacity than 2017.11.29
6532
+ # (Legacy). To determine which version you are using, see [Determining
6533
+ # the version][3]. To update existing global tables from version
6534
+ # 2017.11.29 (Legacy) to version 2019.11.21 (Current), see [ Updating
6535
+ # global tables][4].
6536
+ #
6537
+ #
6538
+ #
6539
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V1.html
6540
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
6541
+ # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.DetermineVersion.html
6542
+ # [4]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_upgrade.html
6543
+ #
6459
6544
  # @option params [required, String] :global_table_name
6460
6545
  # The name of the global table
6461
6546
  #
@@ -6703,8 +6788,8 @@ module Aws::DynamoDB
6703
6788
  #
6704
6789
  # @option params [String] :return_values
6705
6790
  # Use `ReturnValues` if you want to get the item attributes as they
6706
- # appear before or after they are updated. For `UpdateItem`, the valid
6707
- # values are:
6791
+ # appear before or after they are successfully updated. For
6792
+ # `UpdateItem`, the valid values are:
6708
6793
  #
6709
6794
  # * `NONE` - If `ReturnValues` is not specified, or if its value is
6710
6795
  # `NONE`, then nothing is returned. (This setting is the default for
@@ -7049,6 +7134,9 @@ module Aws::DynamoDB
7049
7134
  # Modifies the provisioned throughput settings, global secondary
7050
7135
  # indexes, or DynamoDB Streams settings for a given table.
7051
7136
  #
7137
+ # This operation only applies to [Version 2019.11.21 (Current)][1] of
7138
+ # global tables.
7139
+ #
7052
7140
  # You can only perform one of the following operations at once:
7053
7141
  #
7054
7142
  # * Modify the provisioned throughput settings of the table.
@@ -7065,6 +7153,10 @@ module Aws::DynamoDB
7065
7153
  # table returns to the `ACTIVE` state, the `UpdateTable` operation is
7066
7154
  # complete.
7067
7155
  #
7156
+ #
7157
+ #
7158
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
7159
+ #
7068
7160
  # @option params [Array<Types::AttributeDefinition>] :attribute_definitions
7069
7161
  # An array of attributes that describe the key schema for the table and
7070
7162
  # indexes. If you are adding a new global secondary index to the table,
@@ -7136,8 +7228,8 @@ module Aws::DynamoDB
7136
7228
  # A list of replica update actions (create, delete, or update) for the
7137
7229
  # table.
7138
7230
  #
7139
- # <note markdown="1"> This property only applies to [Version 2019.11.21][1] of global
7140
- # tables.
7231
+ # <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
7232
+ # global tables.
7141
7233
  #
7142
7234
  # </note>
7143
7235
  #
@@ -7394,10 +7486,8 @@ module Aws::DynamoDB
7394
7486
 
7395
7487
  # Updates auto scaling settings on your global tables at once.
7396
7488
  #
7397
- # <note markdown="1"> This operation only applies to [Version 2019.11.21][1] of global
7398
- # tables.
7399
- #
7400
- # </note>
7489
+ # This operation only applies to [Version 2019.11.21 (Current)][1] of
7490
+ # global tables.
7401
7491
  #
7402
7492
  #
7403
7493
  #
@@ -7648,7 +7738,7 @@ module Aws::DynamoDB
7648
7738
  params: params,
7649
7739
  config: config)
7650
7740
  context[:gem_name] = 'aws-sdk-dynamodb'
7651
- context[:gem_version] = '1.80.0'
7741
+ context[:gem_version] = '1.82.0'
7652
7742
  Seahorse::Client::Request.new(handlers, context)
7653
7743
  end
7654
7744
 
@@ -50,9 +50,6 @@ module Aws::DynamoDB
50
50
 
51
51
  def initialize(options = {})
52
52
  self[:region] = options[:region]
53
- if self[:region].nil?
54
- raise ArgumentError, "Missing required EndpointParameter: :region"
55
- end
56
53
  self[:use_dual_stack] = options[:use_dual_stack]
57
54
  self[:use_dual_stack] = false if self[:use_dual_stack].nil?
58
55
  if self[:use_dual_stack].nil?
@@ -9,114 +9,52 @@
9
9
 
10
10
  module Aws::DynamoDB
11
11
  class EndpointProvider
12
- def initialize(rule_set = nil)
13
- @@rule_set ||= begin
14
- endpoint_rules = Aws::Json.load(Base64.decode64(RULES))
15
- Aws::Endpoints::RuleSet.new(
16
- version: endpoint_rules['version'],
17
- service_id: endpoint_rules['serviceId'],
18
- parameters: endpoint_rules['parameters'],
19
- rules: endpoint_rules['rules']
20
- )
12
+ def resolve_endpoint(parameters)
13
+ region = parameters.region
14
+ use_dual_stack = parameters.use_dual_stack
15
+ use_fips = parameters.use_fips
16
+ endpoint = parameters.endpoint
17
+ if Aws::Endpoints::Matchers.set?(endpoint)
18
+ if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
19
+ raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
20
+ end
21
+ if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
22
+ raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
23
+ end
24
+ return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
21
25
  end
22
- @provider = Aws::Endpoints::RulesProvider.new(rule_set || @@rule_set)
23
- end
26
+ if Aws::Endpoints::Matchers.set?(region)
27
+ if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
28
+ if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
29
+ 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"))
30
+ return Aws::Endpoints::Endpoint.new(url: "https://dynamodb-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
31
+ end
32
+ raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
33
+ end
34
+ if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
35
+ if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
36
+ if Aws::Endpoints::Matchers.string_equals?("aws-us-gov", Aws::Endpoints::Matchers.attr(partition_result, "name"))
37
+ return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.amazonaws.com", headers: {}, properties: {})
38
+ end
39
+ return Aws::Endpoints::Endpoint.new(url: "https://dynamodb-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
40
+ end
41
+ raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
42
+ end
43
+ if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
44
+ if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
45
+ return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
46
+ end
47
+ raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
48
+ end
49
+ if Aws::Endpoints::Matchers.string_equals?(region, "local")
50
+ return Aws::Endpoints::Endpoint.new(url: "http://localhost:8000", headers: {}, properties: {"authSchemes"=>[{"name"=>"sigv4", "signingName"=>"dynamodb", "signingRegion"=>"us-east-1"}]})
51
+ end
52
+ return Aws::Endpoints::Endpoint.new(url: "https://dynamodb.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
53
+ end
54
+ end
55
+ raise ArgumentError, "Invalid Configuration: Missing Region"
56
+ raise ArgumentError, 'No endpoint could be resolved'
24
57
 
25
- def resolve_endpoint(parameters)
26
- @provider.resolve_endpoint(parameters)
27
58
  end
28
-
29
- # @api private
30
- RULES = <<-JSON
31
- eyJ2ZXJzaW9uIjoiMS4wIiwicGFyYW1ldGVycyI6eyJSZWdpb24iOnsiYnVp
32
- bHRJbiI6IkFXUzo6UmVnaW9uIiwicmVxdWlyZWQiOnRydWUsImRvY3VtZW50
33
- YXRpb24iOiJUaGUgQVdTIHJlZ2lvbiB1c2VkIHRvIGRpc3BhdGNoIHRoZSBy
34
- ZXF1ZXN0LiIsInR5cGUiOiJTdHJpbmcifSwiVXNlRHVhbFN0YWNrIjp7ImJ1
35
- aWx0SW4iOiJBV1M6OlVzZUR1YWxTdGFjayIsInJlcXVpcmVkIjp0cnVlLCJk
36
- ZWZhdWx0IjpmYWxzZSwiZG9jdW1lbnRhdGlvbiI6IldoZW4gdHJ1ZSwgdXNl
37
- IHRoZSBkdWFsLXN0YWNrIGVuZHBvaW50LiBJZiB0aGUgY29uZmlndXJlZCBl
38
- bmRwb2ludCBkb2VzIG5vdCBzdXBwb3J0IGR1YWwtc3RhY2ssIGRpc3BhdGNo
39
- aW5nIHRoZSByZXF1ZXN0IE1BWSByZXR1cm4gYW4gZXJyb3IuIiwidHlwZSI6
40
- IkJvb2xlYW4ifSwiVXNlRklQUyI6eyJidWlsdEluIjoiQVdTOjpVc2VGSVBT
41
- IiwicmVxdWlyZWQiOnRydWUsImRlZmF1bHQiOmZhbHNlLCJkb2N1bWVudGF0
42
- aW9uIjoiV2hlbiB0cnVlLCBzZW5kIHRoaXMgcmVxdWVzdCB0byB0aGUgRklQ
43
- Uy1jb21wbGlhbnQgcmVnaW9uYWwgZW5kcG9pbnQuIElmIHRoZSBjb25maWd1
44
- cmVkIGVuZHBvaW50IGRvZXMgbm90IGhhdmUgYSBGSVBTIGNvbXBsaWFudCBl
45
- bmRwb2ludCwgZGlzcGF0Y2hpbmcgdGhlIHJlcXVlc3Qgd2lsbCByZXR1cm4g
46
- YW4gZXJyb3IuIiwidHlwZSI6IkJvb2xlYW4ifSwiRW5kcG9pbnQiOnsiYnVp
47
- bHRJbiI6IlNESzo6RW5kcG9pbnQiLCJyZXF1aXJlZCI6ZmFsc2UsImRvY3Vt
48
- ZW50YXRpb24iOiJPdmVycmlkZSB0aGUgZW5kcG9pbnQgdXNlZCB0byBzZW5k
49
- IHRoaXMgcmVxdWVzdCIsInR5cGUiOiJTdHJpbmcifX0sInJ1bGVzIjpbeyJj
50
- b25kaXRpb25zIjpbeyJmbiI6ImF3cy5wYXJ0aXRpb24iLCJhcmd2IjpbeyJy
51
- ZWYiOiJSZWdpb24ifV0sImFzc2lnbiI6IlBhcnRpdGlvblJlc3VsdCJ9XSwi
52
- dHlwZSI6InRyZWUiLCJydWxlcyI6W3siY29uZGl0aW9ucyI6W3siZm4iOiJp
53
- c1NldCIsImFyZ3YiOlt7InJlZiI6IkVuZHBvaW50In1dfV0sInR5cGUiOiJ0
54
- cmVlIiwicnVsZXMiOlt7ImNvbmRpdGlvbnMiOlt7ImZuIjoiYm9vbGVhbkVx
55
- dWFscyIsImFyZ3YiOlt7InJlZiI6IlVzZUZJUFMifSx0cnVlXX1dLCJlcnJv
56
- ciI6IkludmFsaWQgQ29uZmlndXJhdGlvbjogRklQUyBhbmQgY3VzdG9tIGVu
57
- ZHBvaW50IGFyZSBub3Qgc3VwcG9ydGVkIiwidHlwZSI6ImVycm9yIn0seyJj
58
- b25kaXRpb25zIjpbXSwidHlwZSI6InRyZWUiLCJydWxlcyI6W3siY29uZGl0
59
- aW9ucyI6W3siZm4iOiJib29sZWFuRXF1YWxzIiwiYXJndiI6W3sicmVmIjoi
60
- VXNlRHVhbFN0YWNrIn0sdHJ1ZV19XSwiZXJyb3IiOiJJbnZhbGlkIENvbmZp
61
- Z3VyYXRpb246IER1YWxzdGFjayBhbmQgY3VzdG9tIGVuZHBvaW50IGFyZSBu
62
- b3Qgc3VwcG9ydGVkIiwidHlwZSI6ImVycm9yIn0seyJjb25kaXRpb25zIjpb
63
- XSwiZW5kcG9pbnQiOnsidXJsIjp7InJlZiI6IkVuZHBvaW50In0sInByb3Bl
64
- cnRpZXMiOnt9LCJoZWFkZXJzIjp7fX0sInR5cGUiOiJlbmRwb2ludCJ9XX1d
65
- fSx7ImNvbmRpdGlvbnMiOlt7ImZuIjoiYm9vbGVhbkVxdWFscyIsImFyZ3Yi
66
- Olt7InJlZiI6IlVzZUZJUFMifSx0cnVlXX0seyJmbiI6ImJvb2xlYW5FcXVh
67
- bHMiLCJhcmd2IjpbeyJyZWYiOiJVc2VEdWFsU3RhY2sifSx0cnVlXX1dLCJ0
68
- eXBlIjoidHJlZSIsInJ1bGVzIjpbeyJjb25kaXRpb25zIjpbeyJmbiI6ImJv
69
- b2xlYW5FcXVhbHMiLCJhcmd2IjpbdHJ1ZSx7ImZuIjoiZ2V0QXR0ciIsImFy
70
- Z3YiOlt7InJlZiI6IlBhcnRpdGlvblJlc3VsdCJ9LCJzdXBwb3J0c0ZJUFMi
71
- XX1dfSx7ImZuIjoiYm9vbGVhbkVxdWFscyIsImFyZ3YiOlt0cnVlLHsiZm4i
72
- OiJnZXRBdHRyIiwiYXJndiI6W3sicmVmIjoiUGFydGl0aW9uUmVzdWx0In0s
73
- InN1cHBvcnRzRHVhbFN0YWNrIl19XX1dLCJ0eXBlIjoidHJlZSIsInJ1bGVz
74
- IjpbeyJjb25kaXRpb25zIjpbXSwiZW5kcG9pbnQiOnsidXJsIjoiaHR0cHM6
75
- Ly9keW5hbW9kYi1maXBzLntSZWdpb259LntQYXJ0aXRpb25SZXN1bHQjZHVh
76
- bFN0YWNrRG5zU3VmZml4fSIsInByb3BlcnRpZXMiOnt9LCJoZWFkZXJzIjp7
77
- fX0sInR5cGUiOiJlbmRwb2ludCJ9XX0seyJjb25kaXRpb25zIjpbXSwiZXJy
78
- b3IiOiJGSVBTIGFuZCBEdWFsU3RhY2sgYXJlIGVuYWJsZWQsIGJ1dCB0aGlz
79
- IHBhcnRpdGlvbiBkb2VzIG5vdCBzdXBwb3J0IG9uZSBvciBib3RoIiwidHlw
80
- ZSI6ImVycm9yIn1dfSx7ImNvbmRpdGlvbnMiOlt7ImZuIjoiYm9vbGVhbkVx
81
- dWFscyIsImFyZ3YiOlt7InJlZiI6IlVzZUZJUFMifSx0cnVlXX1dLCJ0eXBl
82
- IjoidHJlZSIsInJ1bGVzIjpbeyJjb25kaXRpb25zIjpbeyJmbiI6ImJvb2xl
83
- YW5FcXVhbHMiLCJhcmd2IjpbdHJ1ZSx7ImZuIjoiZ2V0QXR0ciIsImFyZ3Yi
84
- Olt7InJlZiI6IlBhcnRpdGlvblJlc3VsdCJ9LCJzdXBwb3J0c0ZJUFMiXX1d
85
- fV0sInR5cGUiOiJ0cmVlIiwicnVsZXMiOlt7ImNvbmRpdGlvbnMiOltdLCJ0
86
- eXBlIjoidHJlZSIsInJ1bGVzIjpbeyJjb25kaXRpb25zIjpbeyJmbiI6InN0
87
- cmluZ0VxdWFscyIsImFyZ3YiOlsiYXdzLXVzLWdvdiIseyJmbiI6ImdldEF0
88
- dHIiLCJhcmd2IjpbeyJyZWYiOiJQYXJ0aXRpb25SZXN1bHQifSwibmFtZSJd
89
- fV19XSwiZW5kcG9pbnQiOnsidXJsIjoiaHR0cHM6Ly9keW5hbW9kYi57UmVn
90
- aW9ufS57UGFydGl0aW9uUmVzdWx0I2Ruc1N1ZmZpeH0iLCJwcm9wZXJ0aWVz
91
- Ijp7fSwiaGVhZGVycyI6e319LCJ0eXBlIjoiZW5kcG9pbnQifSx7ImNvbmRp
92
- dGlvbnMiOltdLCJlbmRwb2ludCI6eyJ1cmwiOiJodHRwczovL2R5bmFtb2Ri
93
- LWZpcHMue1JlZ2lvbn0ue1BhcnRpdGlvblJlc3VsdCNkbnNTdWZmaXh9Iiwi
94
- cHJvcGVydGllcyI6e30sImhlYWRlcnMiOnt9fSwidHlwZSI6ImVuZHBvaW50
95
- In1dfV19LHsiY29uZGl0aW9ucyI6W10sImVycm9yIjoiRklQUyBpcyBlbmFi
96
- bGVkIGJ1dCB0aGlzIHBhcnRpdGlvbiBkb2VzIG5vdCBzdXBwb3J0IEZJUFMi
97
- LCJ0eXBlIjoiZXJyb3IifV19LHsiY29uZGl0aW9ucyI6W3siZm4iOiJib29s
98
- ZWFuRXF1YWxzIiwiYXJndiI6W3sicmVmIjoiVXNlRHVhbFN0YWNrIn0sdHJ1
99
- ZV19XSwidHlwZSI6InRyZWUiLCJydWxlcyI6W3siY29uZGl0aW9ucyI6W3si
100
- Zm4iOiJib29sZWFuRXF1YWxzIiwiYXJndiI6W3RydWUseyJmbiI6ImdldEF0
101
- dHIiLCJhcmd2IjpbeyJyZWYiOiJQYXJ0aXRpb25SZXN1bHQifSwic3VwcG9y
102
- dHNEdWFsU3RhY2siXX1dfV0sInR5cGUiOiJ0cmVlIiwicnVsZXMiOlt7ImNv
103
- bmRpdGlvbnMiOltdLCJlbmRwb2ludCI6eyJ1cmwiOiJodHRwczovL2R5bmFt
104
- b2RiLntSZWdpb259LntQYXJ0aXRpb25SZXN1bHQjZHVhbFN0YWNrRG5zU3Vm
105
- Zml4fSIsInByb3BlcnRpZXMiOnt9LCJoZWFkZXJzIjp7fX0sInR5cGUiOiJl
106
- bmRwb2ludCJ9XX0seyJjb25kaXRpb25zIjpbXSwiZXJyb3IiOiJEdWFsU3Rh
107
- Y2sgaXMgZW5hYmxlZCBidXQgdGhpcyBwYXJ0aXRpb24gZG9lcyBub3Qgc3Vw
108
- cG9ydCBEdWFsU3RhY2siLCJ0eXBlIjoiZXJyb3IifV19LHsiY29uZGl0aW9u
109
- cyI6W10sInR5cGUiOiJ0cmVlIiwicnVsZXMiOlt7ImNvbmRpdGlvbnMiOlt7
110
- ImZuIjoic3RyaW5nRXF1YWxzIiwiYXJndiI6W3sicmVmIjoiUmVnaW9uIn0s
111
- ImxvY2FsIl19XSwiZW5kcG9pbnQiOnsidXJsIjoiaHR0cDovL2xvY2FsaG9z
112
- dDo4MDAwIiwicHJvcGVydGllcyI6eyJhdXRoU2NoZW1lcyI6W3sibmFtZSI6
113
- InNpZ3Y0Iiwic2lnbmluZ1JlZ2lvbiI6InVzLWVhc3QtMSIsInNpZ25pbmdO
114
- YW1lIjoiZHluYW1vZGIifV19LCJoZWFkZXJzIjp7fX0sInR5cGUiOiJlbmRw
115
- b2ludCJ9LHsiY29uZGl0aW9ucyI6W10sImVuZHBvaW50Ijp7InVybCI6Imh0
116
- dHBzOi8vZHluYW1vZGIue1JlZ2lvbn0ue1BhcnRpdGlvblJlc3VsdCNkbnNT
117
- dWZmaXh9IiwicHJvcGVydGllcyI6e30sImhlYWRlcnMiOnt9fSwidHlwZSI6
118
- ImVuZHBvaW50In1dfV19XX0=
119
-
120
- JSON
121
59
  end
122
60
  end
@@ -539,7 +539,7 @@ module Aws::DynamoDB
539
539
  # A map of attribute names to `AttributeValue` objects, representing the
540
540
  # primary key of the item to delete.
541
541
  #
542
- # For the primary key, you must provide all of the attributes. For
542
+ # For the primary key, you must provide all of the key attributes. For
543
543
  # example, with a simple primary key, you only need to provide a value
544
544
  # for the partition key. For a composite primary key, you must provide
545
545
  # values for both the partition key and the sort key.
@@ -1103,7 +1103,9 @@ module Aws::DynamoDB
1103
1103
  # is equivalent to specifying `ALL_ATTRIBUTES`.
1104
1104
  #
1105
1105
  # * `COUNT` - Returns the number of matching items, rather than the
1106
- # matching items themselves.
1106
+ # matching items themselves. Note that this uses the same quantity of
1107
+ # read capacity units as getting the items, and is subject to the same
1108
+ # item size calculations.
1107
1109
  #
1108
1110
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
1109
1111
  # `ProjectionExpression`. This return value is equivalent to
@@ -1508,7 +1510,9 @@ module Aws::DynamoDB
1508
1510
  # is equivalent to specifying `ALL_ATTRIBUTES`.
1509
1511
  #
1510
1512
  # * `COUNT` - Returns the number of matching items, rather than the
1511
- # matching items themselves.
1513
+ # matching items themselves. Note that this uses the same quantity of
1514
+ # read capacity units as getting the items, and is subject to the same
1515
+ # item size calculations.
1512
1516
  #
1513
1517
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
1514
1518
  # `ProjectionExpression`. This return value is equivalent to
@@ -1902,8 +1906,8 @@ module Aws::DynamoDB
1902
1906
  # A list of replica update actions (create, delete, or update) for the
1903
1907
  # table.
1904
1908
  #
1905
- # <note markdown="1"> This property only applies to [Version 2019.11.21][1] of global
1906
- # tables.
1909
+ # <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
1910
+ # global tables.
1907
1911
  #
1908
1912
  # </note>
1909
1913
  #
@@ -1992,8 +1996,8 @@ module Aws::DynamoDB
1992
1996
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.ConditionalOperator.html
1993
1997
  # @option options [String] :return_values
1994
1998
  # Use `ReturnValues` if you want to get the item attributes as they
1995
- # appear before or after they are updated. For `UpdateItem`, the valid
1996
- # values are:
1999
+ # appear before or after they are successfully updated. For
2000
+ # `UpdateItem`, the valid values are:
1997
2001
  #
1998
2002
  # * `NONE` - If `ReturnValues` is not specified, or if its value is
1999
2003
  # `NONE`, then nothing is returned. (This setting is the default for
@@ -1462,16 +1462,32 @@ module Aws::DynamoDB
1462
1462
  #
1463
1463
  # @!attribute [rw] condition_expression
1464
1464
  # A condition that must be satisfied in order for a conditional update
1465
- # to succeed.
1465
+ # to succeed. For more information, see [Condition expressions][1] in
1466
+ # the *Amazon DynamoDB Developer Guide*.
1467
+ #
1468
+ #
1469
+ #
1470
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ConditionExpressions.html
1466
1471
  # @return [String]
1467
1472
  #
1468
1473
  # @!attribute [rw] expression_attribute_names
1469
1474
  # One or more substitution tokens for attribute names in an
1470
- # expression.
1475
+ # expression. For more information, see [Expression attribute
1476
+ # names][1] in the *Amazon DynamoDB Developer Guide*.
1477
+ #
1478
+ #
1479
+ #
1480
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeNames.html
1471
1481
  # @return [Hash<String,String>]
1472
1482
  #
1473
1483
  # @!attribute [rw] expression_attribute_values
1474
- # One or more values that can be substituted in an expression.
1484
+ # One or more values that can be substituted in an expression. For
1485
+ # more information, see [Condition expressions][1] in the *Amazon
1486
+ # DynamoDB Developer Guide*.
1487
+ #
1488
+ #
1489
+ #
1490
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ConditionExpressions.html
1475
1491
  # @return [Hash<String,Types::AttributeValue>]
1476
1492
  #
1477
1493
  # @!attribute [rw] return_values_on_condition_check_failure
@@ -2147,7 +2163,7 @@ module Aws::DynamoDB
2147
2163
  # A map of attribute names to `AttributeValue` objects, representing
2148
2164
  # the primary key of the item to delete.
2149
2165
  #
2150
- # For the primary key, you must provide all of the attributes. For
2166
+ # For the primary key, you must provide all of the key attributes. For
2151
2167
  # example, with a simple primary key, you only need to provide a value
2152
2168
  # for the partition key. For a composite primary key, you must provide
2153
2169
  # values for both the partition key and the sort key.
@@ -2359,7 +2375,7 @@ module Aws::DynamoDB
2359
2375
  # with statistics for the table and any indexes involved in the
2360
2376
  # operation. `ConsumedCapacity` is only returned if the
2361
2377
  # `ReturnConsumedCapacity` parameter was specified. For more
2362
- # information, see [Provisioned Mode][1] in the *Amazon DynamoDB
2378
+ # information, see [Provisioned Throughput][1] in the *Amazon DynamoDB
2363
2379
  # Developer Guide*.
2364
2380
  #
2365
2381
  #
@@ -3791,12 +3807,12 @@ module Aws::DynamoDB
3791
3807
  # with statistics for the table and any indexes involved in the
3792
3808
  # operation. `ConsumedCapacity` is only returned if the
3793
3809
  # `ReturnConsumedCapacity` parameter was specified. For more
3794
- # information, see [Read/Write Capacity Mode][1] in the *Amazon
3795
- # DynamoDB Developer Guide*.
3810
+ # information, see [Provisioned Throughput][1] in the *Amazon DynamoDB
3811
+ # Developer Guide*.
3796
3812
  #
3797
3813
  #
3798
3814
  #
3799
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
3815
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
3800
3816
  # @return [Types::ConsumedCapacity]
3801
3817
  #
3802
3818
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItemOutput AWS API Documentation
@@ -5920,8 +5936,8 @@ module Aws::DynamoDB
5920
5936
  # with statistics for the table and any indexes involved in the
5921
5937
  # operation. `ConsumedCapacity` is only returned if the
5922
5938
  # `ReturnConsumedCapacity` parameter was specified. For more
5923
- # information, see [Read/Write Capacity Mode][1] in the *Amazon
5924
- # DynamoDB Developer Guide*.
5939
+ # information, see [Provisioned Throughput][1] in the *Amazon DynamoDB
5940
+ # Developer Guide*.
5925
5941
  #
5926
5942
  #
5927
5943
  #
@@ -6013,7 +6029,9 @@ module Aws::DynamoDB
6013
6029
  # value is equivalent to specifying `ALL_ATTRIBUTES`.
6014
6030
  #
6015
6031
  # * `COUNT` - Returns the number of matching items, rather than the
6016
- # matching items themselves.
6032
+ # matching items themselves. Note that this uses the same quantity
6033
+ # of read capacity units as getting the items, and is subject to the
6034
+ # same item size calculations.
6017
6035
  #
6018
6036
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
6019
6037
  # `ProjectionExpression`. This return value is equivalent to
@@ -7423,7 +7441,9 @@ module Aws::DynamoDB
7423
7441
  # value is equivalent to specifying `ALL_ATTRIBUTES`.
7424
7442
  #
7425
7443
  # * `COUNT` - Returns the number of matching items, rather than the
7426
- # matching items themselves.
7444
+ # matching items themselves. Note that this uses the same quantity
7445
+ # of read capacity units as getting the items, and is subject to the
7446
+ # same item size calculations.
7427
7447
  #
7428
7448
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
7429
7449
  # `ProjectionExpression`. This return value is equivalent to
@@ -7763,7 +7783,7 @@ module Aws::DynamoDB
7763
7783
  #
7764
7784
  #
7765
7785
  #
7766
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
7786
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
7767
7787
  # @return [Types::ConsumedCapacity]
7768
7788
  #
7769
7789
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ScanOutput AWS API Documentation
@@ -8627,7 +8647,7 @@ module Aws::DynamoDB
8627
8647
  # Although multiple identical calls using the same client request
8628
8648
  # token produce the same result on the server (no side effects), the
8629
8649
  # responses to the calls might not be the same. If the
8630
- # `ReturnConsumedCapacity>` parameter is set, then the initial
8650
+ # `ReturnConsumedCapacity` parameter is set, then the initial
8631
8651
  # `TransactWriteItems` call returns the amount of write capacity units
8632
8652
  # consumed in making the changes. Subsequent `TransactWriteItems`
8633
8653
  # calls with the same client token return the number of read capacity
@@ -8798,7 +8818,7 @@ module Aws::DynamoDB
8798
8818
  # secondary indexes. DynamoDB is automatically scaling your index
8799
8819
  # so please try again shortly.
8800
8820
  #
8801
- # <note markdown="1"> This message is returned when when writes get throttled on an
8821
+ # <note markdown="1"> This message is returned when writes get throttled on an
8802
8822
  # On-Demand GSI as DynamoDB is automatically scaling the GSI.
8803
8823
  #
8804
8824
  # </note>
@@ -8866,6 +8886,54 @@ module Aws::DynamoDB
8866
8886
 
8867
8887
  # The transaction with the given request token is already in progress.
8868
8888
  #
8889
+ # Recommended Settings
8890
+ #
8891
+ # <note markdown="1"> This is a general recommendation for handling the
8892
+ # `TransactionInProgressException`. These settings help ensure that the
8893
+ # client retries will trigger completion of the ongoing
8894
+ # `TransactWriteItems` request.
8895
+ #
8896
+ # </note>
8897
+ #
8898
+ # * Set `clientExecutionTimeout` to a value that allows at least one
8899
+ # retry to be processed after 5 seconds have elapsed since the first
8900
+ # attempt for the `TransactWriteItems` operation.
8901
+ #
8902
+ # * Set `socketTimeout` to a value a little lower than the
8903
+ # `requestTimeout` setting.
8904
+ #
8905
+ # * `requestTimeout` should be set based on the time taken for the
8906
+ # individual retries of a single HTTP request for your use case, but
8907
+ # setting it to 1 second or higher should work well to reduce chances
8908
+ # of retries and `TransactionInProgressException` errors.
8909
+ #
8910
+ # * Use exponential backoff when retrying and tune backoff if needed.
8911
+ #
8912
+ # Assuming [default retry policy][1], example timeout settings based on
8913
+ # the guidelines above are as follows:
8914
+ #
8915
+ # Example timeline:
8916
+ #
8917
+ # * 0-1000 first attempt
8918
+ #
8919
+ # * 1000-1500 first sleep/delay (default retry policy uses 500 ms as
8920
+ # base delay for 4xx errors)
8921
+ #
8922
+ # * 1500-2500 second attempt
8923
+ #
8924
+ # * 2500-3500 second sleep/delay (500 * 2, exponential backoff)
8925
+ #
8926
+ # * 3500-4500 third attempt
8927
+ #
8928
+ # * 4500-6500 third sleep/delay (500 * 2^2)
8929
+ #
8930
+ # * 6500-7500 fourth attempt (this can trigger inline recovery since 5
8931
+ # seconds have elapsed since the first attempt reached TC)
8932
+ #
8933
+ #
8934
+ #
8935
+ # [1]: https://github.com/aws/aws-sdk-java/blob/fd409dee8ae23fb8953e0bb4dbde65536a7e0514/aws-java-sdk-core/src/main/java/com/amazonaws/retry/PredefinedRetryPolicies.java#L97
8936
+ #
8869
8937
  # @!attribute [rw] message
8870
8938
  # @return [String]
8871
8939
  #
@@ -9201,8 +9269,8 @@ module Aws::DynamoDB
9201
9269
  #
9202
9270
  # @!attribute [rw] return_values
9203
9271
  # Use `ReturnValues` if you want to get the item attributes as they
9204
- # appear before or after they are updated. For `UpdateItem`, the valid
9205
- # values are:
9272
+ # appear before or after they are successfully updated. For
9273
+ # `UpdateItem`, the valid values are:
9206
9274
  #
9207
9275
  # * `NONE` - If `ReturnValues` is not specified, or if its value is
9208
9276
  # `NONE`, then nothing is returned. (This setting is the default for
@@ -9480,9 +9548,9 @@ module Aws::DynamoDB
9480
9548
  # `UpdateItem` operation, as determined by the `ReturnValues`
9481
9549
  # parameter.
9482
9550
  #
9483
- # The `Attributes` map is only present if `ReturnValues` was specified
9484
- # as something other than `NONE` in the request. Each element
9485
- # represents one attribute.
9551
+ # The `Attributes` map is only present if the update was successful
9552
+ # and `ReturnValues` was specified as something other than `NONE` in
9553
+ # the request. Each element represents one attribute.
9486
9554
  # @return [Hash<String,Types::AttributeValue>]
9487
9555
  #
9488
9556
  # @!attribute [rw] consumed_capacity
@@ -9496,7 +9564,7 @@ module Aws::DynamoDB
9496
9564
  #
9497
9565
  #
9498
9566
  #
9499
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
9567
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughput.html#ItemSizeCalculations.Reads
9500
9568
  # @return [Types::ConsumedCapacity]
9501
9569
  #
9502
9570
  # @!attribute [rw] item_collection_metrics
@@ -9654,8 +9722,8 @@ module Aws::DynamoDB
9654
9722
  # A list of replica update actions (create, delete, or update) for the
9655
9723
  # table.
9656
9724
  #
9657
- # <note markdown="1"> This property only applies to [Version 2019.11.21][1] of global
9658
- # tables.
9725
+ # <note markdown="1"> This property only applies to [Version 2019.11.21 (Current)][1] of
9726
+ # global tables.
9659
9727
  #
9660
9728
  # </note>
9661
9729
  #
@@ -54,6 +54,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
54
54
  # @!group service
55
55
  module Aws::DynamoDB
56
56
 
57
- GEM_VERSION = '1.80.0'
57
+ GEM_VERSION = '1.82.0'
58
58
 
59
59
  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.80.0
4
+ version: 1.82.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-12-06 00:00:00.000000000 Z
11
+ date: 2023-03-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core