aws-sdk-dynamodb 1.60.0 → 1.80.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -27,7 +27,10 @@ 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/signature_v4.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'
33
+ require 'aws-sdk-core/plugins/sign.rb'
31
34
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
32
35
  require 'aws-sdk-dynamodb/plugins/extended_retries.rb'
33
36
  require 'aws-sdk-dynamodb/plugins/simple_attributes.rb'
@@ -76,11 +79,15 @@ module Aws::DynamoDB
76
79
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
77
80
  add_plugin(Aws::Plugins::TransferEncoding)
78
81
  add_plugin(Aws::Plugins::HttpChecksum)
79
- add_plugin(Aws::Plugins::SignatureV4)
82
+ add_plugin(Aws::Plugins::ChecksumAlgorithm)
83
+ add_plugin(Aws::Plugins::DefaultsMode)
84
+ add_plugin(Aws::Plugins::RecursionDetection)
85
+ add_plugin(Aws::Plugins::Sign)
80
86
  add_plugin(Aws::Plugins::Protocols::JsonRpc)
81
87
  add_plugin(Aws::DynamoDB::Plugins::ExtendedRetries)
82
88
  add_plugin(Aws::DynamoDB::Plugins::SimpleAttributes)
83
89
  add_plugin(Aws::DynamoDB::Plugins::CRC32Validation)
90
+ add_plugin(Aws::DynamoDB::Plugins::Endpoints)
84
91
 
85
92
  # @overload initialize(options)
86
93
  # @param [Hash] options
@@ -125,7 +132,9 @@ module Aws::DynamoDB
125
132
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
126
133
  # are very aggressive. Construct and pass an instance of
127
134
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
128
- # enable retries and extended timeouts.
135
+ # enable retries and extended timeouts. Instance profile credential
136
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
137
+ # to true.
129
138
  #
130
139
  # @option options [required, String] :region
131
140
  # The AWS region to connect to. The configured `:region` is
@@ -185,6 +194,10 @@ module Aws::DynamoDB
185
194
  # Used only in `standard` and adaptive retry modes. Specifies whether to apply
186
195
  # a clock skew correction and retry requests with skewed client clocks.
187
196
  #
197
+ # @option options [String] :defaults_mode ("legacy")
198
+ # See {Aws::DefaultsModeConfiguration} for a list of the
199
+ # accepted modes and the configuration defaults that are included.
200
+ #
188
201
  # @option options [Boolean] :disable_host_prefix_injection (false)
189
202
  # Set to true to disable SDK automatically adding host prefix
190
203
  # to default service endpoint when available.
@@ -304,10 +317,35 @@ module Aws::DynamoDB
304
317
  # ** Please note ** When response stubbing is enabled, no HTTP
305
318
  # requests are made, and retries are disabled.
306
319
  #
320
+ # @option options [Aws::TokenProvider] :token_provider
321
+ # A Bearer Token Provider. This can be an instance of any one of the
322
+ # following classes:
323
+ #
324
+ # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
325
+ # tokens.
326
+ #
327
+ # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
328
+ # access token generated from `aws login`.
329
+ #
330
+ # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
331
+ # will be used to search for tokens configured for your profile in shared configuration files.
332
+ #
333
+ # @option options [Boolean] :use_dualstack_endpoint
334
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
335
+ # will be used if available.
336
+ #
337
+ # @option options [Boolean] :use_fips_endpoint
338
+ # When set to `true`, fips compatible endpoints will be used if available.
339
+ # When a `fips` region is used, the region is normalized and this config
340
+ # is set to `true`.
341
+ #
307
342
  # @option options [Boolean] :validate_params (true)
308
343
  # When `true`, request parameters are validated before
309
344
  # sending the request.
310
345
  #
346
+ # @option options [Aws::DynamoDB::EndpointProvider] :endpoint_provider
347
+ # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::DynamoDB::EndpointParameters`
348
+ #
311
349
  # @option options [URI::HTTP,String] :http_proxy A proxy to send
312
350
  # requests through. Formatted like 'http://proxy.com:123'.
313
351
  #
@@ -315,7 +353,7 @@ module Aws::DynamoDB
315
353
  # seconds to wait when opening a HTTP session before raising a
316
354
  # `Timeout::Error`.
317
355
  #
318
- # @option options [Integer] :http_read_timeout (60) The default
356
+ # @option options [Float] :http_read_timeout (60) The default
319
357
  # number of seconds to wait for response data. This value can
320
358
  # safely be set per-request on the session.
321
359
  #
@@ -331,6 +369,9 @@ module Aws::DynamoDB
331
369
  # disables this behaviour. This value can safely be set per
332
370
  # request on the session.
333
371
  #
372
+ # @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
373
+ # in seconds.
374
+ #
334
375
  # @option options [Boolean] :http_wire_trace (false) When `true`,
335
376
  # HTTP debug output will be sent to the `:logger`.
336
377
  #
@@ -356,15 +397,50 @@ module Aws::DynamoDB
356
397
 
357
398
  # @!group API Operations
358
399
 
359
- # This operation allows you to perform batch reads and writes on data
360
- # stored in DynamoDB, using PartiQL.
400
+ # This operation allows you to perform batch reads or writes on data
401
+ # stored in DynamoDB, using PartiQL. Each read statement in a
402
+ # `BatchExecuteStatement` must specify an equality condition on all key
403
+ # attributes. This enforces that each `SELECT` statement in a batch
404
+ # returns at most a single item.
405
+ #
406
+ # <note markdown="1"> The entire batch must consist of either read statements or write
407
+ # statements, you cannot mix both in one batch.
408
+ #
409
+ # </note>
410
+ #
411
+ # A HTTP 200 response does not mean that all statements in the
412
+ # BatchExecuteStatement succeeded. Error details for individual
413
+ # statements can be found under the [Error][1] field of the
414
+ # `BatchStatementResponse` for each statement.
415
+ #
416
+ #
417
+ #
418
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_BatchStatementResponse.html#DDB-Type-BatchStatementResponse-Error
361
419
  #
362
420
  # @option params [required, Array<Types::BatchStatementRequest>] :statements
363
421
  # The list of PartiQL statements representing the batch to run.
364
422
  #
423
+ # @option params [String] :return_consumed_capacity
424
+ # Determines the level of detail about either provisioned or on-demand
425
+ # throughput consumption that is returned in the response:
426
+ #
427
+ # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
428
+ # for the operation, together with `ConsumedCapacity` for each table
429
+ # and secondary index that was accessed.
430
+ #
431
+ # Note that some operations, such as `GetItem` and `BatchGetItem`, do
432
+ # not access any indexes at all. In these cases, specifying `INDEXES`
433
+ # will only return `ConsumedCapacity` information for table(s).
434
+ #
435
+ # * `TOTAL` - The response includes only the aggregate
436
+ # `ConsumedCapacity` for the operation.
437
+ #
438
+ # * `NONE` - No `ConsumedCapacity` details are included in the response.
439
+ #
365
440
  # @return [Types::BatchExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
366
441
  #
367
442
  # * {Types::BatchExecuteStatementOutput#responses #responses} => Array&lt;Types::BatchStatementResponse&gt;
443
+ # * {Types::BatchExecuteStatementOutput#consumed_capacity #consumed_capacity} => Array&lt;Types::ConsumedCapacity&gt;
368
444
  #
369
445
  # @example Request syntax with placeholder values
370
446
  #
@@ -376,6 +452,7 @@ module Aws::DynamoDB
376
452
  # consistent_read: false,
377
453
  # },
378
454
  # ],
455
+ # return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
379
456
  # })
380
457
  #
381
458
  # @example Response structure
@@ -386,6 +463,22 @@ module Aws::DynamoDB
386
463
  # resp.responses[0].table_name #=> String
387
464
  # resp.responses[0].item #=> Hash
388
465
  # resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
466
+ # resp.consumed_capacity #=> Array
467
+ # resp.consumed_capacity[0].table_name #=> String
468
+ # resp.consumed_capacity[0].capacity_units #=> Float
469
+ # resp.consumed_capacity[0].read_capacity_units #=> Float
470
+ # resp.consumed_capacity[0].write_capacity_units #=> Float
471
+ # resp.consumed_capacity[0].table.read_capacity_units #=> Float
472
+ # resp.consumed_capacity[0].table.write_capacity_units #=> Float
473
+ # resp.consumed_capacity[0].table.capacity_units #=> Float
474
+ # resp.consumed_capacity[0].local_secondary_indexes #=> Hash
475
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
476
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
477
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
478
+ # resp.consumed_capacity[0].global_secondary_indexes #=> Hash
479
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
480
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
481
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
389
482
  #
390
483
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchExecuteStatement AWS API Documentation
391
484
  #
@@ -547,8 +640,8 @@ module Aws::DynamoDB
547
640
  # [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html
548
641
  #
549
642
  # @option params [String] :return_consumed_capacity
550
- # Determines the level of detail about provisioned throughput
551
- # consumption that is returned in the response:
643
+ # Determines the level of detail about either provisioned or on-demand
644
+ # throughput consumption that is returned in the response:
552
645
  #
