aws-sdk-dynamodb 1.17.0 → 1.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 872fa31bfe14f07f07ea9095ece16937410fd346
4
- data.tar.gz: ce76b114c5e81c1df1eaec2aa575bc9fe16c746b
3
+ metadata.gz: 6a830347ebf2b0a47fe25e0e88ca9e755a68f1d2
4
+ data.tar.gz: 93a0f36aed859496b8e4d3412c2f7691bcee2e12
5
5
  SHA512:
6
- metadata.gz: 99176827c46f11d45a34512e637c693d64cb4e510c4298c4fba746797ef3196bb6d3d8896901c1ad6fcf334098b533cb3f636eb81b9b048f975f03dfbc0b440c
7
- data.tar.gz: 82d3a827eb377e66ba4d26af52f3d1be594110fdc9ff169faedfb8102dd69e9f44fd31215ed7fa906c0085c416e168e3ff29d1b48adf59ae567062b620106a7d
6
+ metadata.gz: 444c6f303f1196fd5f81e30a0bae583b5c73a46a145ab97afb6c18a2d0cf87da720ae8e5fa7bbe4ccabd92f7d2b95a99071a7c03adb8cbcb3b89dddc1f3cb9f6
7
+ data.tar.gz: 851d8438859ed3b364da3a18d3e5b293e953e25cb118c2805b5c6c4f985b60409fa352ed1f739b91405fbf9f56da80e8ed0f1cbe0cc5db4e2a81348acee3c594
@@ -44,6 +44,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
44
44
  # @service
45
45
  module Aws::DynamoDB
46
46
 
47
- GEM_VERSION = '1.17.0'
47
+ GEM_VERSION = '1.18.0'
48
48
 
49
49
  end
@@ -517,10 +517,18 @@ module Aws::DynamoDB
517
517
  # resp.consumed_capacity #=> Array
518
518
  # resp.consumed_capacity[0].table_name #=> String
519
519
  # resp.consumed_capacity[0].capacity_units #=> Float
520
+ # resp.consumed_capacity[0].read_capacity_units #=> Float
521
+ # resp.consumed_capacity[0].write_capacity_units #=> Float
522
+ # resp.consumed_capacity[0].table.read_capacity_units #=> Float
523
+ # resp.consumed_capacity[0].table.write_capacity_units #=> Float
520
524
  # resp.consumed_capacity[0].table.capacity_units #=> Float
521
525
  # resp.consumed_capacity[0].local_secondary_indexes #=> Hash
526
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
527
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
522
528
  # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
523
529
  # resp.consumed_capacity[0].global_secondary_indexes #=> Hash
530
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
531
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
524
532
  # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
525
533
  #
526
534
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchGetItem AWS API Documentation
@@ -780,10 +788,18 @@ module Aws::DynamoDB
780
788
  # resp.consumed_capacity #=> Array
781
789
  # resp.consumed_capacity[0].table_name #=> String
782
790
  # resp.consumed_capacity[0].capacity_units #=> Float
791
+ # resp.consumed_capacity[0].read_capacity_units #=> Float
792
+ # resp.consumed_capacity[0].write_capacity_units #=> Float
793
+ # resp.consumed_capacity[0].table.read_capacity_units #=> Float
794
+ # resp.consumed_capacity[0].table.write_capacity_units #=> Float
783
795
  # resp.consumed_capacity[0].table.capacity_units #=> Float
784
796
  # resp.consumed_capacity[0].local_secondary_indexes #=> Hash
797
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
798
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
785
799
  # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
786
800
  # resp.consumed_capacity[0].global_secondary_indexes #=> Hash
801
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
802
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
787
803
  # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
788
804
  #
789
805
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchWriteItem AWS API Documentation
@@ -1090,11 +1106,25 @@ module Aws::DynamoDB
1090
1106
  # the global secondary index, consisting of read and write capacity
1091
1107
  # units.
1092
1108
  #
1093
- # @option params [required, Types::ProvisionedThroughput] :provisioned_throughput
1109
+ # @option params [String] :billing_mode
1110
+ # Controls how you are charged for read and write throughput and how you
1111
+ # manage capacity. This setting can be changed later.
1112
+ #
1113
+ # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We recommend
1114
+ # using `PROVISIONED` for predictable workloads.
1115
+ #
1116
+ # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
1117
+ # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
1118
+ #
1119
+ # @option params [Types::ProvisionedThroughput] :provisioned_throughput
1094
1120
  # Represents the provisioned throughput settings for a specified table
