aws-sdk-dynamodb 1.37.0 → 1.38.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: ea6cb4f77228b912730bf8b612c07e65cbfef0ad
4
- data.tar.gz: bb1fa5411f03abb4ee414de61630f36719a8bd08
3
+ metadata.gz: bc7250679afbec78bf303aac1bd4e16494a9569a
4
+ data.tar.gz: f8206beb5f18ac1592a13e989dd4971cbfb8c139
5
5
  SHA512:
6
- metadata.gz: 2eec3dc2b378185c6886b6fcdaeb53dc048a8fd34d89dcb249be54b36d9b8d6592cd5e605e77eb3e75e07d17862665117a78640c582d31735a20b015c95a6f62
7
- data.tar.gz: 790a08422c01c5618614fc95ced25306db34635d23069fcd07dbcca0ac8cf55fbd6878b3e019ccd2f62d8e1fca821a71528fb30aa7c7efbd9df23cb3daf3632f
6
+ metadata.gz: ad4799edb1a13a13fcdb9c478925018bdb0dc78072baf3ea49df26610f40d38c2d7acd56c127dfe78f9cd78883529ea04f8c208195e24bd05df55f1bc8b534a0
7
+ data.tar.gz: 83c622e631d8e3523c9a20926774d60bdaec363a75844299181dad3ab7f7e752602b6755cb16374c96d0ba83be2936ed89e0a3f8708908f05194864e0ccfc74a
@@ -44,6 +44,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
44
44
  # @service
45
45
  module Aws::DynamoDB
46
46
 
47
- GEM_VERSION = '1.37.0'
47
+ GEM_VERSION = '1.38.0'
48
48
 
49
49
  end
@@ -1115,11 +1115,18 @@ module Aws::DynamoDB
1115
1115
  # Controls how you are charged for read and write throughput and how you
1116
1116
  # manage capacity. This setting can be changed later.
1117
1117
  #
1118
- # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We recommend
1119
- # using `PROVISIONED` for predictable workloads.
1118
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
1119
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
1120
+ # Mode][1].
1120
1121
  #
1121
- # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
1122
- # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
1122
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
1123
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
1124
+ # [On-Demand Mode][2].
1125
+ #
1126
+ #
1127
+ #
1128
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
1129
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
1123
1130
  #
1124
1131
  # @option params [Types::ProvisionedThroughput] :provisioned_throughput
1125
1132
  # Represents the provisioned throughput settings for a specified table
@@ -3723,6 +3730,22 @@ module Aws::DynamoDB
3723
3730
  # @option params [required, String] :backup_arn
3724
3731
  # The Amazon Resource Name (ARN) associated with the backup.
3725
3732
  #
3733
+ # @option params [String] :billing_mode_override
3734
+ # The billing mode of the restored table.
3735
+ #
3736
+ # @option params [Array<Types::GlobalSecondaryIndex>] :global_secondary_index_override
3737
+ # List of global secondary indexes for the restored table. The indexes
3738
+ # provided should match existing secondary indexes. You can choose to
3739
+ # exclude some or all of the indexes at the time of restore.
3740
+ #
3741
+ # @option params [Array<Types::LocalSecondaryIndex>] :local_secondary_index_override
3742
+ # List of local secondary indexes for the restored table. The indexes
3743
+ # provided should match existing secondary indexes. You can choose to
3744
+ # exclude some or all of the indexes at the time of restore.
3745
+ #
3746
+ # @option params [Types::ProvisionedThroughput] :provisioned_throughput_override
3747
+ # Provisioned throughput settings for the restored table.
3748
+ #
3726
3749
  # @return [Types::RestoreTableFromBackupOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3727
3750
  #
3728
3751
  # * {Types::RestoreTableFromBackupOutput#table_description #table_description} => Types::TableDescription
@@ -3732,6 +3755,45 @@ module Aws::DynamoDB
3732
3755
  # resp = client.restore_table_from_backup({
3733
3756
  # target_table_name: "TableName", # required
3734
3757
  # backup_arn: "BackupArn", # required
3758
+ # billing_mode_override: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
3759
+ # global_secondary_index_override: [
3760
+ # {
3761
+ # index_name: "IndexName", # required
3762
+ # key_schema: [ # required
3763
+ # {
3764
+ # attribute_name: "KeySchemaAttributeName", # required
3765
+ # key_type: "HASH", # required, accepts HASH, RANGE
3766
+ # },
3767
+ # ],
3768
+ # projection: { # required
3769
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
3770
+ # non_key_attributes: ["NonKeyAttributeName"],
3771
+ # },
3772
+ # provisioned_throughput: {
3773
+ # read_capacity_units: 1, # required
3774
+ # write_capacity_units: 1, # required
3775
+ # },
3776
+ # },
3777
+ # ],
3778
+ # local_secondary_index_override: [
3779
+ # {
3780
+ # index_name: "IndexName", # required
3781
+ # key_schema: [ # required
3782
+ # {
3783
+ # attribute_name: "KeySchemaAttributeName", # required
3784
+ # key_type: "HASH", # required, accepts HASH, RANGE
3785
+ # },
3786
+ # ],
3787
+ # projection: { # required
3788
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
3789
+ # non_key_attributes: ["NonKeyAttributeName"],
3790
+ # },
3791
+ # },
3792
+ # ],
3793
+ # provisioned_throughput_override: {
3794
+ # read_capacity_units: 1, # required
3795
+ # write_capacity_units: 1, # required
3796
+ # },
3735
3797
  # })
3736
3798
  #
3737
3799
  # @example Response structure
@@ -3860,6 +3922,22 @@ module Aws::DynamoDB
3860
3922
  # @option params [Time,DateTime,Date,Integer,String] :restore_date_time
3861
3923
  # Time in the past to restore the table to.
3862
3924
  #
3925
+ # @option params [String] :billing_mode_override
3926
+ # The billing mode of the restored table.
3927
+ #
3928
+ # @option params [Array<Types::GlobalSecondaryIndex>] :global_secondary_index_override
3929
+ # List of global secondary indexes for the restored table. The indexes
3930
+ # provided should match existing secondary indexes. You can choose to
3931
+ # exclude some or all of the indexes at the time of restore.
3932
+ #
3933
+ # @option params [Array<Types::LocalSecondaryIndex>] :local_secondary_index_override
3934
+ # List of local secondary indexes for the restored table. The indexes
3935
+ # provided should match existing secondary indexes. You can choose to
3936
+ # exclude some or all of the indexes at the time of restore.
3937
+ #
3938
+ # @option params [Types::ProvisionedThroughput] :provisioned_throughput_override
3939
+ # Provisioned throughput settings for the restored table.
3940
+ #
3863
3941
  # @return [Types::RestoreTableToPointInTimeOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3864
3942
  #
3865
3943
  # * {Types::RestoreTableToPointInTimeOutput#table_description #table_description} => Types::TableDescription
@@ -3871,6 +3949,45 @@ module Aws::DynamoDB
3871
3949
  # target_table_name: "TableName", # required
3872
3950
  # use_latest_restorable_time: false,
3873
3951
  # restore_date_time: Time.now,