553
646
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
554
647
  # for the operation, together with `ConsumedCapacity` for each table
@@ -680,12 +773,19 @@ module Aws::DynamoDB
680
773
  end
681
774
 
682
775
  # The `BatchWriteItem` operation puts or deletes multiple items in one
683
- # or more tables. A single call to `BatchWriteItem` can write up to 16
684
- # MB of data, which can comprise as many as 25 put or delete requests.
685
- # Individual items to be written can be as large as 400 KB.
686
- #
687
- # <note markdown="1"> `BatchWriteItem` cannot update items. To update items, use the
688
- # `UpdateItem` action.
776
+ # or more tables. A single call to `BatchWriteItem` can transmit up to
777
+ # 16MB of data over the network, consisting of up to 25 item put or
778
+ # delete operations. While individual items can be up to 400 KB once
779
+ # stored, it's important to note that an item's representation might
780
+ # be greater than 400KB while being sent in DynamoDB's JSON format for
781
+ # the API call. For more details on this distinction, see [Naming Rules
782
+ # and Data Types][1].
783
+ #
784
+ # <note markdown="1"> `BatchWriteItem` cannot update items. If you perform a
785
+ # `BatchWriteItem` operation on an existing item, that item's values
786
+ # will be overwritten by the operation and it will appear like it was
787
+ # updated. To update items, we recommend you use the `UpdateItem`
788
+ # action.
689
789
  #
690
790
  # </note>
691
791
  #
@@ -712,7 +812,7 @@ module Aws::DynamoDB
712
812
  # operation using exponential backoff, the individual requests in the
713
813
  # batch are much more likely to succeed.
714
814
  #
715
- # For more information, see [Batch Operations and Error Handling][1] in
815
+ # For more information, see [Batch Operations and Error Handling][2] in
716
816
  # the *Amazon DynamoDB Developer Guide*.
717
817
  #
718
818
  # With `BatchWriteItem`, you can efficiently write or delete large
@@ -761,7 +861,8 @@ module Aws::DynamoDB
761
861
  #
762
862
  #
763
863
  #
764
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#Programming.Errors.BatchOperations
864
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html
865
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ErrorHandling.html#Programming.Errors.BatchOperations
765
866
  #
766
867
  # @option params [required, Hash<String,Array>] :request_items
767
868
  # A map of one or more table names and, for each table, a list of
@@ -796,8 +897,8 @@ module Aws::DynamoDB
796
897
  # in the table's attribute definition.
797
898
  #
798
899
  # @option params [String] :return_consumed_capacity
799
- # Determines the level of detail about provisioned throughput
800
- # consumption that is returned in the response:
900
+ # Determines the level of detail about either provisioned or on-demand
901
+ # throughput consumption that is returned in the response:
801
902
  #
802
903
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
803
904
  # for the operation, together with `ConsumedCapacity` for each table
@@ -1085,6 +1186,8 @@ module Aws::DynamoDB
1085
1186
  # resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
1086
1187
  # resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
1087
1188
  # resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
1189
+ # resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
1190
+ # resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
1088
1191
  # resp.global_table_description.global_table_arn #=> String
1089
1192
  # resp.global_table_description.creation_date_time #=> Time
1090
1193
  # resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
@@ -1100,9 +1203,9 @@ module Aws::DynamoDB
1100
1203
  end
1101
1204
 
1102
1205
  # The `CreateTable` operation adds a new table to your account. In an
1103
- # AWS account, table names must be unique within each Region. That is,
1104
- # you can have two tables with same name if you create the tables in
1105
- # different Regions.
1206
+ # Amazon Web Services account, table names must be unique within each
1207
+ # Region. That is, you can have two tables with same name if you create
1208
+ # the tables in different Regions.
1106
1209
  #
1107
1210
  # `CreateTable` is an asynchronous operation. Upon receiving a
1108
1211
  # `CreateTable` request, DynamoDB immediately returns a response with a
@@ -1319,6 +1422,10 @@ module Aws::DynamoDB
1319
1422
  #
1320
1423
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.html
1321
1424
  #
1425
+ # @option params [String] :table_class
1426
+ # The table class of the new table. Valid values are `STANDARD` and
1427
+ # `STANDARD_INFREQUENT_ACCESS`.
1428
+ #
1322
1429
  # @return [Types::CreateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1323
1430
  #
1324
1431
  # * {Types::CreateTableOutput#table_description #table_description} => Types::TableDescription
@@ -1461,6 +1568,7 @@ module Aws::DynamoDB
1461
1568
  # value: "TagValueString", # required
1462
1569
  # },
1463
1570
  # ],
1571
+ # table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
1464
1572
  # })
1465
1573
  #
1466
1574
  # @example Response structure
@@ -1530,6 +1638,8 @@ module Aws::DynamoDB
1530
1638
  # resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
1531
1639
  # resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
1532
1640
  # resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
1641
+ # resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
1642
+ # resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
1533
1643
  # resp.table_description.restore_summary.source_backup_arn #=> String
1534
1644
  # resp.table_description.restore_summary.source_table_arn #=> String
1535
1645
  # resp.table_description.restore_summary.restore_date_time #=> Time
@@ -1541,6 +1651,8 @@ module Aws::DynamoDB
1541
1651
  # resp.table_description.archival_summary.archival_date_time #=> Time
1542
1652
  # resp.table_description.archival_summary.archival_reason #=> String
1543
1653
  # resp.table_description.archival_summary.archival_backup_arn #=> String
1654
+ # resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
1655
+ # resp.table_description.table_class_summary.last_update_date_time #=> Time
1544
1656
  #
1545
1657
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateTable AWS API Documentation
1546
1658
  #
@@ -1682,6 +1794,10 @@ module Aws::DynamoDB
1682
1794
  #
1683
1795
  # * `ALL_OLD` - The content of the old item is returned.
1684
1796
  #
1797
+ # There is no additional cost associated with requesting a return value
1798
+ # aside from the small network and processing overhead of receiving a
1799
+ # larger response. No read capacity units are consumed.
1800
+ #
1685
1801
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
1686
1802
  # however, `DeleteItem` does not recognize any values other than `NONE`
1687
1803
  # or `ALL_OLD`.
@@ -1689,8 +1805,8 @@ module Aws::DynamoDB
1689
1805
  # </note>
1690
1806
  #
1691
1807
  # @option params [String] :return_consumed_capacity
1692
- # Determines the level of detail about provisioned throughput
1693
- # consumption that is returned in the response:
1808
+ # Determines the level of detail about either provisioned or on-demand
1809
+ # throughput consumption that is returned in the response:
1694
1810
  #
1695
1811
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
1696
1812
  # for the operation, together with `ConsumedCapacity` for each table
@@ -2025,6 +2141,8 @@ module Aws::DynamoDB
2025
2141
  # resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
2026
2142
  # resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
2027
2143
  # resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
2144
+ # resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
2145
+ # resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
2028
2146
  # resp.table_description.restore_summary.source_backup_arn #=> String
2029
2147
  # resp.table_description.restore_summary.source_table_arn #=> String
2030
2148
  # resp.table_description.restore_summary.restore_date_time #=> Time
@@ -2036,6 +2154,8 @@ module Aws::DynamoDB
2036
2154
  # resp.table_description.archival_summary.archival_date_time #=> Time
2037
2155
  # resp.table_description.archival_summary.archival_reason #=> String
2038
2156
  # resp.table_description.archival_summary.archival_backup_arn #=> String
2157
+ # resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
2158
+ # resp.table_description.table_class_summary.last_update_date_time #=> Time
2039
2159
  #
2040
2160
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteTable AWS API Documentation
2041
2161
  #
@@ -2319,6 +2439,8 @@ module Aws::DynamoDB
2319
2439
  # resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
2320
2440
  # resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
2321
2441
  # resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
2442
+ # resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
2443
+ # resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
2322
2444
  # resp.global_table_description.global_table_arn #=> String
2323
2445
  # resp.global_table_description.creation_date_time #=> Time
2324
2446
  # resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
@@ -2413,6 +2535,8 @@ module Aws::DynamoDB
2413
2535
  # 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
2536
  # 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
2537
  # 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
2538
+ # resp.replica_settings[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
2539
+ # resp.replica_settings[0].replica_table_class_summary.last_update_date_time #=> Time
2416
2540
  #
2417
2541
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeGlobalTableSettings AWS API Documentation
2418
2542
  #
@@ -2423,6 +2547,79 @@ module Aws::DynamoDB
2423
2547
  req.send_request(options)
2424
2548
  end
2425
2549
 