1095
1121
  # or index. The settings can be modified using the `UpdateTable`
1096
1122
  # operation.
1097
1123
  #
1124
+ # If you set BillingMode as `PROVISIONED`, you must specify this
1125
+ # property. If you set BillingMode as `PAY_PER_REQUEST`, you cannot
1126
+ # specify this property.
1127
+ #
1098
1128
  # For current minimum and maximum provisioned throughput values, see
1099
1129
  # [Limits][1] in the *Amazon DynamoDB Developer Guide*.
1100
1130
  #
@@ -1244,13 +1274,14 @@ module Aws::DynamoDB
1244
1274
  # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
1245
1275
  # non_key_attributes: ["NonKeyAttributeName"],
1246
1276
  # },
1247
- # provisioned_throughput: { # required
1277
+ # provisioned_throughput: {
1248
1278
  # read_capacity_units: 1, # required
1249
1279
  # write_capacity_units: 1, # required
1250
1280
  # },
1251
1281
  # },
1252
1282
  # ],
1253
- # provisioned_throughput: { # required
1283
+ # billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
1284
+ # provisioned_throughput: {
1254
1285
  # read_capacity_units: 1, # required
1255
1286
  # write_capacity_units: 1, # required
1256
1287
  # },
@@ -1285,6 +1316,8 @@ module Aws::DynamoDB
1285
1316
  # resp.table_description.item_count #=> Integer
1286
1317
  # resp.table_description.table_arn #=> String
1287
1318
  # resp.table_description.table_id #=> String
1319
+ # resp.table_description.billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
1320
+ # resp.table_description.billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
1288
1321
  # resp.table_description.local_secondary_indexes #=> Array
1289
1322
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
1290
1323
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -1372,6 +1405,7 @@ module Aws::DynamoDB
1372
1405
  # resp.backup_description.source_table_details.provisioned_throughput.read_capacity_units #=> Integer
1373
1406
  # resp.backup_description.source_table_details.provisioned_throughput.write_capacity_units #=> Integer
1374
1407
  # resp.backup_description.source_table_details.item_count #=> Integer
1408
+ # resp.backup_description.source_table_details.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
1375
1409
  # resp.backup_description.source_table_feature_details.local_secondary_indexes #=> Array
1376
1410
  # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].index_name #=> String
1377
1411
  # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema #=> Array
@@ -1657,10 +1691,18 @@ module Aws::DynamoDB
1657
1691
  # resp.attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
1658
1692
  # resp.consumed_capacity.table_name #=> String
1659
1693
  # resp.consumed_capacity.capacity_units #=> Float
1694
+ # resp.consumed_capacity.read_capacity_units #=> Float
1695
+ # resp.consumed_capacity.write_capacity_units #=> Float
1696
+ # resp.consumed_capacity.table.read_capacity_units #=> Float
1697
+ # resp.consumed_capacity.table.write_capacity_units #=> Float
1660
1698
  # resp.consumed_capacity.table.capacity_units #=> Float
1661
1699
  # resp.consumed_capacity.local_secondary_indexes #=> Hash
1700
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
1701
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
1662
1702
  # resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
1663
1703
  # resp.consumed_capacity.global_secondary_indexes #=> Hash
1704
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
1705
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
1664
1706
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
1665
1707
  # resp.item_collection_metrics.item_collection_key #=> Hash
1666
1708
  # resp.item_collection_metrics.item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
@@ -1756,6 +1798,8 @@ module Aws::DynamoDB
1756
1798
  # resp.table_description.item_count #=> Integer
1757
1799
  # resp.table_description.table_arn #=> String
1758
1800
  # resp.table_description.table_id #=> String
1801
+ # resp.table_description.billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
1802
+ # resp.table_description.billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
1759
1803
  # resp.table_description.local_secondary_indexes #=> Array
1760
1804
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
1761
1805
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -1844,6 +1888,7 @@ module Aws::DynamoDB
1844
1888
  # resp.backup_description.source_table_details.provisioned_throughput.read_capacity_units #=> Integer
1845
1889
  # resp.backup_description.source_table_details.provisioned_throughput.write_capacity_units #=> Integer
1846
1890
  # resp.backup_description.source_table_details.item_count #=> Integer
1891
+ # resp.backup_description.source_table_details.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
1847
1892
  # resp.backup_description.source_table_feature_details.local_secondary_indexes #=> Array
1848
1893
  # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].index_name #=> String
1849
1894
  # resp.backup_description.source_table_feature_details.local_secondary_indexes[0].key_schema #=> Array
