aws-sdk-dynamodb 1.17.0 → 1.18.0

Sign up to get free protection for your applications and to get access to all the features.
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