aws-sdk-dynamodb 1.31.0 → 1.32.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
  SHA1:
3
- metadata.gz: f4fac22ac79cd0a8596d4af469bc4f1015c519a9
4
- data.tar.gz: 2f47456e7aa9f70953b260493d817c1989497d3b
3
+ metadata.gz: 61cbdbb5bc557e1e80e5a5e34a65e38395955eec
4
+ data.tar.gz: 93ada26c17a588130d252ee0d98bb36d2e4dd338
5
5
  SHA512:
6
- metadata.gz: e5810f991a6075f05df5fd03727ba7fea284940ce6f34911a2c7116862e6c06c629507de56dfc0ddb45b5754ce665c83b4daf5061e18a8db06f5be9884f4236e
7
- data.tar.gz: f6f8f9bce1511f00efb73463f675ac269c8829583f9b4c7868d4216f30cf4495a569d9dd654e52e6a75edabacccb374ad30dc0d30901fdfb676325b2617a02ad
6
+ metadata.gz: 5edcbc09d5c64acf9bf126e46dcd905f5ead84bee4609d8723b8f7a1b565999904054ac61f674e8852c70aff8f0e7e0304f09e6d3b680f2e1276c8880771e7f2
7
+ data.tar.gz: b9cfba229a07a2a628d0eb43a32390134bd887a7ba9cb7fb8f82949f84981e8412fce0edb019658c237bc96929dd6c423e919386ae8b1e6978655d9ae4defe46
@@ -44,6 +44,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
44
44
  # @service
45
45
  module Aws::DynamoDB
46
46
 
47
- GEM_VERSION = '1.31.0'
47
+ GEM_VERSION = '1.32.0'
48
48
 
49
49
  end
@@ -296,28 +296,28 @@ module Aws::DynamoDB
296
296
  # key.
297
297
  #
298
298
  # A single operation can retrieve up to 16 MB of data, which can contain
299
- # as many as 100 items. `BatchGetItem` will return a partial result if
300
- # the response size limit is exceeded, the table's provisioned
301
- # throughput is exceeded, or an internal processing failure occurs. If a
302
- # partial result is returned, the operation returns a value for
299
+ # as many as 100 items. `BatchGetItem` returns a partial result if the
300
+ # response size limit is exceeded, the table's provisioned throughput
301
+ # is exceeded, or an internal processing failure occurs. If a partial
302
+ # result is returned, the operation returns a value for
303
303
  # `UnprocessedKeys`. You can use this value to retry the operation
304
304
  # starting with the next item to get.
305
305
  #
306
- # If you request more than 100 items `BatchGetItem` will return a
306
+ # If you request more than 100 items, `BatchGetItem` returns a
307
307
  # `ValidationException` with the message "Too many items requested for
308
- # the BatchGetItem call".
308
+ # the BatchGetItem call."
309
309
  #
310
310
  # For example, if you ask to retrieve 100 items, but each individual
311
311
  # item is 300 KB in size, the system returns 52 items (so as not to
312
312
  # exceed the 16 MB limit). It also returns an appropriate
313
313
  # `UnprocessedKeys` value so you can get the next page of results. If
314
314
  # desired, your application can include its own logic to assemble the
315
- # pages of results into one data set.
315
+ # pages of results into one dataset.
316
316
  #
317
317
  # If *none* of the items can be processed due to insufficient
318
318
  # provisioned throughput on all of the tables in the request, then
319
- # `BatchGetItem` will return a `ProvisionedThroughputExceededException`.
320
- # If *at least one* of the items is successfully processed, then
319
+ # `BatchGetItem` returns a `ProvisionedThroughputExceededException`. If
320
+ # *at least one* of the items is successfully processed, then
321
321
  # `BatchGetItem` completes successfully, while returning the keys of the
322
322
  # unread items in `UnprocessedKeys`.
323
323
  #
@@ -346,8 +346,8 @@ module Aws::DynamoDB
346
346
  #
347
347
  # If a requested item does not exist, it is not returned in the result.
348
348
  # Requests for nonexistent items consume the minimum read capacity units
349
- # according to the type of read. For more information, see [Capacity
350
- # Units Calculations][2] in the *Amazon DynamoDB Developer Guide*.
349
+ # according to the type of read. For more information, see [Working with
350
+ # Tables][2] in the *Amazon DynamoDB Developer Guide*.
351
351
  #
352
352
  #
353
353
  #
@@ -408,8 +408,9 @@ module Aws::DynamoDB
408
408
  #
409
409
  # </note>
410
410
  #
411
- # For more information on expression attribute names, see [Accessing
412
- # Item Attributes][2] in the *Amazon DynamoDB Developer Guide*.
411
+ # For more information about expression attribute names, see
412
+ # [Accessing Item Attributes][2] in the *Amazon DynamoDB Developer
413
+ # Guide*.
413
414
  #
414
415
  # * `Keys` - An array of primary key attribute values that define
415
416
  # specific items in the table. For each primary key, you must provide
@@ -423,9 +424,9 @@ module Aws::DynamoDB
423
424
  # scalars, sets, or elements of a JSON document. The attributes in the
424
425
  # expression must be separated by commas.
425
426
  #
426
- # If no attribute names are specified, then all attributes will be
427
- # returned. If any of the requested attributes are not found, they
428
- # will not appear in the result.
427
+ # If no attribute names are specified, then all attributes are
428
+ # returned. If any of the requested attributes are not found, they do
429
+ # not appear in the result.
429
430
  #
430
431
  # For more information, see [Accessing Item Attributes][2] in the
431
432
  # *Amazon DynamoDB Developer Guide*.
@@ -592,10 +593,9 @@ module Aws::DynamoDB
592
593
  # request with those unprocessed items until all items have been
593
594
  # processed.
594
595
  #
595
- # Note that if *none* of the items can be processed due to insufficient
596
+ # If *none* of the items can be processed due to insufficient
596
597
  # provisioned throughput on all of the tables in the request, then
597
- # `BatchWriteItem` will return a
598
- # `ProvisionedThroughputExceededException`.
598
+ # `BatchWriteItem` returns a `ProvisionedThroughputExceededException`.
599
599
  #
600
600
  # If DynamoDB returns any unprocessed items, you should retry the batch
601
601
  # operation on those items. However, *we strongly recommend that you use
@@ -609,13 +609,12 @@ module Aws::DynamoDB
609
609
  # the *Amazon DynamoDB Developer Guide*.
610
610
  #
611
611
  # With `BatchWriteItem`, you can efficiently write or delete large
612
- # amounts of data, such as from Amazon Elastic MapReduce (EMR), or copy
613
- # data from another database into DynamoDB. In order to improve
614
- # performance with these large-scale operations, `BatchWriteItem` does
615
- # not behave in the same way as individual `PutItem` and `DeleteItem`
616
- # calls would. For example, you cannot specify conditions on individual
617
- # put and delete requests, and `BatchWriteItem` does not return deleted
618
- # items in the response.
612
+ # amounts of data, such as from Amazon EMR, or copy data from another
613
+ # database into DynamoDB. In order to improve performance with these
614
+ # large-scale operations, `BatchWriteItem` does not behave in the same
615
+ # way as individual `PutItem` and `DeleteItem` calls would. For example,
616
+ # you cannot specify conditions on individual put and delete requests,
617
+ # and `BatchWriteItem` does not return deleted items in the response.
619
618
  #
620
619
  # If you use a programming language that supports concurrency, you can
621
620
  # use threads to write items in parallel. Your application must include
@@ -655,7 +654,7 @@ module Aws::DynamoDB
655
654
  #
656
655
  #
657
656
  #
658
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#BatchOperations
657
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#Programming.Errors.BatchOperations
659
658
  #