@@ -1999,6 +2044,8 @@ module Aws::DynamoDB
1999
2044
  # resp.replica_settings #=> Array
2000
2045
  # resp.replica_settings[0].region_name #=> String
2001
2046
  # resp.replica_settings[0].replica_status #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE"
2047
+ # resp.replica_settings[0].replica_billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
2048
+ # resp.replica_settings[0].replica_billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
2002
2049
  # resp.replica_settings[0].replica_provisioned_read_capacity_units #=> Integer
2003
2050
  # resp.replica_settings[0].replica_provisioned_read_capacity_auto_scaling_settings.minimum_units #=> Integer
2004
2051
  # resp.replica_settings[0].replica_provisioned_read_capacity_auto_scaling_settings.maximum_units #=> Integer
@@ -2256,6 +2303,8 @@ module Aws::DynamoDB
2256
2303
  # resp.table.item_count #=> Integer
2257
2304
  # resp.table.table_arn #=> String
2258
2305
  # resp.table.table_id #=> String
2306
+ # resp.table.billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
2307
+ # resp.table.billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
2259
2308
  # resp.table.local_secondary_indexes #=> Array
2260
2309
  # resp.table.local_secondary_indexes[0].index_name #=> String
2261
2310
  # resp.table.local_secondary_indexes[0].key_schema #=> Array
@@ -2518,10 +2567,18 @@ module Aws::DynamoDB
2518
2567
  # resp.item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
2519
2568
  # resp.consumed_capacity.table_name #=> String
2520
2569
  # resp.consumed_capacity.capacity_units #=> Float
2570
+ # resp.consumed_capacity.read_capacity_units #=> Float
2571
+ # resp.consumed_capacity.write_capacity_units #=> Float
2572
+ # resp.consumed_capacity.table.read_capacity_units #=> Float
2573
+ # resp.consumed_capacity.table.write_capacity_units #=> Float
2521
2574
  # resp.consumed_capacity.table.capacity_units #=> Float
2522
2575
  # resp.consumed_capacity.local_secondary_indexes #=> Hash
2576
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
2577
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
2523
2578
  # resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
2524
2579
  # resp.consumed_capacity.global_secondary_indexes #=> Hash
2580
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
2581
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
2525
2582
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
2526
2583
  #
2527
2584
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GetItem AWS API Documentation
@@ -3079,10 +3136,18 @@ module Aws::DynamoDB
3079
3136
  # resp.attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
3080
3137
  # resp.consumed_capacity.table_name #=> String
3081
3138
  # resp.consumed_capacity.capacity_units #=> Float
3139
+ # resp.consumed_capacity.read_capacity_units #=> Float
3140
+ # resp.consumed_capacity.write_capacity_units #=> Float
3141
+ # resp.consumed_capacity.table.read_capacity_units #=> Float
3142
+ # resp.consumed_capacity.table.write_capacity_units #=> Float
3082
3143
  # resp.consumed_capacity.table.capacity_units #=> Float
3083
3144
  # resp.consumed_capacity.local_secondary_indexes #=> Hash
3145
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
3146
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
3084
3147
  # resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
3085
3148
  # resp.consumed_capacity.global_secondary_indexes #=> Hash
3149
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
3150
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
3086
3151
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
3087
3152
  # resp.item_collection_metrics.item_collection_key #=> Hash
3088
3153
  # resp.item_collection_metrics.item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
@@ -3611,10 +3676,18 @@ module Aws::DynamoDB
3611
3676
  # resp.last_evaluated_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
3612
3677
  # resp.consumed_capacity.table_name #=> String
3613
3678
  # resp.consumed_capacity.capacity_units #=> Float
3679
+ # resp.consumed_capacity.read_capacity_units #=> Float
3680
+ # resp.consumed_capacity.write_capacity_units #=> Float
3681
+ # resp.consumed_capacity.table.read_capacity_units #=> Float
3682
+ # resp.consumed_capacity.table.write_capacity_units #=> Float
3614
3683
  # resp.consumed_capacity.table.capacity_units #=> Float
3615
3684
  # resp.consumed_capacity.local_secondary_indexes #=> Hash
3685
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
3686
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
3616
3687
  # resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
3617
3688
  # resp.consumed_capacity.global_secondary_indexes #=> Hash
3689
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
3690
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
3618
3691
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
3619
3692
  #
3620
3693
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Query AWS API Documentation
@@ -3684,6 +3757,8 @@ module Aws::DynamoDB
3684
3757
  # resp.table_description.item_count #=> Integer