3952
+ # billing_mode_override: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
3953
+ # global_secondary_index_override: [
3954
+ # {
3955
+ # index_name: "IndexName", # required
3956
+ # key_schema: [ # required
3957
+ # {
3958
+ # attribute_name: "KeySchemaAttributeName", # required
3959
+ # key_type: "HASH", # required, accepts HASH, RANGE
3960
+ # },
3961
+ # ],
3962
+ # projection: { # required
3963
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
3964
+ # non_key_attributes: ["NonKeyAttributeName"],
3965
+ # },
3966
+ # provisioned_throughput: {
3967
+ # read_capacity_units: 1, # required
3968
+ # write_capacity_units: 1, # required
3969
+ # },
3970
+ # },
3971
+ # ],
3972
+ # local_secondary_index_override: [
3973
+ # {
3974
+ # index_name: "IndexName", # required
3975
+ # key_schema: [ # required
3976
+ # {
3977
+ # attribute_name: "KeySchemaAttributeName", # required
3978
+ # key_type: "HASH", # required, accepts HASH, RANGE
3979
+ # },
3980
+ # ],
3981
+ # projection: { # required
3982
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
3983
+ # non_key_attributes: ["NonKeyAttributeName"],
3984
+ # },
3985
+ # },
3986
+ # ],
3987
+ # provisioned_throughput_override: {
3988
+ # read_capacity_units: 1, # required
3989
+ # write_capacity_units: 1, # required
3990
+ # },
3874
3991
  # })
3875
3992
  #
3876
3993
  # @example Response structure
@@ -4436,18 +4553,6 @@ module Aws::DynamoDB
4436
4553
  # from tables in more than one AWS account or Region. The aggregate size
4437
4554
  # of the items in the transaction cannot exceed 4 MB.
4438
4555
  #
4439
- # <note markdown="1"> All AWS Regions and AWS GovCloud (US) support up to 25 items per
4440
- # transaction with up to 4 MB of data, except the following AWS Regions:
4441
- #
4442
- # * China (Beijing)
4443
- #
4444
- # * China (Ningxia)
4445
- #
4446
- # The China (Beijing) and China (Ningxia) Regions support up to 10 items
4447
- # per transaction with up to 4 MB of data.
4448
- #
4449
- # </note>
4450
- #
4451
4556
  # DynamoDB rejects the entire `TransactGetItems` request if any of the
4452
4557
  # following is true:
4453
4558
  #
@@ -4534,18 +4639,6 @@ module Aws::DynamoDB
4534
4639
  # `ConditionCheck` and `Update` the same item. The aggregate size of the
4535
4640
  # items in the transaction cannot exceed 4 MB.
4536
4641
  #
4537
- # <note markdown="1"> All AWS Regions and AWS GovCloud (US) support up to 25 items per
4538
- # transaction with up to 4 MB of data, except the following AWS Regions:
4539
- #
4540
- # * China (Beijing)
4541
- #
4542
- # * China (Ningxia)
4543
- #
4544
- # The China (Beijing) and China (Ningxia) Regions support up to 10 items
4545
- # per transaction with up to 4 MB of data.
4546
- #
4547
- # </note>
4548
- #
4549
4642
  # The actions are completed atomically so that either all of them
4550
4643
  # succeed, or all of them fail. They are defined by the following
4551
4644
  # objects:
@@ -4925,6 +5018,19 @@ module Aws::DynamoDB
4925
5018
  # not specified, the global table defaults to `PROVISIONED` capacity
4926
5019
  # billing mode.
4927
5020
  #
5021
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
5022
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
5023
+ # Mode][1].
5024
+ #
5025
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
5026
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
5027
+ # [On-Demand Mode][2].
5028
+ #
5029
+ #
5030
+ #
5031
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
5032
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
5033
+ #
4928
5034
  # @option params [Integer] :global_table_provisioned_write_capacity_units
4929
5035
  # The maximum number of writes consumed per second before DynamoDB
4930
5036
  # returns a `ThrottlingException.`
@@ -5529,11 +5635,18 @@ module Aws::DynamoDB
5529
5635
  # and write capacity of your table and global secondary indexes over the
5530
5636
  # past 30 minutes.
5531
5637
  #
5532
- # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We recommend
5533
- # using `PROVISIONED` for predictable workloads.
5638
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
5639
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
5640
+ # Mode][1].
5641
+ #
5642
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
5643
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
5644
+ # [On-Demand Mode][2].
5534
5645
  #
5535
- # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
5536
- # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
5646
+ #
5647
+ #
5648
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
5649
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
5537
5650
  #
5538
5651
  # @option params [Types::ProvisionedThroughput] :provisioned_throughput
5539
5652
  # The new provisioned throughput settings for the specified table or
@@ -5550,6 +5663,9 @@ module Aws::DynamoDB
5550
5663
  #
5551
5664
  # * `Delete` - remove a global secondary index from the table.
5552
5665
  #
5666
+ # You can create or delete only one global secondary index per
5667
+ # `UpdateTable` operation.
5668
+ #
5553
5669
  # For more information, see [Managing Global Secondary Indexes][1] in
5554
5670
  # the *Amazon DynamoDB Developer Guide*.
5555
5671
  #
@@ -5837,7 +5953,7 @@ module Aws::DynamoDB
5837
5953
  params: params,
5838
5954
  config: config)
5839
5955
  context[:gem_name] = 'aws-sdk-dynamodb'
5840
- context[:gem_version] = '1.37.0'
5956
+ context[:gem_version] = '1.38.0'
5841
5957
  Seahorse::Client::Request.new(handlers, context)
5842
5958
  end
5843
5959
 
@@ -1035,6 +1035,10 @@ module Aws::DynamoDB
1035
1035
 
1036
1036
  RestoreTableFromBackupInput.add_member(:target_table_name, Shapes::ShapeRef.new(shape: TableName, required: true, location_name: "TargetTableName"))
1037
1037
  RestoreTableFromBackupInput.add_member(:backup_arn, Shapes::ShapeRef.new(shape: BackupArn, required: true, location_name: "BackupArn"))
1038
+ RestoreTableFromBackupInput.add_member(:billing_mode_override, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingModeOverride"))
1039
+ RestoreTableFromBackupInput.add_member(:global_secondary_index_override, Shapes::ShapeRef.new(shape: GlobalSecondaryIndexList, location_name: "GlobalSecondaryIndexOverride"))
1040
+ RestoreTableFromBackupInput.add_member(:local_secondary_index_override, Shapes::ShapeRef.new(shape: LocalSecondaryIndexList, location_name: "LocalSecondaryIndexOverride"))
1041
+ RestoreTableFromBackupInput.add_member(:provisioned_throughput_override, Shapes::ShapeRef.new(shape: ProvisionedThroughput, location_name: "ProvisionedThroughputOverride"))
1038
1042
  RestoreTableFromBackupInput.struct_class = Types::RestoreTableFromBackupInput
1039
1043
 
1040
1044
  RestoreTableFromBackupOutput.add_member(:table_description, Shapes::ShapeRef.new(shape: TableDescription, location_name: "TableDescription"))
@@ -1044,6 +1048,10 @@ module Aws::DynamoDB
1044
1048
  RestoreTableToPointInTimeInput.add_member(:target_table_name, Shapes::ShapeRef.new(shape: TableName, required: true, location_name: "TargetTableName"))
1045
1049
  RestoreTableToPointInTimeInput.add_member(:use_latest_restorable_time, Shapes::ShapeRef.new(shape: BooleanObject, location_name: "UseLatestRestorableTime"))
1046
1050
  RestoreTableToPointInTimeInput.add_member(:restore_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "RestoreDateTime"))