660
659
  # @option params [required, Hash<String,Array>] :request_items
661
660
  # A map of one or more table names and, for each table, a list of
@@ -683,7 +682,7 @@ module Aws::DynamoDB
683
682
  # Attribute values must not be null; string and binary type
684
683
  # attributes must have lengths greater than zero; and set type
685
684
  # attributes must not be empty. Requests that contain empty values
686
- # will be rejected with a `ValidationException` exception.
685
+ # are rejected with a `ValidationException` exception.
687
686
  #
688
687
  # If you specify any attributes that are part of an index key, then
689
688
  # the data types for those attributes must match those of the schema
@@ -826,11 +825,11 @@ module Aws::DynamoDB
826
825
 
827
826
  # Creates a backup for an existing table.
828
827
  #
829
- # Each time you create an On-Demand Backup, the entire table data is
828
+ # Each time you create an on-demand backup, the entire table data is
830
829
  # backed up. There is no limit to the number of on-demand backups that
831
830
  # can be taken.
832
831
  #
833
- # When you create an On-Demand Backup, a time marker of the request is
832
+ # When you create an on-demand backup, a time marker of the request is
834
833
  # cataloged, and the backup is created asynchronously, by applying all
835
834
  # changes until the time of the request to the last full table snapshot.
836
835
  # Backup requests are processed instantaneously and become available for
@@ -844,8 +843,8 @@ module Aws::DynamoDB
844
843
  # If you submit a backup request on 2018-12-14 at 14:25:00, the backup
845
844
  # is guaranteed to contain all data committed to the table up to
846
845
  # 14:24:00, and data committed after 14:26:00 will not be. The backup
847
- # may or may not contain data modifications made between 14:24:00 and
848
- # 14:26:00. On-Demand Backup does not support causal consistency.
846
+ # might contain data modifications made between 14:24:00 and 14:26:00.
847
+ # On-demand backup does not support causal consistency.
849
848
  #
850
849
  # Along with data, the following are also included on the backups:
851
850
  #
@@ -895,7 +894,7 @@ module Aws::DynamoDB
895
894
 
896
895
  # Creates a global table from an existing table. A global table creates
897
896
  # a replication relationship between two or more DynamoDB tables with
898
- # the same table name in the provided regions.
897
+ # the same table name in the provided Regions.
899
898
  #
900
899
  # If you want to add a new replica table to a global table, each of the
901
900
  # following conditions must be true:
@@ -932,7 +931,7 @@ module Aws::DynamoDB
932
931
  # The global table name.
933
932
  #
934
933
  # @option params [required, Array<Types::Replica>] :replication_group
935
- # The regions where the global table needs to be created.
934
+ # The Regions where the global table needs to be created.
936
935
  #
937
936
  # @return [Types::CreateGlobalTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
938
937
  #
@@ -968,9 +967,9 @@ module Aws::DynamoDB
968
967
  end
969
968
 
970
969
  # The `CreateTable` operation adds a new table to your account. In an
971
- # AWS account, table names must be unique within each region. That is,
970
+ # AWS account, table names must be unique within each Region. That is,
972
971
  # you can have two tables with same name if you create the tables in
973
- # different regions.
972
+ # different Regions.
974
973
  #
975
974
  # `CreateTable` is an asynchronous operation. Upon receiving a
976
975
  # `CreateTable` request, DynamoDB immediately returns a response with a
@@ -1010,7 +1009,7 @@ module Aws::DynamoDB
1010
1009
  # * `RANGE` - sort key
1011
1010
  #
1012
1011
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
1013
- # The term "hash attribute" derives from DynamoDB' usage of an
1012
+ # The term "hash attribute" derives from the DynamoDB usage of an
1014
1013
  # internal hash function to evenly distribute data items across
1015
1014
  # partitions, based on their partition key values.
1016
1015
  #
@@ -1029,8 +1028,8 @@ module Aws::DynamoDB
1029
1028
  # have a `KeyType` of `HASH`, and the second element must have a
1030
1029
  # `KeyType` of `RANGE`.
1031
1030
  #
1032
- # For more information, see [Specifying the Primary Key][2] in the
1033
- # *Amazon DynamoDB Developer Guide*.
1031
+ # For more information, see [Working with Tables][2] in the *Amazon
1032
+ # DynamoDB Developer Guide*.
1034
1033
  #
1035
1034
  #
1036
1035
  #
@@ -1065,7 +1064,7 @@ module Aws::DynamoDB
1065
1064
  # the index.
1066
1065
  #
1067
1066
  # * `INCLUDE` - Only the specified table attributes are projected
1068
- # into the index. The list of projected attributes are in
1067
+ # into the index. The list of projected attributes is in
1069
1068
  # `NonKeyAttributes`.
1070
1069
  #
1071
1070
  # * `ALL` - All of the table attributes are projected into the
@@ -1102,7 +1101,7 @@ module Aws::DynamoDB
1102
1101
  # the index.
1103
1102
  #
1104
1103
  # * `INCLUDE` - Only the specified table attributes are projected
1105
- # into the index. The list of projected attributes are in
1104
+ # into the index. The list of projected attributes is in
1106
1105
  # `NonKeyAttributes`.
1107
1106
  #
1108
1107
  # * `ALL` - All of the table attributes are projected into the
@@ -1149,8 +1148,8 @@ module Aws::DynamoDB
1149
1148
  # The settings for DynamoDB Streams on the table. These settings consist
1150
1149
  # of:
1151
1150
  #
1152
- # * `StreamEnabled` - Indicates whether Streams is to be enabled (true)
1153
- # or disabled (false).
1151
+ # * `StreamEnabled` - Indicates whether DynamoDB Streams is to be
1152
+ # enabled (true) or disabled (false).
1154
1153
  #
1155
1154
  # * `StreamViewType` - When an item in the table is modified,
1156
1155
  # `StreamViewType` determines what information is written to the
@@ -1569,8 +1568,8 @@ module Aws::DynamoDB
1569
1568
  #
1570
1569
  # * Logical operators: `AND | OR | NOT`
1571
1570
  #
1572
- # For more information on condition expressions, see [Specifying
1573
- # Conditions][1] in the *Amazon DynamoDB Developer Guide*.
1571
+ # For more information about condition expressions, see [Condition
1572
+ # Expressions][1] in the *Amazon DynamoDB Developer Guide*.
1574
1573
  #
1575
1574
  #
1576
1575
  #
@@ -1619,7 +1618,7 @@ module Aws::DynamoDB
1619
1618
  #
1620
1619
  # </note>
1621
1620
  #
1622
- # For more information on expression attribute names, see [Accessing
1621
+ # For more information on expression attribute names, see [Specifying
1623
1622
  # Item Attributes][2] in the *Amazon DynamoDB Developer Guide*.
1624
1623
  #
1625
1624
  #
@@ -1646,8 +1645,8 @@ module Aws::DynamoDB
1646
1645
  #
1647
1646
  # `ProductStatus IN (:avail, :back, :disc)`
1648
1647
  #
1649
- # For more information on expression attribute values, see [Specifying
1650
- # Conditions][1] in the *Amazon DynamoDB Developer Guide*.
1648
+ # For more information on expression attribute values, see [Condition
1649
+ # Expressions][1] in the *Amazon DynamoDB Developer Guide*.
1651
1650
  #
1652
1651
  #
1653
1652
  #
@@ -1879,7 +1878,7 @@ module Aws::DynamoDB
1879
1878
  # second.
1880
1879
  #
1881
1880
  # @option params [required, String] :backup_arn
1882
- # The ARN associated with the backup.
1881
+ # The Amazon Resource Name (ARN) associated with the backup.
1883
1882
  #
