aws-sdk-dynamodb 1.60.0 → 1.74.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/CHANGELOG.md +70 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-dynamodb/client.rb +310 -80
- data/lib/aws-sdk-dynamodb/client_api.rb +22 -0
- data/lib/aws-sdk-dynamodb/resource.rb +8 -4
- data/lib/aws-sdk-dynamodb/table.rb +33 -19
- data/lib/aws-sdk-dynamodb/types.rb +297 -114
- data/lib/aws-sdk-dynamodb.rb +1 -1
- metadata +8 -9
@@ -27,6 +27,9 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
|
|
27
27
|
require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
|
28
28
|
require 'aws-sdk-core/plugins/transfer_encoding.rb'
|
29
29
|
require 'aws-sdk-core/plugins/http_checksum.rb'
|
30
|
+
require 'aws-sdk-core/plugins/checksum_algorithm.rb'
|
31
|
+
require 'aws-sdk-core/plugins/defaults_mode.rb'
|
32
|
+
require 'aws-sdk-core/plugins/recursion_detection.rb'
|
30
33
|
require 'aws-sdk-core/plugins/signature_v4.rb'
|
31
34
|
require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
|
32
35
|
require 'aws-sdk-dynamodb/plugins/extended_retries.rb'
|
@@ -76,6 +79,9 @@ module Aws::DynamoDB
|
|
76
79
|
add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
|
77
80
|
add_plugin(Aws::Plugins::TransferEncoding)
|
78
81
|
add_plugin(Aws::Plugins::HttpChecksum)
|
82
|
+
add_plugin(Aws::Plugins::ChecksumAlgorithm)
|
83
|
+
add_plugin(Aws::Plugins::DefaultsMode)
|
84
|
+
add_plugin(Aws::Plugins::RecursionDetection)
|
79
85
|
add_plugin(Aws::Plugins::SignatureV4)
|
80
86
|
add_plugin(Aws::Plugins::Protocols::JsonRpc)
|
81
87
|
add_plugin(Aws::DynamoDB::Plugins::ExtendedRetries)
|
@@ -125,7 +131,9 @@ module Aws::DynamoDB
|
|
125
131
|
# * EC2/ECS IMDS instance profile - When used by default, the timeouts
|
126
132
|
# are very aggressive. Construct and pass an instance of
|
127
133
|
# `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
|
128
|
-
# enable retries and extended timeouts.
|
134
|
+
# enable retries and extended timeouts. Instance profile credential
|
135
|
+
# fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
|
136
|
+
# to true.
|
129
137
|
#
|
130
138
|
# @option options [required, String] :region
|
131
139
|
# The AWS region to connect to. The configured `:region` is
|
@@ -185,6 +193,10 @@ module Aws::DynamoDB
|
|
185
193
|
# Used only in `standard` and adaptive retry modes. Specifies whether to apply
|
186
194
|
# a clock skew correction and retry requests with skewed client clocks.
|
187
195
|
#
|
196
|
+
# @option options [String] :defaults_mode ("legacy")
|
197
|
+
# See {Aws::DefaultsModeConfiguration} for a list of the
|
198
|
+
# accepted modes and the configuration defaults that are included.
|
199
|
+
#
|
188
200
|
# @option options [Boolean] :disable_host_prefix_injection (false)
|
189
201
|
# Set to true to disable SDK automatically adding host prefix
|
190
202
|
# to default service endpoint when available.
|
@@ -304,6 +316,15 @@ module Aws::DynamoDB
|
|
304
316
|
# ** Please note ** When response stubbing is enabled, no HTTP
|
305
317
|
# requests are made, and retries are disabled.
|
306
318
|
#
|
319
|
+
# @option options [Boolean] :use_dualstack_endpoint
|
320
|
+
# When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
|
321
|
+
# will be used if available.
|
322
|
+
#
|
323
|
+
# @option options [Boolean] :use_fips_endpoint
|
324
|
+
# When set to `true`, fips compatible endpoints will be used if available.
|
325
|
+
# When a `fips` region is used, the region is normalized and this config
|
326
|
+
# is set to `true`.
|
327
|
+
#
|
307
328
|
# @option options [Boolean] :validate_params (true)
|
308
329
|
# When `true`, request parameters are validated before
|
309
330
|
# sending the request.
|
@@ -315,7 +336,7 @@ module Aws::DynamoDB
|
|
315
336
|
# seconds to wait when opening a HTTP session before raising a
|
316
337
|
# `Timeout::Error`.
|
317
338
|
#
|
318
|
-
# @option options [
|
339
|
+
# @option options [Float] :http_read_timeout (60) The default
|
319
340
|
# number of seconds to wait for response data. This value can
|
320
341
|
# safely be set per-request on the session.
|
321
342
|
#
|
@@ -331,6 +352,9 @@ module Aws::DynamoDB
|
|
331
352
|
# disables this behaviour. This value can safely be set per
|
332
353
|
# request on the session.
|
333
354
|
#
|
355
|
+
# @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
|
356
|
+
# in seconds.
|
357
|
+
#
|
334
358
|
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
335
359
|
# HTTP debug output will be sent to the `:logger`.
|
336
360
|
#
|
@@ -356,15 +380,38 @@ module Aws::DynamoDB
|
|
356
380
|
|
357
381
|
# @!group API Operations
|
358
382
|
|
359
|
-
# This operation allows you to perform batch reads
|
383
|
+
# This operation allows you to perform batch reads or writes on data
|
360
384
|
# stored in DynamoDB, using PartiQL.
|
361
385
|
#
|
386
|
+
# <note markdown="1"> The entire batch must consist of either read statements or write
|
387
|
+
# statements, you cannot mix both in one batch.
|
388
|
+
#
|
389
|
+
# </note>
|
390
|
+
#
|
362
391
|
# @option params [required, Array<Types::BatchStatementRequest>] :statements
|
363
392
|
# The list of PartiQL statements representing the batch to run.
|
364
393
|
#
|
394
|
+
# @option params [String] :return_consumed_capacity
|
395
|
+
# Determines the level of detail about either provisioned or on-demand
|
396
|
+
# throughput consumption that is returned in the response:
|
397
|
+
#
|
398
|
+
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
399
|
+
# for the operation, together with `ConsumedCapacity` for each table
|
400
|
+
# and secondary index that was accessed.
|
401
|
+
#
|
402
|
+
# Note that some operations, such as `GetItem` and `BatchGetItem`, do
|
403
|
+
# not access any indexes at all. In these cases, specifying `INDEXES`
|
404
|
+
# will only return `ConsumedCapacity` information for table(s).
|
405
|
+
#
|
406
|
+
# * `TOTAL` - The response includes only the aggregate
|
407
|
+
# `ConsumedCapacity` for the operation.
|
408
|
+
#
|
409
|
+
# * `NONE` - No `ConsumedCapacity` details are included in the response.
|
410
|
+
#
|
365
411
|
# @return [Types::BatchExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
366
412
|
#
|
367
413
|
# * {Types::BatchExecuteStatementOutput#responses #responses} => Array<Types::BatchStatementResponse>
|
414
|
+
# * {Types::BatchExecuteStatementOutput#consumed_capacity #consumed_capacity} => Array<Types::ConsumedCapacity>
|
368
415
|
#
|
369
416
|
# @example Request syntax with placeholder values
|
370
417
|
#
|
@@ -376,6 +423,7 @@ module Aws::DynamoDB
|
|
376
423
|
# consistent_read: false,
|
377
424
|
# },
|
378
425
|
# ],
|
426
|
+
# return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
|
379
427
|
# })
|
380
428
|
#
|
381
429
|
# @example Response structure
|
@@ -386,6 +434,22 @@ module Aws::DynamoDB
|
|
386
434
|
# resp.responses[0].table_name #=> String
|
387
435
|
# resp.responses[0].item #=> Hash
|
388
436
|
# resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
437
|
+
# resp.consumed_capacity #=> Array
|
438
|
+
# resp.consumed_capacity[0].table_name #=> String
|
439
|
+
# resp.consumed_capacity[0].capacity_units #=> Float
|
440
|
+
# resp.consumed_capacity[0].read_capacity_units #=> Float
|
441
|
+
# resp.consumed_capacity[0].write_capacity_units #=> Float
|
442
|
+
# resp.consumed_capacity[0].table.read_capacity_units #=> Float
|
443
|
+
# resp.consumed_capacity[0].table.write_capacity_units #=> Float
|
444
|
+
# resp.consumed_capacity[0].table.capacity_units #=> Float
|
445
|
+
# resp.consumed_capacity[0].local_secondary_indexes #=> Hash
|
446
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
447
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
448
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
|
449
|
+
# resp.consumed_capacity[0].global_secondary_indexes #=> Hash
|
450
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
451
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
452
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
|
389
453
|
#
|
390
454
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchExecuteStatement AWS API Documentation
|
391
455
|
#
|
@@ -547,8 +611,8 @@ module Aws::DynamoDB
|
|
547
611
|
# [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html
|
548
612
|
#
|
549
613
|
# @option params [String] :return_consumed_capacity
|
550
|
-
# Determines the level of detail about provisioned
|
551
|
-
# consumption that is returned in the response:
|
614
|
+
# Determines the level of detail about either provisioned or on-demand
|
615
|
+
# throughput consumption that is returned in the response:
|
552
616
|
#
|
553
617
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
554
618
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -680,9 +744,13 @@ module Aws::DynamoDB
|
|
680
744
|
end
|
681
745
|
|
682
746
|
# The `BatchWriteItem` operation puts or deletes multiple items in one
|
683
|
-
# or more tables. A single call to `BatchWriteItem` can
|
684
|
-
#
|
685
|
-
#
|
747
|
+
# or more tables. A single call to `BatchWriteItem` can transmit up to
|
748
|
+
# 16MB of data over the network, consisting of up to 25 item put or
|
749
|
+
# delete operations. While individual items can be up to 400 KB once
|
750
|
+
# stored, it's important to note that an item's representation might
|
751
|
+
# be greater than 400KB while being sent in DynamoDB's JSON format for
|
752
|
+
# the API call. For more details on this distinction, see [Naming Rules
|
753
|
+
# and Data Types][1].
|
686
754
|
#
|
687
755
|
# <note markdown="1"> `BatchWriteItem` cannot update items. To update items, use the
|
688
756
|
# `UpdateItem` action.
|
@@ -712,7 +780,7 @@ module Aws::DynamoDB
|
|
712
780
|
# operation using exponential backoff, the individual requests in the
|
713
781
|
# batch are much more likely to succeed.
|
714
782
|
#
|
715
|
-
# For more information, see [Batch Operations and Error Handling][
|
783
|
+
# For more information, see [Batch Operations and Error Handling][2] in
|
716
784
|
# the *Amazon DynamoDB Developer Guide*.
|
717
785
|
#
|
718
786
|
# With `BatchWriteItem`, you can efficiently write or delete large
|
@@ -761,7 +829,8 @@ module Aws::DynamoDB
|
|
761
829
|
#
|
762
830
|
#
|
763
831
|
#
|
764
|
-
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/
|
832
|
+
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html
|
833
|
+
# [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#Programming.Errors.BatchOperations
|
765
834
|
#
|
766
835
|
# @option params [required, Hash<String,Array>] :request_items
|
767
836
|
# A map of one or more table names and, for each table, a list of
|
@@ -796,8 +865,8 @@ module Aws::DynamoDB
|
|
796
865
|
# in the table's attribute definition.
|
797
866
|
#
|
798
867
|
# @option params [String] :return_consumed_capacity
|
799
|
-
# Determines the level of detail about provisioned
|
800
|
-
# consumption that is returned in the response:
|
868
|
+
# Determines the level of detail about either provisioned or on-demand
|
869
|
+
# throughput consumption that is returned in the response:
|
801
870
|
#
|
802
871
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
803
872
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -1085,6 +1154,8 @@ module Aws::DynamoDB
|
|
1085
1154
|
# resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
|
1086
1155
|
# resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
1087
1156
|
# resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
|
1157
|
+
# resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
1158
|
+
# resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
|
1088
1159
|
# resp.global_table_description.global_table_arn #=> String
|
1089
1160
|
# resp.global_table_description.creation_date_time #=> Time
|
1090
1161
|
# resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
|
@@ -1100,9 +1171,9 @@ module Aws::DynamoDB
|
|
1100
1171
|
end
|
1101
1172
|
|
1102
1173
|
# The `CreateTable` operation adds a new table to your account. In an
|
1103
|
-
#
|
1104
|
-
# you can have two tables with same name if you create
|
1105
|
-
# different Regions.
|
1174
|
+
# Amazon Web Services account, table names must be unique within each
|
1175
|
+
# Region. That is, you can have two tables with same name if you create
|
1176
|
+
# the tables in different Regions.
|
1106
1177
|
#
|
1107
1178
|
# `CreateTable` is an asynchronous operation. Upon receiving a
|
1108
1179
|
# `CreateTable` request, DynamoDB immediately returns a response with a
|
@@ -1319,6 +1390,10 @@ module Aws::DynamoDB
|
|
1319
1390
|
#
|
1320
1391
|
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html
|
1321
1392
|
#
|
1393
|
+
# @option params [String] :table_class
|
1394
|
+
# The table class of the new table. Valid values are `STANDARD` and
|
1395
|
+
# `STANDARD_INFREQUENT_ACCESS`.
|
1396
|
+
#
|
1322
1397
|
# @return [Types::CreateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1323
1398
|
#
|
1324
1399
|
# * {Types::CreateTableOutput#table_description #table_description} => Types::TableDescription
|
@@ -1461,6 +1536,7 @@ module Aws::DynamoDB
|
|
1461
1536
|
# value: "TagValueString", # required
|
1462
1537
|
# },
|
1463
1538
|
# ],
|
1539
|
+
# table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
|
1464
1540
|
# })
|
1465
1541
|
#
|
1466
1542
|
# @example Response structure
|
@@ -1530,6 +1606,8 @@ module Aws::DynamoDB
|
|
1530
1606
|
# resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
|
1531
1607
|
# resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
1532
1608
|
# resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
|
1609
|
+
# resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
1610
|
+
# resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
|
1533
1611
|
# resp.table_description.restore_summary.source_backup_arn #=> String
|
1534
1612
|
# resp.table_description.restore_summary.source_table_arn #=> String
|
1535
1613
|
# resp.table_description.restore_summary.restore_date_time #=> Time
|
@@ -1541,6 +1619,8 @@ module Aws::DynamoDB
|
|
1541
1619
|
# resp.table_description.archival_summary.archival_date_time #=> Time
|
1542
1620
|
# resp.table_description.archival_summary.archival_reason #=> String
|
1543
1621
|
# resp.table_description.archival_summary.archival_backup_arn #=> String
|
1622
|
+
# resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
1623
|
+
# resp.table_description.table_class_summary.last_update_date_time #=> Time
|
1544
1624
|
#
|
1545
1625
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTable AWS API Documentation
|
1546
1626
|
#
|
@@ -1689,8 +1769,8 @@ module Aws::DynamoDB
|
|
1689
1769
|
# </note>
|
1690
1770
|
#
|
1691
1771
|
# @option params [String] :return_consumed_capacity
|
1692
|
-
# Determines the level of detail about provisioned
|
1693
|
-
# consumption that is returned in the response:
|
1772
|
+
# Determines the level of detail about either provisioned or on-demand
|
1773
|
+
# throughput consumption that is returned in the response:
|
1694
1774
|
#
|
1695
1775
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
1696
1776
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -2025,6 +2105,8 @@ module Aws::DynamoDB
|
|
2025
2105
|
# resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
|
2026
2106
|
# resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
2027
2107
|
# resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
|
2108
|
+
# resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
2109
|
+
# resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
|
2028
2110
|
# resp.table_description.restore_summary.source_backup_arn #=> String
|
2029
2111
|
# resp.table_description.restore_summary.source_table_arn #=> String
|
2030
2112
|
# resp.table_description.restore_summary.restore_date_time #=> Time
|
@@ -2036,6 +2118,8 @@ module Aws::DynamoDB
|
|
2036
2118
|
# resp.table_description.archival_summary.archival_date_time #=> Time
|
2037
2119
|
# resp.table_description.archival_summary.archival_reason #=> String
|
2038
2120
|
# resp.table_description.archival_summary.archival_backup_arn #=> String
|
2121
|
+
# resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
2122
|
+
# resp.table_description.table_class_summary.last_update_date_time #=> Time
|
2039
2123
|
#
|
2040
2124
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTable AWS API Documentation
|
2041
2125
|
#
|
@@ -2319,6 +2403,8 @@ module Aws::DynamoDB
|
|
2319
2403
|
# resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
|
2320
2404
|
# resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
2321
2405
|
# resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
|
2406
|
+
# resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
2407
|
+
# resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
|
2322
2408
|
# resp.global_table_description.global_table_arn #=> String
|
2323
2409
|
# resp.global_table_description.creation_date_time #=> Time
|
2324
2410
|
# resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
|
@@ -2413,6 +2499,8 @@ module Aws::DynamoDB
|
|
2413
2499
|
# resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_in_cooldown #=> Integer
|
2414
2500
|
# resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_out_cooldown #=> Integer
|
2415
2501
|
# resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.target_value #=> Float
|
2502
|
+
# resp.replica_settings[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
2503
|
+
# resp.replica_settings[0].replica_table_class_summary.last_update_date_time #=> Time
|
2416
2504
|
#
|
2417
2505
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeGlobalTableSettings AWS API Documentation
|
2418
2506
|
#
|
@@ -2456,25 +2544,26 @@ module Aws::DynamoDB
|
|
2456
2544
|
req.send_request(options)
|
2457
2545
|
end
|
2458
2546
|
|
2459
|
-
# Returns the current provisioned-capacity quotas for your
|
2460
|
-
# in a Region, both for the Region as a whole and for
|
2461
|
-
# table that you create there.
|
2462
|
-
#
|
2463
|
-
# When you establish an
|
2464
|
-
# the maximum read capacity units and write capacity
|
2465
|
-
# provision across all of your DynamoDB tables in a
|
2466
|
-
# there are per-table quotas that apply when you
|
2467
|
-
# For more information, see [Service, Account, and
|
2468
|
-
# in the *Amazon DynamoDB Developer Guide*.
|
2469
|
-
#
|
2470
|
-
# Although you can increase these quotas by filing a case at [
|
2471
|
-
# Support Center][2], obtaining the increase is not
|
2472
|
-
# `DescribeLimits` action lets you write code to
|
2473
|
-
# you are currently using to those quotas imposed
|
2474
|
-
# that you have enough time to apply for an increase
|
2475
|
-
# quota.
|
2476
|
-
#
|
2477
|
-
# For example, you could use one of the
|
2547
|
+
# Returns the current provisioned-capacity quotas for your Amazon Web
|
2548
|
+
# Services account in a Region, both for the Region as a whole and for
|
2549
|
+
# any one DynamoDB table that you create there.
|
2550
|
+
#
|
2551
|
+
# When you establish an Amazon Web Services account, the account has
|
2552
|
+
# initial quotas on the maximum read capacity units and write capacity
|
2553
|
+
# units that you can provision across all of your DynamoDB tables in a
|
2554
|
+
# given Region. Also, there are per-table quotas that apply when you
|
2555
|
+
# create a table there. For more information, see [Service, Account, and
|
2556
|
+
# Table Quotas][1] page in the *Amazon DynamoDB Developer Guide*.
|
2557
|
+
#
|
2558
|
+
# Although you can increase these quotas by filing a case at [Amazon Web
|
2559
|
+
# Services Support Center][2], obtaining the increase is not
|
2560
|
+
# instantaneous. The `DescribeLimits` action lets you write code to
|
2561
|
+
# compare the capacity you are currently using to those quotas imposed
|
2562
|
+
# by your account so that you have enough time to apply for an increase
|
2563
|
+
# before you hit a quota.
|
2564
|
+
#
|
2565
|
+
# For example, you could use one of the Amazon Web Services SDKs to do
|
2566
|
+
# the following:
|
2478
2567
|
#
|
2479
2568
|
# 1. Call `DescribeLimits` for a particular Region to obtain your
|
2480
2569
|
# current account quotas on provisioned capacity there.
|
@@ -2703,6 +2792,8 @@ module Aws::DynamoDB
|
|
2703
2792
|
# resp.table.replicas[0].global_secondary_indexes[0].index_name #=> String
|
2704
2793
|
# resp.table.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
2705
2794
|
# resp.table.replicas[0].replica_inaccessible_date_time #=> Time
|
2795
|
+
# resp.table.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
2796
|
+
# resp.table.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
|
2706
2797
|
# resp.table.restore_summary.source_backup_arn #=> String
|
2707
2798
|
# resp.table.restore_summary.source_table_arn #=> String
|
2708
2799
|
# resp.table.restore_summary.restore_date_time #=> Time
|
@@ -2714,6 +2805,8 @@ module Aws::DynamoDB
|
|
2714
2805
|
# resp.table.archival_summary.archival_date_time #=> Time
|
2715
2806
|
# resp.table.archival_summary.archival_reason #=> String
|
2716
2807
|
# resp.table.archival_summary.archival_backup_arn #=> String
|
2808
|
+
# resp.table.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
2809
|
+
# resp.table.table_class_summary.last_update_date_time #=> Time
|
2717
2810
|
#
|
2718
2811
|
#
|
2719
2812
|
# The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
|
@@ -2925,6 +3018,19 @@ module Aws::DynamoDB
|
|
2925
3018
|
# This operation allows you to perform reads and singleton writes on
|
2926
3019
|
# data stored in DynamoDB, using PartiQL.
|
2927
3020
|
#
|
3021
|
+
# For PartiQL reads (`SELECT` statement), if the total number of
|
3022
|
+
# processed items exceeds the maximum dataset size limit of 1 MB, the
|
3023
|
+
# read stops and results are returned to the user as a
|
3024
|
+
# `LastEvaluatedKey` value to continue the read in a subsequent
|
3025
|
+
# operation. If the filter criteria in `WHERE` clause does not match any
|
3026
|
+
# data, the read will return an empty result set.
|
3027
|
+
#
|
3028
|
+
# A single `SELECT` statement response can return up to the maximum
|
3029
|
+
# number of items (if using the Limit parameter) or a maximum of 1 MB of
|
3030
|
+
# data (and then apply any filtering to the results using `WHERE`
|
3031
|
+
# clause). If `LastEvaluatedKey` is present in the response, you need to
|
3032
|
+
# paginate the result set.
|
3033
|
+
#
|
2928
3034
|
# @option params [required, String] :statement
|
2929
3035
|
# The PartiQL statement representing the operation to run.
|
2930
3036
|
#
|
@@ -2940,10 +3046,41 @@ module Aws::DynamoDB
|
|
2940
3046
|
# Set this value to get remaining results, if `NextToken` was returned
|
2941
3047
|
# in the statement response.
|
2942
3048
|
#
|
3049
|
+
# @option params [String] :return_consumed_capacity
|
3050
|
+
# Determines the level of detail about either provisioned or on-demand
|
3051
|
+
# throughput consumption that is returned in the response:
|
3052
|
+
#
|
3053
|
+
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
3054
|
+
# for the operation, together with `ConsumedCapacity` for each table
|
3055
|
+
# and secondary index that was accessed.
|
3056
|
+
#
|
3057
|
+
# Note that some operations, such as `GetItem` and `BatchGetItem`, do
|
3058
|
+
# not access any indexes at all. In these cases, specifying `INDEXES`
|
3059
|
+
# will only return `ConsumedCapacity` information for table(s).
|
3060
|
+
#
|
3061
|
+
# * `TOTAL` - The response includes only the aggregate
|
3062
|
+
# `ConsumedCapacity` for the operation.
|
3063
|
+
#
|
3064
|
+
# * `NONE` - No `ConsumedCapacity` details are included in the response.
|
3065
|
+
#
|
3066
|
+
# @option params [Integer] :limit
|
3067
|
+
# The maximum number of items to evaluate (not necessarily the number of
|
3068
|
+
# matching items). If DynamoDB processes the number of items up to the
|
3069
|
+
# limit while processing the results, it stops the operation and returns
|
3070
|
+
# the matching values up to that point, along with a key in
|
3071
|
+
# `LastEvaluatedKey` to apply in a subsequent operation so you can pick
|
3072
|
+
# up where you left off. Also, if the processed dataset size exceeds 1
|
3073
|
+
# MB before DynamoDB reaches this limit, it stops the operation and
|
3074
|
+
# returns the matching values up to the limit, and a key in
|
3075
|
+
# `LastEvaluatedKey` to apply in a subsequent operation to continue the
|
3076
|
+
# operation.
|
3077
|
+
#
|
2943
3078
|
# @return [Types::ExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2944
3079
|
#
|
2945
3080
|
# * {Types::ExecuteStatementOutput#items #items} => Array<Hash<String,Types::AttributeValue>>
|
2946
3081
|
# * {Types::ExecuteStatementOutput#next_token #next_token} => String
|
3082
|
+
# * {Types::ExecuteStatementOutput#consumed_capacity #consumed_capacity} => Types::ConsumedCapacity
|
3083
|
+
# * {Types::ExecuteStatementOutput#last_evaluated_key #last_evaluated_key} => Hash<String,Types::AttributeValue>
|
2947
3084
|
#
|
2948
3085
|
# @example Request syntax with placeholder values
|
2949
3086
|
#
|
@@ -2952,6 +3089,8 @@ module Aws::DynamoDB
|
|
2952
3089
|
# parameters: ["value"], # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
2953
3090
|
# consistent_read: false,
|
2954
3091
|
# next_token: "PartiQLNextToken",
|
3092
|
+
# return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
|
3093
|
+
# limit: 1,
|
2955
3094
|
# })
|
2956
3095
|
#
|
2957
3096
|
# @example Response structure
|
@@ -2960,6 +3099,23 @@ module Aws::DynamoDB
|
|
2960
3099
|
# resp.items[0] #=> Hash
|
2961
3100
|
# resp.items[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
2962
3101
|
# resp.next_token #=> String
|
3102
|
+
# resp.consumed_capacity.table_name #=> String
|
3103
|
+
# resp.consumed_capacity.capacity_units #=> Float
|
3104
|
+
# resp.consumed_capacity.read_capacity_units #=> Float
|
3105
|
+
# resp.consumed_capacity.write_capacity_units #=> Float
|
3106
|
+
# resp.consumed_capacity.table.read_capacity_units #=> Float
|
3107
|
+
# resp.consumed_capacity.table.write_capacity_units #=> Float
|
3108
|
+
# resp.consumed_capacity.table.capacity_units #=> Float
|
3109
|
+
# resp.consumed_capacity.local_secondary_indexes #=> Hash
|
3110
|
+
# resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3111
|
+
# resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3112
|
+
# resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
|
3113
|
+
# resp.consumed_capacity.global_secondary_indexes #=> Hash
|
3114
|
+
# resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3115
|
+
# resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3116
|
+
# resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
|
3117
|
+
# resp.last_evaluated_key #=> Hash
|
3118
|
+
# resp.last_evaluated_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
2963
3119
|
#
|
2964
3120
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatement AWS API Documentation
|
2965
3121
|
#
|
@@ -2973,6 +3129,18 @@ module Aws::DynamoDB
|
|
2973
3129
|
# This operation allows you to perform transactional reads or writes on
|
2974
3130
|
# data stored in DynamoDB, using PartiQL.
|
2975
3131
|
#
|
3132
|
+
# <note markdown="1"> The entire transaction must consist of either read statements or write
|
3133
|
+
# statements, you cannot mix both in one transaction. The EXISTS
|
3134
|
+
# function is an exception and can be used to check the condition of
|
3135
|
+
# specific attributes of the item in a similar manner to
|
3136
|
+
# `ConditionCheck` in the [TransactWriteItems][1] API.
|
3137
|
+
#
|
3138
|
+
# </note>
|
3139
|
+
#
|
3140
|
+
#
|
3141
|
+
#
|
3142
|
+
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html#transaction-apis-txwriteitems
|
3143
|
+
#
|
2976
3144
|
# @option params [required, Array<Types::ParameterizedStatement>] :transact_statements
|
2977
3145
|
# The list of PartiQL statements representing the transaction to run.
|
2978
3146
|
#
|
@@ -2983,9 +3151,20 @@ module Aws::DynamoDB
|
|
2983
3151
|
# **A suitable default value is auto-generated.** You should normally
|
2984
3152
|
# not need to pass this option.**
|
2985
3153
|
#
|
3154
|
+
# @option params [String] :return_consumed_capacity
|
3155
|
+
# Determines the level of detail about either provisioned or on-demand
|
3156
|
+
# throughput consumption that is returned in the response. For more
|
3157
|
+
# information, see [TransactGetItems][1] and [TransactWriteItems][2].
|
3158
|
+
#
|
3159
|
+
#
|
3160
|
+
#
|
3161
|
+
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html
|
3162
|
+
# [2]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html
|
3163
|
+
#
|
2986
3164
|
# @return [Types::ExecuteTransactionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2987
3165
|
#
|
2988
3166
|
# * {Types::ExecuteTransactionOutput#responses #responses} => Array<Types::ItemResponse>
|
3167
|
+
# * {Types::ExecuteTransactionOutput#consumed_capacity #consumed_capacity} => Array<Types::ConsumedCapacity>
|
2989
3168
|
#
|
2990
3169
|
# @example Request syntax with placeholder values
|
2991
3170
|
#
|
@@ -2997,6 +3176,7 @@ module Aws::DynamoDB
|
|
2997
3176
|
# },
|
2998
3177
|
# ],
|
2999
3178
|
# client_request_token: "ClientRequestToken",
|
3179
|
+
# return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
|
3000
3180
|
# })
|
3001
3181
|
#
|
3002
3182
|
# @example Response structure
|
@@ -3004,6 +3184,22 @@ module Aws::DynamoDB
|
|
3004
3184
|
# resp.responses #=> Array
|
3005
3185
|
# resp.responses[0].item #=> Hash
|
3006
3186
|
# resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
3187
|
+
# resp.consumed_capacity #=> Array
|
3188
|
+
# resp.consumed_capacity[0].table_name #=> String
|
3189
|
+
# resp.consumed_capacity[0].capacity_units #=> Float
|
3190
|
+
# resp.consumed_capacity[0].read_capacity_units #=> Float
|
3191
|
+
# resp.consumed_capacity[0].write_capacity_units #=> Float
|
3192
|
+
# resp.consumed_capacity[0].table.read_capacity_units #=> Float
|
3193
|
+
# resp.consumed_capacity[0].table.write_capacity_units #=> Float
|
3194
|
+
# resp.consumed_capacity[0].table.capacity_units #=> Float
|
3195
|
+
# resp.consumed_capacity[0].local_secondary_indexes #=> Hash
|
3196
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3197
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3198
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
|
3199
|
+
# resp.consumed_capacity[0].global_secondary_indexes #=> Hash
|
3200
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3201
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3202
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
|
3007
3203
|
#
|
3008
3204
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteTransaction AWS API Documentation
|
3009
3205
|
#
|
@@ -3047,8 +3243,8 @@ module Aws::DynamoDB
|
|
3047
3243
|
# The name of the Amazon S3 bucket to export the snapshot to.
|
3048
3244
|
#
|
3049
3245
|
# @option params [String] :s3_bucket_owner
|
3050
|
-
# The ID of the
|
3051
|
-
# stored in.
|
3246
|
+
# The ID of the Amazon Web Services account that owns the bucket the
|
3247
|
+
# export will be stored in.
|
3052
3248
|
#
|
3053
3249
|
# @option params [String] :s3_prefix
|
3054
3250
|
# The Amazon S3 bucket prefix to use as the file name and path of the
|
@@ -3060,10 +3256,10 @@ module Aws::DynamoDB
|
|
3060
3256
|
#
|
3061
3257
|
# * `AES256` - server-side encryption with Amazon S3 managed keys
|
3062
3258
|
#
|
3063
|
-
# * `KMS` - server-side encryption with
|
3259
|
+
# * `KMS` - server-side encryption with KMS managed keys
|
3064
3260
|
#
|
3065
3261
|
# @option params [String] :s3_sse_kms_key_id
|
3066
|
-
# The ID of the
|
3262
|
+
# The ID of the KMS managed key used to encrypt the S3 bucket where
|
3067
3263
|
# export data will be stored (if applicable).
|
3068
3264
|
#
|
3069
3265
|
# @option params [String] :export_format
|
@@ -3157,8 +3353,8 @@ module Aws::DynamoDB
|
|
3157
3353
|
# uses eventually consistent reads.
|
3158
3354
|
#
|
3159
3355
|
# @option params [String] :return_consumed_capacity
|
3160
|
-
# Determines the level of detail about provisioned
|
3161
|
-
# consumption that is returned in the response:
|
3356
|
+
# Determines the level of detail about either provisioned or on-demand
|
3357
|
+
# throughput consumption that is returned in the response:
|
3162
3358
|
#
|
3163
3359
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
3164
3360
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -3314,10 +3510,11 @@ module Aws::DynamoDB
|
|
3314
3510
|
req.send_request(options)
|
3315
3511
|
end
|
3316
3512
|
|
3317
|
-
# List backups associated with an
|
3318
|
-
# given table, specify `TableName`. `ListBackups` returns
|
3319
|
-
# list of results with at most 1 MB worth of items in a
|
3320
|
-
# also specify a maximum number of entries to be returned
|
3513
|
+
# List backups associated with an Amazon Web Services account. To list
|
3514
|
+
# backups for a given table, specify `TableName`. `ListBackups` returns
|
3515
|
+
# a paginated list of results with at most 1 MB worth of items in a
|
3516
|
+
# page. You can also specify a maximum number of entries to be returned
|
3517
|
+
# in a page.
|
3321
3518
|
#
|
3322
3519
|
# In the request, start time is inclusive, but end time is exclusive.
|
3323
3520
|
# Note that these boundaries are for the time at which the original
|
@@ -3660,26 +3857,26 @@ module Aws::DynamoDB
|
|
3660
3857
|
#
|
3661
3858
|
# This topic provides general information about the `PutItem` API.
|
3662
3859
|
#
|
3663
|
-
# For information on how to call the `PutItem` API using the
|
3664
|
-
# specific languages, see the following:
|
3860
|
+
# For information on how to call the `PutItem` API using the Amazon Web
|
3861
|
+
# Services SDK in specific languages, see the following:
|
3665
3862
|
#
|
3666
|
-
# * [ PutItem in the
|
3863
|
+
# * [ PutItem in the Command Line Interface][1]
|
3667
3864
|
#
|
3668
|
-
# * [ PutItem in the
|
3865
|
+
# * [ PutItem in the SDK for .NET][2]
|
3669
3866
|
#
|
3670
|
-
# * [ PutItem in the
|
3867
|
+
# * [ PutItem in the SDK for C++][3]
|
3671
3868
|
#
|
3672
|
-
# * [ PutItem in the
|
3869
|
+
# * [ PutItem in the SDK for Go][4]
|
3673
3870
|
#
|
3674
|
-
# * [ PutItem in the
|
3871
|
+
# * [ PutItem in the SDK for Java][5]
|
3675
3872
|
#
|
3676
|
-
# * [ PutItem in the
|
3873
|
+
# * [ PutItem in the SDK for JavaScript][6]
|
3677
3874
|
#
|
3678
|
-
# * [ PutItem in the
|
3875
|
+
# * [ PutItem in the SDK for PHP V3][7]
|
3679
3876
|
#
|
3680
|
-
# * [ PutItem in the
|
3877
|
+
# * [ PutItem in the SDK for Python (Boto)][8]
|
3681
3878
|
#
|
3682
|
-
# * [ PutItem in the
|
3879
|
+
# * [ PutItem in the SDK for Ruby V2][9]
|
3683
3880
|
#
|
3684
3881
|
# When you add an item, the primary key attributes are the only required
|
3685
3882
|
# attributes. Attribute values cannot be null.
|
@@ -3768,6 +3965,8 @@ module Aws::DynamoDB
|
|
3768
3965
|
# * `ALL_OLD` - If `PutItem` overwrote an attribute name-value pair,
|
3769
3966
|
# then the content of the old item is returned.
|
3770
3967
|
#
|
3968
|
+
# The values returned are strongly consistent.
|
3969
|
+
#
|
3771
3970
|
# <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
|
3772
3971
|
# however, `PutItem` does not recognize any values other than `NONE` or
|
3773
3972
|
# `ALL_OLD`.
|
@@ -3775,8 +3974,8 @@ module Aws::DynamoDB
|
|
3775
3974
|
# </note>
|
3776
3975
|
#
|
3777
3976
|
# @option params [String] :return_consumed_capacity
|
3778
|
-
# Determines the level of detail about provisioned
|
3779
|
-
# consumption that is returned in the response:
|
3977
|
+
# Determines the level of detail about either provisioned or on-demand
|
3978
|
+
# throughput consumption that is returned in the response:
|
3780
3979
|
#
|
3781
3980
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
3782
3981
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -3995,9 +4194,10 @@ module Aws::DynamoDB
|
|
3995
4194
|
req.send_request(options)
|
3996
4195
|
end
|
3997
4196
|
|
3998
|
-
#
|
3999
|
-
#
|
4000
|
-
# partition key
|
4197
|
+
# You must provide the name of the partition key attribute and a single
|
4198
|
+
# value for that attribute. `Query` returns all items with that
|
4199
|
+
# partition key value. Optionally, you can provide a sort key attribute
|
4200
|
+
# and use a comparison operator to refine the search results.
|
4001
4201
|
#
|
4002
4202
|
# Use the `KeyConditionExpression` parameter to provide a specific value
|
4003
4203
|
# for the partition key. The `Query` operation will return all of the
|
@@ -4204,8 +4404,8 @@ module Aws::DynamoDB
|
|
4204
4404
|
# Binary. No set data types are allowed.
|
4205
4405
|
#
|
4206
4406
|
# @option params [String] :return_consumed_capacity
|
4207
|
-
# Determines the level of detail about provisioned
|
4208
|
-
# consumption that is returned in the response:
|
4407
|
+
# Determines the level of detail about either provisioned or on-demand
|
4408
|
+
# throughput consumption that is returned in the response:
|
4209
4409
|
#
|
4210
4410
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
4211
4411
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -4697,6 +4897,8 @@ module Aws::DynamoDB
|
|
4697
4897
|
# resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
|
4698
4898
|
# resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
4699
4899
|
# resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
|
4900
|
+
# resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
4901
|
+
# resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
|
4700
4902
|
# resp.table_description.restore_summary.source_backup_arn #=> String
|
4701
4903
|
# resp.table_description.restore_summary.source_table_arn #=> String
|
4702
4904
|
# resp.table_description.restore_summary.restore_date_time #=> Time
|
@@ -4708,6 +4910,8 @@ module Aws::DynamoDB
|
|
4708
4910
|
# resp.table_description.archival_summary.archival_date_time #=> Time
|
4709
4911
|
# resp.table_description.archival_summary.archival_reason #=> String
|
4710
4912
|
# resp.table_description.archival_summary.archival_backup_arn #=> String
|
4913
|
+
# resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
4914
|
+
# resp.table_description.table_class_summary.last_update_date_time #=> Time
|
4711
4915
|
#
|
4712
4916
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableFromBackup AWS API Documentation
|
4713
4917
|
#
|
@@ -4920,6 +5124,8 @@ module Aws::DynamoDB
|
|
4920
5124
|
# resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
|
4921
5125
|
# resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
4922
5126
|
# resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
|
5127
|
+
# resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
5128
|
+
# resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
|
4923
5129
|
# resp.table_description.restore_summary.source_backup_arn #=> String
|
4924
5130
|
# resp.table_description.restore_summary.source_table_arn #=> String
|
4925
5131
|
# resp.table_description.restore_summary.restore_date_time #=> Time
|
@@ -4931,6 +5137,8 @@ module Aws::DynamoDB
|
|
4931
5137
|
# resp.table_description.archival_summary.archival_date_time #=> Time
|
4932
5138
|
# resp.table_description.archival_summary.archival_reason #=> String
|
4933
5139
|
# resp.table_description.archival_summary.archival_backup_arn #=> String
|
5140
|
+
# resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
5141
|
+
# resp.table_description.table_class_summary.last_update_date_time #=> Time
|
4934
5142
|
#
|
4935
5143
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableToPointInTime AWS API Documentation
|
4936
5144
|
#
|
@@ -5092,8 +5300,8 @@ module Aws::DynamoDB
|
|
5092
5300
|
# corresponding value of `LastEvaluatedKey`.
|
5093
5301
|
#
|
5094
5302
|
# @option params [String] :return_consumed_capacity
|
5095
|
-
# Determines the level of detail about provisioned
|
5096
|
-
# consumption that is returned in the response:
|
5303
|
+
# Determines the level of detail about either provisioned or on-demand
|
5304
|
+
# throughput consumption that is returned in the response:
|
5097
5305
|
#
|
5098
5306
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
5099
5307
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -5431,8 +5639,8 @@ module Aws::DynamoDB
|
|
5431
5639
|
# contain up to 25 `TransactGetItem` objects, each of which contains a
|
5432
5640
|
# `Get` structure that specifies an item to retrieve from a table in the
|
5433
5641
|
# account and Region. A call to `TransactGetItems` cannot retrieve items
|
5434
|
-
# from tables in more than one
|
5435
|
-
# of the items in the transaction cannot exceed 4 MB.
|
5642
|
+
# from tables in more than one Amazon Web Services account or Region.
|
5643
|
+
# The aggregate size of the items in the transaction cannot exceed 4 MB.
|
5436
5644
|
#
|
5437
5645
|
# DynamoDB rejects the entire `TransactGetItems` request if any of the
|
5438
5646
|
# following is true:
|
@@ -5515,10 +5723,10 @@ module Aws::DynamoDB
|
|
5515
5723
|
|
5516
5724
|
# `TransactWriteItems` is a synchronous write operation that groups up
|
5517
5725
|
# to 25 action requests. These actions can target items in different
|
5518
|
-
# tables, but not in different
|
5519
|
-
# actions can target the same item. For example, you cannot
|
5520
|
-
# `ConditionCheck` and `Update` the same item. The aggregate size
|
5521
|
-
# items in the transaction cannot exceed 4 MB.
|
5726
|
+
# tables, but not in different Amazon Web Services accounts or Regions,
|
5727
|
+
# and no two actions can target the same item. For example, you cannot
|
5728
|
+
# both `ConditionCheck` and `Update` the same item. The aggregate size
|
5729
|
+
# of the items in the transaction cannot exceed 4 MB.
|
5522
5730
|
#
|
5523
5731
|
# The actions are completed atomically so that either all of them
|
5524
5732
|
# succeed, or all of them fail. They are defined by the following
|
@@ -5575,12 +5783,12 @@ module Aws::DynamoDB
|
|
5575
5783
|
# An ordered array of up to 25 `TransactWriteItem` objects, each of
|
5576
5784
|
# which contains a `ConditionCheck`, `Put`, `Update`, or `Delete`
|
5577
5785
|
# object. These can operate on items in different tables, but the tables
|
5578
|
-
# must reside in the same
|
5579
|
-
# operate on the same item.
|
5786
|
+
# must reside in the same Amazon Web Services account and Region, and no
|
5787
|
+
# two of them can operate on the same item.
|
5580
5788
|
#
|
5581
5789
|
# @option params [String] :return_consumed_capacity
|
5582
|
-
# Determines the level of detail about provisioned
|
5583
|
-
# consumption that is returned in the response:
|
5790
|
+
# Determines the level of detail about either provisioned or on-demand
|
5791
|
+
# throughput consumption that is returned in the response:
|
5584
5792
|
#
|
5585
5793
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
5586
5794
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -5822,7 +6030,13 @@ module Aws::DynamoDB
|
|
5822
6030
|
end
|
5823
6031
|
|
5824
6032
|
# Updates the status for contributor insights for a specific table or
|
5825
|
-
# index.
|
6033
|
+
# index. CloudWatch Contributor Insights for DynamoDB graphs display the
|
6034
|
+
# partition key and (if applicable) sort key of frequently accessed
|
6035
|
+
# items and frequently throttled items in plaintext. If you require the
|
6036
|
+
# use of Amazon Web Services Key Management Service (KMS) to encrypt
|
6037
|
+
# this table’s partition key and sort key data with an Amazon Web
|
6038
|
+
# Services managed key or customer managed key, you should not enable
|
6039
|
+
# CloudWatch Contributor Insights for DynamoDB for this table.
|
5826
6040
|
#
|
5827
6041
|
# @option params [required, String] :table_name
|
5828
6042
|
# The name of the table.
|
@@ -5925,6 +6139,8 @@ module Aws::DynamoDB
|
|
5925
6139
|
# resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
|
5926
6140
|
# resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
5927
6141
|
# resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
|
6142
|
+
# resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
6143
|
+
# resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
|
5928
6144
|
# resp.global_table_description.global_table_arn #=> String
|
5929
6145
|
# resp.global_table_description.creation_date_time #=> Time
|
5930
6146
|
# resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
|
@@ -6065,6 +6281,7 @@ module Aws::DynamoDB
|
|
6065
6281
|
# },
|
6066
6282
|
# },
|
6067
6283
|
# ],
|
6284
|
+
# replica_table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
|
6068
6285
|
# },
|
6069
6286
|
# ],
|
6070
6287
|
# })
|
@@ -6124,6 +6341,8 @@ module Aws::DynamoDB
|
|
6124
6341
|
# resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_in_cooldown #=> Integer
|
6125
6342
|
# resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.scale_out_cooldown #=> Integer
|
6126
6343
|
# resp.replica_settings[0].replica_global_secondary_index_settings[0].provisioned_write_capacity_auto_scaling_settings.scaling_policies[0].target_tracking_scaling_policy_configuration.target_value #=> Float
|
6344
|
+
# resp.replica_settings[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
6345
|
+
# resp.replica_settings[0].replica_table_class_summary.last_update_date_time #=> Time
|
6127
6346
|
#
|
6128
6347
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateGlobalTableSettings AWS API Documentation
|
6129
6348
|
#
|
@@ -6211,8 +6430,8 @@ module Aws::DynamoDB
|
|
6211
6430
|
# The values returned are strongly consistent.
|
6212
6431
|
#
|
6213
6432
|
# @option params [String] :return_consumed_capacity
|
6214
|
-
# Determines the level of detail about provisioned
|
6215
|
-
# consumption that is returned in the response:
|
6433
|
+
# Determines the level of detail about either provisioned or on-demand
|
6434
|
+
# throughput consumption that is returned in the response:
|
6216
6435
|
#
|
6217
6436
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
6218
6437
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -6629,6 +6848,10 @@ module Aws::DynamoDB
|
|
6629
6848
|
#
|
6630
6849
|
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
|
6631
6850
|
#
|
6851
|
+
# @option params [String] :table_class
|
6852
|
+
# The table class of the table to be updated. Valid values are
|
6853
|
+
# `STANDARD` and `STANDARD_INFREQUENT_ACCESS`.
|
6854
|
+
#
|
6632
6855
|
# @return [Types::UpdateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6633
6856
|
#
|
6634
6857
|
# * {Types::UpdateTableOutput#table_description #table_description} => Types::TableDescription
|
@@ -6754,6 +6977,7 @@ module Aws::DynamoDB
|
|
6754
6977
|
# },
|
6755
6978
|
# },
|
6756
6979
|
# ],
|
6980
|
+
# table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
|
6757
6981
|
# },
|
6758
6982
|
# update: {
|
6759
6983
|
# region_name: "RegionName", # required
|
@@ -6769,12 +6993,14 @@ module Aws::DynamoDB
|
|
6769
6993
|
# },
|
6770
6994
|
# },
|
6771
6995
|
# ],
|
6996
|
+
# table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
|
6772
6997
|
# },
|
6773
6998
|
# delete: {
|
6774
6999
|
# region_name: "RegionName", # required
|
6775
7000
|
# },
|
6776
7001
|
# },
|
6777
7002
|
# ],
|
7003
|
+
# table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
|
6778
7004
|
# })
|
6779
7005
|
#
|
6780
7006
|
# @example Response structure
|
@@ -6844,6 +7070,8 @@ module Aws::DynamoDB
|
|
6844
7070
|
# resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
|
6845
7071
|
# resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
|
6846
7072
|
# resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
|
7073
|
+
# resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
7074
|
+
# resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
|
6847
7075
|
# resp.table_description.restore_summary.source_backup_arn #=> String
|
6848
7076
|
# resp.table_description.restore_summary.source_table_arn #=> String
|
6849
7077
|
# resp.table_description.restore_summary.restore_date_time #=> Time
|
@@ -6855,6 +7083,8 @@ module Aws::DynamoDB
|
|
6855
7083
|
# resp.table_description.archival_summary.archival_date_time #=> Time
|
6856
7084
|
# resp.table_description.archival_summary.archival_reason #=> String
|
6857
7085
|
# resp.table_description.archival_summary.archival_backup_arn #=> String
|
7086
|
+
# resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
|
7087
|
+
# resp.table_description.table_class_summary.last_update_date_time #=> Time
|
6858
7088
|
#
|
6859
7089
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTable AWS API Documentation
|
6860
7090
|
#
|
@@ -7121,7 +7351,7 @@ module Aws::DynamoDB
|
|
7121
7351
|
params: params,
|
7122
7352
|
config: config)
|
7123
7353
|
context[:gem_name] = 'aws-sdk-dynamodb'
|
7124
|
-
context[:gem_version] = '1.
|
7354
|
+
context[:gem_version] = '1.74.0'
|
7125
7355
|
Seahorse::Client::Request.new(handlers, context)
|
7126
7356
|
end
|
7127
7357
|
|