1051
+ RestoreTableToPointInTimeInput.add_member(:billing_mode_override, Shapes::ShapeRef.new(shape: BillingMode, location_name: "BillingModeOverride"))
1052
+ RestoreTableToPointInTimeInput.add_member(:global_secondary_index_override, Shapes::ShapeRef.new(shape: GlobalSecondaryIndexList, location_name: "GlobalSecondaryIndexOverride"))
1053
+ RestoreTableToPointInTimeInput.add_member(:local_secondary_index_override, Shapes::ShapeRef.new(shape: LocalSecondaryIndexList, location_name: "LocalSecondaryIndexOverride"))
1054
+ RestoreTableToPointInTimeInput.add_member(:provisioned_throughput_override, Shapes::ShapeRef.new(shape: ProvisionedThroughput, location_name: "ProvisionedThroughputOverride"))
1047
1055
  RestoreTableToPointInTimeInput.struct_class = Types::RestoreTableToPointInTimeInput
1048
1056
 
1049
1057
  RestoreTableToPointInTimeOutput.add_member(:table_description, Shapes::ShapeRef.new(shape: TableDescription, location_name: "TableDescription"))
@@ -1704,6 +1712,7 @@ module Aws::DynamoDB
1704
1712
  o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
1705
1713
  o.errors << Shapes::ShapeRef.new(shape: TransactionCanceledException)
1706
1714
  o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
1715
+ o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
1707
1716
  o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
1708
1717
  end)
1709
1718
 
@@ -1720,6 +1729,7 @@ module Aws::DynamoDB
1720
1729
  o.errors << Shapes::ShapeRef.new(shape: TransactionInProgressException)
1721
1730
  o.errors << Shapes::ShapeRef.new(shape: IdempotentParameterMismatchException)
1722
1731
  o.errors << Shapes::ShapeRef.new(shape: ProvisionedThroughputExceededException)
1732
+ o.errors << Shapes::ShapeRef.new(shape: RequestLimitExceeded)
1723
1733
  o.errors << Shapes::ShapeRef.new(shape: InternalServerError)
1724
1734
  end)
1725
1735
 
@@ -435,11 +435,18 @@ module Aws::DynamoDB
435
435
  # Controls how you are charged for read and write throughput and how you
436
436
  # manage capacity. This setting can be changed later.
437
437
  #
438
- # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We recommend
439
- # using `PROVISIONED` for predictable workloads.
438
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
439
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
440
+ # Mode][1].
440
441
  #
441
- # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
442
- # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
442
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
443
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
444
+ # [On-Demand Mode][2].
445
+ #
446
+ #
447
+ #
448
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
449
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
443
450
  # @option options [Types::ProvisionedThroughput] :provisioned_throughput
444
451
  # Represents the provisioned throughput settings for a specified table
445
452
  # or index. The settings can be modified using the `UpdateTable`
@@ -169,7 +169,7 @@ module Aws::DynamoDB
169
169
  # the index.
170
170
  #
171
171
  # * `INCLUDE` - Only the specified table attributes are projected
172
- # into the index. The list of projected attributes are in
172
+ # into the index. The list of projected attributes is in
173
173
  # `NonKeyAttributes`.
174
174
  #
175
175
  # * `ALL` - All of the table attributes are projected into the
@@ -202,11 +202,18 @@ module Aws::DynamoDB
202
202
  #
203
203
  # * `Backfilling` - If true, then the index is currently in the
204
204
  # backfilling phase. Backfilling occurs only when a new global
205
- # secondary index is added to the table; it is the process by which
205
+ # secondary index is added to the table. It is the process by which
206
206
  # DynamoDB populates the new index with data from the table. (This
207
207
  # attribute does not appear for indexes that were created during a
208
208
  # `CreateTable` operation.)
209
209
  #
210
+ # You can delete an index that is being created during the
211
+ # `Backfilling` phase when `IndexStatus` is set to CREATING and
212
+ # `Backfilling` is true. You can't delete the index that is being
213
+ # created when `IndexStatus` is set to CREATING and `Backfilling` is
214
+ # false. (This attribute does not appear for indexes that were created
215
+ # during a `CreateTable` operation.)
216
+ #
210
217
  # * `IndexName` - The name of the global secondary index.
211
218
  #
212
219
  # * `IndexSizeBytes` - The total size of the global secondary index, in
@@ -243,7 +250,7 @@ module Aws::DynamoDB
243
250
  # the index.
244
251
  #
245
252
  # * `INCLUDE` - Only the specified table attributes are projected
246
- # into the index. The list of projected attributes are in
253
+ # into the index. The list of projected attributes is in
247
254
  # `NonKeyAttributes`.
248
255
  #
249
256
  # * `ALL` - All of the table attributes are projected into the
@@ -280,11 +287,11 @@ module Aws::DynamoDB
280
287
  # have the same timestamp. However, the combination of the following
281
288
  # three elements is guaranteed to be unique:
282
289
  #
283
- # * the AWS customer ID.
290
+ # * AWS customer ID
284
291
  #
285
- # * the table name.
292
+ # * Table name
286
293
  #
287
- # * the `StreamLabel`.
294
+ # * `StreamLabel`
288
295
  # @return [String]
289
296
  def latest_stream_label
290
297
  data[:latest_stream_label]
@@ -1742,11 +1749,18 @@ module Aws::DynamoDB
1742
1749
  # and write capacity of your table and global secondary indexes over the
1743
1750
  # past 30 minutes.
1744
1751
  #
1745
- # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We recommend
1746
- # using `PROVISIONED` for predictable workloads.
1752
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
1753
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
1754
+ # Mode][1].
1755
+ #
1756
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
1757
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode to
1758
+ # [On-Demand Mode][2].
1759
+ #
1747
1760
  #
1748
- # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
1749
- # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
1761
+ #
1762
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
1763
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
1750
1764
  # @option options [Types::ProvisionedThroughput] :provisioned_throughput
1751
1765
  # The new provisioned throughput settings for the specified table or
1752
1766
  # index.
@@ -1761,6 +1775,9 @@ module Aws::DynamoDB
1761
1775
  #
1762
1776
  # * `Delete` - remove a global secondary index from the table.
1763
1777
  #
1778
+ # You can create or delete only one global secondary index per
1779
+ # `UpdateTable` operation.
1780
+ #
1764
1781
  # For more information, see [Managing Global Secondary Indexes][1] in
1765
1782
  # the *Amazon DynamoDB Developer Guide*.
1766
1783
  #
@@ -297,7 +297,7 @@ module Aws::DynamoDB
297
297
  include Aws::Structure
298
298
  end
299
299
 
300
- # Represents the autoscaling policy to be modified.
300
+ # Represents the auto scaling policy to be modified.
301
301
  #
302
302
  # @note When making an API call, you may pass AutoScalingPolicyUpdate
303
303
  # data as a hash:
@@ -328,7 +328,7 @@ module Aws::DynamoDB
328
328
  include Aws::Structure
329
329
  end
330
330
 
331
- # Represents the autoscaling settings for a global table or global
331
+ # Represents the auto scaling settings for a global table or global
332
332
  # secondary index.
333
333
  #
334
334
  # @!attribute [rw] minimum_units