1884
1883
  # @return [Types::DescribeBackupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1885
1884
  #
@@ -1952,7 +1951,7 @@ module Aws::DynamoDB
1952
1951
  # table creation. If point in time recovery is enabled,
1953
1952
  # `PointInTimeRecoveryStatus` will be set to ENABLED.
1954
1953
  #
1955
- # Once continuous backups and point in time recovery are enabled, you
1954
+ # After continuous backups and point in time recovery are enabled, you
1956
1955
  # can restore to any point in time within `EarliestRestorableDateTime`
1957
1956
  # and `LatestRestorableDateTime`.
1958
1957
  #
@@ -2047,7 +2046,7 @@ module Aws::DynamoDB
2047
2046
  req.send_request(options)
2048
2047
  end
2049
2048
 
2050
- # Describes region specific settings for a global table.
2049
+ # Describes Region-specific settings for a global table.
2051
2050
  #
2052
2051
  # @option params [required, String] :global_table_name
2053
2052
  # The name of the global table to describe.
@@ -2129,12 +2128,12 @@ module Aws::DynamoDB
2129
2128
  end
2130
2129
 
2131
2130
  # Returns the current provisioned-capacity limits for your AWS account
2132
- # in a region, both for the region as a whole and for any one DynamoDB
2131
+ # in a Region, both for the Region as a whole and for any one DynamoDB
2133
2132
  # table that you create there.
2134
2133
  #
2135
2134
  # When you establish an AWS account, the account has initial limits on
2136
2135
  # the maximum read capacity units and write capacity units that you can
2137
- # provision across all of your DynamoDB tables in a given region. Also,
2136
+ # provision across all of your DynamoDB tables in a given Region. Also,
2138
2137
  # there are per-table limits that apply when you create a table there.
2139
2138
  # For more information, see [Limits][1] page in the *Amazon DynamoDB
2140
2139
  # Developer Guide*.
@@ -2148,11 +2147,11 @@ module Aws::DynamoDB
2148
2147
  #
2149
2148
  # For example, you could use one of the AWS SDKs to do the following:
2150
2149
  #
2151
- # 1. Call `DescribeLimits` for a particular region to obtain your
2150
+ # 1. Call `DescribeLimits` for a particular Region to obtain your
2152
2151
  # current account limits on provisioned capacity there.
2153
2152
  #
2154
2153
  # 2. Create a variable to hold the aggregate read capacity units
2155
- # provisioned for all your tables in that region, and one to hold
2154
+ # provisioned for all your tables in that Region, and one to hold
2156
2155
  # the aggregate write capacity units. Zero them both.
2157
2156
  #
2158
2157
  # 3. Call `ListTables` to obtain a list of all your DynamoDB tables.
@@ -2169,7 +2168,7 @@ module Aws::DynamoDB
2169
2168
  # loop over these GSIs and add their provisioned capacity values
2170
2169
  # to your variables as well.
2171
2170
  #
2172
- # 5. Report the account limits for that region returned by
2171
+ # 5. Report the account limits for that Region returned by
2173
2172
  # `DescribeLimits`, along with the total current provisioned
2174
2173
  # capacity levels you have calculated.
2175
2174
  #
@@ -2180,8 +2179,8 @@ module Aws::DynamoDB
2180
2179
  # They restrict the sum of the provisioned capacity of the new table
2181
2180
  # itself and all its global secondary indexes.
2182
2181
  #
2183
- # For existing tables and their GSIs, DynamoDB will not let you increase
2184
- # provisioned capacity extremely rapidly, but the only upper limit that
2182
+ # For existing tables and their GSIs, DynamoDB doesn't let you increase
2183
+ # provisioned capacity extremely rapidly. But the only upper limit that
2185
2184
  # applies is that the aggregate provisioned capacity over all your
2186
2185
  # tables and GSIs cannot exceed either of the per-account limits.
2187
2186
  #
@@ -2470,11 +2469,11 @@ module Aws::DynamoDB
2470
2469
  # JSON document. The attributes in the expression must be separated by
2471
2470
  # commas.
2472
2471
  #
2473
- # If no attribute names are specified, then all attributes will be
2474
- # returned. If any of the requested attributes are not found, they will
2475
- # not appear in the result.
2472
+ # If no attribute names are specified, then all attributes are returned.
2473
+ # If any of the requested attributes are not found, they do not appear
2474
+ # in the result.
2476
2475
  #
2477
- # For more information, see [Accessing Item Attributes][1] in the
2476
+ # For more information, see [Specifying Item Attributes][1] in the
2478
2477
  # *Amazon DynamoDB Developer Guide*.
2479
2478
  #
2480
2479
  #
@@ -2524,7 +2523,7 @@ module Aws::DynamoDB
2524
2523
  #
2525
2524
  # </note>
2526
2525
  #
2527
- # For more information on expression attribute names, see [Accessing
2526
+ # For more information on expression attribute names, see [Specifying
2528
2527
  # Item Attributes][2] in the *Amazon DynamoDB Developer Guide*.
2529
2528
  #
2530
2529
  #
@@ -2607,15 +2606,15 @@ module Aws::DynamoDB
2607
2606
 
2608
2607
  # List backups associated with an AWS account. To list backups for a
2609
2608
  # given table, specify `TableName`. `ListBackups` returns a paginated
2610
- # list of results with at most 1MB worth of items in a page. You can
2609
+ # list of results with at most 1 MB worth of items in a page. You can
2611
2610
  # also specify a limit for the maximum number of entries to be returned
2612
2611
  # in a page.
2613
2612
  #
2614
- # In the request, start time is inclusive but end time is exclusive.
2613
+ # In the request, start time is inclusive, but end time is exclusive.
2615
2614
  # Note that these limits are for the time at which the original backup
2616
2615
  # was requested.
2617
2616
  #
2618
- # You can call `ListBackups` a maximum of 5 times per second.
2617
+ # You can call `ListBackups` a maximum of five times per second.
2619
2618
  #
2620
2619
  # @option params [String] :table_name
2621
2620
  # The backups from the table specified by `TableName` are listed.
@@ -2632,11 +2631,11 @@ module Aws::DynamoDB
2632
2631
  # `TimeRangeUpperBound` is exclusive.
2633
2632
  #
2634
2633
  # @option params [String] :exclusive_start_backup_arn
2635
- # `LastEvaluatedBackupArn` is the ARN of the backup last evaluated when
2636
- # the current page of results was returned, inclusive of the current
2637
- # page of results. This value may be specified as the
2638
- # `ExclusiveStartBackupArn` of a new `ListBackups` operation in order to
2639
- # fetch the next page of results.
2634
+ # `LastEvaluatedBackupArn` is the Amazon Resource Name (ARN) of the
2635
+ # backup last evaluated when the current page of results was returned,
2636
+ # inclusive of the current page of results. This value may be specified
2637
+ # as the `ExclusiveStartBackupArn` of a new `ListBackups` operation in
2638
+ # order to fetch the next page of results.
2640
2639
  #
2641
2640
  # @option params [String] :backup_type
2642
2641
  # The backups from the table specified by `BackupType` are listed.
@@ -2689,7 +2688,7 @@ module Aws::DynamoDB
2689
2688
  req.send_request(options)
2690
2689
  end
2691
2690
 
2692
- # Lists all global tables that have a replica in the specified region.
2691
+ # Lists all global tables that have a replica in the specified Region.
2693
2692
  #
2694
2693
  # @option params [String] :exclusive_start_global_table_name
2695
2694
  # The first global table name that this operation will evaluate.
@@ -2698,7 +2697,7 @@ module Aws::DynamoDB
2698
2697
  # The maximum number of table names to return.
2699
2698
  #
2700
2699
  # @option params [String] :region_name
