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 +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
|
|