@@ -342,12 +342,12 @@ module Aws::DynamoDB
342
342
  # @return [Integer]
343
343
  #
344
344
  # @!attribute [rw] auto_scaling_disabled
345
- # Disabled autoscaling for this global table or global secondary
345
+ # Disabled auto scaling for this global table or global secondary
346
346
  # index.
347
347
  # @return [Boolean]
348
348
  #
349
349
  # @!attribute [rw] auto_scaling_role_arn
350
- # Role ARN used for configuring autoScaling policy.
350
+ # Role ARN used for configuring the auto scaling policy.
351
351
  # @return [String]
352
352
  #
353
353
  # @!attribute [rw] scaling_policies
@@ -365,7 +365,7 @@ module Aws::DynamoDB
365
365
  include Aws::Structure
366
366
  end
367
367
 
368
- # Represents the autoscaling settings to be modified for a global table
368
+ # Represents the auto scaling settings to be modified for a global table
369
369
  # or global secondary index.
370
370
  #
371
371
  # @note When making an API call, you may pass AutoScalingSettingsUpdate
@@ -398,12 +398,12 @@ module Aws::DynamoDB
398
398
  # @return [Integer]
399
399
  #
400
400
  # @!attribute [rw] auto_scaling_disabled
401
- # Disabled autoscaling for this global table or global secondary
401
+ # Disabled auto scaling for this global table or global secondary
402
402
  # index.
403
403
  # @return [Boolean]
404
404
  #
405
405
  # @!attribute [rw] auto_scaling_role_arn
406
- # Role ARN used for configuring autoscaling policy.
406
+ # Role ARN used for configuring auto scaling policy.
407
407
  # @return [String]
408
408
  #
409
409
  # @!attribute [rw] scaling_policy_update
@@ -439,8 +439,8 @@ module Aws::DynamoDB
439
439
  # used to block subsequent scale in requests until it has expired. You
440
440
  # should scale in conservatively to protect your application's
441
441
  # availability. However, if another alarm triggers a scale out policy
442
- # during the cooldown period after a scale-in, application autoscaling
443
- # scales out your scalable target immediately.
442
+ # during the cooldown period after a scale-in, application auto
443
+ # scaling scales out your scalable target immediately.
444
444
  # @return [Integer]
445
445
  #
446
446
  # @!attribute [rw] scale_out_cooldown
@@ -495,8 +495,8 @@ module Aws::DynamoDB
495
495
  # used to block subsequent scale in requests until it has expired. You
496
496
  # should scale in conservatively to protect your application's
497
497
  # availability. However, if another alarm triggers a scale out policy
498
- # during the cooldown period after a scale-in, application autoscaling
499
- # scales out your scalable target immediately.
498
+ # during the cooldown period after a scale-in, application auto
499
+ # scaling scales out your scalable target immediately.
500
500
  # @return [Integer]
501
501
  #
502
502
  # @!attribute [rw] scale_out_cooldown
@@ -1389,7 +1389,7 @@ module Aws::DynamoDB
1389
1389
  end
1390
1390
 
1391
1391
  # Represents a request to perform a check that an item exists or to
1392
- # check the condition of specific attributes of the item..
1392
+ # check the condition of specific attributes of the item.
1393
1393
  #
1394
1394
  # @note When making an API call, you may pass ConditionCheck
1395
1395
  # data as a hash:
@@ -1696,7 +1696,7 @@ module Aws::DynamoDB
1696
1696
  # }
1697
1697
  #
1698
1698
  # @!attribute [rw] region_name
1699
- # The region of the replica to be added.
1699
+ # The Region of the replica to be added.
1700
1700
  # @return [String]
1701
1701
  #
1702
1702
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CreateReplicaAction AWS API Documentation
@@ -1925,11 +1925,18 @@ module Aws::DynamoDB
1925
1925
  # Controls how you are charged for read and write throughput and how
1926
1926
  # you manage capacity. This setting can be changed later.
1927
1927
  #
1928
- # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We
1929
- # recommend using `PROVISIONED` for predictable workloads.
1928
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
1929
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
1930
+ # Mode][1].
1930
1931
  #
1931
- # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
1932
- # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
1932
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
1933
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode
1934
+ # to [On-Demand Mode][2].
1935
+ #
1936
+ #
1937
+ #
1938
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
1939
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
1933
1940
  # @return [String]
1934
1941
  #
1935
1942
  # @!attribute [rw] provisioned_throughput
@@ -2425,7 +2432,7 @@ module Aws::DynamoDB
2425
2432
  # }
2426
2433
  #
2427
2434
  # @!attribute [rw] region_name
2428
- # The region of the replica to be removed.
2435
+ # The Region of the replica to be removed.
2429
2436
  # @return [String]
2430
2437
  #
2431
2438
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DeleteReplicaAction AWS API Documentation
@@ -2757,7 +2764,7 @@ module Aws::DynamoDB
2757
2764
  end
2758
2765
 
2759
2766
  # Represents a condition to be compared with an attribute value. This
2760
- # condition can be used with `DeleteItem`, `PutItem` or `UpdateItem`
2767
+ # condition can be used with `DeleteItem`, `PutItem`, or `UpdateItem`
2761
2768
  # operations; if the comparison evaluates to true, the operation
2762
2769
  # succeeds; if not, the operation fails. You can use
2763
2770
  # `ExpectedAttributeValue` in one of two different ways:
@@ -3302,7 +3309,7 @@ module Aws::DynamoDB
3302
3309
  # * `RANGE` - sort key
3303
3310
  #
3304
3311
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
3305
- # The term "hash attribute" derives from DynamoDB' usage of an
3312
+ # The term "hash attribute" derives from DynamoDB's usage of an
3306
3313
  # internal hash function to evenly distribute data items across
3307
3314
  # partitions, based on their partition key values.
3308
3315
  #
@@ -3358,7 +3365,7 @@ module Aws::DynamoDB
3358
3365
  # * `RANGE` - sort key
3359
3366
  #
3360
3367
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
3361
- # The term "hash attribute" derives from DynamoDB' usage of an
3368
+ # The term "hash attribute" derives from DynamoDB's usage of an
3362
3369
  # internal hash function to evenly distribute data items across
3363
3370
  # partitions, based on their partition key values.
3364
3371
  #
@@ -3398,6 +3405,12 @@ module Aws::DynamoDB
3398
3405
  # items have been processed, the backfilling operation is complete and
3399
3406
  # `Backfilling` is false.
3400
3407
  #
3408
+ # You can delete an index that is being created during the
3409
+ # `Backfilling` phase when `IndexStatus` is set to CREATING and
3410
+ # `Backfilling` is true. You can't delete the index that is being
3411
+ # created when `IndexStatus` is set to CREATING and `Backfilling` is
3412
+ # false.
3413
+ #
3401
3414
  # <note markdown="1"> For indexes that were created during a `CreateTable` operation, the
3402
3415
  # `Backfilling` attribute does not appear in the `DescribeTable`
3403
3416
  # output.
@@ -3464,7 +3477,7 @@ module Aws::DynamoDB
3464
3477
  # * `RANGE` - sort key
3465
3478
  #
3466
3479
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
3467
- # The term "hash attribute" derives from DynamoDB' usage of an
3480
+ # The term "hash attribute" derives from DynamoDB's usage of an
3468
3481
  # internal hash function to evenly distribute data items across