3685
3758
  # resp.table_description.table_arn #=> String
3686
3759
  # resp.table_description.table_id #=> String
3760
+ # resp.table_description.billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
3761
+ # resp.table_description.billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
3687
3762
  # resp.table_description.local_secondary_indexes #=> Array
3688
3763
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
3689
3764
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -3821,6 +3896,8 @@ module Aws::DynamoDB
3821
3896
  # resp.table_description.item_count #=> Integer
3822
3897
  # resp.table_description.table_arn #=> String
3823
3898
  # resp.table_description.table_id #=> String
3899
+ # resp.table_description.billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
3900
+ # resp.table_description.billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
3824
3901
  # resp.table_description.local_secondary_indexes #=> Array
3825
3902
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
3826
3903
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -4298,10 +4375,18 @@ module Aws::DynamoDB
4298
4375
  # resp.last_evaluated_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4299
4376
  # resp.consumed_capacity.table_name #=> String
4300
4377
  # resp.consumed_capacity.capacity_units #=> Float
4378
+ # resp.consumed_capacity.read_capacity_units #=> Float
4379
+ # resp.consumed_capacity.write_capacity_units #=> Float
4380
+ # resp.consumed_capacity.table.read_capacity_units #=> Float
4381
+ # resp.consumed_capacity.table.write_capacity_units #=> Float
4301
4382
  # resp.consumed_capacity.table.capacity_units #=> Float
4302
4383
  # resp.consumed_capacity.local_secondary_indexes #=> Hash
4384
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
4385
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
4303
4386
  # resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
4304
4387
  # resp.consumed_capacity.global_secondary_indexes #=> Hash
4388
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
4389
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
4305
4390
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
4306
4391
  #
4307
4392
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Scan AWS API Documentation
@@ -4355,6 +4440,309 @@ module Aws::DynamoDB
4355
4440
  req.send_request(options)
4356
4441
  end
4357
4442
 
