aws-sdk-dynamodb 1.60.0 → 1.80.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.
@@ -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