3469
3482
  # partitions, based on their partition key values.
3470
3483
  #
@@ -3581,7 +3594,7 @@ module Aws::DynamoDB
3581
3594
  # @return [String]
3582
3595
  #
3583
3596
  # @!attribute [rw] replication_group
3584
- # The regions where the global table has replicas.
3597
+ # The Regions where the global table has replicas.
3585
3598
  # @return [Array<Types::Replica>]
3586
3599
  #
3587
3600
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/GlobalTable AWS API Documentation
@@ -3607,7 +3620,7 @@ module Aws::DynamoDB
3607
3620
  # Contains details about the global table.
3608
3621
  #
3609
3622
  # @!attribute [rw] replication_group
3610
- # The regions where the global table has replicas.
3623
+ # The Regions where the global table has replicas.
3611
3624
  # @return [Array<Types::ReplicaDescription>]
3612
3625
  #
3613
3626
  # @!attribute [rw] global_table_arn
@@ -3682,7 +3695,7 @@ module Aws::DynamoDB
3682
3695
  # @return [Integer]
3683
3696
  #
3684
3697
  # @!attribute [rw] provisioned_write_capacity_auto_scaling_settings_update
3685
- # AutoScaling settings for managing a global secondary index's write
3698
+ # Auto scaling settings for managing a global secondary index's write
3686
3699
  # capacity units.
3687
3700
  # @return [Types::AutoScalingSettingsUpdate]
3688
3701
  #
@@ -3852,7 +3865,7 @@ module Aws::DynamoDB
3852
3865
  # * `RANGE` - sort key
3853
3866
  #
3854
3867
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
3855
- # The term "hash attribute" derives from DynamoDB' usage of an
3868
+ # The term "hash attribute" derives from DynamoDB's usage of an
3856
3869
  # internal hash function to evenly distribute data items across
3857
3870
  # partitions, based on their partition key values.
3858
3871
  #
@@ -4297,7 +4310,7 @@ module Aws::DynamoDB
4297
4310
  # * `RANGE` - sort key
4298
4311
  #
4299
4312
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
4300
- # The term "hash attribute" derives from DynamoDB' usage of an
4313
+ # The term "hash attribute" derives from DynamoDB's usage of an
4301
4314
  # internal hash function to evenly distribute data items across
4302
4315
  # partitions, based on their partition key values.
4303
4316
  #
@@ -4340,7 +4353,7 @@ module Aws::DynamoDB
4340
4353
  # * `RANGE` - sort key
4341
4354
  #
4342
4355
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
4343
- # The term "hash attribute" derives from DynamoDB' usage of an
4356
+ # The term "hash attribute" derives from DynamoDB's usage of an
4344
4357
  # internal hash function to evenly distribute data items across
4345
4358
  # partitions, based on their partition key values.
4346
4359
  #
@@ -4403,7 +4416,7 @@ module Aws::DynamoDB
4403
4416
  # * `RANGE` - sort key
4404
4417
  #
4405
4418
  # <note markdown="1"> The partition key of an item is also known as its *hash attribute*.
4406
- # The term "hash attribute" derives from DynamoDB' usage of an
4419
+ # The term "hash attribute" derives from DynamoDB's usage of an
4407
4420
  # internal hash function to evenly distribute data items across
4408
4421
  # partitions, based on their partition key values.
4409
4422
  #
@@ -4445,8 +4458,8 @@ module Aws::DynamoDB
4445
4458
  #
4446
4459
  # @!attribute [rw] earliest_restorable_date_time
4447
4460
  # Specifies the earliest point in time you can restore your table to.
4448
- # It You can restore your table to any point in time during the last
4449
- # 35 days.
4461
+ # You can restore your table to any point in time during the last 35
4462
+ # days.
4450
4463
  # @return [Time]
4451
4464
  #
4452
4465
  # @!attribute [rw] latest_restorable_date_time
@@ -4515,7 +4528,7 @@ module Aws::DynamoDB
4515
4528
  # the index.
4516
4529
  #
4517
4530
  # * `INCLUDE` - Only the specified table attributes are projected into
4518
- # the index. The list of projected attributes are in
4531
+ # the index. The list of projected attributes is in
4519
4532
  # `NonKeyAttributes`.
4520
4533
  #
4521
4534
  # * `ALL` - All of the table attributes are projected into the index.
@@ -5050,8 +5063,8 @@ module Aws::DynamoDB
5050
5063
  # primary key of an item to be processed by `PutItem`. All of the
5051
5064
  # table's primary key attributes must be specified, and their data
5052
5065
  # types must match those of the table's key schema. If any attributes
5053
- # are present in the item which are part of an index key schema for
5054
- # the table, their types must match the index key schema.
5066
+ # are present in the item that are part of an index key schema for the
5067
+ # table, their types must match the index key schema.
5055
5068
  # @return [Hash<String,Types::AttributeValue>]
5056
5069
  #
5057
5070
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/PutRequest AWS API Documentation
@@ -5594,7 +5607,7 @@ module Aws::DynamoDB
5594
5607
  # }
5595
5608
  #
5596
5609
  # @!attribute [rw] region_name
5597
- # The region where the replica needs to be created.
5610
+ # The Region where the replica needs to be created.
5598
5611
  # @return [String]
5599
5612
  #
5600
5613
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/Replica AWS API Documentation
@@ -5619,7 +5632,7 @@ module Aws::DynamoDB
5619
5632
  # Contains the details of the replica.
5620
5633
  #
5621
5634
  # @!attribute [rw] region_name
5622
- # The name of the region.
5635
+ # The name of the Region.
5623
5636
  # @return [String]
5624
5637
  #
5625
5638
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ReplicaDescription AWS API Documentation
@@ -5654,7 +5667,7 @@ module Aws::DynamoDB
5654
5667
  # @return [Integer]
5655
5668
  #
5656
5669
  # @!attribute [rw] provisioned_read_capacity_auto_scaling_settings
5657
- # Autoscaling settings for a global secondary index replica's read
5670
+ # Auto scaling settings for a global secondary index replica's read
5658
5671
  # capacity units.
5659
5672
  # @return [Types::AutoScalingSettingsDescription]
5660
5673
  #
@@ -5664,7 +5677,7 @@ module Aws::DynamoDB
5664
5677
  # @return [Integer]
5665
5678
  #
5666
5679
  # @!attribute [rw] provisioned_write_capacity_auto_scaling_settings
5667
- # AutoScaling settings for a global secondary index replica's write
5680
+ # Auto scaling settings for a global secondary index replica's write
5668
5681
  # capacity units.
5669
5682
  # @return [Types::AutoScalingSettingsDescription]
5670
5683
  #
@@ -5717,7 +5730,7 @@ module Aws::DynamoDB
5717
5730
  # @return [Integer]
5718
5731
  #
5719
5732
  # @!attribute [rw] provisioned_read_capacity_auto_scaling_settings_update
5720
- # Autoscaling settings for managing a global secondary index
5733
+ # Auto scaling settings for managing a global secondary index
5721
5734
  # replica's read capacity units.
5722
5735
  # @return [Types::AutoScalingSettingsUpdate]
5723
5736
  #
@@ -5745,19 +5758,19 @@ module Aws::DynamoDB
5745
5758
  # Represents the properties of a replica.
5746
5759
  #
5747
5760
  # @!attribute [rw] region_name