4443
+ # `TransactGetItems` is a synchronous operation that atomically
4444
+ # retrieves multiple items from one or more tables (but not from
4445
+ # indexes) in a single account and region. A `TransactGetItems` call can
4446
+ # contain up to 10 `TransactGetItem` objects, each of which contains a
4447
+ # `Get` structure that specifies an item to retrieve from a table in the
4448
+ # account and region. A call to `TransactGetItems` cannot retrieve items
4449
+ # from tables in more than one AWS account or region.
4450
+ #
4451
+ # DynamoDB rejects the entire `TransactGetItems` request if any of the
4452
+ # following is true:
4453
+ #
4454
+ # * A conflicting operation is in the process of updating an item to be
4455
+ # read.
4456
+ #
4457
+ # * There is insufficient provisioned capacity for the transaction to be
4458
+ # completed.
4459
+ #
4460
+ # * There is a user error, such as an invalid data format.
4461
+ #
4462
+ # @option params [required, Array<Types::TransactGetItem>] :transact_items
4463
+ # An ordered array of up to 10 `TransactGetItem` objects, each of which
4464
+ # contains a `Get` structure.
4465
+ #
4466
+ # @option params [String] :return_consumed_capacity
4467
+ # A value of `TOTAL` causes consumed capacity information to be
4468
+ # returned, and a value of `NONE` prevents that information from being
4469
+ # returned. No other value is valid.
4470
+ #
4471
+ # @return [Types::TransactGetItemsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4472
+ #
4473
+ # * {Types::TransactGetItemsOutput#consumed_capacity #consumed_capacity} => Array&lt;Types::ConsumedCapacity&gt;
4474
+ # * {Types::TransactGetItemsOutput#responses #responses} => Array&lt;Types::ItemResponse&gt;
4475
+ #
4476
+ # @example Request syntax with placeholder values
4477
+ #
4478
+ # resp = client.transact_get_items({
4479
+ # transact_items: [ # required
4480
+ # {
4481
+ # get: { # required
4482
+ # key: { # required
4483
+ # "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4484
+ # },
4485
+ # table_name: "TableName", # required
4486
+ # projection_expression: "ProjectionExpression",
4487
+ # expression_attribute_names: {
4488
+ # "ExpressionAttributeNameVariable" => "AttributeName",
4489
+ # },
4490
+ # },
4491
+ # },
4492
+ # ],
4493
+ # return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
4494
+ # })
4495
+ #
4496
+ # @example Response structure
4497
+ #
4498
+ # resp.consumed_capacity #=> Array
4499
+ # resp.consumed_capacity[0].table_name #=> String
4500
+ # resp.consumed_capacity[0].capacity_units #=> Float
4501
+ # resp.consumed_capacity[0].read_capacity_units #=> Float
4502
+ # resp.consumed_capacity[0].write_capacity_units #=> Float
4503
+ # resp.consumed_capacity[0].table.read_capacity_units #=> Float
4504
+ # resp.consumed_capacity[0].table.write_capacity_units #=> Float
4505
+ # resp.consumed_capacity[0].table.capacity_units #=> Float
4506
+ # resp.consumed_capacity[0].local_secondary_indexes #=> Hash
4507
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
4508
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
4509
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
4510
+ # resp.consumed_capacity[0].global_secondary_indexes #=> Hash
4511
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
4512
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
4513
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
4514
+ # resp.responses #=> Array
4515
+ # resp.responses[0].item #=> Hash
4516
+ # resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4517
+ #
4518
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TransactGetItems AWS API Documentation
4519
+ #
4520
+ # @overload transact_get_items(params = {})
4521
+ # @param [Hash] params ({})
4522
+ def transact_get_items(params = {}, options = {})
4523
+ req = build_request(:transact_get_items, params)
4524
+ req.send_request(options)
4525
+ end
4526
+
4527
+ # `TransactWriteItems` is a synchronous write operation that groups up
4528
+ # to 10 action requests. These actions can target items in different
4529
+ # tables, but not in different AWS accounts or regions, and no two
4530
+ # actions can target the same item. For example, you cannot both
4531
+ # `ConditionCheck` and `Update` the same item.
4532
+ #
4533
+ # The actions are completed atomically so that either all of them
4534
+ # succeed, or all of them fail. They are defined by the following
4535
+ # objects:
4536
+ #
4537
+ # * `Put`  —   Initiates a `PutItem` operation to write a new item. This
4538
+ # structure specifies the primary key of the item to be written, the
4539
+ # name of the table to write it in, an optional condition expression
4540
+ # that must be satisfied for the write to succeed, a list of the
4541
+ # item's attributes, and a field indicating whether or not to
4542
+ # retrieve the item's attributes if the condition is not met.
4543
+ #
4544
+ # * `Update`  —   Initiates an `UpdateItem` operation to update an
4545
+ # existing item. This structure specifies the primary key of the item
4546
+ # to be updated, the name of the table where it resides, an optional
4547
+ # condition expression that must be satisfied for the update to
4548
+ # succeed, an expression that defines one or more attributes to be
4549
+ # updated, and a field indicating whether or not to retrieve the
4550
+ # item's attributes if the condition is not met.
4551
+ #
4552
+ # * `Delete`  —   Initiates a `DeleteItem` operation to delete an
4553
+ # existing item. This structure specifies the primary key of the item
4554
+ # to be deleted, the name of the table where it resides, an optional
4555
+ # condition expression that must be satisfied for the deletion to
4556
+ # succeed, and a field indicating whether or not to retrieve the
4557
+ # item's attributes if the condition is not met.
4558
+ #
4559
+ # * `ConditionCheck`  —   Applies a condition to an item that is not
4560
+ # being modified by the transaction. This structure specifies the
4561
+ # primary key of the item to be checked, the name of the table where
4562
+ # it resides, a condition expression that must be satisfied for the
4563
+ # transaction to succeed, and a field indicating whether or not to
4564
+ # retrieve the item's attributes if the condition is not met.
4565
+ #
4566
+ # DynamoDB rejects the entire `TransactWriteItems` request if any of the
4567
+ # following is true:
4568
+ #
4569
+ # * A condition in one of the condition expressions is not met.
4570
+ #
4571
+ # * A conflicting operation is in the process of updating the same item.
4572
+ #
4573
+ # * There is insufficient provisioned capacity for the transaction to be
4574
+ # completed.
4575
+ #
4576
+ # * An item size becomes too large (bigger than 400 KB), a Local
4577
+ # Secondary Index (LSI) becomes too large, or a similar validation
4578
+ # error occurs because of changes made by the transaction.
4579
+ #
4580
+ # * There is a user error, such as an invalid data format.
4581
+ #
4582
+ # @option params [required, Array<Types::TransactWriteItem>] :transact_items
4583
+ # An ordered array of up to 10 `TransactWriteItem` objects, each of
4584
+ # which contains a `ConditionCheck`, `Put`, `Update`, or `Delete`
4585
+ # object. These can operate on items in different tables, but the tables
4586
+ # must reside in the same AWS account and region, and no two of them can
4587
+ # operate on the same item.
4588
+ #
4589
+ # @option params [String] :return_consumed_capacity
4590
+ # Determines the level of detail about provisioned throughput
4591
+ # consumption that is returned in the response:
4592
+ #
4593
+ # * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
4594
+ # for the operation, together with `ConsumedCapacity` for each table
4595
+ # and secondary index that was accessed.
4596
+ #
4597
+ # Note that some operations, such as `GetItem` and `BatchGetItem`, do
4598
+ # not access any indexes at all. In these cases, specifying `INDEXES`
4599
+ # will only return `ConsumedCapacity` information for table(s).
4600
+ #
4601
+ # * `TOTAL` - The response includes only the aggregate
4602
+ # `ConsumedCapacity` for the operation.
4603
+ #
4604
+ # * `NONE` - No `ConsumedCapacity` details are included in the response.
4605
+ #
4606
+ # @option params [String] :return_item_collection_metrics
4607
+ # Determines whether item collection metrics are returned. If set to
4608
+ # `SIZE`, the response includes statistics about item collections (if
4609
+ # any), that were modified during the operation and are returned in the
4610
+ # response. If set to `NONE` (the default), no statistics are returned.
4611
+ #
4612
+ # @option params [String] :client_request_token
4613
+ # Providing a `ClientRequestToken` makes the call to
4614
+ # `TransactWriteItems` idempotent, meaning that multiple identical calls
4615
+ # have the same effect as one single call.
4616
+ #
4617
+ # Although multiple identical calls using the same client request token
4618
+ # produce the same result on the server (no side effects), the responses
4619
+ # to the calls may not be the same. If the `ReturnConsumedCapacity>`
4620
+ # parameter is set, then the initial `TransactWriteItems` call returns
4621
+ # the amount of write capacity units consumed in making the changes, and
4622
+ # subsequent `TransactWriteItems` calls with the same client token
4623
+ # return the amount of read capacity units consumed in reading the item.
4624
+ #
4625
+ # A client request token is valid for 10 minutes after the first request
4626
+ # that uses it completes. After 10 minutes, any request with the same
4627
+ # client token is treated as a new request. Do not resubmit the same
4628
+ # request with the same client token for more than 10 minutes or the
4629
+ # result may not be idempotent.
4630
+ #
4631
+ # If you submit a request with the same client token but a change in
4632
+ # other parameters within the 10 minute idempotency window, DynamoDB
4633
+ # returns an `IdempotentParameterMismatch` exception.
4634
+ #
4635
+ # **A suitable default value is auto-generated.** You should normally
4636
+ # not need to pass this option.**
4637
+ #
4638
+ # @return [Types::TransactWriteItemsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4639
+ #
4640
+ # * {Types::TransactWriteItemsOutput#consumed_capacity #consumed_capacity} => Array&lt;Types::ConsumedCapacity&gt;
4641
+ # * {Types::TransactWriteItemsOutput#item_collection_metrics #item_collection_metrics} => Hash&lt;String,Array&lt;Types::ItemCollectionMetrics&gt;&gt;
4642
+ #
4643
+ # @example Request syntax with placeholder values
4644
+ #
4645
+ # resp = client.transact_write_items({
4646
+ # transact_items: [ # required
4647
+ # {
4648
+ # condition_check: {
4649
+ # key: { # required
4650
+ # "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4651
+ # },
4652
+ # table_name: "TableName", # required
4653
+ # condition_expression: "ConditionExpression", # required
4654
+ # expression_attribute_names: {
4655
+ # "ExpressionAttributeNameVariable" => "AttributeName",
4656
+ # },
4657
+ # expression_attribute_values: {
4658
+ # "ExpressionAttributeValueVariable" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4659
+ # },
4660
+ # return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
4661
+ # },
4662
+ # put: {
4663
+ # item: { # required
4664
+ # "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4665
+ # },
4666
+ # table_name: "TableName", # required
4667
+ # condition_expression: "ConditionExpression",
4668
+ # expression_attribute_names: {
4669
+ # "ExpressionAttributeNameVariable" => "AttributeName",
4670
+ # },
4671
+ # expression_attribute_values: {
4672
+ # "ExpressionAttributeValueVariable" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4673
+ # },
4674
+ # return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
4675
+ # },
4676
+ # delete: {
4677
+ # key: { # required
4678
+ # "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4679
+ # },
4680
+ # table_name: "TableName", # required
4681
+ # condition_expression: "ConditionExpression",
4682
+ # expression_attribute_names: {
4683
+ # "ExpressionAttributeNameVariable" => "AttributeName",
4684
+ # },
4685
+ # expression_attribute_values: {
4686
+ # "ExpressionAttributeValueVariable" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4687
+ # },
4688
+ # return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
4689
+ # },
4690
+ # update: {
4691
+ # key: { # required
4692
+ # "AttributeName" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4693
+ # },
4694
+ # update_expression: "UpdateExpression", # required
4695
+ # table_name: "TableName", # required
4696
+ # condition_expression: "ConditionExpression",
4697
+ # expression_attribute_names: {
4698
+ # "ExpressionAttributeNameVariable" => "AttributeName",
4699
+ # },
4700
+ # expression_attribute_values: {
4701
+ # "ExpressionAttributeValueVariable" => "value", # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4702
+ # },
4703
+ # return_values_on_condition_check_failure: "ALL_OLD", # accepts ALL_OLD, NONE
4704
+ # },
4705
+ # },
4706
+ # ],
4707
+ # return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
4708
+ # return_item_collection_metrics: "SIZE", # accepts SIZE, NONE
4709
+ # client_request_token: "String",
4710
+ # })
4711
+ #
4712
+ # @example Response structure
4713
+ #
4714
+ # resp.consumed_capacity #=> Array
4715
+ # resp.consumed_capacity[0].table_name #=> String
4716
+ # resp.consumed_capacity[0].capacity_units #=> Float
4717
+ # resp.consumed_capacity[0].read_capacity_units #=> Float
4718
+ # resp.consumed_capacity[0].write_capacity_units #=> Float
4719
+ # resp.consumed_capacity[0].table.read_capacity_units #=> Float
4720
+ # resp.consumed_capacity[0].table.write_capacity_units #=> Float
4721
+ # resp.consumed_capacity[0].table.capacity_units #=> Float
4722
+ # resp.consumed_capacity[0].local_secondary_indexes #=> Hash
4723
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
4724
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
4725
+ # resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
4726
+ # resp.consumed_capacity[0].global_secondary_indexes #=> Hash
4727
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
4728
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
4729
+ # resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
4730
+ # resp.item_collection_metrics #=> Hash
4731
+ # resp.item_collection_metrics["TableName"] #=> Array
4732
+ # resp.item_collection_metrics["TableName"][0].item_collection_key #=> Hash
4733
+ # resp.item_collection_metrics["TableName"][0].item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
4734
+ # resp.item_collection_metrics["TableName"][0].size_estimate_range_gb #=> Array
4735
+ # resp.item_collection_metrics["TableName"][0].size_estimate_range_gb[0] #=> Float
4736
+ #
4737
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TransactWriteItems AWS API Documentation
4738
+ #
4739
+ # @overload transact_write_items(params = {})
4740
+ # @param [Hash] params ({})
4741
+ def transact_write_items(params = {}, options = {})
4742
+ req = build_request(:transact_write_items, params)
4743
+ req.send_request(options)
4744
+ end
4745
+
4358
4746
  # Removes the association of tags from an Amazon DynamoDB resource. You