2550
+ # Represents the properties of the import.
2551
+ #
2552
+ # @option params [required, String] :import_arn
2553
+ # The Amazon Resource Name (ARN) associated with the table you're
2554
+ # importing to.
2555
+ #
2556
+ # @return [Types::DescribeImportOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2557
+ #
2558
+ # * {Types::DescribeImportOutput#import_table_description #import_table_description} => Types::ImportTableDescription
2559
+ #
2560
+ # @example Request syntax with placeholder values
2561
+ #
2562
+ # resp = client.describe_import({
2563
+ # import_arn: "ImportArn", # required
2564
+ # })
2565
+ #
2566
+ # @example Response structure
2567
+ #
2568
+ # resp.import_table_description.import_arn #=> String
2569
+ # resp.import_table_description.import_status #=> String, one of "IN_PROGRESS", "COMPLETED", "CANCELLING", "CANCELLED", "FAILED"
2570
+ # resp.import_table_description.table_arn #=> String
2571
+ # resp.import_table_description.table_id #=> String
2572
+ # resp.import_table_description.client_token #=> String
2573
+ # resp.import_table_description.s3_bucket_source.s3_bucket_owner #=> String
2574
+ # resp.import_table_description.s3_bucket_source.s3_bucket #=> String
2575
+ # resp.import_table_description.s3_bucket_source.s3_key_prefix #=> String
2576
+ # resp.import_table_description.error_count #=> Integer
2577
+ # resp.import_table_description.cloud_watch_log_group_arn #=> String
2578
+ # resp.import_table_description.input_format #=> String, one of "DYNAMODB_JSON", "ION", "CSV"
2579
+ # resp.import_table_description.input_format_options.csv.delimiter #=> String
2580
+ # resp.import_table_description.input_format_options.csv.header_list #=> Array
2581
+ # resp.import_table_description.input_format_options.csv.header_list[0] #=> String
2582
+ # resp.import_table_description.input_compression_type #=> String, one of "GZIP", "ZSTD", "NONE"
2583
+ # resp.import_table_description.table_creation_parameters.table_name #=> String
2584
+ # resp.import_table_description.table_creation_parameters.attribute_definitions #=> Array
2585
+ # resp.import_table_description.table_creation_parameters.attribute_definitions[0].attribute_name #=> String
2586
+ # resp.import_table_description.table_creation_parameters.attribute_definitions[0].attribute_type #=> String, one of "S", "N", "B"
2587
+ # resp.import_table_description.table_creation_parameters.key_schema #=> Array
2588
+ # resp.import_table_description.table_creation_parameters.key_schema[0].attribute_name #=> String
2589
+ # resp.import_table_description.table_creation_parameters.key_schema[0].key_type #=> String, one of "HASH", "RANGE"
2590
+ # resp.import_table_description.table_creation_parameters.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
2591
+ # resp.import_table_description.table_creation_parameters.provisioned_throughput.read_capacity_units #=> Integer
2592
+ # resp.import_table_description.table_creation_parameters.provisioned_throughput.write_capacity_units #=> Integer
2593
+ # resp.import_table_description.table_creation_parameters.sse_specification.enabled #=> Boolean
2594
+ # resp.import_table_description.table_creation_parameters.sse_specification.sse_type #=> String, one of "AES256", "KMS"
2595
+ # resp.import_table_description.table_creation_parameters.sse_specification.kms_master_key_id #=> String
2596
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes #=> Array
2597
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].index_name #=> String
2598
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].key_schema #=> Array
2599
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].key_schema[0].attribute_name #=> String
2600
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
2601
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
2602
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.non_key_attributes #=> Array
2603
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
2604
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
2605
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
2606
+ # resp.import_table_description.start_time #=> Time
2607
+ # resp.import_table_description.end_time #=> Time
2608
+ # resp.import_table_description.processed_size_bytes #=> Integer
2609
+ # resp.import_table_description.processed_item_count #=> Integer
2610
+ # resp.import_table_description.imported_item_count #=> Integer
2611
+ # resp.import_table_description.failure_code #=> String
2612
+ # resp.import_table_description.failure_message #=> String
2613
+ #
2614
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeImport AWS API Documentation
2615
+ #
2616
+ # @overload describe_import(params = {})
2617
+ # @param [Hash] params ({})
2618
+ def describe_import(params = {}, options = {})
2619
+ req = build_request(:describe_import, params)
2620
+ req.send_request(options)
2621
+ end
2622
+
2426
2623
  # Returns information about the status of Kinesis streaming.
2427
2624
  #
2428
2625
  # @option params [required, String] :table_name
@@ -2456,25 +2653,26 @@ module Aws::DynamoDB
2456
2653
  req.send_request(options)
2457
2654
  end
2458
2655
 
2459
- # Returns the current provisioned-capacity quotas for your AWS account
2460
- # in a Region, both for the Region as a whole and for any one DynamoDB
2461
- # table that you create there.
2462
- #
2463
- # When you establish an AWS account, the account has initial quotas on
2464
- # the maximum read capacity units and write capacity units that you can
2465
- # provision across all of your DynamoDB tables in a given Region. Also,
2466
- # there are per-table quotas that apply when you create a table there.
2467
- # For more information, see [Service, Account, and Table Quotas][1] page
2468
- # in the *Amazon DynamoDB Developer Guide*.
2469
- #
2470
- # Although you can increase these quotas by filing a case at [AWS
2471
- # Support Center][2], obtaining the increase is not instantaneous. The
2472
- # `DescribeLimits` action lets you write code to compare the capacity
2473
- # you are currently using to those quotas imposed by your account so
2474
- # that you have enough time to apply for an increase before you hit a
2475
- # quota.
2476
- #
2477
- # For example, you could use one of the AWS SDKs to do the following:
2656
+ # Returns the current provisioned-capacity quotas for your Amazon Web
2657
+ # Services account in a Region, both for the Region as a whole and for
2658
+ # any one DynamoDB table that you create there.
2659
+ #
2660
+ # When you establish an Amazon Web Services account, the account has
2661
+ # initial quotas on the maximum read capacity units and write capacity
2662
+ # units that you can provision across all of your DynamoDB tables in a
2663
+ # given Region. Also, there are per-table quotas that apply when you
2664
+ # create a table there. For more information, see [Service, Account, and
2665
+ # Table Quotas][1] page in the *Amazon DynamoDB Developer Guide*.
2666
+ #
2667
+ # Although you can increase these quotas by filing a case at [Amazon Web
2668
+ # Services Support Center][2], obtaining the increase is not
2669
+ # instantaneous. The `DescribeLimits` action lets you write code to
2670
+ # compare the capacity you are currently using to those quotas imposed
2671
+ # by your account so that you have enough time to apply for an increase
2672
+ # before you hit a quota.
2673
+ #
2674
+ # For example, you could use one of the Amazon Web Services SDKs to do
2675
+ # the following:
2478
2676
  #
2479
2677
  # 1. Call `DescribeLimits` for a particular Region to obtain your
2480
2678
  # current account quotas on provisioned capacity there.
@@ -2703,6 +2901,8 @@ module Aws::DynamoDB
2703
2901
  # resp.table.replicas[0].global_secondary_indexes[0].index_name #=> String
2704
2902
  # resp.table.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
2705
2903
  # resp.table.replicas[0].replica_inaccessible_date_time #=> Time
2904
+ # resp.table.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
2905
+ # resp.table.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
2706
2906
  # resp.table.restore_summary.source_backup_arn #=> String
2707
2907
  # resp.table.restore_summary.source_table_arn #=> String
2708
2908
  # resp.table.restore_summary.restore_date_time #=> Time
@@ -2714,6 +2914,8 @@ module Aws::DynamoDB
2714
2914
  # resp.table.archival_summary.archival_date_time #=> Time
2715
2915
  # resp.table.archival_summary.archival_reason #=> String
2716
2916
  # resp.table.archival_summary.archival_backup_arn #=> String
2917
+ # resp.table.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
2918
+ # resp.table.table_class_summary.last_update_date_time #=> Time
2717
2919
  #
2718
2920
  #
2719
2921
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -2925,6 +3127,19 @@ module Aws::DynamoDB
2925
3127
  # This operation allows you to perform reads and singleton writes on
2926
3128
  # data stored in DynamoDB, using PartiQL.
2927
3129
  #
3130
+ # For PartiQL reads (`SELECT` statement), if the total number of
3131
+ # processed items exceeds the maximum dataset size limit of 1 MB, the
3132
+ # read stops and results are returned to the user as a
3133
+ # `LastEvaluatedKey` value to continue the read in a subsequent
3134
+ # operation. If the filter criteria in `WHERE` clause does not match any
3135
+ # data, the read will return an empty result set.
3136
+ #
3137
+ # A single `SELECT` statement response can return up to the maximum
3138
+ # number of items (if using the Limit parameter) or a maximum of 1 MB of
3139
+ # data (and then apply any filtering to the results using `WHERE`
3140
+ # clause). If `LastEvaluatedKey` is present in the response, you need to
3141
+ # paginate the result set.
3142
+ #
2928
3143
  # @option params [required, String] :statement
2929
3144
  # The PartiQL statement representing the operation to run.
2930
3145
  #
@@ -2940,10 +3155,41 @@ module Aws::DynamoDB
2940
3155
  # Set this value to get remaining results, if `NextToken` was returned
2941
3156
  # in the statement response.