2701
- # Lists the global tables in a specific region.
2700
+ # Lists the global tables in a specific Region.
2702
2701
  #
2703
2702
  # @return [Types::ListGlobalTablesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2704
2703
  #
@@ -2849,29 +2848,29 @@ module Aws::DynamoDB
2849
2848
  # For information on how to call the `PutItem` API using the AWS SDK in
2850
2849
  # specific languages, see the following:
2851
2850
  #
2852
- # * [ PutItem in the AWS Command Line Interface ][1]
2851
+ # * [ PutItem in the AWS Command Line Interface][1]
2853
2852
  #
2854
- # * [ PutItem in the AWS SDK for .NET ][2]
2853
+ # * [ PutItem in the AWS SDK for .NET][2]
2855
2854
  #
2856
- # * [ PutItem in the AWS SDK for C++ ][3]
2855
+ # * [ PutItem in the AWS SDK for C++][3]
2857
2856
  #
2858
- # * [ PutItem in the AWS SDK for Go ][4]
2857
+ # * [ PutItem in the AWS SDK for Go][4]
2859
2858
  #
2860
- # * [ PutItem in the AWS SDK for Java ][5]
2859
+ # * [ PutItem in the AWS SDK for Java][5]
2861
2860
  #
2862
- # * [ PutItem in the AWS SDK for JavaScript ][6]
2861
+ # * [ PutItem in the AWS SDK for JavaScript][6]
2863
2862
  #
2864
- # * [ PutItem in the AWS SDK for PHP V3 ][7]
2863
+ # * [ PutItem in the AWS SDK for PHP V3][7]
2865
2864
  #
2866
- # * [ PutItem in the AWS SDK for Python ][8]
2865
+ # * [ PutItem in the AWS SDK for Python][8]
2867
2866
  #
2868
- # * [ PutItem in the AWS SDK for Ruby V2 ][9]
2867
+ # * [ PutItem in the AWS SDK for Ruby V2][9]
2869
2868
  #
2870
- # When you add an item, the primary key attribute(s) are the only
2871
- # required attributes. Attribute values cannot be null. String and
2872
- # Binary type attributes must have lengths greater than zero. Set type
2873
- # attributes cannot be empty. Requests with empty values will be
2874
- # rejected with a `ValidationException` exception.
2869
+ # When you add an item, the primary key attributes are the only required
2870
+ # attributes. Attribute values cannot be null. String and Binary type
2871
+ # attributes must have lengths greater than zero. Set type attributes
2872
+ # cannot be empty. Requests with empty values will be rejected with a
2873
+ # `ValidationException` exception.
2875
2874
  #
2876
2875
  # <note markdown="1"> To prevent a new item from replacing an existing item, use a
2877
2876
  # conditional expression that contains the `attribute_not_exists`
@@ -2922,7 +2921,7 @@ module Aws::DynamoDB
2922
2921
  #
2923
2922
  #
2924
2923
  #
2925
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DataModel.html#DataModelPrimaryKey
2924
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.CoreComponents.html#HowItWorks.CoreComponents.PrimaryKey
2926
2925
  #
2927
2926
  # @option params [Hash<String,Types::ExpectedAttributeValue>] :expected
2928
2927
  # This is a legacy parameter. Use `ConditionExpression` instead. For
@@ -2998,8 +2997,8 @@ module Aws::DynamoDB
2998
2997
  #
2999
2998
  # * Logical operators: `AND | OR | NOT`
3000
2999
  #
3001
- # For more information on condition expressions, see [Specifying
3002
- # Conditions][1] in the *Amazon DynamoDB Developer Guide*.
3000
+ # For more information on condition expressions, see [Condition
3001
+ # Expressions][1] in the *Amazon DynamoDB Developer Guide*.
3003
3002
  #
3004
3003
  #
3005
3004
  #
@@ -3048,7 +3047,7 @@ module Aws::DynamoDB
3048
3047
  #
3049
3048
  # </note>
3050
3049
  #
3051
- # For more information on expression attribute names, see [Accessing
3050
+ # For more information on expression attribute names, see [Specifying
3052
3051
  # Item Attributes][2] in the *Amazon DynamoDB Developer Guide*.
3053
3052
  #
3054
3053
  #
@@ -3075,8 +3074,8 @@ module Aws::DynamoDB
3075
3074
  #
3076
3075
  # `ProductStatus IN (:avail, :back, :disc)`
3077
3076
  #
3078
- # For more information on expression attribute values, see [Specifying
3079
- # Conditions][1] in the *Amazon DynamoDB Developer Guide*.
3077
+ # For more information on expression attribute values, see [Condition
3078
+ # Expressions][1] in the *Amazon DynamoDB Developer Guide*.
3080
3079
  #
3081
3080
  #
3082
3081
  #
@@ -3251,7 +3250,7 @@ module Aws::DynamoDB
3251
3250
  #
3252
3251
  # * `ALL_ATTRIBUTES` - Returns all of the item attributes from the
3253
3252
  # specified table or index. If you query a local secondary index, then
3254
- # for each matching item in the index DynamoDB will fetch the entire
3253
+ # for each matching item in the index, DynamoDB fetches the entire
3255
3254
  # item from the parent table. If the index is configured to project
3256
3255
  # all item attributes, then all of the data can be obtained from the
3257
3256
  # local secondary index, and no fetching is required.
@@ -3272,7 +3271,7 @@ module Aws::DynamoDB
3272
3271
  # attributes that are projected into that index, the operation will
3273
3272
  # read only the index and not the table. If any of the requested
3274
3273
  # attributes are not projected into the local secondary index,
3275
- # DynamoDB will fetch each of these attributes from the parent table.
3274
+ # DynamoDB fetches each of these attributes from the parent table.
3276
3275
  # This extra fetching incurs additional throughput cost and latency.
3277
3276
  #
3278
3277
  # If you query or scan a global secondary index, you can only request
@@ -3308,7 +3307,7 @@ module Aws::DynamoDB
3308
3307
  # limit while processing the results, it stops the operation and returns
3309
3308
  # the matching values up to that point, and a key in `LastEvaluatedKey`
3310
3309
  # to apply in a subsequent operation, so that you can pick up where you
3311
- # left off. Also, if the processed data set size exceeds 1 MB before
3310
+ # left off. Also, if the processed dataset size exceeds 1 MB before
3312
3311
  # DynamoDB reaches this limit, it stops the operation and returns the
3313
3312
  # matching values up to the limit, and a key in `LastEvaluatedKey` to
3314
3313
  # apply in a subsequent operation to continue the operation. For more
@@ -3377,7 +3376,7 @@ module Aws::DynamoDB
3377
3376
  # Use the value that was returned for `LastEvaluatedKey` in the previous
3378
3377
  # operation.
3379
3378
  #
3380
- # The data type for `ExclusiveStartKey` must be String, Number or
3379
+ # The data type for `ExclusiveStartKey` must be String, Number, or
3381
3380
  # Binary. No set data types are allowed.
3382
3381
  #
3383
3382
  # @option params [String] :return_consumed_capacity
@@ -3436,8 +3435,8 @@ module Aws::DynamoDB
3436
3435
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
3437
3436
  #
3438
3437
  # @option params [String] :key_condition_expression
3439
- # The condition that specifies the key value(s) for items to be
3440
- # retrieved by the `Query` action.
3438
+ # The condition that specifies the key values for items to be retrieved
3439
+ # by the `Query` action.
3441
3440
  #
3442
3441
  # The condition must perform an equality test on a single partition key
3443
3442
  # value.
@@ -3562,7 +3561,7 @@ module Aws::DynamoDB
3562
3561
  #
3563
3562
  # </note>
3564
3563
  #