5748
- # The region name of the replica.
5761
+ # The Region name of the replica.
5749
5762
  # @return [String]
5750
5763
  #
5751
5764
  # @!attribute [rw] replica_status
5752
- # The current state of the region:
5765
+ # The current state of the Region:
5753
5766
  #
5754
- # * `CREATING` - The region is being created.
5767
+ # * `CREATING` - The Region is being created.
5755
5768
  #
5756
- # * `UPDATING` - The region is being updated.
5769
+ # * `UPDATING` - The Region is being updated.
5757
5770
  #
5758
- # * `DELETING` - The region is being deleted.
5771
+ # * `DELETING` - The Region is being deleted.
5759
5772
  #
5760
- # * `ACTIVE` - The region is ready for use.
5773
+ # * `ACTIVE` - The Region is ready for use.
5761
5774
  # @return [String]
5762
5775
  #
5763
5776
  # @!attribute [rw] replica_billing_mode_summary
@@ -5776,7 +5789,7 @@ module Aws::DynamoDB
5776
5789
  # @return [Integer]
5777
5790
  #
5778
5791
  # @!attribute [rw] replica_provisioned_read_capacity_auto_scaling_settings
5779
- # Autoscaling settings for a global table replica's read capacity
5792
+ # Auto scaling settings for a global table replica's read capacity
5780
5793
  # units.
5781
5794
  # @return [Types::AutoScalingSettingsDescription]
5782
5795
  #
@@ -5792,7 +5805,7 @@ module Aws::DynamoDB
5792
5805
  # @return [Integer]
5793
5806
  #
5794
5807
  # @!attribute [rw] replica_provisioned_write_capacity_auto_scaling_settings
5795
- # AutoScaling settings for a global table replica's write capacity
5808
+ # Auto scaling settings for a global table replica's write capacity
5796
5809
  # units.
5797
5810
  # @return [Types::AutoScalingSettingsDescription]
5798
5811
  #
@@ -5814,7 +5827,7 @@ module Aws::DynamoDB
5814
5827
  include Aws::Structure
5815
5828
  end
5816
5829
 
5817
- # Represents the settings for a global table in a region that will be
5830
+ # Represents the settings for a global table in a Region that will be
5818
5831
  # modified.
5819
5832
  #
5820
5833
  # @note When making an API call, you may pass ReplicaSettingsUpdate
@@ -5862,7 +5875,7 @@ module Aws::DynamoDB
5862
5875
  # }
5863
5876
  #
5864
5877
  # @!attribute [rw] region_name
5865
- # The region of the replica to be added.
5878
+ # The Region of the replica to be added.
5866
5879
  # @return [String]
5867
5880
  #
5868
5881
  # @!attribute [rw] replica_provisioned_read_capacity_units
@@ -5877,7 +5890,7 @@ module Aws::DynamoDB
5877
5890
  # @return [Integer]
5878
5891
  #
5879
5892
  # @!attribute [rw] replica_provisioned_read_capacity_auto_scaling_settings_update
5880
- # Autoscaling settings for managing a global table replica's read
5893
+ # Auto scaling settings for managing a global table replica's read
5881
5894
  # capacity units.
5882
5895
  # @return [Types::AutoScalingSettingsUpdate]
5883
5896
  #
@@ -5984,11 +5997,12 @@ module Aws::DynamoDB
5984
5997
  # Contains details for the restore.
5985
5998
  #
5986
5999
  # @!attribute [rw] source_backup_arn
5987
- # ARN of the backup from which the table was restored.
6000
+ # The Amazon Resource Name (ARN) of the backup from which the table
6001
+ # was restored.
5988
6002
  # @return [String]
5989
6003
  #
5990
6004
  # @!attribute [rw] source_table_arn
5991
- # ARN of the source table of the backup that is being restored.
6005
+ # The ARN of the source table of the backup that is being restored.
5992
6006
  # @return [String]
5993
6007
  #
5994
6008
  # @!attribute [rw] restore_date_time
@@ -6015,6 +6029,45 @@ module Aws::DynamoDB
6015
6029
  # {
6016
6030
  # target_table_name: "TableName", # required
6017
6031
  # backup_arn: "BackupArn", # required
6032
+ # billing_mode_override: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
6033
+ # global_secondary_index_override: [
6034
+ # {
6035
+ # index_name: "IndexName", # required
6036
+ # key_schema: [ # required
6037
+ # {
6038
+ # attribute_name: "KeySchemaAttributeName", # required
6039
+ # key_type: "HASH", # required, accepts HASH, RANGE
6040
+ # },
6041
+ # ],
6042
+ # projection: { # required
6043
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
6044
+ # non_key_attributes: ["NonKeyAttributeName"],
6045
+ # },
6046
+ # provisioned_throughput: {
6047
+ # read_capacity_units: 1, # required
6048
+ # write_capacity_units: 1, # required
6049
+ # },
6050
+ # },
6051
+ # ],
6052
+ # local_secondary_index_override: [
6053
+ # {
6054
+ # index_name: "IndexName", # required
6055
+ # key_schema: [ # required
6056
+ # {
6057
+ # attribute_name: "KeySchemaAttributeName", # required
6058
+ # key_type: "HASH", # required, accepts HASH, RANGE
6059
+ # },
6060
+ # ],
6061
+ # projection: { # required
6062
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
6063
+ # non_key_attributes: ["NonKeyAttributeName"],
6064
+ # },
6065
+ # },
6066
+ # ],
6067
+ # provisioned_throughput_override: {
6068
+ # read_capacity_units: 1, # required
6069
+ # write_capacity_units: 1, # required
6070
+ # },
6018
6071
  # }
6019
6072
  #
6020
6073
  # @!attribute [rw] target_table_name
@@ -6025,11 +6078,35 @@ module Aws::DynamoDB
6025
6078
  # The Amazon Resource Name (ARN) associated with the backup.
6026
6079
  # @return [String]
6027
6080
  #
6081
+ # @!attribute [rw] billing_mode_override
6082
+ # The billing mode of the restored table.
6083
+ # @return [String]
6084
+ #
6085
+ # @!attribute [rw] global_secondary_index_override
6086
+ # List of global secondary indexes for the restored table. The indexes
6087
+ # provided should match existing secondary indexes. You can choose to
6088
+ # exclude some or all of the indexes at the time of restore.
6089
+ # @return [Array<Types::GlobalSecondaryIndex>]
6090
+ #
6091
+ # @!attribute [rw] local_secondary_index_override
6092
+ # List of local secondary indexes for the restored table. The indexes
6093
+ # provided should match existing secondary indexes. You can choose to
6094
+ # exclude some or all of the indexes at the time of restore.
6095
+ # @return [Array<Types::LocalSecondaryIndex>]
6096
+ #
6097
+ # @!attribute [rw] provisioned_throughput_override
6098
+ # Provisioned throughput settings for the restored table.
6099
+ # @return [Types::ProvisionedThroughput]
6100
+ #
6028
6101
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableFromBackupInput AWS API Documentation
6029
6102
  #
6030
6103
  class RestoreTableFromBackupInput < Struct.new(
6031
6104
  :target_table_name,
6032
- :backup_arn)
6105
+ :backup_arn,
6106
+ :billing_mode_override,
6107
+ :global_secondary_index_override,
6108
+ :local_secondary_index_override,
6109
+ :provisioned_throughput_override)
6033
6110
  include Aws::Structure