2942
3157
  #
3158
+ # @option params [String] :return_consumed_capacity
3159
+ # Determines the level of detail about either provisioned or on-demand
3160
+ # throughput consumption that is returned in the response:
3161
+ #
3162
+ # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
3163
+ # for the operation, together with `ConsumedCapacity` for each table
3164
+ # and secondary index that was accessed.
3165
+ #
3166
+ # Note that some operations, such as `GetItem` and `BatchGetItem`, do
3167
+ # not access any indexes at all. In these cases, specifying `INDEXES`
3168
+ # will only return `ConsumedCapacity` information for table(s).
3169
+ #
3170
+ # * `TOTAL` - The response includes only the aggregate
3171
+ # `ConsumedCapacity` for the operation.
3172
+ #
3173
+ # * `NONE` - No `ConsumedCapacity` details are included in the response.
3174
+ #
3175
+ # @option params [Integer] :limit
3176
+ # The maximum number of items to evaluate (not necessarily the number of
3177
+ # matching items). If DynamoDB processes the number of items up to the
3178
+ # limit while processing the results, it stops the operation and returns
3179
+ # the matching values up to that point, along with a key in
3180
+ # `LastEvaluatedKey` to apply in a subsequent operation so you can pick
3181
+ # up where you left off. Also, if the processed dataset size exceeds 1
3182
+ # MB before DynamoDB reaches this limit, it stops the operation and
3183
+ # returns the matching values up to the limit, and a key in
3184
+ # `LastEvaluatedKey` to apply in a subsequent operation to continue the
3185
+ # operation.
3186
+ #
2943
3187
  # @return [Types::ExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2944
3188
  #
2945
3189
  # * {Types::ExecuteStatementOutput#items #items} => Array&lt;Hash&lt;String,Types::AttributeValue&gt;&gt;
2946
3190
  # * {Types::ExecuteStatementOutput#next_token #next_token} => String
3191
+ # * {Types::ExecuteStatementOutput#consumed_capacity #consumed_capacity} => Types::ConsumedCapacity
3192
+ # * {Types::ExecuteStatementOutput#last_evaluated_key #last_evaluated_key} => Hash&lt;String,Types::AttributeValue&gt;
2947
3193
  #
2948
3194
  # @example Request syntax with placeholder values
2949
3195
  #
@@ -2952,6 +3198,8 @@ module Aws::DynamoDB
2952
3198
  # parameters: ["value"], # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
2953
3199
  # consistent_read: false,
2954
3200
  # next_token: "PartiQLNextToken",
3201
+ # return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
3202
+ # limit: 1,
2955
3203
  # })
2956
3204
  #
2957
3205
  # @example Response structure
@@ -2960,6 +3208,23 @@ module Aws::DynamoDB
2960
3208
  # resp.items[0] #=> Hash
2961
3209
  # resp.items[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
2962
3210
  # resp.next_token #=> String
3211
+ # resp.consumed_capacity.table_name #=> String
3212
+ # resp.consumed_capacity.capacity_units #=> Float
3213
+ # resp.consumed_capacity.read_capacity_units #=> Float
3214
+ # resp.consumed_capacity.write_capacity_units #=> Float
3215
+ # resp.consumed_capacity.table.read_capacity_units #=> Float
3216
+ # resp.consumed_capacity.table.write_capacity_units #=> Float
3217
+ # resp.consumed_capacity.table.capacity_units #=> Float
3218
+ # resp.consumed_capacity.local_secondary_indexes #=> Hash
3219
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
3220
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
3221
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
3222
+ # resp.consumed_capacity.global_secondary_indexes #=> Hash
3223
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
3224
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
3225
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
3226
+ # resp.last_evaluated_key #=> Hash
3227
+ # resp.last_evaluated_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
2963
3228
  #
2964
3229
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatement AWS API Documentation
2965
3230
  #
@@ -2973,6 +3238,18 @@ module Aws::DynamoDB
2973
3238
  # This operation allows you to perform transactional reads or writes on
2974
3239
  # data stored in DynamoDB, using PartiQL.
2975
3240
  #
3241
+ # <note markdown="1"> The entire transaction must consist of either read statements or write
3242
+ # statements, you cannot mix both in one transaction. The EXISTS
3243
+ # function is an exception and can be used to check the condition of
3244
+ # specific attributes of the item in a similar manner to
3245
+ # `ConditionCheck` in the [TransactWriteItems][1] API.
3246
+ #
3247
+ # </note>
3248
+ #
3249
+ #
3250
+ #
3251
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html#transaction-apis-txwriteitems
3252
+ #
2976
3253
  # @option params [required, Array<Types::ParameterizedStatement>] :transact_statements
2977
3254
  # The list of PartiQL statements representing the transaction to run.
2978
3255
  #
@@ -2983,9 +3260,20 @@ module Aws::DynamoDB
2983
3260
  # **A suitable default value is auto-generated.** You should normally
2984
3261
  # not need to pass this option.**
2985
3262
  #
3263
+ # @option params [String] :return_consumed_capacity
3264
+ # Determines the level of detail about either provisioned or on-demand
3265
+ # throughput consumption that is returned in the response. For more
3266
+ # information, see [TransactGetItems][1] and [TransactWriteItems][2].
3267
+ #
3268
+ #
3269
+ #
3270
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html
3271
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html
3272
+ #
2986
3273
  # @return [Types::ExecuteTransactionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2987
3274
  #
2988
3275
  # * {Types::ExecuteTransactionOutput#responses #responses} => Array&lt;Types::ItemResponse&gt;
3276
+ # * {Types::ExecuteTransactionOutput#consumed_capacity #consumed_capacity} => Array&lt;Types::ConsumedCapacity&gt;
2989
3277
  #
2990
3278
  # @example Request syntax with placeholder values
2991
3279
  #
@@ -2997,6 +3285,7 @@ module Aws::DynamoDB
2997
3285
  # },
2998
3286
  # ],
2999
3287
  # client_request_token: "ClientRequestToken",
3288
+ # return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
3000
3289
  # })
3001
3290
  #
3002
3291
  # @example Response structure
@@ -3004,6 +3293,22 @@ module Aws::DynamoDB
3004
3293
  # resp.responses #=> Array
3005
3294
  # resp.responses[0].item #=> Hash
3006
3295
  # resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
3296
+ # resp.consumed_capacity #=> Array
3297
+ # resp.consumed_capacity[0].table_name #=> String
3298
+ # resp.consumed_capacity[0].capacity_units #=> Float
3299
+ # resp.consumed_capacity[0].read_capacity_units #=> Float
3300
+ # resp.consumed_capacity[0].write_capacity_units #=> Float
3301
+ # resp.consumed_capacity[0].table.read_capacity_units #=> Float
3302
+ # resp.consumed_capacity[0].table.write_capacity_units #=> Float
3303
+ # resp.consumed_capacity[0].table.capacity_units #=> Float
3304
+ # resp.consumed_capacity[0].local_secondary_indexes #=> Hash
3305
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
3306
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
3307
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
3308
+ # resp.consumed_capacity[0].global_secondary_indexes #=> Hash
3309
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
3310
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
3311
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
3007
3312
  #
3008
3313
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteTransaction AWS API Documentation
3009
3314
  #
@@ -3022,8 +3327,9 @@ module Aws::DynamoDB
3022
3327
  # The Amazon Resource Name (ARN) associated with the table to export.
3023
3328
  #
3024
3329
  # @option params [Time,DateTime,Date,Integer,String] :export_time
3025
- # Time in the past from which to export table data. The table export
3026
- # will be a snapshot of the table's state at this point in time.
3330
+ # Time in the past from which to export table data, counted in seconds
3331
+ # from the start of the Unix epoch. The table export will be a snapshot
3332
+ # of the table's state at this point in time.
3027
3333
  #
3028
3334
  # @option params [String] :client_token
3029
3335
  # Providing a `ClientToken` makes the call to
@@ -3038,7 +3344,7 @@ module Aws::DynamoDB
3038
3344
  #
3039
3345
  # If you submit a request with the same client token but a change in
3040
3346
  # other parameters within the 8-hour idempotency window, DynamoDB
3041
- # returns an `IdempotentParameterMismatch` exception.
3347
+ # returns an `ImportConflictException`.
3042
3348
  #
3043
3349
  # **A suitable default value is auto-generated.** You should normally
3044
3350
  # not need to pass this option.**
@@ -3047,8 +3353,8 @@ module Aws::DynamoDB
3047
3353
  # The name of the Amazon S3 bucket to export the snapshot to.
3048
3354
  #
3049
3355
  # @option params [String] :s3_bucket_owner
3050
- # The ID of the AWS account that owns the bucket the export will be
3051
- # stored in.
3356
+ # The ID of the Amazon Web Services account that owns the bucket the
3357
+ # export will be stored in.
3052
3358
  #
3053
3359
  # @option params [String] :s3_prefix
3054
3360
  # The Amazon S3 bucket prefix to use as the file name and path of the