3565
- # For more information on expression attribute names, see [Accessing
3564
+ # For more information on expression attribute names, see [Specifying
3566
3565
  # Item Attributes][2] in the *Amazon DynamoDB Developer Guide*.
3567
3566
  #
3568
3567
  #
@@ -3717,7 +3716,7 @@ module Aws::DynamoDB
3717
3716
  #
3718
3717
  # * IAM policies
3719
3718
  #
3720
- # * Cloudwatch metrics and alarms
3719
+ # * Amazon CloudWatch metrics and alarms
3721
3720
  #
3722
3721
  # * Tags
3723
3722
  #
@@ -3729,7 +3728,7 @@ module Aws::DynamoDB
3729
3728
  # The name of the new table to which the backup must be restored.
3730
3729
  #
3731
3730
  # @option params [required, String] :backup_arn
3732
- # The ARN associated with the backup.
3731
+ # The Amazon Resource Name (ARN) associated with the backup.
3733
3732
  #
3734
3733
  # @return [Types::RestoreTableFromBackupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3735
3734
  #
@@ -3844,7 +3843,7 @@ module Aws::DynamoDB
3844
3843
  #
3845
3844
  # * IAM policies
3846
3845
  #
3847
- # * Cloudwatch metrics and alarms
3846
+ # * Amazon CloudWatch metrics and alarms
3848
3847
  #
3849
3848
  # * Tags
3850
3849
  #
@@ -3957,18 +3956,18 @@ module Aws::DynamoDB
3957
3956
  # accessing every item in a table or a secondary index. To have DynamoDB
3958
3957
  # return fewer items, you can provide a `FilterExpression` operation.
3959
3958
  #
3960
- # If the total number of scanned items exceeds the maximum data set size
3959
+ # If the total number of scanned items exceeds the maximum dataset size
3961
3960
  # limit of 1 MB, the scan stops and results are returned to the user as
3962
3961
  # a `LastEvaluatedKey` value to continue the scan in a subsequent
3963
3962
  # operation. The results also include the number of items exceeding the
3964
3963
  # limit. A scan can result in no table data meeting the filter criteria.
3965
3964
  #
3966
- # A single `Scan` operation will read up to the maximum number of items
3967
- # set (if using the `Limit` parameter) or a maximum of 1 MB of data and
3968
- # then apply any filtering to the results using `FilterExpression`. If
3969
- # `LastEvaluatedKey` is present in the response, you will need to
3970
- # paginate the result set. For more information, see [Paginating the
3971
- # Results][1] in the *Amazon DynamoDB Developer Guide*.
3965
+ # A single `Scan` operation reads up to the maximum number of items set
3966
+ # (if using the `Limit` parameter) or a maximum of 1 MB of data and then
3967
+ # apply any filtering to the results using `FilterExpression`. If
3968
+ # `LastEvaluatedKey` is present in the response, you need to paginate
3969
+ # the result set. For more information, see [Paginating the Results][1]
3970
+ # in the *Amazon DynamoDB Developer Guide*.
3972
3971
  #
3973
3972
  # `Scan` operations proceed sequentially; however, for faster
3974
3973
  # performance on a large table or secondary index, applications can
@@ -4012,12 +4011,12 @@ module Aws::DynamoDB
4012
4011
  # limit while processing the results, it stops the operation and returns
4013
4012
  # the matching values up to that point, and a key in `LastEvaluatedKey`
4014
4013
  # to apply in a subsequent operation, so that you can pick up where you
4015
- # left off. Also, if the processed data set size exceeds 1 MB before
4014
+ # left off. Also, if the processed dataset size exceeds 1 MB before
4016
4015
  # DynamoDB reaches this limit, it stops the operation and returns the
4017
4016
  # matching values up to the limit, and a key in `LastEvaluatedKey` to
4018
4017
  # apply in a subsequent operation to continue the operation. For more
4019
- # information, see [Query and Scan][1] in the *Amazon DynamoDB Developer
4020
- # Guide*.
4018
+ # information, see [Working with Queries][1] in the *Amazon DynamoDB
4019
+ # Developer Guide*.
4021
4020
  #
4022
4021
  #
4023
4022
  #
@@ -4031,7 +4030,7 @@ module Aws::DynamoDB
4031
4030
  #
4032
4031
  # * `ALL_ATTRIBUTES` - Returns all of the item attributes from the
4033
4032
  # specified table or index. If you query a local secondary index, then
4034
- # for each matching item in the index DynamoDB will fetch the entire
4033
+ # for each matching item in the index, DynamoDB fetches the entire
4035
4034
  # item from the parent table. If the index is configured to project
4036
4035
  # all item attributes, then all of the data can be obtained from the
4037
4036
  # local secondary index, and no fetching is required.
@@ -4049,11 +4048,11 @@ module Aws::DynamoDB
4049
4048
  # `AttributesToGet` without specifying any value for `Select`.
4050
4049
  #
4051
4050
  # If you query or scan a local secondary index and request only
4052
- # attributes that are projected into that index, the operation will
4053
- # read only the index and not the table. If any of the requested
4054
- # attributes are not projected into the local secondary index,
4055
- # DynamoDB will fetch each of these attributes from the parent table.
4056
- # This extra fetching incurs additional throughput cost and latency.
4051
+ # attributes that are projected into that index, the operation reads
4052
+ # only the index and not the table. If any of the requested attributes
4053
+ # are not projected into the local secondary index, DynamoDB fetches
4054
+ # each of these attributes from the parent table. This extra fetching
4055
+ # incurs additional throughput cost and latency.
4057
4056
  #
4058
4057
  # If you query or scan a global secondary index, you can only request
4059
4058
  # attributes that are projected into the index. Global secondary index
@@ -4162,7 +4161,7 @@ module Aws::DynamoDB
4162
4161
  # returned. If any of the requested attributes are not found, they will
4163
4162
  # not appear in the result.
4164
4163
  #
4165
- # For more information, see [Accessing Item Attributes][1] in the
4164
+ # For more information, see [Specifying Item Attributes][1] in the
4166
4165
  # *Amazon DynamoDB Developer Guide*.
4167
4166
  #
4168
4167
  #
@@ -4230,7 +4229,7 @@ module Aws::DynamoDB
4230
4229
  #
4231
4230
  # </note>
4232
4231
  #
4233
- # For more information on expression attribute names, see [Accessing
4232
+ # For more information on expression attribute names, see [Specifying
4234
4233
  # Item Attributes][2] in the *Amazon DynamoDB Developer Guide*.
4235
4234
  #
4236
4235
  #
@@ -4243,7 +4242,7 @@ module Aws::DynamoDB
4243
4242
  #
4244
4243
  # Use the **\:** (colon) character in an expression to dereference an
4245
4244
  # attribute value. For example, suppose that you wanted to check whether
4246
- # the value of the *ProductStatus* attribute was one of the following:
4245
+ # the value of the `ProductStatus` attribute was one of the following:
4247
4246
  #
4248
4247
  # `Available | Backordered | Discontinued`
4249
4248
  #
@@ -4257,8 +4256,8 @@ module Aws::DynamoDB
4257
4256
  #
4258
4257
  # `ProductStatus IN (:avail, :back, :disc)`
4259
4258
  #
4260
- # For more information on expression attribute values, see [Specifying
4261
- # Conditions][1] in the *Amazon DynamoDB Developer Guide*.
4259
+ # For more information on expression attribute values, see [Condition
4260
+ # Expressions][1] in the *Amazon DynamoDB Developer Guide*.
4262
4261
  #
4263
4262
  #
4264
4263
  #
@@ -4270,7 +4269,7 @@ module Aws::DynamoDB
4270
4269
  #