6034
6111
  end
6035
6112
 
@@ -6052,6 +6129,45 @@ module Aws::DynamoDB
6052
6129
  # target_table_name: "TableName", # required
6053
6130
  # use_latest_restorable_time: false,
6054
6131
  # restore_date_time: Time.now,
6132
+ # billing_mode_override: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
6133
+ # global_secondary_index_override: [
6134
+ # {
6135
+ # index_name: "IndexName", # required
6136
+ # key_schema: [ # required
6137
+ # {
6138
+ # attribute_name: "KeySchemaAttributeName", # required
6139
+ # key_type: "HASH", # required, accepts HASH, RANGE
6140
+ # },
6141
+ # ],
6142
+ # projection: { # required
6143
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
6144
+ # non_key_attributes: ["NonKeyAttributeName"],
6145
+ # },
6146
+ # provisioned_throughput: {
6147
+ # read_capacity_units: 1, # required
6148
+ # write_capacity_units: 1, # required
6149
+ # },
6150
+ # },
6151
+ # ],
6152
+ # local_secondary_index_override: [
6153
+ # {
6154
+ # index_name: "IndexName", # required
6155
+ # key_schema: [ # required
6156
+ # {
6157
+ # attribute_name: "KeySchemaAttributeName", # required
6158
+ # key_type: "HASH", # required, accepts HASH, RANGE
6159
+ # },
6160
+ # ],
6161
+ # projection: { # required
6162
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
6163
+ # non_key_attributes: ["NonKeyAttributeName"],
6164
+ # },
6165
+ # },
6166
+ # ],
6167
+ # provisioned_throughput_override: {
6168
+ # read_capacity_units: 1, # required
6169
+ # write_capacity_units: 1, # required
6170
+ # },
6055
6171
  # }
6056
6172
  #
6057
6173
  # @!attribute [rw] source_table_name
@@ -6072,13 +6188,37 @@ module Aws::DynamoDB
6072
6188
  # Time in the past to restore the table to.
6073
6189
  # @return [Time]
6074
6190
  #
6191
+ # @!attribute [rw] billing_mode_override
6192
+ # The billing mode of the restored table.
6193
+ # @return [String]
6194
+ #
6195
+ # @!attribute [rw] global_secondary_index_override
6196
+ # List of global secondary indexes for the restored table. The indexes
6197
+ # provided should match existing secondary indexes. You can choose to
6198
+ # exclude some or all of the indexes at the time of restore.
6199
+ # @return [Array<Types::GlobalSecondaryIndex>]
6200
+ #
6201
+ # @!attribute [rw] local_secondary_index_override
6202
+ # List of local secondary indexes for the restored table. The indexes
6203
+ # provided should match existing secondary indexes. You can choose to
6204
+ # exclude some or all of the indexes at the time of restore.
6205
+ # @return [Array<Types::LocalSecondaryIndex>]
6206
+ #
6207
+ # @!attribute [rw] provisioned_throughput_override
6208
+ # Provisioned throughput settings for the restored table.
6209
+ # @return [Types::ProvisionedThroughput]
6210
+ #
6075
6211
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/RestoreTableToPointInTimeInput AWS API Documentation
6076
6212
  #
6077
6213
  class RestoreTableToPointInTimeInput < Struct.new(
6078
6214
  :source_table_name,
6079
6215
  :target_table_name,
6080
6216
  :use_latest_restorable_time,
6081
- :restore_date_time)
6217
+ :restore_date_time,
6218
+ :billing_mode_override,
6219
+ :global_secondary_index_override,
6220
+ :local_secondary_index_override,
6221
+ :provisioned_throughput_override)
6082
6222
  include Aws::Structure
6083
6223
  end
6084
6224
 
@@ -6108,15 +6248,16 @@ module Aws::DynamoDB
6108
6248
  # @!attribute [rw] sse_type
6109
6249
  # Server-side encryption type. The only supported value is:
6110
6250
  #
6111
- # * `KMS` - Server-side encryption which uses AWS Key Management
6112
- # Service. Key is stored in your account and is managed by AWS KMS
6113
- # (KMS charges apply).
6251
+ # * `KMS` - Server-side encryption that uses AWS Key Management
6252
+ # Service. The key is stored in your account and is managed by AWS
6253
+ # KMS (AWS KMS charges apply).
6114
6254
  #
6115
6255
  # ^
6116
6256
  # @return [String]
6117
6257
  #
6118
6258
  # @!attribute [rw] kms_master_key_arn
6119
- # The KMS customer master key (CMK) ARN used for the KMS encryption.
6259
+ # The KMS customer master key (CMK) ARN used for the AWS KMS
6260
+ # encryption.
6120
6261
  # @return [String]
6121
6262
  #
6122
6263
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/SSEDescription AWS API Documentation
@@ -6150,19 +6291,19 @@ module Aws::DynamoDB
6150
6291
  # @!attribute [rw] sse_type
6151
6292
  # Server-side encryption type. The only supported value is:
6152
6293
  #
6153
- # * `KMS` - Server-side encryption which uses AWS Key Management
6154
- # Service. Key is stored in your account and is managed by AWS KMS
6155
- # (KMS charges apply).
6294
+ # * `KMS` - Server-side encryption that uses AWS Key Management
6295
+ # Service. The key is stored in your account and is managed by AWS
6296
+ # KMS (AWS KMS charges apply).
6156
6297
  #
6157
6298
  # ^
6158
6299
  # @return [String]
6159
6300
  #
6160
6301
  # @!attribute [rw] kms_master_key_id
6161
- # The KMS Customer Master Key (CMK) which should be used for the KMS
6162
- # encryption. To specify a CMK, use its key ID, Amazon Resource Name
6163
- # (ARN), alias name, or alias ARN. Note that you should only provide
6164
- # this parameter if the key is different from the default DynamoDB
6165
- # Customer Master Key alias/aws/dynamodb.
6302
+ # The KMS customer master key (CMK) that should be used for the AWS
6303
+ # KMS encryption. To specify a CMK, use its key ID, Amazon Resource
6304
+ # Name (ARN), alias name, or alias ARN. Note that you should only
6305
+ # provide this parameter if the key is different from the default
6306
+ # DynamoDB customer master key alias/aws/dynamodb.
6166
6307
  # @return [String]
6167
6308
  #
6168
6309
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/SSESpecification AWS API Documentation
@@ -6635,8 +6776,7 @@ module Aws::DynamoDB
6635
6776
  # @return [String]
6636
6777
  #
6637
6778
  # @!attribute [rw] table_size_bytes
6638
- # Size of the table in bytes. Please note this is an approximate
6639
- # value.
6779
+ # Size of the table in bytes. Note that this is an approximate value.
6640
6780
  # @return [Integer]
6641
6781
  #
6642
6782
  # @!attribute [rw] key_schema
@@ -6652,7 +6792,7 @@ module Aws::DynamoDB
6652
6792
  # @return [Types::ProvisionedThroughput]
6653
6793
  #
6654
6794
  # @!attribute [rw] item_count
6655
- # Number of items in the table. Please note this is an approximate
6795
+ # Number of items in the table. Note that this is an approximate
6656
6796
  # value.
6657
6797
  # @return [Integer]
6658
6798
  #
@@ -6695,7 +6835,7 @@ module Aws::DynamoDB
6695
6835
  #