4359
4747
  # can call UntagResource up to 5 times per second, per account.
4360
4748
  #
@@ -4516,6 +4904,11 @@ module Aws::DynamoDB
4516
4904
  # @option params [required, String] :global_table_name
4517
4905
  # The name of the global table
4518
4906
  #
4907
+ # @option params [String] :global_table_billing_mode
4908
+ # The billing mode of the global table. If `GlobalTableBillingMode` is
4909
+ # not specified, the global table defaults to `PROVISIONED` capacity
4910
+ # billing mode.
4911
+ #
4519
4912
  # @option params [Integer] :global_table_provisioned_write_capacity_units
4520
4913
  # The maximum number of writes consumed per second before DynamoDB
4521
4914
  # returns a `ThrottlingException.`
@@ -4541,6 +4934,7 @@ module Aws::DynamoDB
4541
4934
  #
4542
4935
  # resp = client.update_global_table_settings({
4543
4936
  # global_table_name: "TableName", # required
4937
+ # global_table_billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
4544
4938
  # global_table_provisioned_write_capacity_units: 1,
4545
4939
  # global_table_provisioned_write_capacity_auto_scaling_settings_update: {
4546
4940
  # minimum_units: 1,
@@ -4628,6 +5022,8 @@ module Aws::DynamoDB
4628
5022
  # resp.replica_settings #=> Array