4271
4270
  # * If `ConsistentRead` is `false`, then the data returned from `Scan`
4272
4271
  # might not contain the results from other recently completed write
4273
- # operations (PutItem, UpdateItem or DeleteItem).
4272
+ # operations (`PutItem`, `UpdateItem`, or `DeleteItem`).
4274
4273
  #
4275
4274
  # * If `ConsistentRead` is `true`, then all of the write operations that
4276
4275
  # completed before the `Scan` began are guaranteed to be contained in
@@ -4298,8 +4297,8 @@ module Aws::DynamoDB
4298
4297
  #
4299
4298
  # resp = client.scan({
4300
4299
  # expression_attribute_names: {
4301
- # "AT" => "AlbumTitle",
4302
- # "ST" => "SongTitle",
4300
+ # "#AT" => "AlbumTitle",
4301
+ # "#ST" => "SongTitle",
4303
4302
  # },
4304
4303
  # expression_attribute_values: {
4305
4304
  # ":a" => "No One You Know",
@@ -4396,7 +4395,7 @@ module Aws::DynamoDB
4396
4395
  # Associate a set of tags with an Amazon DynamoDB resource. You can then
4397
4396
  # activate these user-defined tags so that they appear on the Billing
4398
4397
  # and Cost Management console for cost allocation tracking. You can call
4399
- # TagResource up to 5 times per second, per account.
4398
+ # TagResource up to five times per second, per account.
4400
4399
  #
4401
4400
  # For an overview on tagging DynamoDB resources, see [Tagging for
4402
4401
  # DynamoDB][1] in the *Amazon DynamoDB Developer Guide*.
@@ -4437,11 +4436,24 @@ module Aws::DynamoDB
4437
4436
 
4438
4437
  # `TransactGetItems` is a synchronous operation that atomically
4439
4438
  # retrieves multiple items from one or more tables (but not from
4440
- # indexes) in a single account and region. A `TransactGetItems` call can
4441
- # contain up to 10 `TransactGetItem` objects, each of which contains a
4439
+ # indexes) in a single account and Region. A `TransactGetItems` call can
4440
+ # contain up to 25 `TransactGetItem` objects, each of which contains a
4442
4441
  # `Get` structure that specifies an item to retrieve from a table in the
4443
- # account and region. A call to `TransactGetItems` cannot retrieve items
4444
- # from tables in more than one AWS account or region.
4442
+ # account and Region. A call to `TransactGetItems` cannot retrieve items
4443
+ # from tables in more than one AWS account or Region. The aggregate size
4444
+ # of the items in the transaction cannot exceed 4 MB.
4445
+ #
4446
+ # <note markdown="1"> All AWS Regions and AWS GovCloud (US) support up to 25 items per
4447
+ # transaction with up to 4 MB of data, except the following AWS Regions:
4448
+ #
4449
+ # * China (Beijing)
4450
+ #
4451
+ # * China (Ningxia)
4452
+ #
4453
+ # The China (Beijing) and China (Ningxia) Regions support up to 10 items
4454
+ # per transaction with up to 4 MB of data.
4455
+ #
4456
+ # </note>
4445
4457
  #
4446
4458
  # DynamoDB rejects the entire `TransactGetItems` request if any of the
4447
4459
  # following is true:
@@ -4454,8 +4466,11 @@ module Aws::DynamoDB
4454
4466
  #
4455
4467
  # * There is a user error, such as an invalid data format.
4456
4468
  #
4469
+ # * The aggregate size of the items in the transaction cannot exceed 4
4470
+ # MB.
4471
+ #
4457
4472
  # @option params [required, Array<Types::TransactGetItem>] :transact_items
4458
- # An ordered array of up to 10 `TransactGetItem` objects, each of which
4473
+ # An ordered array of up to 25 `TransactGetItem` objects, each of which
4459
4474
  # contains a `Get` structure.
4460
4475
  #
4461
4476
  # @option params [String] :return_consumed_capacity
@@ -4520,10 +4535,23 @@ module Aws::DynamoDB
4520
4535
  end
4521
4536
 
4522
4537
  # `TransactWriteItems` is a synchronous write operation that groups up
4523
- # to 10 action requests. These actions can target items in different
4524
- # tables, but not in different AWS accounts or regions, and no two
4538
+ # to 25 action requests. These actions can target items in different
4539
+ # tables, but not in different AWS accounts or Regions, and no two
4525
4540
  # actions can target the same item. For example, you cannot both
4526
- # `ConditionCheck` and `Update` the same item.
4541
+ # `ConditionCheck` and `Update` the same item. The aggregate size of the
4542
+ # items in the transaction cannot exceed 4 MB.
4543
+ #
4544
+ # <note markdown="1"> All AWS Regions and AWS GovCloud (US) support up to 25 items per
4545
+ # transaction with up to 4 MB of data, except the following AWS Regions:
4546
+ #
4547
+ # * China (Beijing)
4548
+ #
4549
+ # * China (Ningxia)
4550
+ #
4551
+ # The China (Beijing) and China (Ningxia) Regions support up to 10 items
4552
+ # per transaction with up to 4 MB of data.
4553
+ #
4554
+ # </note>
4527
4555
  #
4528
4556
  # The actions are completed atomically so that either all of them
4529
4557
  # succeed, or all of them fail. They are defined by the following
@@ -4533,52 +4561,54 @@ module Aws::DynamoDB
4533
4561
  # structure specifies the primary key of the item to be written, the
4534
4562
  # name of the table to write it in, an optional condition expression
4535
4563
  # that must be satisfied for the write to succeed, a list of the
4536
- # item's attributes, and a field indicating whether or not to
4537
- # retrieve the item's attributes if the condition is not met.
4564
+ # item's attributes, and a field indicating whether to retrieve the
4565
+ # item's attributes if the condition is not met.
4538
4566
  #
4539
4567
  # * `Update`  —   Initiates an `UpdateItem` operation to update an
4540
4568
  # existing item. This structure specifies the primary key of the item
4541
4569
  # to be updated, the name of the table where it resides, an optional
4542
4570
  # condition expression that must be satisfied for the update to
4543
4571
  # succeed, an expression that defines one or more attributes to be
4544
- # updated, and a field indicating whether or not to retrieve the
4545
- # item's attributes if the condition is not met.
4572
+ # updated, and a field indicating whether to retrieve the item's
4573
+ # attributes if the condition is not met.
4546
4574
  #
4547
4575
  # * `Delete`  —   Initiates a `DeleteItem` operation to delete an
4548
4576
  # existing item. This structure specifies the primary key of the item
4549
4577
  # to be deleted, the name of the table where it resides, an optional
4550
4578
  # condition expression that must be satisfied for the deletion to
4551
- # succeed, and a field indicating whether or not to retrieve the
4552
- # item's attributes if the condition is not met.
4579
+ # succeed, and a field indicating whether to retrieve the item's
4580
+ # attributes if the condition is not met.
4553
4581
  #
4554
4582
  # * `ConditionCheck`  —   Applies a condition to an item that is not
4555
4583
  # being modified by the transaction. This structure specifies the
4556
4584
  # primary key of the item to be checked, the name of the table where
4557
4585
  # it resides, a condition expression that must be satisfied for the
4558
- # transaction to succeed, and a field indicating whether or not to
4559
- # retrieve the item's attributes if the condition is not met.
4586
+ # transaction to succeed, and a field indicating whether to retrieve
4587
+ # the item's attributes if the condition is not met.
4560
4588
  #
4561
4589
  # DynamoDB rejects the entire `TransactWriteItems` request if any of the
4562
4590
  # following is true:
4563
4591
  #
4564
4592
  # * A condition in one of the condition expressions is not met.
4565
4593
  #