@@ -3060,10 +3366,10 @@ module Aws::DynamoDB
3060
3366
  #
3061
3367
  # * `AES256` - server-side encryption with Amazon S3 managed keys
3062
3368
  #
3063
- # * `KMS` - server-side encryption with AWS KMS managed keys
3369
+ # * `KMS` - server-side encryption with KMS managed keys
3064
3370
  #
3065
3371
  # @option params [String] :s3_sse_kms_key_id
3066
- # The ID of the AWS KMS managed key used to encrypt the S3 bucket where
3372
+ # The ID of the KMS managed key used to encrypt the S3 bucket where
3067
3373
  # export data will be stored (if applicable).
3068
3374
  #
3069
3375
  # @option params [String] :export_format
@@ -3157,8 +3463,8 @@ module Aws::DynamoDB
3157
3463
  # uses eventually consistent reads.
3158
3464
  #
3159
3465
  # @option params [String] :return_consumed_capacity
3160
- # Determines the level of detail about provisioned throughput
3161
- # consumption that is returned in the response:
3466
+ # Determines the level of detail about either provisioned or on-demand
3467
+ # throughput consumption that is returned in the response:
3162
3468
  #
3163
3469
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
3164
3470
  # for the operation, together with `ConsumedCapacity` for each table
@@ -3314,10 +3620,172 @@ module Aws::DynamoDB
3314
3620
  req.send_request(options)
3315
3621
  end
3316
3622
 
3317
- # List backups associated with an AWS account. To list backups for a
3318
- # given table, specify `TableName`. `ListBackups` returns a paginated
3319
- # list of results with at most 1 MB worth of items in a page. You can
3320
- # also specify a maximum number of entries to be returned in a page.
3623
+ # Imports table data from an S3 bucket.
3624
+ #
3625
+ # @option params [String] :client_token
3626
+ # Providing a `ClientToken` makes the call to `ImportTableInput`
3627
+ # idempotent, meaning that multiple identical calls have the same effect
3628
+ # as one single call.
3629
+ #
3630
+ # A client token is valid for 8 hours after the first request that uses
3631
+ # it is completed. After 8 hours, any request with the same client token
3632
+ # is treated as a new request. Do not resubmit the same request with the
3633
+ # same client token for more than 8 hours, or the result might not be
3634
+ # idempotent.
3635
+ #
3636
+ # If you submit a request with the same client token but a change in
3637
+ # other parameters within the 8-hour idempotency window, DynamoDB
3638
+ # returns an `IdempotentParameterMismatch` exception.
3639
+ #
3640
+ # **A suitable default value is auto-generated.** You should normally
3641
+ # not need to pass this option.**
3642
+ #
3643
+ # @option params [required, Types::S3BucketSource] :s3_bucket_source
3644
+ # The S3 bucket that provides the source for the import.
3645
+ #
3646
+ # @option params [required, String] :input_format
3647
+ # The format of the source data. Valid values for `ImportFormat` are
3648
+ # `CSV`, `DYNAMODB_JSON` or `ION`.
3649
+ #
3650
+ # @option params [Types::InputFormatOptions] :input_format_options
3651
+ # Additional properties that specify how the input is formatted,
3652
+ #
3653
+ # @option params [String] :input_compression_type
3654
+ # Type of compression to be used on the input coming from the imported
3655
+ # table.
3656
+ #
3657
+ # @option params [required, Types::TableCreationParameters] :table_creation_parameters
3658
+ # Parameters for the table to import the data into.
3659
+ #
3660
+ # @return [Types::ImportTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3661
+ #
3662
+ # * {Types::ImportTableOutput#import_table_description #import_table_description} => Types::ImportTableDescription
3663
+ #
3664
+ # @example Request syntax with placeholder values
3665
+ #
3666
+ # resp = client.import_table({
3667
+ # client_token: "ClientToken",
3668
+ # s3_bucket_source: { # required
3669
+ # s3_bucket_owner: "S3BucketOwner",
3670
+ # s3_bucket: "S3Bucket", # required
3671
+ # s3_key_prefix: "S3Prefix",
3672
+ # },
3673
+ # input_format: "DYNAMODB_JSON", # required, accepts DYNAMODB_JSON, ION, CSV
3674
+ # input_format_options: {
3675
+ # csv: {
3676
+ # delimiter: "CsvDelimiter",
3677
+ # header_list: ["CsvHeader"],
3678
+ # },
3679
+ # },
3680
+ # input_compression_type: "GZIP", # accepts GZIP, ZSTD, NONE
3681
+ # table_creation_parameters: { # required
3682
+ # table_name: "TableName", # required
3683
+ # attribute_definitions: [ # required
3684
+ # {
3685
+ # attribute_name: "KeySchemaAttributeName", # required
3686
+ # attribute_type: "S", # required, accepts S, N, B
3687
+ # },
3688
+ # ],
3689
+ # key_schema: [ # required
3690
+ # {
3691
+ # attribute_name: "KeySchemaAttributeName", # required
3692
+ # key_type: "HASH", # required, accepts HASH, RANGE
3693
+ # },
3694
+ # ],
3695
+ # billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
3696
+ # provisioned_throughput: {
3697
+ # read_capacity_units: 1, # required
3698
+ # write_capacity_units: 1, # required
3699
+ # },
3700
+ # sse_specification: {
3701
+ # enabled: false,
3702
+ # sse_type: "AES256", # accepts AES256, KMS
3703
+ # kms_master_key_id: "KMSMasterKeyId",
3704
+ # },
3705
+ # global_secondary_indexes: [
3706
+ # {
3707
+ # index_name: "IndexName", # required
3708
+ # key_schema: [ # required
3709
+ # {
3710
+ # attribute_name: "KeySchemaAttributeName", # required
3711
+ # key_type: "HASH", # required, accepts HASH, RANGE
3712
+ # },
3713
+ # ],
3714
+ # projection: { # required
3715
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
3716
+ # non_key_attributes: ["NonKeyAttributeName"],
3717
+ # },
3718
+ # provisioned_throughput: {
3719
+ # read_capacity_units: 1, # required
3720
+ # write_capacity_units: 1, # required
3721
+ # },
3722
+ # },
3723
+ # ],
3724
+ # },
3725
+ # })
3726
+ #
3727
+ # @example Response structure
3728
+ #
3729
+ # resp.import_table_description.import_arn #=> String
3730
+ # resp.import_table_description.import_status #=> String, one of "IN_PROGRESS", "COMPLETED", "CANCELLING", "CANCELLED", "FAILED"
3731
+ # resp.import_table_description.table_arn #=> String
3732
+ # resp.import_table_description.table_id #=> String
3733
+ # resp.import_table_description.client_token #=> String
3734
+ # resp.import_table_description.s3_bucket_source.s3_bucket_owner #=> String
3735
+ # resp.import_table_description.s3_bucket_source.s3_bucket #=> String
3736
+ # resp.import_table_description.s3_bucket_source.s3_key_prefix #=> String
3737
+ # resp.import_table_description.error_count #=> Integer
3738
+ # resp.import_table_description.cloud_watch_log_group_arn #=> String
3739
+ # resp.import_table_description.input_format #=> String, one of "DYNAMODB_JSON", "ION", "CSV"
3740
+ # resp.import_table_description.input_format_options.csv.delimiter #=> String
3741
+ # resp.import_table_description.input_format_options.csv.header_list #=> Array
3742
+ # resp.import_table_description.input_format_options.csv.header_list[0] #=> String
3743
+ # resp.import_table_description.input_compression_type #=> String, one of "GZIP", "ZSTD", "NONE"
3744
+ # resp.import_table_description.table_creation_parameters.table_name #=> String
3745
+ # resp.import_table_description.table_creation_parameters.attribute_definitions #=> Array
3746
+ # resp.import_table_description.table_creation_parameters.attribute_definitions[0].attribute_name #=> String
3747
+ # resp.import_table_description.table_creation_parameters.attribute_definitions[0].attribute_type #=> String, one of "S", "N", "B"
3748
+ # resp.import_table_description.table_creation_parameters.key_schema #=> Array
3749
+ # resp.import_table_description.table_creation_parameters.key_schema[0].attribute_name #=> String
3750
+ # resp.import_table_description.table_creation_parameters.key_schema[0].key_type #=> String, one of "HASH", "RANGE"
3751
+ # resp.import_table_description.table_creation_parameters.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
3752
+ # resp.import_table_description.table_creation_parameters.provisioned_throughput.read_capacity_units #=> Integer
3753
+ # resp.import_table_description.table_creation_parameters.provisioned_throughput.write_capacity_units #=> Integer
3754
+ # resp.import_table_description.table_creation_parameters.sse_specification.enabled #=> Boolean
3755
+ # resp.import_table_description.table_creation_parameters.sse_specification.sse_type #=> String, one of "AES256", "KMS"
3756
+ # resp.import_table_description.table_creation_parameters.sse_specification.kms_master_key_id #=> String
3757
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes #=> Array
3758
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].index_name #=> String
3759
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].key_schema #=> Array
3760
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].key_schema[0].attribute_name #=> String
3761
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].key_schema[0].key_type #=> String, one of "HASH", "RANGE"
3762
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.projection_type #=> String, one of "ALL", "KEYS_ONLY", "INCLUDE"
3763
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.non_key_attributes #=> Array
3764
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].projection.non_key_attributes[0] #=> String
3765
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.read_capacity_units #=> Integer
3766
+ # resp.import_table_description.table_creation_parameters.global_secondary_indexes[0].provisioned_throughput.write_capacity_units #=> Integer
3767
+ # resp.import_table_description.start_time #=> Time
3768
+ # resp.import_table_description.end_time #=> Time
3769
+ # resp.import_table_description.processed_size_bytes #=> Integer
3770
+ # resp.import_table_description.processed_item_count #=> Integer
3771
+ # resp.import_table_description.imported_item_count #=> Integer
3772
+ # resp.import_table_description.failure_code #=> String
3773
+ # resp.import_table_description.failure_message #=> String
3774
+ #
3775
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ImportTable AWS API Documentation
3776
+ #
3777
+ # @overload import_table(params = {})
3778
+ # @param [Hash] params ({})
3779
+ def import_table(params = {}, options = {})
3780
+ req = build_request(:import_table, params)
3781
+ req.send_request(options)
3782
+ end
3783
+
3784
+ # List backups associated with an Amazon Web Services account. To list
3785
+ # backups for a given table, specify `TableName`. `ListBackups` returns
3786
+ # a paginated list of results with at most 1 MB worth of items in a
3787
+ # page. You can also specify a maximum number of entries to be returned
3788
+ # in a page.
3321
3789
  #