6696
6836
  # @!attribute [rw] global_secondary_indexes
6697
6837
  # Represents the GSI properties for the table when the backup was
6698
- # created. It includes the IndexName, KeySchema, Projection and
6838
+ # created. It includes the IndexName, KeySchema, Projection, and
6699
6839
  # ProvisionedThroughput for the GSIs on the table at the time of
6700
6840
  # backup.
6701
6841
  # @return [Array<Types::GlobalSecondaryIndexInfo>]
@@ -6903,7 +7043,7 @@ module Aws::DynamoDB
6903
7043
  # into the index.
6904
7044
  #
6905
7045
  # * `INCLUDE` - Only the specified table attributes are projected
6906
- # into the index. The list of projected attributes are in
7046
+ # into the index. The list of projected attributes is in
6907
7047
  # `NonKeyAttributes`.
6908
7048
  #
6909
7049
  # * `ALL` - All of the table attributes are projected into the
@@ -6934,11 +7074,18 @@ module Aws::DynamoDB
6934
7074
  #
6935
7075
  # * `Backfilling` - If true, then the index is currently in the
6936
7076
  # backfilling phase. Backfilling occurs only when a new global
6937
- # secondary index is added to the table; it is the process by which
7077
+ # secondary index is added to the table. It is the process by which
6938
7078
  # DynamoDB populates the new index with data from the table. (This
6939
7079
  # attribute does not appear for indexes that were created during a
6940
7080
  # `CreateTable` operation.)
6941
7081
  #
7082
+ # You can delete an index that is being created during the
7083
+ # `Backfilling` phase when `IndexStatus` is set to CREATING and
7084
+ # `Backfilling` is true. You can't delete the index that is being
7085
+ # created when `IndexStatus` is set to CREATING and `Backfilling` is
7086
+ # false. (This attribute does not appear for indexes that were
7087
+ # created during a `CreateTable` operation.)
7088
+ #
6942
7089
  # * `IndexName` - The name of the global secondary index.
6943
7090
  #
6944
7091
  # * `IndexSizeBytes` - The total size of the global secondary index,
@@ -6976,7 +7123,7 @@ module Aws::DynamoDB
6976
7123
  # into the index.
6977
7124
  #
6978
7125
  # * `INCLUDE` - Only the specified table attributes are projected
6979
- # into the index. The list of projected attributes are in
7126
+ # into the index. The list of projected attributes is in
6980
7127
  # `NonKeyAttributes`.
6981
7128
  #
6982
7129
  # * `ALL` - All of the table attributes are projected into the
@@ -7009,11 +7156,11 @@ module Aws::DynamoDB
7009
7156
  # might have the same timestamp. However, the combination of the
7010
7157
  # following three elements is guaranteed to be unique:
7011
7158
  #
7012
- # * the AWS customer ID.
7159
+ # * AWS customer ID
7013
7160
  #
7014
- # * the table name.
7161
+ # * Table name
7015
7162
  #
7016
- # * the `StreamLabel`.
7163
+ # * `StreamLabel`
7017
7164
  # @return [String]
7018
7165
  #
7019
7166
  # @!attribute [rw] latest_stream_arn
@@ -7578,8 +7725,6 @@ module Aws::DynamoDB
7578
7725
  # secondary index (LSI) becomes too large, or a similar validation
7579
7726
  # error occurs because of changes made by the transaction.
7580
7727
  #
7581
- # * The aggregate size of the items in the transaction exceeds 4 MBs.
7582
- #
7583
7728
  # * There is a user error, such as an invalid data format.
7584
7729
  #
7585
7730
  # DynamoDB cancels a `TransactGetItems` request under the following
@@ -7596,8 +7741,6 @@ module Aws::DynamoDB
7596
7741
  # * There is insufficient provisioned capacity for the transaction to be
7597
7742
  # completed.
7598
7743
  #
7599
- # * The aggregate size of the items in the transaction exceeds 4 MBs.
7600
- #
7601
7744
  # * There is a user error, such as an invalid data format.
7602
7745
  #
7603
7746
  # <note markdown="1"> If using Java, DynamoDB lists the cancellation reasons on the
@@ -8067,6 +8210,19 @@ module Aws::DynamoDB
8067
8210
  # The billing mode of the global table. If `GlobalTableBillingMode` is
8068
8211
  # not specified, the global table defaults to `PROVISIONED` capacity
8069
8212
  # billing mode.
8213
+ #
8214
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
8215
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
8216
+ # Mode][1].
8217
+ #
8218
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
8219
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode
8220
+ # to [On-Demand Mode][2].
8221
+ #
8222
+ #
8223
+ #
8224
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
8225
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
8070
8226
  # @return [String]
8071
8227
  #
8072
8228
  # @!attribute [rw] global_table_provisioned_write_capacity_units
@@ -8611,11 +8767,18 @@ module Aws::DynamoDB
8611
8767
  # the consumed read and write capacity of your table and global
8612
8768
  # secondary indexes over the past 30 minutes.
8613
8769
  #
8614
- # * `PROVISIONED` - Sets the billing mode to `PROVISIONED`. We
8615
- # recommend using `PROVISIONED` for predictable workloads.
8770
+ # * `PROVISIONED` - We recommend using `PROVISIONED` for predictable
8771
+ # workloads. `PROVISIONED` sets the billing mode to [Provisioned
8772
+ # Mode][1].
8773
+ #
8774
+ # * `PAY_PER_REQUEST` - We recommend using `PAY_PER_REQUEST` for
8775
+ # unpredictable workloads. `PAY_PER_REQUEST` sets the billing mode
8776
+ # to [On-Demand Mode][2].
8616
8777
  #
8617
- # * `PAY_PER_REQUEST` - Sets the billing mode to `PAY_PER_REQUEST`. We
8618
- # recommend using `PAY_PER_REQUEST` for unpredictable workloads.
8778
+ #
8779
+ #
8780
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.ProvisionedThroughput.Manual
8781
+ # [2]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.html#HowItWorks.OnDemand
8619
8782
  # @return [String]
8620
8783
  #
8621
8784
  # @!attribute [rw] provisioned_throughput
@@ -8634,6 +8797,9 @@ module Aws::DynamoDB
8634
8797
  #
8635
8798
  # * `Delete` - remove a global secondary index from the table.
8636
8799
  #
8800
+ # You can create or delete only one global secondary index per
8801
+ # `UpdateTable` operation.
8802
+ #
8637
8803
  # For more information, see [Managing Global Secondary Indexes][1] in
8638
8804
  # the *Amazon DynamoDB Developer Guide*.
8639
8805
  #
@@ -8726,7 +8892,7 @@ module Aws::DynamoDB
8726
8892
  # Represents an operation to perform - either `DeleteItem` or `PutItem`.
8727
8893
  # You can only request one of these operations, not both, in a single
8728
8894
  # `WriteRequest`. If you do need to perform both of these operations,
8729
- # you will need to provide two separate `WriteRequest` objects.
8895
+ # you need to provide two separate `WriteRequest` objects.
8730
8896
  #
8731
8897
  # @note When making an API call, you may pass WriteRequest
8732
8898
  # data as a hash:
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-dynamodb
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.37.0
4
+ version: 1.38.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2019-10-23 00:00:00.000000000 Z
11
+ date: 2019-11-12 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core