4566
- # * A conflicting operation is in the process of updating the same item.
4594
+ # * An ongoing operation is in the process of updating the same item.
4567
4595
  #
4568
4596
  # * There is insufficient provisioned capacity for the transaction to be
4569
4597
  # completed.
4570
4598
  #
4571
- # * An item size becomes too large (bigger than 400 KB), a Local
4572
- # Secondary Index (LSI) becomes too large, or a similar validation
4599
+ # * An item size becomes too large (bigger than 400 KB), a local
4600
+ # secondary index (LSI) becomes too large, or a similar validation
4573
4601
  # error occurs because of changes made by the transaction.
4574
4602
  #
4603
+ # * The aggregate size of the items in the transaction exceeds 4 MB.
4604
+ #
4575
4605
  # * There is a user error, such as an invalid data format.
4576
4606
  #
4577
4607
  # @option params [required, Array<Types::TransactWriteItem>] :transact_items
4578
- # An ordered array of up to 10 `TransactWriteItem` objects, each of
4608
+ # An ordered array of up to 25 `TransactWriteItem` objects, each of
4579
4609
  # which contains a `ConditionCheck`, `Put`, `Update`, or `Delete`
4580
4610
  # object. These can operate on items in different tables, but the tables
4581
- # must reside in the same AWS account and region, and no two of them can
4611
+ # must reside in the same AWS account and Region, and no two of them can
4582
4612
  # operate on the same item.
4583
4613
  #
4584
4614
  # @option params [String] :return_consumed_capacity
@@ -4611,20 +4641,20 @@ module Aws::DynamoDB
4611
4641
  #
4612
4642
  # Although multiple identical calls using the same client request token
4613
4643
  # produce the same result on the server (no side effects), the responses
4614
- # to the calls may not be the same. If the `ReturnConsumedCapacity>`
4644
+ # to the calls might not be the same. If the `ReturnConsumedCapacity>`
4615
4645
  # parameter is set, then the initial `TransactWriteItems` call returns
4616
- # the amount of write capacity units consumed in making the changes, and
4617
- # subsequent `TransactWriteItems` calls with the same client token
4618
- # return the amount of read capacity units consumed in reading the item.
4646
+ # the amount of write capacity units consumed in making the changes.
4647
+ # Subsequent `TransactWriteItems` calls with the same client token
4648
+ # return the number of read capacity units consumed in reading the item.
4619
4649
  #
4620
4650
  # A client request token is valid for 10 minutes after the first request
4621
- # that uses it completes. After 10 minutes, any request with the same
4651
+ # that uses it is completed. After 10 minutes, any request with the same
4622
4652
  # client token is treated as a new request. Do not resubmit the same
4623
- # request with the same client token for more than 10 minutes or the
4624
- # result may not be idempotent.
4653
+ # request with the same client token for more than 10 minutes, or the
4654
+ # result might not be idempotent.
4625
4655
  #
4626
4656
  # If you submit a request with the same client token but a change in
4627
- # other parameters within the 10 minute idempotency window, DynamoDB
4657
+ # other parameters within the 10-minute idempotency window, DynamoDB
4628
4658
  # returns an `IdempotentParameterMismatch` exception.
4629
4659
  #
4630
4660
  # **A suitable default value is auto-generated.** You should normally
@@ -4739,7 +4769,7 @@ module Aws::DynamoDB
4739
4769
  end
4740
4770
 
4741
4771
  # Removes the association of tags from an Amazon DynamoDB resource. You
4742
- # can call UntagResource up to 5 times per second, per account.
4772
+ # can call `UntagResource` up to five times per second, per account.
4743
4773
  #
4744
4774
  # For an overview on tagging DynamoDB resources, see [Tagging for
4745
4775
  # DynamoDB][1] in the *Amazon DynamoDB Developer Guide*.
@@ -4749,13 +4779,12 @@ module Aws::DynamoDB
4749
4779
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html
4750
4780
  #
4751
4781
  # @option params [required, String] :resource_arn
4752
- # The Amazon DyanamoDB resource the tags will be removed from. This
4753
- # value is an Amazon Resource Name (ARN).
4782
+ # The DynamoDB resource that the tags will be removed from. This value
4783
+ # is an Amazon Resource Name (ARN).
4754
4784
  #
4755
4785
  # @option params [required, Array<String>] :tag_keys
4756
4786
  # A list of tag keys. Existing tags of the resource whose keys are
4757
- # members of this list will be removed from the Amazon DynamoDB
4758
- # resource.
4787
+ # members of this list will be removed from the DynamoDB resource.
4759
4788
  #
4760
4789
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4761
4790
  #
@@ -4788,7 +4817,7 @@ module Aws::DynamoDB
4788
4817
  #
4789
4818
  # `LatestRestorableDateTime` is typically 5 minutes before the current
4790
4819
  # time. You can restore your table to any point in time during the last
4791
- # 35 days..
4820
+ # 35 days.
4792
4821
  #
4793
4822
  # @option params [required, String] :table_name
4794
4823
  # The name of the table.
@@ -4827,10 +4856,9 @@ module Aws::DynamoDB
4827
4856
 
4828
4857
  # Adds or removes replicas in the specified global table. The global
4829
4858
  # table must already exist to be able to use this operation. Any replica
4830
- # to be added must be empty, must have the same name as the global
4831
- # table, must have the same key schema, and must have DynamoDB Streams
4832
- # enabled and must have same provisioned and maximum write capacity
4833
- # units.
4859
+ # to be added must be empty, have the same name as the global table,
4860
+ # have the same key schema, have DynamoDB Streams enabled, and have the
4861
+ # same provisioned and maximum write capacity units.
4834
4862
  #
4835
4863
  # <note markdown="1"> Although you can use `UpdateGlobalTable` to add replicas and remove
4836
4864
  # replicas in a single request, for simplicity we recommend that you
@@ -4853,7 +4881,7 @@ module Aws::DynamoDB
4853
4881
  # The global table name.
4854
4882
  #
4855
4883
  # @option params [required, Array<Types::ReplicaUpdate>] :replica_updates
4856
- # A list of regions that should be added or removed from the global
4884
+ # A list of Regions that should be added or removed from the global
4857
4885
  # table.
4858
4886
  #
4859
4887
  # @return [Types::UpdateGlobalTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -4909,7 +4937,7 @@ module Aws::DynamoDB
4909
4937
  # returns a `ThrottlingException.`
4910
4938
  #
4911
4939
  # @option params [Types::AutoScalingSettingsUpdate] :global_table_provisioned_write_capacity_auto_scaling_settings_update
4912
- # AutoScaling settings for managing provisioned write capacity for the
4940
+ # Auto scaling settings for managing provisioned write capacity for the
4913
4941
  # global table.
4914
4942
  #
4915
4943
  # @option params [Array<Types::GlobalTableGlobalSecondaryIndexSettingsUpdate>] :global_table_global_secondary_index_settings_update
@@ -4917,7 +4945,7 @@ module Aws::DynamoDB
4917
4945
  # that will be modified.
4918
4946
  #
4919
4947
  # @option params [Array<Types::ReplicaSettingsUpdate>] :replica_settings_update
4920
- # Represents the settings for a global table in a region that will be
4948
+ # Represents the settings for a global table in a Region that will be
4921
4949
  # modified.
4922
4950
  #
4923
4951
  # @return [Types::UpdateGlobalTableSettingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -5177,12 +5205,12 @@ module Aws::DynamoDB
5177
5205
  #
5178
5206
  # @option params [String] :update_expression
5179
5207
  # An expression that defines one or more attributes to be updated, the
5180
- # action to be performed on them, and new value(s) for them.
5208
+ # action to be performed on them, and new values for them.
5181
5209
  #