3322
3790
  # In the request, start time is inclusive, but end time is exclusive.
3323
3791
  # Note that these boundaries are for the time at which the original
@@ -3351,7 +3819,8 @@ module Aws::DynamoDB
3351
3819
  #
3352
3820
  # Where `BackupType` can be:
3353
3821
  #
3354
- # * `USER` - On-demand backup created by you.
3822
+ # * `USER` - On-demand backup created by you. (The default setting if no
3823
+ # other backup types are specified.)
3355
3824
  #
3356
3825
  # * `SYSTEM` - On-demand backup automatically created by DynamoDB.
3357
3826
  #
@@ -3542,6 +4011,59 @@ module Aws::DynamoDB
3542
4011
  req.send_request(options)
3543
4012
  end
3544
4013
 
4014
+ # Lists completed imports within the past 90 days.
4015
+ #
4016
+ # @option params [String] :table_arn
4017
+ # The Amazon Resource Name (ARN) associated with the table that was
4018
+ # imported to.
4019
+ #
4020
+ # @option params [Integer] :page_size
4021
+ # The number of `ImportSummary `objects returned in a single page.
4022
+ #
4023
+ # @option params [String] :next_token
4024
+ # An optional string that, if supplied, must be copied from the output
4025
+ # of a previous call to `ListImports`. When provided in this manner, the
4026
+ # API fetches the next page of results.
4027
+ #
4028
+ # @return [Types::ListImportsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4029
+ #
4030
+ # * {Types::ListImportsOutput#import_summary_list #import_summary_list} => Array&lt;Types::ImportSummary&gt;
4031
+ # * {Types::ListImportsOutput#next_token #next_token} => String
4032
+ #
4033
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4034
+ #
4035
+ # @example Request syntax with placeholder values
4036
+ #
4037
+ # resp = client.list_imports({
4038
+ # table_arn: "TableArn",
4039
+ # page_size: 1,
4040
+ # next_token: "ImportNextToken",
4041
+ # })
4042
+ #
4043
+ # @example Response structure
4044
+ #
4045
+ # resp.import_summary_list #=> Array
4046
+ # resp.import_summary_list[0].import_arn #=> String
4047
+ # resp.import_summary_list[0].import_status #=> String, one of "IN_PROGRESS", "COMPLETED", "CANCELLING", "CANCELLED", "FAILED"
4048
+ # resp.import_summary_list[0].table_arn #=> String
4049
+ # resp.import_summary_list[0].s3_bucket_source.s3_bucket_owner #=> String
4050
+ # resp.import_summary_list[0].s3_bucket_source.s3_bucket #=> String
4051
+ # resp.import_summary_list[0].s3_bucket_source.s3_key_prefix #=> String
4052
+ # resp.import_summary_list[0].cloud_watch_log_group_arn #=> String
4053
+ # resp.import_summary_list[0].input_format #=> String, one of "DYNAMODB_JSON", "ION", "CSV"
4054
+ # resp.import_summary_list[0].start_time #=> Time
4055
+ # resp.import_summary_list[0].end_time #=> Time
4056
+ # resp.next_token #=> String
4057
+ #
4058
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListImports AWS API Documentation
4059
+ #
4060
+ # @overload list_imports(params = {})
4061
+ # @param [Hash] params ({})
4062
+ def list_imports(params = {}, options = {})
4063
+ req = build_request(:list_imports, params)
4064
+ req.send_request(options)
4065
+ end
4066
+
3545
4067
  # Returns an array of table names associated with the current account
3546
4068
  # and endpoint. The output from `ListTables` is paginated, with each
3547
4069
  # page returning a maximum of 100 table names.
@@ -3658,31 +4180,8 @@ module Aws::DynamoDB
3658
4180
  # item's attribute values in the same operation, using the
3659
4181
  # `ReturnValues` parameter.
3660
4182
  #
3661
- # This topic provides general information about the `PutItem` API.
3662
- #
3663
- # For information on how to call the `PutItem` API using the AWS SDK in
3664
- # specific languages, see the following:
3665
- #
3666
- # * [ PutItem in the AWS Command Line Interface][1]
3667
- #
3668
- # * [ PutItem in the AWS SDK for .NET][2]
3669
- #
3670
- # * [ PutItem in the AWS SDK for C++][3]
3671
- #
3672
- # * [ PutItem in the AWS SDK for Go][4]
3673
- #
3674
- # * [ PutItem in the AWS SDK for Java][5]
3675
- #
3676
- # * [ PutItem in the AWS SDK for JavaScript][6]
3677
- #
3678
- # * [ PutItem in the AWS SDK for PHP V3][7]
3679
- #
3680
- # * [ PutItem in the AWS SDK for Python][8]
3681
- #
3682
- # * [ PutItem in the AWS SDK for Ruby V2][9]
3683
- #
3684
4183
  # When you add an item, the primary key attributes are the only required
3685
- # attributes. Attribute values cannot be null.
4184
+ # attributes.
3686
4185
  #
3687
4186
  # Empty String and Binary attribute values are allowed. Attribute values
3688
4187
  # of type String and Binary must have a length greater than zero if the
@@ -3701,21 +4200,12 @@ module Aws::DynamoDB
3701
4200
  #
3702
4201
  # </note>
3703
4202
  #
3704
- # For more information about `PutItem`, see [Working with Items][10] in
4203
+ # For more information about `PutItem`, see [Working with Items][1] in
3705
4204
  # the *Amazon DynamoDB Developer Guide*.
3706
4205
  #
3707
4206
  #
3708
4207
  #
3709
- # [1]: http://docs.aws.amazon.com/goto/aws-cli/dynamodb-2012-08-10/PutItem
3710
- # [2]: http://docs.aws.amazon.com/goto/DotNetSDKV3/dynamodb-2012-08-10/PutItem
3711
- # [3]: http://docs.aws.amazon.com/goto/SdkForCpp/dynamodb-2012-08-10/PutItem
3712
- # [4]: http://docs.aws.amazon.com/goto/SdkForGoV1/dynamodb-2012-08-10/PutItem
3713
- # [5]: http://docs.aws.amazon.com/goto/SdkForJava/dynamodb-2012-08-10/PutItem
3714
- # [6]: http://docs.aws.amazon.com/goto/AWSJavaScriptSDK/dynamodb-2012-08-10/PutItem
3715
- # [7]: http://docs.aws.amazon.com/goto/SdkForPHPV3/dynamodb-2012-08-10/PutItem
3716
- # [8]: http://docs.aws.amazon.com/goto/boto3/dynamodb-2012-08-10/PutItem
3717
- # [9]: http://docs.aws.amazon.com/goto/SdkForRubyV2/dynamodb-2012-08-10/PutItem
3718
- # [10]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html
4208
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html
3719
4209
  #
3720
4210
  # @option params [required, String] :table_name
3721
4211
  # The name of the table to contain the item.
@@ -3768,6 +4258,12 @@ module Aws::DynamoDB
3768
4258
  # * `ALL_OLD` - If `PutItem` overwrote an attribute name-value pair,
3769
4259
  # then the content of the old item is returned.
3770
4260
  #
4261
+ # The values returned are strongly consistent.
4262
+ #
4263
+ # There is no additional cost associated with requesting a return value
4264
+ # aside from the small network and processing overhead of receiving a
4265
+ # larger response. No read capacity units are consumed.
4266
+ #
3771
4267
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
3772
4268
  # however, `PutItem` does not recognize any values other than `NONE` or
