aws-sdk-dynamodb 1.31.0 → 1.32.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  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