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 +4 -4
- data/lib/aws-sdk-dynamodb.rb +1 -1
- data/lib/aws-sdk-dynamodb/client.rb +223 -195
- data/lib/aws-sdk-dynamodb/resource.rb +14 -13
- data/lib/aws-sdk-dynamodb/table.rb +53 -53
- data/lib/aws-sdk-dynamodb/types.rb +127 -124
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 61cbdbb5bc557e1e80e5a5e34a65e38395955eec
|
4
|
+
data.tar.gz: 93ada26c17a588130d252ee0d98bb36d2e4dd338
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 5edcbc09d5c64acf9bf126e46dcd905f5ead84bee4609d8723b8f7a1b565999904054ac61f674e8852c70aff8f0e7e0304f09e6d3b680f2e1276c8880771e7f2
|
7
|
+
data.tar.gz: b9cfba229a07a2a628d0eb43a32390134bd887a7ba9cb7fb8f82949f84981e8412fce0edb019658c237bc96929dd6c423e919386ae8b1e6978655d9ae4defe46
|
data/lib/aws-sdk-dynamodb.rb
CHANGED
@@ -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`
|
300
|
-
#
|
301
|
-
#
|
302
|
-
#
|
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`
|
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
|
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`
|
320
|
-
#
|
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 [
|
350
|
-
#
|
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
|
412
|
-
# Item Attributes][2] in the *Amazon DynamoDB Developer
|
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
|
427
|
-
# returned. If any of the requested attributes are not found, they
|
428
|
-
#
|
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
|
-
#
|
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`
|
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
|
613
|
-
#
|
614
|
-
#
|
615
|
-
#
|
616
|
-
#
|
617
|
-
#
|
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
|
-
#
|
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
|
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
|
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
|
-
#
|
848
|
-
#
|
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
|
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
|
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
|
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
|
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
|
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 [
|
1033
|
-
#
|
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
|
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
|
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
|
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
|
1573
|
-
#
|
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 [
|
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 [
|
1650
|
-
#
|
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
|
-
#
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
2184
|
-
# provisioned capacity extremely rapidly
|
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
|
2474
|
-
#
|
2475
|
-
#
|
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 [
|
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 [
|
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
|
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
|
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
|
2636
|
-
# the current page of results was returned,
|
2637
|
-
# page of results. This value may be specified
|
2638
|
-
# `ExclusiveStartBackupArn` of a new `ListBackups` operation in
|
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
|
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
|
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
|
2851
|
+
# * [ PutItem in the AWS Command Line Interface][1]
|
2853
2852
|
#
|
2854
|
-
# * [ PutItem in the AWS SDK for .NET
|
2853
|
+
# * [ PutItem in the AWS SDK for .NET][2]
|
2855
2854
|
#
|
2856
|
-
# * [ PutItem in the AWS SDK for C++
|
2855
|
+
# * [ PutItem in the AWS SDK for C++][3]
|
2857
2856
|
#
|
2858
|
-
# * [ PutItem in the AWS SDK for Go
|
2857
|
+
# * [ PutItem in the AWS SDK for Go][4]
|
2859
2858
|
#
|
2860
|
-
# * [ PutItem in the AWS SDK for Java
|
2859
|
+
# * [ PutItem in the AWS SDK for Java][5]
|
2861
2860
|
#
|
2862
|
-
# * [ PutItem in the AWS SDK for JavaScript
|
2861
|
+
# * [ PutItem in the AWS SDK for JavaScript][6]
|
2863
2862
|
#
|
2864
|
-
# * [ PutItem in the AWS SDK for PHP V3
|
2863
|
+
# * [ PutItem in the AWS SDK for PHP V3][7]
|
2865
2864
|
#
|
2866
|
-
# * [ PutItem in the AWS SDK for Python
|
2865
|
+
# * [ PutItem in the AWS SDK for Python][8]
|
2867
2866
|
#
|
2868
|
-
# * [ PutItem in the AWS SDK for Ruby V2
|
2867
|
+
# * [ PutItem in the AWS SDK for Ruby V2][9]
|
2869
2868
|
#
|
2870
|
-
# When you add an item, the primary key
|
2871
|
-
#
|
2872
|
-
#
|
2873
|
-
#
|
2874
|
-
#
|
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/
|
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 [
|
3002
|
-
#
|
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 [
|
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 [
|
3079
|
-
#
|
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
|
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
|
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
|
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
|
3440
|
-
#
|
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 [
|
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
|
-
# *
|
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
|
-
# *
|
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
|
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
|
3967
|
-
#
|
3968
|
-
#
|
3969
|
-
# `LastEvaluatedKey` is present in the response, you
|
3970
|
-
#
|
3971
|
-
#
|
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
|
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 [
|
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
|
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
|
4053
|
-
#
|
4054
|
-
#
|
4055
|
-
#
|
4056
|
-
#
|
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 [
|
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 [
|
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
|
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 [
|
4261
|
-
#
|
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
|
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
|
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
|
4441
|
-
# contain up to
|
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
|
4444
|
-
# from tables in more than one AWS account or
|
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
|
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
|
4524
|
-
# tables, but not in different AWS accounts or
|
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
|
4537
|
-
#
|
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
|
4545
|
-
#
|
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
|
4552
|
-
#
|
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
|
4559
|
-
#
|
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
|
-
# *
|
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
|
4572
|
-
#
|
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
|
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
|
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
|
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
|
4617
|
-
#
|
4618
|
-
# return the
|
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
|
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
|
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
|
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
|
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
|
4753
|
-
#
|
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
|
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,
|
4831
|
-
#
|
4832
|
-
#
|
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
|
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
|
-
#
|
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
|
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
|
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
|
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
|
5223
|
-
# `3` to this attribute anyway. DynamoDB will create the
|
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
|
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
|
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
|
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
|
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
|
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 [
|
5359
|
-
#
|
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.
|
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
|
5543
|
-
#
|
5544
|
-
#
|
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
|
5735
|
-
# specified table. A successful `UpdateTimeToLive` call returns
|
5736
|
-
# current `TimeToLiveSpecification
|
5737
|
-
# change to fully process. Any additional `UpdateTimeToLive` calls
|
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
|
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
|
5761
|
-
# and
|
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.
|
5847
|
+
context[:gem_version] = '1.32.0'
|
5820
5848
|
Seahorse::Client::Request.new(handlers, context)
|
5821
5849
|
end
|
5822
5850
|
|