5182
5210
  # The following action values are available for `UpdateExpression`.
5183
5211
  #
5184
5212
  # * `SET` - Adds one or more attributes and values to an item. If any of
5185
- # these attribute already exist, they are replaced by the new values.
5213
+ # these attributes already exist, they are replaced by the new values.
5186
5214
  # You can also use `SET` to add or subtract from an attribute that is
5187
5215
  # of type Number. For example: `SET myNum = myNum + :val`
5188
5216
  #
@@ -5219,10 +5247,10 @@ module Aws::DynamoDB
5219
5247
  # decrement an attribute value that doesn't exist before the
5220
5248
  # update, DynamoDB uses `0` as the initial value. For example,
5221
5249
  # suppose that the item you want to update doesn't have an
5222
- # attribute named *itemcount*, but you decide to `ADD` the number
5223
- # `3` to this attribute anyway. DynamoDB will create the *itemcount*
5250
+ # attribute named `itemcount`, but you decide to `ADD` the number
5251
+ # `3` to this attribute anyway. DynamoDB will create the `itemcount`
5224
5252
  # attribute, set its initial value to `0`, and finally add `3` to
5225
- # it. The result will be a new *itemcount* attribute in the item,
5253
+ # it. The result will be a new `itemcount` attribute in the item,
5226
5254
  # with a value of `3`.
5227
5255
  #
5228
5256
  # </note>
@@ -5278,7 +5306,7 @@ module Aws::DynamoDB
5278
5306
  #
5279
5307
  # * Logical operators: `AND | OR | NOT`
5280
5308
  #
5281
- # For more information on condition expressions, see [Specifying
5309
+ # For more information about condition expressions, see [Specifying
5282
5310
  # Conditions][1] in the *Amazon DynamoDB Developer Guide*.
5283
5311
  #
5284
5312
  #
@@ -5309,7 +5337,7 @@ module Aws::DynamoDB
5309
5337
  # The name of this attribute conflicts with a reserved word, so it
5310
5338
  # cannot be used directly in an expression. (For the complete list of
5311
5339
  # reserved words, see [Reserved Words][1] in the *Amazon DynamoDB
5312
- # Developer Guide*). To work around this, you could specify the
5340
+ # Developer Guide*.) To work around this, you could specify the
5313
5341
  # following for `ExpressionAttributeNames`\:
5314
5342
  #
5315
5343
  # * `\{"#P":"Percentile"\}`
@@ -5328,7 +5356,7 @@ module Aws::DynamoDB
5328
5356
  #
5329
5357
  # </note>
5330
5358
  #
5331
- # For more information on expression attribute names, see [Accessing
5359
+ # For more information about expression attribute names, see [Specifying
5332
5360
  # Item Attributes][2] in the *Amazon DynamoDB Developer Guide*.
5333
5361
  #
5334
5362
  #
@@ -5341,7 +5369,7 @@ module Aws::DynamoDB
5341
5369
  #
5342
5370
  # Use the **\:** (colon) character in an expression to dereference an
5343
5371
  # attribute value. For example, suppose that you wanted to check whether
5344
- # the value of the *ProductStatus* attribute was one of the following:
5372
+ # the value of the `ProductStatus` attribute was one of the following:
5345
5373
  #
5346
5374
  # `Available | Backordered | Discontinued`
5347
5375
  #
@@ -5355,8 +5383,8 @@ module Aws::DynamoDB
5355
5383
  #
5356
5384
  # `ProductStatus IN (:avail, :back, :disc)`
5357
5385
  #
5358
- # For more information on expression attribute values, see [Specifying
5359
- # Conditions][1] in the *Amazon DynamoDB Developer Guide*.
5386
+ # For more information on expression attribute values, see [Condition
5387
+ # Expressions][1] in the *Amazon DynamoDB Developer Guide*.
5360
5388
  #
5361
5389
  #
5362
5390
  #
@@ -5477,11 +5505,11 @@ module Aws::DynamoDB
5477
5505
  #
5478
5506
  # * Modify the provisioned throughput settings of the table.
5479
5507
  #
5480
- # * Enable or disable Streams on the table.
5508
+ # * Enable or disable DynamoDB Streams on the table.
5481
5509
  #
5482
5510
  # * Remove a global secondary index from the table.
5483
5511
  #
5484
- # * Create a new global secondary index on the table. Once the index
5512
+ # * Create a new global secondary index on the table. After the index
5485
5513
  # begins backfilling, you can use `UpdateTable` to perform other
5486
5514
  # operations.
5487
5515
  #
@@ -5539,9 +5567,9 @@ module Aws::DynamoDB
5539
5567
  # @option params [Types::StreamSpecification] :stream_specification
5540
5568
  # Represents the DynamoDB Streams configuration for the table.
5541
5569
  #
5542
- # <note markdown="1"> You will receive a `ResourceInUseException` if you attempt to enable a
5543
- # stream on a table that already has a stream, or if you attempt to
5544
- # disable a stream on a table which does not have a stream.
5570
+ # <note markdown="1"> You receive a `ResourceInUseException` if you try to enable a stream
5571
+ # on a table that already has a stream, or if you try to disable a
5572
+ # stream on a table that doesn't have a stream.
5545
5573
  #
5546
5574
  # </note>
5547
5575
  #
@@ -5731,11 +5759,11 @@ module Aws::DynamoDB
5731
5759
  req.send_request(options)
5732
5760
  end
5733
5761
 
5734
- # The UpdateTimeToLive method will enable or disable TTL for the
5735
- # specified table. A successful `UpdateTimeToLive` call returns the
5736
- # current `TimeToLiveSpecification`; it may take up to one hour for the
5737
- # change to fully process. Any additional `UpdateTimeToLive` calls for
5738
- # the same table during this one hour duration result in a
5762
+ # The `UpdateTimeToLive` method enables or disables Time to Live (TTL)
5763
+ # for the specified table. A successful `UpdateTimeToLive` call returns
5764
+ # the current `TimeToLiveSpecification`. It can take up to one hour for
5765
+ # the change to fully process. Any additional `UpdateTimeToLive` calls
5766
+ # for the same table during this one hour duration result in a
5739
5767
  # `ValidationException`.
5740
5768
  #
5741
5769
  # TTL compares the current time in epoch time format to the time stored
@@ -5744,7 +5772,7 @@ module Aws::DynamoDB
5744
5772
  # and subsequently deleted.
5745
5773
  #
5746
5774
  # <note markdown="1"> The epoch time format is the number of seconds elapsed since 12:00:00
5747
- # AM January 1st, 1970 UTC.
5775
+ # AM January 1, 1970 UTC.
5748
5776
  #
5749
5777
  # </note>
5750
5778
  #
@@ -5757,8 +5785,8 @@ module Aws::DynamoDB
5757
5785
  # expired and not been deleted will still show up in reads, queries, and
5758
5786
  # scans.
5759
5787
  #
5760
- # As items are deleted, they are removed from any Local Secondary Index
5761
- # and Global Secondary Index immediately in the same eventually
5788
+ # As items are deleted, they are removed from any local secondary index
5789
+ # and global secondary index immediately in the same eventually
5762
5790
  # consistent way as a standard delete operation.
5763
5791
  #
5764
5792
  # For more information, see [Time To Live][1] in the Amazon DynamoDB
@@ -5816,7 +5844,7 @@ module Aws::DynamoDB
5816
5844
  params: params,
5817
5845
  config: config)
5818
5846
  context[:gem_name] = 'aws-sdk-dynamodb'
5819
- context[:gem_version] = '1.31.0'
5847
+ context[:gem_version] = '1.32.0'
5820
5848
  Seahorse::Client::Request.new(handlers, context)
5821
5849
  end
5822
5850