3773
4269
  # `ALL_OLD`.
@@ -3775,8 +4271,8 @@ module Aws::DynamoDB
3775
4271
  # </note>
3776
4272
  #
3777
4273
  # @option params [String] :return_consumed_capacity
3778
- # Determines the level of detail about provisioned throughput
3779
- # consumption that is returned in the response:
4274
+ # Determines the level of detail about either provisioned or on-demand
4275
+ # throughput consumption that is returned in the response:
3780
4276
  #
3781
4277
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
3782
4278
  # for the operation, together with `ConsumedCapacity` for each table
@@ -3995,9 +4491,10 @@ module Aws::DynamoDB
3995
4491
  req.send_request(options)
3996
4492
  end
3997
4493
 
3998
- # The `Query` operation finds items based on primary key values. You can
3999
- # query any table or secondary index that has a composite primary key (a
4000
- # partition key and a sort key).
4494
+ # You must provide the name of the partition key attribute and a single
4495
+ # value for that attribute. `Query` returns all items with that
4496
+ # partition key value. Optionally, you can provide a sort key attribute
4497
+ # and use a comparison operator to refine the search results.
4001
4498
  #
4002
4499
  # Use the `KeyConditionExpression` parameter to provide a specific value
4003
4500
  # for the partition key. The `Query` operation will return all of the
@@ -4088,8 +4585,9 @@ module Aws::DynamoDB
4088
4585
  # matching items themselves.
4089
4586
  #
4090
4587
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
4091
- # `AttributesToGet`. This return value is equivalent to specifying
4092
- # `AttributesToGet` without specifying any value for `Select`.
4588
+ # `ProjectionExpression`. This return value is equivalent to
4589
+ # specifying `ProjectionExpression` without specifying any value for
4590
+ # `Select`.
4093
4591
  #
4094
4592
  # If you query or scan a local secondary index and request only
4095
4593
  # attributes that are projected into that index, the operation will
@@ -4102,12 +4600,12 @@ module Aws::DynamoDB
4102
4600
  # attributes that are projected into the index. Global secondary index
4103
4601
  # queries cannot fetch attributes from the parent table.
4104
4602
  #
4105
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
4603
+ # If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
4106
4604
  # defaults to `ALL_ATTRIBUTES` when accessing a table, and
4107
4605
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
4108
- # both `Select` and `AttributesToGet` together in a single request,
4606
+ # both `Select` and `ProjectionExpression` together in a single request,
4109
4607
  # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
4110
- # equivalent to specifying `AttributesToGet` without any value for
4608
+ # equivalent to specifying `ProjectionExpression` without any value for
4111
4609
  # `Select`.)
4112
4610
  #
4113
4611
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -4204,8 +4702,8 @@ module Aws::DynamoDB
4204
4702
  # Binary. No set data types are allowed.
4205
4703
  #
4206
4704
  # @option params [String] :return_consumed_capacity
4207
- # Determines the level of detail about provisioned throughput
4208
- # consumption that is returned in the response:
4705
+ # Determines the level of detail about either provisioned or on-demand
4706
+ # throughput consumption that is returned in the response:
4209
4707
  #
4210
4708
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
4211
4709
  # for the operation, together with `ConsumedCapacity` for each table
@@ -4256,7 +4754,7 @@ module Aws::DynamoDB
4256
4754
  #
4257
4755
  #
4258
4756
  #
4259
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
4757
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
4260
4758
  #
4261
4759
  # @option params [String] :key_condition_expression
4262
4760
  # The condition that specifies the key values for items to be retrieved
@@ -4697,6 +5195,8 @@ module Aws::DynamoDB
4697
5195
  # resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
4698
5196
  # resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
4699
5197
  # resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
5198
+ # resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
5199
+ # resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
4700
5200
  # resp.table_description.restore_summary.source_backup_arn #=> String
4701
5201
  # resp.table_description.restore_summary.source_table_arn #=> String
4702
5202
  # resp.table_description.restore_summary.restore_date_time #=> Time
@@ -4708,6 +5208,8 @@ module Aws::DynamoDB
4708
5208
  # resp.table_description.archival_summary.archival_date_time #=> Time
4709
5209
  # resp.table_description.archival_summary.archival_reason #=> String
4710
5210
  # resp.table_description.archival_summary.archival_backup_arn #=> String
5211
+ # resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
5212
+ # resp.table_description.table_class_summary.last_update_date_time #=> Time
4711
5213
  #
4712
5214
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableFromBackup AWS API Documentation
4713
5215
  #
@@ -4920,6 +5422,8 @@ module Aws::DynamoDB
4920
5422
  # resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
4921
5423
  # resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
4922
5424
  # resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
5425
+ # resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
5426
+ # resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
4923
5427
  # resp.table_description.restore_summary.source_backup_arn #=> String
4924
5428
  # resp.table_description.restore_summary.source_table_arn #=> String
4925
5429
  # resp.table_description.restore_summary.restore_date_time #=> Time
@@ -4931,6 +5435,8 @@ module Aws::DynamoDB
4931
5435
  # resp.table_description.archival_summary.archival_date_time #=> Time
4932
5436
  # resp.table_description.archival_summary.archival_reason #=> String
4933
5437
  # resp.table_description.archival_summary.archival_backup_arn #=> String
5438
+ # resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
5439
+ # resp.table_description.table_class_summary.last_update_date_time #=> Time
4934
5440
  #
4935
5441
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableToPointInTime AWS API Documentation
4936
5442
  #
@@ -5033,8 +5539,9 @@ module Aws::DynamoDB
5033
5539
  # matching items themselves.
5034
5540
  #
5035
5541
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
5036
- # `AttributesToGet`. This return value is equivalent to specifying
5037
- # `AttributesToGet` without specifying any value for `Select`.
5542
+ # `ProjectionExpression`. This return value is equivalent to
5543
+ # specifying `ProjectionExpression` without specifying any value for
5544
+ # `Select`.
5038
5545
  #
5039
5546
  # If you query or scan a local secondary index and request only
5040
5547
  # attributes that are projected into that index, the operation reads
@@ -5047,12 +5554,12 @@ module Aws::DynamoDB
5047
5554
  # attributes that are projected into the index. Global secondary index
5048
5555
  # queries cannot fetch attributes from the parent table.
5049
5556
  #
5050
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
5557
+ # If neither `Select` nor `ProjectionExpression` are specified, DynamoDB
5051
5558
  # defaults to `ALL_ATTRIBUTES` when accessing a table, and
5052
5559
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
5053
- # both `Select` and `AttributesToGet` together in a single request,
5560
+ # both `Select` and `ProjectionExpression` together in a single request,
5054
5561
  # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage is
5055
- # equivalent to specifying `AttributesToGet` without any value for
5562
+ # equivalent to specifying `ProjectionExpression` without any value for
5056
5563
  # `Select`.)
5057
5564
  #
5058
5565
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
@@ -5092,8 +5599,8 @@ module Aws::DynamoDB
5092
5599
  # corresponding value of `LastEvaluatedKey`.
5093
5600
  #
5094
5601
  # @option params [String] :return_consumed_capacity
5095
- # Determines the level of detail about provisioned throughput
5096
- # consumption that is returned in the response:
5602
+ # Determines the level of detail about either provisioned or on-demand
5603
+ # throughput consumption that is returned in the response:
5097
5604
  #
5098
5605
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
5099
5606
  # for the operation, together with `ConsumedCapacity` for each table
@@ -5173,7 +5680,7 @@ module Aws::DynamoDB
5173
5680
  #
5174
5681
  #
5175
5682
  #
5176
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
5683
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
5177
5684
  #
5178
5685
  # @option params [Hash<String,String>] :expression_attribute_names
5179
5686
  # One or more substitution tokens for attribute names in an expression.
@@ -5428,11 +5935,11 @@ module Aws::DynamoDB
5428
5935
  # `TransactGetItems` is a synchronous operation that atomically
5429
5936
  # retrieves multiple items from one or more tables (but not from
5430
5937
  # indexes) in a single account and Region. A `TransactGetItems` call can
5431
- # contain up to 25 `TransactGetItem` objects, each of which contains a
5938
+ # contain up to 100 `TransactGetItem` objects, each of which contains a
5432
5939
  # `Get` structure that specifies an item to retrieve from a table in the
5433
5940
  # account and Region. A call to `TransactGetItems` cannot retrieve items
5434
- # from tables in more than one AWS account or Region. The aggregate size
5435
- # of the items in the transaction cannot exceed 4 MB.
5941
+ # from tables in more than one Amazon Web Services account or Region.
5942
+ # The aggregate size of the items in the transaction cannot exceed 4 MB.
5436
5943
  #
5437
5944
  # DynamoDB rejects the entire `TransactGetItems` request if any of the
5438
5945
  # following is true:
@@ -5449,7 +5956,7 @@ module Aws::DynamoDB
5449
5956
  # MB.
5450
5957
  #