4629
5023
  # resp.replica_settings[0].region_name #=> String
4630
5024
  # resp.replica_settings[0].replica_status #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE"
5025
+ # resp.replica_settings[0].replica_billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
5026
+ # resp.replica_settings[0].replica_billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
4631
5027
  # resp.replica_settings[0].replica_provisioned_read_capacity_units #=> Integer
4632
5028
  # resp.replica_settings[0].replica_provisioned_read_capacity_auto_scaling_settings.minimum_units #=> Integer
4633
5029
  # resp.replica_settings[0].replica_provisioned_read_capacity_auto_scaling_settings.maximum_units #=> Integer
@@ -5068,10 +5464,18 @@ module Aws::DynamoDB
5068
5464
  # resp.attributes["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
5069
5465
  # resp.consumed_capacity.table_name #=> String
5070
5466
  # resp.consumed_capacity.capacity_units #=> Float
5467
+ # resp.consumed_capacity.read_capacity_units #=> Float
5468
+ # resp.consumed_capacity.write_capacity_units #=> Float
5469
+ # resp.consumed_capacity.table.read_capacity_units #=> Float
5470
+ # resp.consumed_capacity.table.write_capacity_units #=> Float
5071
5471
  # resp.consumed_capacity.table.capacity_units #=> Float
