aws-sdk-dynamodb 1.63.0 → 1.67.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-dynamodb/client.rb +207 -73
- data/lib/aws-sdk-dynamodb/client_api.rb +6 -0
- data/lib/aws-sdk-dynamodb/resource.rb +4 -4
- data/lib/aws-sdk-dynamodb/table.rb +21 -19
- data/lib/aws-sdk-dynamodb/types.rb +187 -104
- data/lib/aws-sdk-dynamodb.rb +1 -1
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: '09ddd8ebcc2e63ee9235e0363e699689533e498a734dca0ce70a79afa517da81'
|
4
|
+
data.tar.gz: 53678f725ca52a1c8312cd2bc5f7a56c94da3fd5a880d216da796b30ccb9bdba
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: ec684ac8b8ffba7ef4ed8e836a96c29c615631218027f8dce64a39d957204ab8fc6bbede7601062bba6b34465b8615cf96e8da13d62d480c136d45a0bedfae03
|
7
|
+
data.tar.gz: 4c5f718d08f2981f02674f9e327f2fdf2ccd0ad7bc58a7c349c6610278283e7259b442976647fc6547cafb178651d7aeb2168b7d8d4f40ce0585cc924516fc84
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,26 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.67.0 (2021-11-23)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - DynamoDB PartiQL now supports ReturnConsumedCapacity, which returns capacity units consumed by PartiQL APIs if the request specified returnConsumedCapacity parameter. PartiQL APIs include ExecuteStatement, BatchExecuteStatement, and ExecuteTransaction.
|
8
|
+
|
9
|
+
1.66.0 (2021-11-11)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Updated Help section for "dynamodb update-contributor-insights" API
|
13
|
+
|
14
|
+
1.65.0 (2021-11-04)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
18
|
+
|
19
|
+
1.64.0 (2021-10-18)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
23
|
+
|
4
24
|
1.63.0 (2021-09-01)
|
5
25
|
------------------
|
6
26
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.67.0
|
@@ -304,6 +304,15 @@ module Aws::DynamoDB
|
|
304
304
|
# ** Please note ** When response stubbing is enabled, no HTTP
|
305
305
|
# requests are made, and retries are disabled.
|
306
306
|
#
|
307
|
+
# @option options [Boolean] :use_dualstack_endpoint
|
308
|
+
# When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
|
309
|
+
# will be used if available.
|
310
|
+
#
|
311
|
+
# @option options [Boolean] :use_fips_endpoint
|
312
|
+
# When set to `true`, fips compatible endpoints will be used if available.
|
313
|
+
# When a `fips` region is used, the region is normalized and this config
|
314
|
+
# is set to `true`.
|
315
|
+
#
|
307
316
|
# @option options [Boolean] :validate_params (true)
|
308
317
|
# When `true`, request parameters are validated before
|
309
318
|
# sending the request.
|
@@ -356,15 +365,38 @@ module Aws::DynamoDB
|
|
356
365
|
|
357
366
|
# @!group API Operations
|
358
367
|
|
359
|
-
# This operation allows you to perform batch reads
|
368
|
+
# This operation allows you to perform batch reads or writes on data
|
360
369
|
# stored in DynamoDB, using PartiQL.
|
361
370
|
#
|
371
|
+
# <note markdown="1"> The entire batch must consist of either read statements or write
|
372
|
+
# statements, you cannot mix both in one batch.
|
373
|
+
#
|
374
|
+
# </note>
|
375
|
+
#
|
362
376
|
# @option params [required, Array<Types::BatchStatementRequest>] :statements
|
363
377
|
# The list of PartiQL statements representing the batch to run.
|
364
378
|
#
|
379
|
+
# @option params [String] :return_consumed_capacity
|
380
|
+
# Determines the level of detail about either provisioned or on-demand
|
381
|
+
# throughput consumption that is returned in the response:
|
382
|
+
#
|
383
|
+
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
384
|
+
# for the operation, together with `ConsumedCapacity` for each table
|
385
|
+
# and secondary index that was accessed.
|
386
|
+
#
|
387
|
+
# Note that some operations, such as `GetItem` and `BatchGetItem`, do
|
388
|
+
# not access any indexes at all. In these cases, specifying `INDEXES`
|
389
|
+
# will only return `ConsumedCapacity` information for table(s).
|
390
|
+
#
|
391
|
+
# * `TOTAL` - The response includes only the aggregate
|
392
|
+
# `ConsumedCapacity` for the operation.
|
393
|
+
#
|
394
|
+
# * `NONE` - No `ConsumedCapacity` details are included in the response.
|
395
|
+
#
|
365
396
|
# @return [Types::BatchExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
366
397
|
#
|
367
398
|
# * {Types::BatchExecuteStatementOutput#responses #responses} => Array<Types::BatchStatementResponse>
|
399
|
+
# * {Types::BatchExecuteStatementOutput#consumed_capacity #consumed_capacity} => Array<Types::ConsumedCapacity>
|
368
400
|
#
|
369
401
|
# @example Request syntax with placeholder values
|
370
402
|
#
|
@@ -376,6 +408,7 @@ module Aws::DynamoDB
|
|
376
408
|
# consistent_read: false,
|
377
409
|
# },
|
378
410
|
# ],
|
411
|
+
# return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
|
379
412
|
# })
|
380
413
|
#
|
381
414
|
# @example Response structure
|
@@ -386,6 +419,22 @@ module Aws::DynamoDB
|
|
386
419
|
# resp.responses[0].table_name #=> String
|
387
420
|
# resp.responses[0].item #=> Hash
|
388
421
|
# resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
422
|
+
# resp.consumed_capacity #=> Array
|
423
|
+
# resp.consumed_capacity[0].table_name #=> String
|
424
|
+
# resp.consumed_capacity[0].capacity_units #=> Float
|
425
|
+
# resp.consumed_capacity[0].read_capacity_units #=> Float
|
426
|
+
# resp.consumed_capacity[0].write_capacity_units #=> Float
|
427
|
+
# resp.consumed_capacity[0].table.read_capacity_units #=> Float
|
428
|
+
# resp.consumed_capacity[0].table.write_capacity_units #=> Float
|
429
|
+
# resp.consumed_capacity[0].table.capacity_units #=> Float
|
430
|
+
# resp.consumed_capacity[0].local_secondary_indexes #=> Hash
|
431
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
432
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
433
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
|
434
|
+
# resp.consumed_capacity[0].global_secondary_indexes #=> Hash
|
435
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
436
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
437
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
|
389
438
|
#
|
390
439
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchExecuteStatement AWS API Documentation
|
391
440
|
#
|
@@ -547,8 +596,8 @@ module Aws::DynamoDB
|
|
547
596
|
# [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html
|
548
597
|
#
|
549
598
|
# @option params [String] :return_consumed_capacity
|
550
|
-
# Determines the level of detail about provisioned
|
551
|
-
# consumption that is returned in the response:
|
599
|
+
# Determines the level of detail about either provisioned or on-demand
|
600
|
+
# throughput consumption that is returned in the response:
|
552
601
|
#
|
553
602
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
554
603
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -796,8 +845,8 @@ module Aws::DynamoDB
|
|
796
845
|
# in the table's attribute definition.
|
797
846
|
#
|
798
847
|
# @option params [String] :return_consumed_capacity
|
799
|
-
# Determines the level of detail about provisioned
|
800
|
-
# consumption that is returned in the response:
|
848
|
+
# Determines the level of detail about either provisioned or on-demand
|
849
|
+
# throughput consumption that is returned in the response:
|
801
850
|
#
|
802
851
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
803
852
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -1100,9 +1149,9 @@ module Aws::DynamoDB
|
|
1100
1149
|
end
|
1101
1150
|
|
1102
1151
|
# The `CreateTable` operation adds a new table to your account. In an
|
1103
|
-
#
|
1104
|
-
# you can have two tables with same name if you create
|
1105
|
-
# different Regions.
|
1152
|
+
# Amazon Web Services account, table names must be unique within each
|
1153
|
+
# Region. That is, you can have two tables with same name if you create
|
1154
|
+
# the tables in different Regions.
|
1106
1155
|
#
|
1107
1156
|
# `CreateTable` is an asynchronous operation. Upon receiving a
|
1108
1157
|
# `CreateTable` request, DynamoDB immediately returns a response with a
|
@@ -1689,8 +1738,8 @@ module Aws::DynamoDB
|
|
1689
1738
|
# </note>
|
1690
1739
|
#
|
1691
1740
|
# @option params [String] :return_consumed_capacity
|
1692
|
-
# Determines the level of detail about provisioned
|
1693
|
-
# consumption that is returned in the response:
|
1741
|
+
# Determines the level of detail about either provisioned or on-demand
|
1742
|
+
# throughput consumption that is returned in the response:
|
1694
1743
|
#
|
1695
1744
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
1696
1745
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -2456,25 +2505,26 @@ module Aws::DynamoDB
|
|
2456
2505
|
req.send_request(options)
|
2457
2506
|
end
|
2458
2507
|
|
2459
|
-
# Returns the current provisioned-capacity quotas for your
|
2460
|
-
# in a Region, both for the Region as a whole and for
|
2461
|
-
# table that you create there.
|
2462
|
-
#
|
2463
|
-
# When you establish an
|
2464
|
-
# the maximum read capacity units and write capacity
|
2465
|
-
# provision across all of your DynamoDB tables in a
|
2466
|
-
# there are per-table quotas that apply when you
|
2467
|
-
# For more information, see [Service, Account, and
|
2468
|
-
# in the *Amazon DynamoDB Developer Guide*.
|
2469
|
-
#
|
2470
|
-
# Although you can increase these quotas by filing a case at [
|
2471
|
-
# Support Center][2], obtaining the increase is not
|
2472
|
-
# `DescribeLimits` action lets you write code to
|
2473
|
-
# you are currently using to those quotas imposed
|
2474
|
-
# that you have enough time to apply for an increase
|
2475
|
-
# quota.
|
2476
|
-
#
|
2477
|
-
# For example, you could use one of the
|
2508
|
+
# Returns the current provisioned-capacity quotas for your Amazon Web
|
2509
|
+
# Services account in a Region, both for the Region as a whole and for
|
2510
|
+
# any one DynamoDB table that you create there.
|
2511
|
+
#
|
2512
|
+
# When you establish an Amazon Web Services account, the account has
|
2513
|
+
# initial quotas on the maximum read capacity units and write capacity
|
2514
|
+
# units that you can provision across all of your DynamoDB tables in a
|
2515
|
+
# given Region. Also, there are per-table quotas that apply when you
|
2516
|
+
# create a table there. For more information, see [Service, Account, and
|
2517
|
+
# Table Quotas][1] page in the *Amazon DynamoDB Developer Guide*.
|
2518
|
+
#
|
2519
|
+
# Although you can increase these quotas by filing a case at [Amazon Web
|
2520
|
+
# Services Support Center][2], obtaining the increase is not
|
2521
|
+
# instantaneous. The `DescribeLimits` action lets you write code to
|
2522
|
+
# compare the capacity you are currently using to those quotas imposed
|
2523
|
+
# by your account so that you have enough time to apply for an increase
|
2524
|
+
# before you hit a quota.
|
2525
|
+
#
|
2526
|
+
# For example, you could use one of the Amazon Web Services SDKs to do
|
2527
|
+
# the following:
|
2478
2528
|
#
|
2479
2529
|
# 1. Call `DescribeLimits` for a particular Region to obtain your
|
2480
2530
|
# current account quotas on provisioned capacity there.
|
@@ -2940,10 +2990,28 @@ module Aws::DynamoDB
|
|
2940
2990
|
# Set this value to get remaining results, if `NextToken` was returned
|
2941
2991
|
# in the statement response.
|
2942
2992
|
#
|
2993
|
+
# @option params [String] :return_consumed_capacity
|
2994
|
+
# Determines the level of detail about either provisioned or on-demand
|
2995
|
+
# throughput consumption that is returned in the response:
|
2996
|
+
#
|
2997
|
+
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
2998
|
+
# for the operation, together with `ConsumedCapacity` for each table
|
2999
|
+
# and secondary index that was accessed.
|
3000
|
+
#
|
3001
|
+
# Note that some operations, such as `GetItem` and `BatchGetItem`, do
|
3002
|
+
# not access any indexes at all. In these cases, specifying `INDEXES`
|
3003
|
+
# will only return `ConsumedCapacity` information for table(s).
|
3004
|
+
#
|
3005
|
+
# * `TOTAL` - The response includes only the aggregate
|
3006
|
+
# `ConsumedCapacity` for the operation.
|
3007
|
+
#
|
3008
|
+
# * `NONE` - No `ConsumedCapacity` details are included in the response.
|
3009
|
+
#
|
2943
3010
|
# @return [Types::ExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2944
3011
|
#
|
2945
3012
|
# * {Types::ExecuteStatementOutput#items #items} => Array<Hash<String,Types::AttributeValue>>
|
2946
3013
|
# * {Types::ExecuteStatementOutput#next_token #next_token} => String
|
3014
|
+
# * {Types::ExecuteStatementOutput#consumed_capacity #consumed_capacity} => Types::ConsumedCapacity
|
2947
3015
|
#
|
2948
3016
|
# @example Request syntax with placeholder values
|
2949
3017
|
#
|
@@ -2952,6 +3020,7 @@ module Aws::DynamoDB
|
|
2952
3020
|
# parameters: ["value"], # value <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
2953
3021
|
# consistent_read: false,
|
2954
3022
|
# next_token: "PartiQLNextToken",
|
3023
|
+
# return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
|
2955
3024
|
# })
|
2956
3025
|
#
|
2957
3026
|
# @example Response structure
|
@@ -2960,6 +3029,21 @@ module Aws::DynamoDB
|
|
2960
3029
|
# resp.items[0] #=> Hash
|
2961
3030
|
# resp.items[0]["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
2962
3031
|
# resp.next_token #=> String
|
3032
|
+
# resp.consumed_capacity.table_name #=> String
|
3033
|
+
# resp.consumed_capacity.capacity_units #=> Float
|
3034
|
+
# resp.consumed_capacity.read_capacity_units #=> Float
|
3035
|
+
# resp.consumed_capacity.write_capacity_units #=> Float
|
3036
|
+
# resp.consumed_capacity.table.read_capacity_units #=> Float
|
3037
|
+
# resp.consumed_capacity.table.write_capacity_units #=> Float
|
3038
|
+
# resp.consumed_capacity.table.capacity_units #=> Float
|
3039
|
+
# resp.consumed_capacity.local_secondary_indexes #=> Hash
|
3040
|
+
# resp.consumed_capacity.local_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3041
|
+
# resp.consumed_capacity.local_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3042
|
+
# resp.consumed_capacity.local_secondary_indexes["IndexName"].capacity_units #=> Float
|
3043
|
+
# resp.consumed_capacity.global_secondary_indexes #=> Hash
|
3044
|
+
# resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3045
|
+
# resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3046
|
+
# resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
|
2963
3047
|
#
|
2964
3048
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatement AWS API Documentation
|
2965
3049
|
#
|
@@ -2973,6 +3057,18 @@ module Aws::DynamoDB
|
|
2973
3057
|
# This operation allows you to perform transactional reads or writes on
|
2974
3058
|
# data stored in DynamoDB, using PartiQL.
|
2975
3059
|
#
|
3060
|
+
# <note markdown="1"> The entire transaction must consist of either read statements or write
|
3061
|
+
# statements, you cannot mix both in one transaction. The EXISTS
|
3062
|
+
# function is an exception and can be used to check the condition of
|
3063
|
+
# specific attributes of the item in a similar manner to
|
3064
|
+
# `ConditionCheck` in the [TransactWriteItems][1] API.
|
3065
|
+
#
|
3066
|
+
# </note>
|
3067
|
+
#
|
3068
|
+
#
|
3069
|
+
#
|
3070
|
+
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/transaction-apis.html#transaction-apis-txwriteitems
|
3071
|
+
#
|
2976
3072
|
# @option params [required, Array<Types::ParameterizedStatement>] :transact_statements
|
2977
3073
|
# The list of PartiQL statements representing the transaction to run.
|
2978
3074
|
#
|
@@ -2983,9 +3079,20 @@ module Aws::DynamoDB
|
|
2983
3079
|
# **A suitable default value is auto-generated.** You should normally
|
2984
3080
|
# not need to pass this option.**
|
2985
3081
|
#
|
3082
|
+
# @option params [String] :return_consumed_capacity
|
3083
|
+
# Determines the level of detail about either provisioned or on-demand
|
3084
|
+
# throughput consumption that is returned in the response. For more
|
3085
|
+
# information, see [TransactGetItems][1] and [TransactWriteItems][2].
|
3086
|
+
#
|
3087
|
+
#
|
3088
|
+
#
|
3089
|
+
# [1]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactGetItems.html
|
3090
|
+
# [2]: https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TransactWriteItems.html
|
3091
|
+
#
|
2986
3092
|
# @return [Types::ExecuteTransactionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
2987
3093
|
#
|
2988
3094
|
# * {Types::ExecuteTransactionOutput#responses #responses} => Array<Types::ItemResponse>
|
3095
|
+
# * {Types::ExecuteTransactionOutput#consumed_capacity #consumed_capacity} => Array<Types::ConsumedCapacity>
|
2989
3096
|
#
|
2990
3097
|
# @example Request syntax with placeholder values
|
2991
3098
|
#
|
@@ -2997,6 +3104,7 @@ module Aws::DynamoDB
|
|
2997
3104
|
# },
|
2998
3105
|
# ],
|
2999
3106
|
# client_request_token: "ClientRequestToken",
|
3107
|
+
# return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
|
3000
3108
|
# })
|
3001
3109
|
#
|
3002
3110
|
# @example Response structure
|
@@ -3004,6 +3112,22 @@ module Aws::DynamoDB
|
|
3004
3112
|
# resp.responses #=> Array
|
3005
3113
|
# resp.responses[0].item #=> Hash
|
3006
3114
|
# resp.responses[0].item["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
|
3115
|
+
# resp.consumed_capacity #=> Array
|
3116
|
+
# resp.consumed_capacity[0].table_name #=> String
|
3117
|
+
# resp.consumed_capacity[0].capacity_units #=> Float
|
3118
|
+
# resp.consumed_capacity[0].read_capacity_units #=> Float
|
3119
|
+
# resp.consumed_capacity[0].write_capacity_units #=> Float
|
3120
|
+
# resp.consumed_capacity[0].table.read_capacity_units #=> Float
|
3121
|
+
# resp.consumed_capacity[0].table.write_capacity_units #=> Float
|
3122
|
+
# resp.consumed_capacity[0].table.capacity_units #=> Float
|
3123
|
+
# resp.consumed_capacity[0].local_secondary_indexes #=> Hash
|
3124
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3125
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3126
|
+
# resp.consumed_capacity[0].local_secondary_indexes["IndexName"].capacity_units #=> Float
|
3127
|
+
# resp.consumed_capacity[0].global_secondary_indexes #=> Hash
|
3128
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].read_capacity_units #=> Float
|
3129
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].write_capacity_units #=> Float
|
3130
|
+
# resp.consumed_capacity[0].global_secondary_indexes["IndexName"].capacity_units #=> Float
|
3007
3131
|
#
|
3008
3132
|
# @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteTransaction AWS API Documentation
|
3009
3133
|
#
|
@@ -3047,8 +3171,8 @@ module Aws::DynamoDB
|
|
3047
3171
|
# The name of the Amazon S3 bucket to export the snapshot to.
|
3048
3172
|
#
|
3049
3173
|
# @option params [String] :s3_bucket_owner
|
3050
|
-
# The ID of the
|
3051
|
-
# stored in.
|
3174
|
+
# The ID of the Amazon Web Services account that owns the bucket the
|
3175
|
+
# export will be stored in.
|
3052
3176
|
#
|
3053
3177
|
# @option params [String] :s3_prefix
|
3054
3178
|
# The Amazon S3 bucket prefix to use as the file name and path of the
|
@@ -3060,10 +3184,10 @@ module Aws::DynamoDB
|
|
3060
3184
|
#
|
3061
3185
|
# * `AES256` - server-side encryption with Amazon S3 managed keys
|
3062
3186
|
#
|
3063
|
-
# * `KMS` - server-side encryption with
|
3187
|
+
# * `KMS` - server-side encryption with KMS managed keys
|
3064
3188
|
#
|
3065
3189
|
# @option params [String] :s3_sse_kms_key_id
|
3066
|
-
# The ID of the
|
3190
|
+
# The ID of the KMS managed key used to encrypt the S3 bucket where
|
3067
3191
|
# export data will be stored (if applicable).
|
3068
3192
|
#
|
3069
3193
|
# @option params [String] :export_format
|
@@ -3157,8 +3281,8 @@ module Aws::DynamoDB
|
|
3157
3281
|
# uses eventually consistent reads.
|
3158
3282
|
#
|
3159
3283
|
# @option params [String] :return_consumed_capacity
|
3160
|
-
# Determines the level of detail about provisioned
|
3161
|
-
# consumption that is returned in the response:
|
3284
|
+
# Determines the level of detail about either provisioned or on-demand
|
3285
|
+
# throughput consumption that is returned in the response:
|
3162
3286
|
#
|
3163
3287
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
3164
3288
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -3314,10 +3438,11 @@ module Aws::DynamoDB
|
|
3314
3438
|
req.send_request(options)
|
3315
3439
|
end
|
3316
3440
|
|
3317
|
-
# List backups associated with an
|
3318
|
-
# given table, specify `TableName`. `ListBackups` returns
|
3319
|
-
# list of results with at most 1 MB worth of items in a
|
3320
|
-
# also specify a maximum number of entries to be returned
|
3441
|
+
# List backups associated with an Amazon Web Services account. To list
|
3442
|
+
# backups for a given table, specify `TableName`. `ListBackups` returns
|
3443
|
+
# a paginated list of results with at most 1 MB worth of items in a
|
3444
|
+
# page. You can also specify a maximum number of entries to be returned
|
3445
|
+
# in a page.
|
3321
3446
|
#
|
3322
3447
|
# In the request, start time is inclusive, but end time is exclusive.
|
3323
3448
|
# Note that these boundaries are for the time at which the original
|
@@ -3660,26 +3785,26 @@ module Aws::DynamoDB
|
|
3660
3785
|
#
|
3661
3786
|
# This topic provides general information about the `PutItem` API.
|
3662
3787
|
#
|
3663
|
-
# For information on how to call the `PutItem` API using the
|
3664
|
-
# specific languages, see the following:
|
3788
|
+
# For information on how to call the `PutItem` API using the Amazon Web
|
3789
|
+
# Services SDK in specific languages, see the following:
|
3665
3790
|
#
|
3666
|
-
# * [ PutItem in the
|
3791
|
+
# * [ PutItem in the Command Line Interface][1]
|
3667
3792
|
#
|
3668
|
-
# * [ PutItem in the
|
3793
|
+
# * [ PutItem in the SDK for .NET][2]
|
3669
3794
|
#
|
3670
|
-
# * [ PutItem in the
|
3795
|
+
# * [ PutItem in the SDK for C++][3]
|
3671
3796
|
#
|
3672
|
-
# * [ PutItem in the
|
3797
|
+
# * [ PutItem in the SDK for Go][4]
|
3673
3798
|
#
|
3674
|
-
# * [ PutItem in the
|
3799
|
+
# * [ PutItem in the SDK for Java][5]
|
3675
3800
|
#
|
3676
|
-
# * [ PutItem in the
|
3801
|
+
# * [ PutItem in the SDK for JavaScript][6]
|
3677
3802
|
#
|
3678
|
-
# * [ PutItem in the
|
3803
|
+
# * [ PutItem in the SDK for PHP V3][7]
|
3679
3804
|
#
|
3680
|
-
# * [ PutItem in the
|
3805
|
+
# * [ PutItem in the SDK for Python (Boto)][8]
|
3681
3806
|
#
|
3682
|
-
# * [ PutItem in the
|
3807
|
+
# * [ PutItem in the SDK for Ruby V2][9]
|
3683
3808
|
#
|
3684
3809
|
# When you add an item, the primary key attributes are the only required
|
3685
3810
|
# attributes. Attribute values cannot be null.
|
@@ -3768,6 +3893,8 @@ module Aws::DynamoDB
|
|
3768
3893
|
# * `ALL_OLD` - If `PutItem` overwrote an attribute name-value pair,
|
3769
3894
|
# then the content of the old item is returned.
|
3770
3895
|
#
|
3896
|
+
# The values returned are strongly consistent.
|
3897
|
+
#
|
3771
3898
|
# <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
|
3772
3899
|
# however, `PutItem` does not recognize any values other than `NONE` or
|
3773
3900
|
# `ALL_OLD`.
|
@@ -3775,8 +3902,8 @@ module Aws::DynamoDB
|
|
3775
3902
|
# </note>
|
3776
3903
|
#
|
3777
3904
|
# @option params [String] :return_consumed_capacity
|
3778
|
-
# Determines the level of detail about provisioned
|
3779
|
-
# consumption that is returned in the response:
|
3905
|
+
# Determines the level of detail about either provisioned or on-demand
|
3906
|
+
# throughput consumption that is returned in the response:
|
3780
3907
|
#
|
3781
3908
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
3782
3909
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -3995,9 +4122,10 @@ module Aws::DynamoDB
|
|
3995
4122
|
req.send_request(options)
|
3996
4123
|
end
|
3997
4124
|
|
3998
|
-
#
|
3999
|
-
#
|
4000
|
-
# partition key
|
4125
|
+
# You must provide the name of the partition key attribute and a single
|
4126
|
+
# value for that attribute. `Query` returns all items with that
|
4127
|
+
# partition key value. Optionally, you can provide a sort key attribute
|
4128
|
+
# and use a comparison operator to refine the search results.
|
4001
4129
|
#
|
4002
4130
|
# Use the `KeyConditionExpression` parameter to provide a specific value
|
4003
4131
|
# for the partition key. The `Query` operation will return all of the
|
@@ -4204,8 +4332,8 @@ module Aws::DynamoDB
|
|
4204
4332
|
# Binary. No set data types are allowed.
|
4205
4333
|
#
|
4206
4334
|
# @option params [String] :return_consumed_capacity
|
4207
|
-
# Determines the level of detail about provisioned
|
4208
|
-
# consumption that is returned in the response:
|
4335
|
+
# Determines the level of detail about either provisioned or on-demand
|
4336
|
+
# throughput consumption that is returned in the response:
|
4209
4337
|
#
|
4210
4338
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
4211
4339
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -5092,8 +5220,8 @@ module Aws::DynamoDB
|
|
5092
5220
|
# corresponding value of `LastEvaluatedKey`.
|
5093
5221
|
#
|
5094
5222
|
# @option params [String] :return_consumed_capacity
|
5095
|
-
# Determines the level of detail about provisioned
|
5096
|
-
# consumption that is returned in the response:
|
5223
|
+
# Determines the level of detail about either provisioned or on-demand
|
5224
|
+
# throughput consumption that is returned in the response:
|
5097
5225
|
#
|
5098
5226
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
5099
5227
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -5431,8 +5559,8 @@ module Aws::DynamoDB
|
|
5431
5559
|
# contain up to 25 `TransactGetItem` objects, each of which contains a
|
5432
5560
|
# `Get` structure that specifies an item to retrieve from a table in the
|
5433
5561
|
# account and Region. A call to `TransactGetItems` cannot retrieve items
|
5434
|
-
# from tables in more than one
|
5435
|
-
# of the items in the transaction cannot exceed 4 MB.
|
5562
|
+
# from tables in more than one Amazon Web Services account or Region.
|
5563
|
+
# The aggregate size of the items in the transaction cannot exceed 4 MB.
|
5436
5564
|
#
|
5437
5565
|
# DynamoDB rejects the entire `TransactGetItems` request if any of the
|
5438
5566
|
# following is true:
|
@@ -5515,10 +5643,10 @@ module Aws::DynamoDB
|
|
5515
5643
|
|
5516
5644
|
# `TransactWriteItems` is a synchronous write operation that groups up
|
5517
5645
|
# to 25 action requests. These actions can target items in different
|
5518
|
-
# tables, but not in different
|
5519
|
-
# actions can target the same item. For example, you cannot
|
5520
|
-
# `ConditionCheck` and `Update` the same item. The aggregate size
|
5521
|
-
# items in the transaction cannot exceed 4 MB.
|
5646
|
+
# tables, but not in different Amazon Web Services accounts or Regions,
|
5647
|
+
# and no two actions can target the same item. For example, you cannot
|
5648
|
+
# both `ConditionCheck` and `Update` the same item. The aggregate size
|
5649
|
+
# of the items in the transaction cannot exceed 4 MB.
|
5522
5650
|
#
|
5523
5651
|
# The actions are completed atomically so that either all of them
|
5524
5652
|
# succeed, or all of them fail. They are defined by the following
|
@@ -5575,12 +5703,12 @@ module Aws::DynamoDB
|
|
5575
5703
|
# An ordered array of up to 25 `TransactWriteItem` objects, each of
|
5576
5704
|
# which contains a `ConditionCheck`, `Put`, `Update`, or `Delete`
|
5577
5705
|
# object. These can operate on items in different tables, but the tables
|
5578
|
-
# must reside in the same
|
5579
|
-
# operate on the same item.
|
5706
|
+
# must reside in the same Amazon Web Services account and Region, and no
|
5707
|
+
# two of them can operate on the same item.
|
5580
5708
|
#
|
5581
5709
|
# @option params [String] :return_consumed_capacity
|
5582
|
-
# Determines the level of detail about provisioned
|
5583
|
-
# consumption that is returned in the response:
|
5710
|
+
# Determines the level of detail about either provisioned or on-demand
|
5711
|
+
# throughput consumption that is returned in the response:
|
5584
5712
|
#
|
5585
5713
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
5586
5714
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -5822,7 +5950,13 @@ module Aws::DynamoDB
|
|
5822
5950
|
end
|
5823
5951
|
|
5824
5952
|
# Updates the status for contributor insights for a specific table or
|
5825
|
-
# index.
|
5953
|
+
# index. CloudWatch Contributor Insights for DynamoDB graphs display the
|
5954
|
+
# partition key and (if applicable) sort key of frequently accessed
|
5955
|
+
# items and frequently throttled items in plaintext. If you require the
|
5956
|
+
# use of AWS Key Management Service (KMS) to encrypt this table’s
|
5957
|
+
# partition key and sort key data with an AWS managed key or customer
|
5958
|
+
# managed key, you should not enable CloudWatch Contributor Insights for
|
5959
|
+
# DynamoDB for this table.
|
5826
5960
|
#
|
5827
5961
|
# @option params [required, String] :table_name
|
5828
5962
|
# The name of the table.
|
@@ -6211,8 +6345,8 @@ module Aws::DynamoDB
|
|
6211
6345
|
# The values returned are strongly consistent.
|
6212
6346
|
#
|
6213
6347
|
# @option params [String] :return_consumed_capacity
|
6214
|
-
# Determines the level of detail about provisioned
|
6215
|
-
# consumption that is returned in the response:
|
6348
|
+
# Determines the level of detail about either provisioned or on-demand
|
6349
|
+
# throughput consumption that is returned in the response:
|
6216
6350
|
#
|
6217
6351
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
6218
6352
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -7121,7 +7255,7 @@ module Aws::DynamoDB
|
|
7121
7255
|
params: params,
|
7122
7256
|
config: config)
|
7123
7257
|
context[:gem_name] = 'aws-sdk-dynamodb'
|
7124
|
-
context[:gem_version] = '1.
|
7258
|
+
context[:gem_version] = '1.67.0'
|
7125
7259
|
Seahorse::Client::Request.new(handlers, context)
|
7126
7260
|
end
|
7127
7261
|
|
@@ -534,9 +534,11 @@ module Aws::DynamoDB
|
|
534
534
|
BackupSummary.struct_class = Types::BackupSummary
|
535
535
|
|
536
536
|
BatchExecuteStatementInput.add_member(:statements, Shapes::ShapeRef.new(shape: PartiQLBatchRequest, required: true, location_name: "Statements"))
|
537
|
+
BatchExecuteStatementInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
|
537
538
|
BatchExecuteStatementInput.struct_class = Types::BatchExecuteStatementInput
|
538
539
|
|
539
540
|
BatchExecuteStatementOutput.add_member(:responses, Shapes::ShapeRef.new(shape: PartiQLBatchResponse, location_name: "Responses"))
|
541
|
+
BatchExecuteStatementOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacityMultiple, location_name: "ConsumedCapacity"))
|
540
542
|
BatchExecuteStatementOutput.struct_class = Types::BatchExecuteStatementOutput
|
541
543
|
|
542
544
|
BatchGetItemInput.add_member(:request_items, Shapes::ShapeRef.new(shape: BatchGetRequestMap, required: true, location_name: "RequestItems"))
|
@@ -828,17 +830,21 @@ module Aws::DynamoDB
|
|
828
830
|
ExecuteStatementInput.add_member(:parameters, Shapes::ShapeRef.new(shape: PreparedStatementParameters, location_name: "Parameters"))
|
829
831
|
ExecuteStatementInput.add_member(:consistent_read, Shapes::ShapeRef.new(shape: ConsistentRead, location_name: "ConsistentRead"))
|
830
832
|
ExecuteStatementInput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
|
833
|
+
ExecuteStatementInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
|
831
834
|
ExecuteStatementInput.struct_class = Types::ExecuteStatementInput
|
832
835
|
|
833
836
|
ExecuteStatementOutput.add_member(:items, Shapes::ShapeRef.new(shape: ItemList, location_name: "Items"))
|
834
837
|
ExecuteStatementOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
|
838
|
+
ExecuteStatementOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacity, location_name: "ConsumedCapacity"))
|
835
839
|
ExecuteStatementOutput.struct_class = Types::ExecuteStatementOutput
|
836
840
|
|
837
841
|
ExecuteTransactionInput.add_member(:transact_statements, Shapes::ShapeRef.new(shape: ParameterizedStatements, required: true, location_name: "TransactStatements"))
|
838
842
|
ExecuteTransactionInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken", metadata: {"idempotencyToken"=>true}))
|
843
|
+
ExecuteTransactionInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
|
839
844
|
ExecuteTransactionInput.struct_class = Types::ExecuteTransactionInput
|
840
845
|
|
841
846
|
ExecuteTransactionOutput.add_member(:responses, Shapes::ShapeRef.new(shape: ItemResponseList, location_name: "Responses"))
|
847
|
+
ExecuteTransactionOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacityMultiple, location_name: "ConsumedCapacity"))
|
842
848
|
ExecuteTransactionOutput.struct_class = Types::ExecuteTransactionOutput
|
843
849
|
|
844
850
|
ExpectedAttributeMap.key = Shapes::ShapeRef.new(shape: AttributeName)
|
@@ -143,8 +143,8 @@ module Aws::DynamoDB
|
|
143
143
|
# [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.AccessingItemAttributes.html
|
144
144
|
# [3]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LegacyConditionalParameters.AttributesToGet.html
|
145
145
|
# @option options [String] :return_consumed_capacity
|
146
|
-
# Determines the level of detail about provisioned
|
147
|
-
# consumption that is returned in the response:
|
146
|
+
# Determines the level of detail about either provisioned or on-demand
|
147
|
+
# throughput consumption that is returned in the response:
|
148
148
|
#
|
149
149
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
150
150
|
# for the operation, together with `ConsumedCapacity` for each table
|
@@ -219,8 +219,8 @@ module Aws::DynamoDB
|
|
219
219
|
# the data types for those attributes must match those of the schema
|
220
220
|
# in the table's attribute definition.
|
221
221
|
# @option options [String] :return_consumed_capacity
|
222
|
-
# Determines the level of detail about provisioned
|
223
|
-
# consumption that is returned in the response:
|
222
|
+
# Determines the level of detail about either provisioned or on-demand
|
223
|
+
# throughput consumption that is returned in the response:
|
224
224
|
#
|
225
225
|
# * `INDEXES` - The response includes the aggregate `ConsumedCapacity`
|
226
226
|
# for the operation, together with `ConsumedCapacity` for each table
|