5451
5958
  # @option params [required, Array<Types::TransactGetItem>] :transact_items
5452
- # An ordered array of up to 25 `TransactGetItem` objects, each of which
5959
+ # An ordered array of up to 100 `TransactGetItem` objects, each of which
5453
5960
  # contains a `Get` structure.
5454
5961
  #
5455
5962
  # @option params [String] :return_consumed_capacity
@@ -5514,11 +6021,11 @@ module Aws::DynamoDB
5514
6021
  end
5515
6022
 
5516
6023
  # `TransactWriteItems` is a synchronous write operation that groups up
5517
- # to 25 action requests. These actions can target items in different
5518
- # tables, but not in different AWS accounts or Regions, and no two
5519
- # actions can target the same item. For example, you cannot both
5520
- # `ConditionCheck` and `Update` the same item. The aggregate size of the
5521
- # items in the transaction cannot exceed 4 MB.
6024
+ # to 100 action requests. These actions can target items in different
6025
+ # tables, but not in different Amazon Web Services accounts or Regions,
6026
+ # and no two actions can target the same item. For example, you cannot
6027
+ # both `ConditionCheck` and `Update` the same item. The aggregate size
6028
+ # of the items in the transaction cannot exceed 4 MB.
5522
6029
  #
5523
6030
  # The actions are completed atomically so that either all of them
5524
6031
  # succeed, or all of them fail. They are defined by the following
@@ -5572,15 +6079,15 @@ module Aws::DynamoDB
5572
6079
  # * There is a user error, such as an invalid data format.
5573
6080
  #
5574
6081
  # @option params [required, Array<Types::TransactWriteItem>] :transact_items
5575
- # An ordered array of up to 25 `TransactWriteItem` objects, each of
6082
+ # An ordered array of up to 100 `TransactWriteItem` objects, each of
5576
6083
  # which contains a `ConditionCheck`, `Put`, `Update`, or `Delete`
5577
6084
  # object. These can operate on items in different tables, but the tables
5578
- # must reside in the same AWS account and Region, and no two of them can
5579
- # operate on the same item.
6085
+ # must reside in the same Amazon Web Services account and Region, and no
6086
+ # two of them can operate on the same item.
5580
6087
  #
5581
6088
  # @option params [String] :return_consumed_capacity
5582
- # Determines the level of detail about provisioned throughput
5583
- # consumption that is returned in the response:
6089
+ # Determines the level of detail about either provisioned or on-demand
6090
+ # throughput consumption that is returned in the response:
5584
6091
  #
5585
6092
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
5586
6093
  # for the operation, together with `ConsumedCapacity` for each table
@@ -5822,7 +6329,13 @@ module Aws::DynamoDB
5822
6329
  end
5823
6330
 
5824
6331
  # Updates the status for contributor insights for a specific table or
5825
- # index.
6332
+ # index. CloudWatch Contributor Insights for DynamoDB graphs display the
6333
+ # partition key and (if applicable) sort key of frequently accessed
6334
+ # items and frequently throttled items in plaintext. If you require the
6335
+ # use of Amazon Web Services Key Management Service (KMS) to encrypt
6336
+ # this table’s partition key and sort key data with an Amazon Web
6337
+ # Services managed key or customer managed key, you should not enable
6338
+ # CloudWatch Contributor Insights for DynamoDB for this table.
5826
6339
  #
5827
6340
  # @option params [required, String] :table_name
5828
6341
  # The name of the table.
@@ -5925,6 +6438,8 @@ module Aws::DynamoDB
5925
6438
  # resp.global_table_description.replication_group[0].global_secondary_indexes[0].index_name #=> String
5926
6439
  # resp.global_table_description.replication_group[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
5927
6440
  # resp.global_table_description.replication_group[0].replica_inaccessible_date_time #=> Time
6441
+ # resp.global_table_description.replication_group[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
6442
+ # resp.global_table_description.replication_group[0].replica_table_class_summary.last_update_date_time #=> Time
5928
6443
  # resp.global_table_description.global_table_arn #=> String
5929
6444
  # resp.global_table_description.creation_date_time #=> Time
5930
6445
  # resp.global_table_description.global_table_status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING"
@@ -6065,6 +6580,7 @@ module Aws::DynamoDB
6065
6580
  # },
6066
6581
  # },
6067
6582
  # ],
6583
+ # replica_table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
6068
6584
  # },
6069
6585
  # ],
6070
6586
  # })
@@ -6124,6 +6640,8 @@ module Aws::DynamoDB
6124
6640
  # 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
6641
  # 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
6642
  # 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
6643
+ # resp.replica_settings[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
6644
+ # resp.replica_settings[0].replica_table_class_summary.last_update_date_time #=> Time
6127
6645
  #
6128
6646
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateGlobalTableSettings AWS API Documentation
6129
6647
  #
@@ -6211,8 +6729,8 @@ module Aws::DynamoDB
6211
6729
  # The values returned are strongly consistent.
6212
6730
  #
6213
6731
  # @option params [String] :return_consumed_capacity
6214
- # Determines the level of detail about provisioned throughput
6215
- # consumption that is returned in the response:
6732
+ # Determines the level of detail about either provisioned or on-demand
6733
+ # throughput consumption that is returned in the response:
6216
6734
  #
6217
6735
  # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
6218
6736
  # for the operation, together with `ConsumedCapacity` for each table
@@ -6535,8 +7053,6 @@ module Aws::DynamoDB
6535
7053
  #
6536
7054
  # * Modify the provisioned throughput settings of the table.
6537
7055
  #
6538
- # * Enable or disable DynamoDB Streams on the table.
6539
- #
6540
7056
  # * Remove a global secondary index from the table.
6541
7057
  #
6542
7058
  # * Create a new global secondary index on the table. After the index
@@ -6629,6 +7145,10 @@ module Aws::DynamoDB
6629
7145
  #
6630
7146
  # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/globaltables.V2.html
6631
7147
  #
7148
+ # @option params [String] :table_class
7149
+ # The table class of the table to be updated. Valid values are
7150
+ # `STANDARD` and `STANDARD_INFREQUENT_ACCESS`.
7151
+ #
6632
7152
  # @return [Types::UpdateTableOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6633
7153
  #
6634
7154
  # * {Types::UpdateTableOutput#table_description #table_description} => Types::TableDescription
@@ -6754,6 +7274,7 @@ module Aws::DynamoDB
6754
7274
  # },
6755
7275
  # },
6756
7276
  # ],
7277
+ # table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
6757
7278
  # },
6758
7279
  # update: {
6759
7280
  # region_name: "RegionName", # required
@@ -6769,12 +7290,14 @@ module Aws::DynamoDB
6769
7290
  # },
6770
7291
  # },
6771
7292
  # ],
7293
+ # table_class_override: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
6772
7294
  # },
6773
7295
  # delete: {
6774
7296
  # region_name: "RegionName", # required
6775
7297
  # },
6776
7298
  # },
6777
7299
  # ],
7300
+ # table_class: "STANDARD", # accepts STANDARD, STANDARD_INFREQUENT_ACCESS
6778
7301
  # })
6779
7302
  #
6780
7303
  # @example Response structure
@@ -6844,6 +7367,8 @@ module Aws::DynamoDB
6844
7367
  # resp.table_description.replicas[0].global_secondary_indexes[0].index_name #=> String
6845
7368
  # resp.table_description.replicas[0].global_secondary_indexes[0].provisioned_throughput_override.read_capacity_units #=> Integer
6846
7369
  # resp.table_description.replicas[0].replica_inaccessible_date_time #=> Time
7370
+ # resp.table_description.replicas[0].replica_table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
7371
+ # resp.table_description.replicas[0].replica_table_class_summary.last_update_date_time #=> Time
6847
7372
  # resp.table_description.restore_summary.source_backup_arn #=> String
6848
7373
  # resp.table_description.restore_summary.source_table_arn #=> String
6849
7374
  # resp.table_description.restore_summary.restore_date_time #=> Time
@@ -6855,6 +7380,8 @@ module Aws::DynamoDB
6855
7380
  # resp.table_description.archival_summary.archival_date_time #=> Time
6856
7381
  # resp.table_description.archival_summary.archival_reason #=> String
6857
7382
  # resp.table_description.archival_summary.archival_backup_arn #=> String
7383
+ # resp.table_description.table_class_summary.table_class #=> String, one of "STANDARD", "STANDARD_INFREQUENT_ACCESS"
7384
+ # resp.table_description.table_class_summary.last_update_date_time #=> Time
6858
7385
  #
6859
7386
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/UpdateTable AWS API Documentation
6860
7387
  #
@@ -7121,7 +7648,7 @@ module Aws::DynamoDB
7121
7648
  params: params,
7122
7649
  config: config)
7123
7650
  context[:gem_name] = 'aws-sdk-dynamodb'
7124
- context[:gem_version] = '1.60.0'
7651
+ context[:gem_version] = '1.80.0'
7125
7652
  Seahorse::Client::Request.new(handlers, context)
7126
7653
  end
7127
7654