5072
5472
  # resp.consumed_capacity.local_secondary_indexes #=> Hash
5473
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
5474
+ # resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
5073
5475
  # resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
5074
5476
  # resp.consumed_capacity.global_secondary_indexes #=> Hash
5477
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
5478
+ # resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
5075
5479
  # resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
5076
5480
  # resp.item_collection_metrics.item_collection_key #=> Hash
5077
5481
  # resp.item_collection_metrics.item_collection_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
@@ -5117,6 +5521,20 @@ module Aws::DynamoDB
5117
5521
  # @option params [required, String] :table_name
5118
5522
  # The name of the table to be updated.
5119
5523
  #
5524
+ # @option params [String] :billing_mode
5525
+ # Controls how you are charged for read and write throughput and how you
5526
+ # manage capacity. When switching from pay-per-request to provisioned
5527
+ # capacity, initial provisioned capacity values must be set. The initial
5528
+ # provisioned capacity values are estimated based on the consumed read
5529
+ # and write capacity of your table and global secondary indexes over the
5530
+ # past 30 minutes.
5531
+ #
5532
+ # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We recommend
5533
+ # using `PROVISIONED` for predictable workloads.
5534
+ #
5535
+ # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
5536
+ # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
5537
+ #
5120
5538
  # @option params [Types::ProvisionedThroughput] :provisioned_throughput
5121
5539
  # The new provisioned throughput settings for the specified table or
5122
5540
  # index.
@@ -5215,6 +5633,7 @@ module Aws::DynamoDB
5215
5633
  # },
5216
5634
  # ],
5217
5635
  # table_name: "TableName", # required
5636
+ # billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
5218
5637
  # provisioned_throughput: {
5219
5638
  # read_capacity_units: 1, # required
5220
5639
  # write_capacity_units: 1, # required
@@ -5240,7 +5659,7 @@ module Aws::DynamoDB
5240
5659
  # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
5241
5660
  # non_key_attributes: ["NonKeyAttributeName"],
5242
5661
  # },
5243
- # provisioned_throughput: { # required
5662
+ # provisioned_throughput: {
5244
5663
  # read_capacity_units: 1, # required
5245
5664
  # write_capacity_units: 1, # required
5246
5665
  # },
@@ -5281,6 +5700,8 @@ module Aws::DynamoDB
5281
5700
  # resp.table_description.item_count #=> Integer
5282
5701
  # resp.table_description.table_arn #=> String
5283
5702
  # resp.table_description.table_id #=> String
5703
+ # resp.table_description.billing_mode_summary.billing_mode #=> String, one of "PROVISIONED", "PAY_PER_REQUEST"
5704
+ # resp.table_description.billing_mode_summary.last_update_to_pay_per_request_date_time #=> Time
5284
5705
  # resp.table_description.local_secondary_indexes #=> Array
5285
5706
  # resp.table_description.local_secondary_indexes[0].index_name #=> String
5286
5707
  # resp.table_description.local_secondary_indexes[0].key_schema #=> Array
@@ -5416,7 +5837,7 @@ module Aws::DynamoDB
5416
5837
  params: params,
5417
5838
  config: config)
5418
5839
  context[:gem_name] = 'aws-sdk-dynamodb'
5419
- context[:gem_version] = '1.17.0'
5840
+ context[:gem_version] = '1.18.0'
5420
5841
  Seahorse::Client::Request.new(handlers, context)
5421
5842
  end
5422
5843