aws-sdk-dynamodb 1.73.0 → 1.76.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.
@@ -164,7 +164,7 @@ module Aws::DynamoDB
164
164
  # @!attribute [rw] l
165
165
  # An attribute of type List. For example:
166
166
  #
167
- # `"L": [ \{"S": "Cookies"\} , \{"S": "Coffee"\}, \{"N", "3.14159"\}]`
167
+ # `"L": [ \{"S": "Cookies"\} , \{"S": "Coffee"\}, \{"N": "3.14159"\}]`
168
168
  # @return [Array<Types::AttributeValue>]
169
169
  #
170
170
  # @!attribute [rw] null
@@ -304,10 +304,9 @@ module Aws::DynamoDB
304
304
  #
305
305
  # * `DELETE` - Nothing happens; there is no attribute to delete.
306
306
  #
307
- # * `ADD` - DynamoDB creates an item with the supplied primary key and
308
- # number (or set of numbers) for the attribute value. The only data
309
- # types allowed are number and number set; no other data types can
310
- # be specified.
307
+ # * `ADD` - DynamoDB creates a new item with the supplied primary key
308
+ # and number (or set) for the attribute value. The only data types
309
+ # allowed are number, number set, string set or binary set.
311
310
  # @return [String]
312
311
  #
313
312
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/AttributeValueUpdate AWS API Documentation
@@ -605,7 +604,9 @@ module Aws::DynamoDB
605
604
  # @return [String]
606
605
  #
607
606
  # @!attribute [rw] backup_size_bytes
608
- # Size of the backup in bytes.
607
+ # Size of the backup in bytes. DynamoDB updates this value
608
+ # approximately every six hours. Recent changes might not be reflected
609
+ # in this value.
609
610
  # @return [Integer]
610
611
  #
611
612
  # @!attribute [rw] backup_status
@@ -1025,7 +1026,7 @@ module Aws::DynamoDB
1025
1026
  # @return [String]
1026
1027
  #
1027
1028
  # @!attribute [rw] message
1028
- # The error message associated with the PartiQL batch resposne.
1029
+ # The error message associated with the PartiQL batch response.
1029
1030
  # @return [String]
1030
1031
  #
1031
1032
  # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/BatchStatementError AWS API Documentation
@@ -2330,6 +2331,38 @@ module Aws::DynamoDB
2330
2331
  include Aws::Structure
2331
2332
  end
2332
2333
 
2334
+ # Processing options for the CSV file being imported.
2335
+ #
2336
+ # @note When making an API call, you may pass CsvOptions
2337
+ # data as a hash:
2338
+ #
2339
+ # {
2340
+ # delimiter: "CsvDelimiter",
2341
+ # header_list: ["CsvHeader"],
2342
+ # }
2343
+ #
2344
+ # @!attribute [rw] delimiter
2345
+ # The delimiter used for separating items in the CSV file being
2346
+ # imported.
2347
+ # @return [String]
2348
+ #
2349
+ # @!attribute [rw] header_list
2350
+ # List of the headers used to specify a common header for all source
2351
+ # CSV files being imported. If this field is specified then the first
2352
+ # line of each CSV file is treated as data instead of the header. If
2353
+ # this field is not specified the the first line of each CSV file is
2354
+ # treated as the header.
2355
+ # @return [Array<String>]
2356
+ #
2357
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/CsvOptions AWS API Documentation
2358
+ #
2359
+ class CsvOptions < Struct.new(
2360
+ :delimiter,
2361
+ :header_list)
2362
+ SENSITIVE = []
2363
+ include Aws::Structure
2364
+ end
2365
+
2333
2366
  # Represents a request to perform a `DeleteItem` operation.
2334
2367
  #
2335
2368
  # @note When making an API call, you may pass Delete
@@ -2522,6 +2555,10 @@ module Aws::DynamoDB
2522
2555
  #
2523
2556
  # * `ALL_OLD` - The content of the old item is returned.
2524
2557
  #
2558
+ # There is no additional cost associated with requesting a return
2559
+ # value aside from the small network and processing overhead of
2560
+ # receiving a larger response. No read capacity units are consumed.
2561
+ #
2525
2562
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
2526
2563
  # however, `DeleteItem` does not recognize any values other than
2527
2564
  # `NONE` or `ALL_OLD`.
@@ -3097,6 +3134,41 @@ module Aws::DynamoDB
3097
3134
  include Aws::Structure
3098
3135
  end
3099
3136
 
3137
+ # @note When making an API call, you may pass DescribeImportInput
3138
+ # data as a hash:
3139
+ #
3140
+ # {
3141
+ # import_arn: "ImportArn", # required
3142
+ # }
3143
+ #
3144
+ # @!attribute [rw] import_arn
3145
+ # The Amazon Resource Name (ARN) associated with the table you're
3146
+ # importing to.
3147
+ # @return [String]
3148
+ #
3149
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeImportInput AWS API Documentation
3150
+ #
3151
+ class DescribeImportInput < Struct.new(
3152
+ :import_arn)
3153
+ SENSITIVE = []
3154
+ include Aws::Structure
3155
+ end
3156
+
3157
+ # @!attribute [rw] import_table_description
3158
+ # Represents the properties of the table created for the import, and
3159
+ # parameters of the import. The import parameters include import
3160
+ # status, how many items were processed, and how many errors were
3161
+ # encountered.
3162
+ # @return [Types::ImportTableDescription]
3163
+ #
3164
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/DescribeImportOutput AWS API Documentation
3165
+ #
3166
+ class DescribeImportOutput < Struct.new(
3167
+ :import_table_description)
3168
+ SENSITIVE = []
3169
+ include Aws::Structure
3170
+ end
3171
+
3100
3172
  # @note When making an API call, you may pass DescribeKinesisStreamingDestinationInput
3101
3173
  # data as a hash:
3102
3174
  #
@@ -3958,8 +4030,9 @@ module Aws::DynamoDB
3958
4030
  # @return [String]
3959
4031
  #
3960
4032
  # @!attribute [rw] export_time
3961
- # Time in the past from which to export table data. The table export
3962
- # will be a snapshot of the table's state at this point in time.
4033
+ # Time in the past from which to export table data, counted in seconds
4034
+ # from the start of the Unix epoch. The table export will be a
4035
+ # snapshot of the table's state at this point in time.
3963
4036
  # @return [Time]
3964
4037
  #
3965
4038
  # @!attribute [rw] client_token
@@ -3975,7 +4048,7 @@ module Aws::DynamoDB
3975
4048
  #
3976
4049
  # If you submit a request with the same client token but a change in
3977
4050
  # other parameters within the 8-hour idempotency window, DynamoDB
3978
- # returns an `IdempotentParameterMismatch` exception.
4051
+ # returns an `ImportConflictException`.
3979
4052
  #
3980
4053
  # **A suitable default value is auto-generated.** You should normally
3981
4054
  # not need to pass this option.
@@ -4812,6 +4885,338 @@ module Aws::DynamoDB
4812
4885
  include Aws::Structure
4813
4886
  end
4814
4887
 
4888
+ # There was a conflict when importing from the specified S3 source. This
4889
+ # can occur when the current import conflicts with a previous import
4890
+ # request that had the same client token.
4891
+ #
4892
+ # @!attribute [rw] message
4893
+ # @return [String]
4894
+ #
4895
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ImportConflictException AWS API Documentation
4896
+ #
4897
+ class ImportConflictException < Struct.new(
4898
+ :message)
4899
+ SENSITIVE = []
4900
+ include Aws::Structure
4901
+ end
4902
+
4903
+ # The specified import was not found.
4904
+ #
4905
+ # @!attribute [rw] message
4906
+ # @return [String]
4907
+ #
4908
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ImportNotFoundException AWS API Documentation
4909
+ #
4910
+ class ImportNotFoundException < Struct.new(
4911
+ :message)
4912
+ SENSITIVE = []
4913
+ include Aws::Structure
4914
+ end
4915
+
4916
+ # Summary information about the source file for the import.
4917
+ #
4918
+ # @!attribute [rw] import_arn
4919
+ # The Amazon Resource Number (ARN) corresponding to the import
4920
+ # request.
4921
+ # @return [String]
4922
+ #
4923
+ # @!attribute [rw] import_status
4924
+ # The status of the import operation.
4925
+ # @return [String]
4926
+ #
4927
+ # @!attribute [rw] table_arn
4928
+ # The Amazon Resource Number (ARN) of the table being imported into.
4929
+ # @return [String]
4930
+ #
4931
+ # @!attribute [rw] s3_bucket_source
4932
+ # The path and S3 bucket of the source file that is being imported.
4933
+ # This includes the S3Bucket (required), S3KeyPrefix (optional) and
4934
+ # S3BucketOwner (optional if the bucket is owned by the requester).
4935
+ # @return [Types::S3BucketSource]
4936
+ #
4937
+ # @!attribute [rw] cloud_watch_log_group_arn
4938
+ # The Amazon Resource Number (ARN) of the Cloudwatch Log Group
4939
+ # associated with this import task.
4940
+ # @return [String]
4941
+ #
4942
+ # @!attribute [rw] input_format
4943
+ # The format of the source data. Valid values are `CSV`,
4944
+ # `DYNAMODB_JSON` or `ION`.
4945
+ # @return [String]
4946
+ #
4947
+ # @!attribute [rw] start_time
4948
+ # The time at which this import task began.
4949
+ # @return [Time]
4950
+ #
4951
+ # @!attribute [rw] end_time
4952
+ # The time at which this import task ended. (Does this include the
4953
+ # successful complete creation of the table it was imported to?)
4954
+ # @return [Time]
4955
+ #
4956
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ImportSummary AWS API Documentation
4957
+ #
4958
+ class ImportSummary < Struct.new(
4959
+ :import_arn,
4960
+ :import_status,
4961
+ :table_arn,
4962
+ :s3_bucket_source,
4963
+ :cloud_watch_log_group_arn,
4964
+ :input_format,
4965
+ :start_time,
4966
+ :end_time)
4967
+ SENSITIVE = []
4968
+ include Aws::Structure
4969
+ end
4970
+
4971
+ # Represents the properties of the table being imported into.
4972
+ #
4973
+ # @!attribute [rw] import_arn
4974
+ # The Amazon Resource Number (ARN) corresponding to the import
4975
+ # request.
4976
+ # @return [String]
4977
+ #
4978
+ # @!attribute [rw] import_status
4979
+ # The status of the import.
4980
+ # @return [String]
4981
+ #
4982
+ # @!attribute [rw] table_arn
4983
+ # The Amazon Resource Number (ARN) of the table being imported into.
4984
+ # @return [String]
4985
+ #
4986
+ # @!attribute [rw] table_id
4987
+ # The table id corresponding to the table created by import table
4988
+ # process.
4989
+ # @return [String]
4990
+ #
4991
+ # @!attribute [rw] client_token
4992
+ # The client token that was provided for the import task. Reusing the
4993
+ # client token on retry makes a call to `ImportTable` idempotent.
4994
+ # @return [String]
4995
+ #
4996
+ # @!attribute [rw] s3_bucket_source
4997
+ # Values for the S3 bucket the source file is imported from. Includes
4998
+ # bucket name (required), key prefix (optional) and bucket account
4999
+ # owner ID (optional).
5000
+ # @return [Types::S3BucketSource]
5001
+ #
5002
+ # @!attribute [rw] error_count
5003
+ # The number of errors occurred on importing the source file into the
5004
+ # target table.
5005
+ # @return [Integer]
5006
+ #
5007
+ # @!attribute [rw] cloud_watch_log_group_arn
5008
+ # The Amazon Resource Number (ARN) of the Cloudwatch Log Group
5009
+ # associated with the target table.
5010
+ # @return [String]
5011
+ #
5012
+ # @!attribute [rw] input_format
5013
+ # The format of the source data going into the target table.
5014
+ # @return [String]
5015
+ #
5016
+ # @!attribute [rw] input_format_options
5017
+ # The format options for the data that was imported into the target
5018
+ # table. There is one value, CsvOption.
5019
+ # @return [Types::InputFormatOptions]
5020
+ #
5021
+ # @!attribute [rw] input_compression_type
5022
+ # The compression options for the data that has been imported into the
5023
+ # target table. The values are NONE, GZIP, or ZSTD.
5024
+ # @return [String]
5025
+ #
5026
+ # @!attribute [rw] table_creation_parameters
5027
+ # The parameters for the new table that is being imported into.
5028
+ # @return [Types::TableCreationParameters]
5029
+ #
5030
+ # @!attribute [rw] start_time
5031
+ # The time when this import task started.
5032
+ # @return [Time]
5033
+ #
5034
+ # @!attribute [rw] end_time
5035
+ # The time at which the creation of the table associated with this
5036
+ # import task completed.
5037
+ # @return [Time]
5038
+ #
5039
+ # @!attribute [rw] processed_size_bytes
5040
+ # The total size of data processed from the source file, in Bytes.
5041
+ # @return [Integer]
5042
+ #
5043
+ # @!attribute [rw] processed_item_count
5044
+ # The total number of items processed from the source file.
5045
+ # @return [Integer]
5046
+ #
5047
+ # @!attribute [rw] imported_item_count
5048
+ # The number of items successfully imported into the new table.
5049
+ # @return [Integer]
5050
+ #
5051
+ # @!attribute [rw] failure_code
5052
+ # The error code corresponding to the failure that the import job ran
5053
+ # into during execution.
5054
+ # @return [String]
5055
+ #
5056
+ # @!attribute [rw] failure_message
5057
+ # The error message corresponding to the failure that the import job
5058
+ # ran into during execution.
5059
+ # @return [String]
5060
+ #
5061
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ImportTableDescription AWS API Documentation
5062
+ #
5063
+ class ImportTableDescription < Struct.new(
5064
+ :import_arn,
5065
+ :import_status,
5066
+ :table_arn,
5067
+ :table_id,
5068
+ :client_token,
5069
+ :s3_bucket_source,
5070
+ :error_count,
5071
+ :cloud_watch_log_group_arn,
5072
+ :input_format,
5073
+ :input_format_options,
5074
+ :input_compression_type,
5075
+ :table_creation_parameters,
5076
+ :start_time,
5077
+ :end_time,
5078
+ :processed_size_bytes,
5079
+ :processed_item_count,
5080
+ :imported_item_count,
5081
+ :failure_code,
5082
+ :failure_message)
5083
+ SENSITIVE = []
5084
+ include Aws::Structure
5085
+ end
5086
+
5087
+ # @note When making an API call, you may pass ImportTableInput
5088
+ # data as a hash:
5089
+ #
5090
+ # {
5091
+ # client_token: "ClientToken",
5092
+ # s3_bucket_source: { # required
5093
+ # s3_bucket_owner: "S3BucketOwner",
5094
+ # s3_bucket: "S3Bucket", # required
5095
+ # s3_key_prefix: "S3Prefix",
5096
+ # },
5097
+ # input_format: "DYNAMODB_JSON", # required, accepts DYNAMODB_JSON, ION, CSV
5098
+ # input_format_options: {
5099
+ # csv: {
5100
+ # delimiter: "CsvDelimiter",
5101
+ # header_list: ["CsvHeader"],
5102
+ # },
5103
+ # },
5104
+ # input_compression_type: "GZIP", # accepts GZIP, ZSTD, NONE
5105
+ # table_creation_parameters: { # required
5106
+ # table_name: "TableName", # required
5107
+ # attribute_definitions: [ # required
5108
+ # {
5109
+ # attribute_name: "KeySchemaAttributeName", # required
5110
+ # attribute_type: "S", # required, accepts S, N, B
5111
+ # },
5112
+ # ],
5113
+ # key_schema: [ # required
5114
+ # {
5115
+ # attribute_name: "KeySchemaAttributeName", # required
5116
+ # key_type: "HASH", # required, accepts HASH, RANGE
5117
+ # },
5118
+ # ],
5119
+ # billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
5120
+ # provisioned_throughput: {
5121
+ # read_capacity_units: 1, # required
5122
+ # write_capacity_units: 1, # required
5123
+ # },
5124
+ # sse_specification: {
5125
+ # enabled: false,
5126
+ # sse_type: "AES256", # accepts AES256, KMS
5127
+ # kms_master_key_id: "KMSMasterKeyId",
5128
+ # },
5129
+ # global_secondary_indexes: [
5130
+ # {
5131
+ # index_name: "IndexName", # required
5132
+ # key_schema: [ # required
5133
+ # {
5134
+ # attribute_name: "KeySchemaAttributeName", # required
5135
+ # key_type: "HASH", # required, accepts HASH, RANGE
5136
+ # },
5137
+ # ],
5138
+ # projection: { # required
5139
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
5140
+ # non_key_attributes: ["NonKeyAttributeName"],
5141
+ # },
5142
+ # provisioned_throughput: {
5143
+ # read_capacity_units: 1, # required
5144
+ # write_capacity_units: 1, # required
5145
+ # },
5146
+ # },
5147
+ # ],
5148
+ # },
5149
+ # }
5150
+ #
5151
+ # @!attribute [rw] client_token
5152
+ # Providing a `ClientToken` makes the call to `ImportTableInput`
5153
+ # idempotent, meaning that multiple identical calls have the same
5154
+ # effect as one single call.
5155
+ #
5156
+ # A client token is valid for 8 hours after the first request that
5157
+ # uses it is completed. After 8 hours, any request with the same
5158
+ # client token is treated as a new request. Do not resubmit the same
5159
+ # request with the same client token for more than 8 hours, or the
5160
+ # result might not be idempotent.
5161
+ #
5162
+ # If you submit a request with the same client token but a change in
5163
+ # other parameters within the 8-hour idempotency window, DynamoDB
5164
+ # returns an `IdempotentParameterMismatch` exception.
5165
+ #
5166
+ # **A suitable default value is auto-generated.** You should normally
5167
+ # not need to pass this option.
5168
+ # @return [String]
5169
+ #
5170
+ # @!attribute [rw] s3_bucket_source
5171
+ # The S3 bucket that provides the source for the import.
5172
+ # @return [Types::S3BucketSource]
5173
+ #
5174
+ # @!attribute [rw] input_format
5175
+ # The format of the source data. Valid values for `ImportFormat` are
5176
+ # `CSV`, `DYNAMODB_JSON` or `ION`.
5177
+ # @return [String]
5178
+ #
5179
+ # @!attribute [rw] input_format_options
5180
+ # Additional properties that specify how the input is formatted,
5181
+ # @return [Types::InputFormatOptions]
5182
+ #
5183
+ # @!attribute [rw] input_compression_type
5184
+ # Type of compression to be used on the input coming from the imported
5185
+ # table.
5186
+ # @return [String]
5187
+ #
5188
+ # @!attribute [rw] table_creation_parameters
5189
+ # Parameters for the table to import the data into.
5190
+ # @return [Types::TableCreationParameters]
5191
+ #
5192
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ImportTableInput AWS API Documentation
5193
+ #
5194
+ class ImportTableInput < Struct.new(
5195
+ :client_token,
5196
+ :s3_bucket_source,
5197
+ :input_format,
5198
+ :input_format_options,
5199
+ :input_compression_type,
5200
+ :table_creation_parameters)
5201
+ SENSITIVE = []
5202
+ include Aws::Structure
5203
+ end
5204
+
5205
+ # @!attribute [rw] import_table_description
5206
+ # Represents the properties of the table created for the import, and
5207
+ # parameters of the import. The import parameters include import
5208
+ # status, how many items were processed, and how many errors were
5209
+ # encountered.
5210
+ # @return [Types::ImportTableDescription]
5211
+ #
5212
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ImportTableOutput AWS API Documentation
5213
+ #
5214
+ class ImportTableOutput < Struct.new(
5215
+ :import_table_description)
5216
+ SENSITIVE = []
5217
+ include Aws::Structure
5218
+ end
5219
+
4815
5220
  # The operation tried to access a nonexistent index.
4816
5221
  #
4817
5222
  # @!attribute [rw] message
@@ -4825,6 +5230,32 @@ module Aws::DynamoDB
4825
5230
  include Aws::Structure
4826
5231
  end
4827
5232
 
5233
+ # The format options for the data that was imported into the target
5234
+ # table. There is one value, CsvOption.
5235
+ #
5236
+ # @note When making an API call, you may pass InputFormatOptions
5237
+ # data as a hash:
5238
+ #
5239
+ # {
5240
+ # csv: {
5241
+ # delimiter: "CsvDelimiter",
5242
+ # header_list: ["CsvHeader"],
5243
+ # },
5244
+ # }
5245
+ #
5246
+ # @!attribute [rw] csv
5247
+ # The options for imported source files in CSV format. The values are
5248
+ # Delimiter and HeaderList.
5249
+ # @return [Types::CsvOptions]
5250
+ #
5251
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/InputFormatOptions AWS API Documentation
5252
+ #
5253
+ class InputFormatOptions < Struct.new(
5254
+ :csv)
5255
+ SENSITIVE = []
5256
+ include Aws::Structure
5257
+ end
5258
+
4828
5259
  # An error occurred on the server side.
4829
5260
  #
4830
5261
  # @!attribute [rw] message
@@ -5188,17 +5619,17 @@ module Aws::DynamoDB
5188
5619
  # There is no limit to the number of daily on-demand backups that can be
5189
5620
  # taken.
5190
5621
  #
5191
- # Up to 50 simultaneous table operations are allowed per account. These
5622
+ # Up to 500 simultaneous table operations are allowed per account. These
5192
5623
  # operations include `CreateTable`, `UpdateTable`,
5193
5624
  # `DeleteTable`,`UpdateTimeToLive`, `RestoreTableFromBackup`, and
5194
5625
  # `RestoreTableToPointInTime`.
5195
5626
  #
5196
5627
  # The only exception is when you are creating a table with one or more
5197
- # secondary indexes. You can have up to 25 such requests running at a
5628
+ # secondary indexes. You can have up to 250 such requests running at a
5198
5629
  # time; however, if the table or index specifications are complex,
5199
5630
  # DynamoDB might temporarily reduce the number of concurrent operations.
5200
5631
  #
5201
- # There is a soft account quota of 256 tables.
5632
+ # There is a soft account quota of 2,500 tables.
5202
5633
  #
5203
5634
  # @!attribute [rw] message
5204
5635
  # Too many operations for a given subscriber.
@@ -5255,7 +5686,8 @@ module Aws::DynamoDB
5255
5686
  #
5256
5687
  # Where `BackupType` can be:
5257
5688
  #
5258
- # * `USER` - On-demand backup created by you.
5689
+ # * `USER` - On-demand backup created by you. (The default setting if
5690
+ # no other backup types are specified.)
5259
5691
  #
5260
5692
  # * `SYSTEM` - On-demand backup automatically created by DynamoDB.
5261
5693
  #
@@ -5458,6 +5890,59 @@ module Aws::DynamoDB
5458
5890
  include Aws::Structure
5459
5891
  end
5460
5892
 
5893
+ # @note When making an API call, you may pass ListImportsInput
5894
+ # data as a hash:
5895
+ #
5896
+ # {
5897
+ # table_arn: "TableArn",
5898
+ # page_size: 1,
5899
+ # next_token: "ImportNextToken",
5900
+ # }
5901
+ #
5902
+ # @!attribute [rw] table_arn
5903
+ # The Amazon Resource Name (ARN) associated with the table that was
5904
+ # imported to.
5905
+ # @return [String]
5906
+ #
5907
+ # @!attribute [rw] page_size
5908
+ # The number of `ImportSummary `objects returned in a single page.
5909
+ # @return [Integer]
5910
+ #
5911
+ # @!attribute [rw] next_token
5912
+ # An optional string that, if supplied, must be copied from the output
5913
+ # of a previous call to `ListImports`. When provided in this manner,
5914
+ # the API fetches the next page of results.
5915
+ # @return [String]
5916
+ #
5917
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListImportsInput AWS API Documentation
5918
+ #
5919
+ class ListImportsInput < Struct.new(
5920
+ :table_arn,
5921
+ :page_size,
5922
+ :next_token)
5923
+ SENSITIVE = []
5924
+ include Aws::Structure
5925
+ end
5926
+
5927
+ # @!attribute [rw] import_summary_list
5928
+ # A list of `ImportSummary` objects.
5929
+ # @return [Array<Types::ImportSummary>]
5930
+ #
5931
+ # @!attribute [rw] next_token
5932
+ # If this value is returned, there are additional results to be
5933
+ # displayed. To retrieve them, call `ListImports` again, with
5934
+ # `NextToken` set to this value.
5935
+ # @return [String]
5936
+ #
5937
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ListImportsOutput AWS API Documentation
5938
+ #
5939
+ class ListImportsOutput < Struct.new(
5940
+ :import_summary_list,
5941
+ :next_token)
5942
+ SENSITIVE = []
5943
+ include Aws::Structure
5944
+ end
5945
+
5461
5946
  # Represents the input of a `ListTables` operation.
5462
5947
  #
5463
5948
  # @note When making an API call, you may pass ListTablesInput
@@ -5859,7 +6344,7 @@ module Aws::DynamoDB
5859
6344
  #
5860
6345
  # For local secondary indexes, the total count of `NonKeyAttributes`
5861
6346
  # summed across all of the local secondary indexes, must not exceed
5862
- # 20. If you project the same attribute into two different indexes,
6347
+ # 100. If you project the same attribute into two different indexes,
5863
6348
  # this counts as two distinct attributes when determining the total.
5864
6349
  # @return [Array<String>]
5865
6350
  #
@@ -6180,6 +6665,10 @@ module Aws::DynamoDB
6180
6665
  #
6181
6666
  # The values returned are strongly consistent.
6182
6667
  #
6668
+ # There is no additional cost associated with requesting a return
6669
+ # value aside from the small network and processing overhead of
6670
+ # receiving a larger response. No read capacity units are consumed.
6671
+ #
6183
6672
  # <note markdown="1"> The `ReturnValues` parameter is used by several DynamoDB operations;
6184
6673
  # however, `PutItem` does not recognize any values other than `NONE`
6185
6674
  # or `ALL_OLD`.
@@ -6505,8 +6994,9 @@ module Aws::DynamoDB
6505
6994
  # matching items themselves.
6506
6995
  #
6507
6996
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
6508
- # `AttributesToGet`. This return value is equivalent to specifying
6509
- # `AttributesToGet` without specifying any value for `Select`.
6997
+ # `ProjectionExpression`. This return value is equivalent to
6998
+ # specifying `ProjectionExpression` without specifying any value for
6999
+ # `Select`.
6510
7000
  #
6511
7001
  # If you query or scan a local secondary index and request only
6512
7002
  # attributes that are projected into that index, the operation will
@@ -6520,13 +7010,13 @@ module Aws::DynamoDB
6520
7010
  # secondary index queries cannot fetch attributes from the parent
6521
7011
  # table.
6522
7012
  #
6523
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
6524
- # defaults to `ALL_ATTRIBUTES` when accessing a table, and
7013
+ # If neither `Select` nor `ProjectionExpression` are specified,
7014
+ # DynamoDB defaults to `ALL_ATTRIBUTES` when accessing a table, and
6525
7015
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
6526
- # both `Select` and `AttributesToGet` together in a single request,
6527
- # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage
6528
- # is equivalent to specifying `AttributesToGet` without any value for
6529
- # `Select`.)
7016
+ # both `Select` and `ProjectionExpression` together in a single
7017
+ # request, unless the value for `Select` is `SPECIFIC_ATTRIBUTES`.
7018
+ # (This usage is equivalent to specifying `ProjectionExpression`
7019
+ # without any value for `Select`.)
6530
7020
  #
6531
7021
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
6532
7022
  # `Select` can only be `SPECIFIC_ATTRIBUTES`. Any other value for
@@ -6688,7 +7178,7 @@ module Aws::DynamoDB
6688
7178
  #
6689
7179
  #
6690
7180
  #
6691
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
7181
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
6692
7182
  # @return [String]
6693
7183
  #
6694
7184
  # @!attribute [rw] key_condition_expression
@@ -7658,6 +8148,12 @@ module Aws::DynamoDB
7658
8148
  # `DeleteTableReplica` action in the destination Region, deleting the
7659
8149
  # replica and all if its items in the destination Region.
7660
8150
  #
8151
+ # <note markdown="1"> When you manually remove a table or global table replica, you do not
8152
+ # automatically remove any associated scalable targets, scaling
8153
+ # policies, or CloudWatch alarms.
8154
+ #
8155
+ # </note>
8156
+ #
7661
8157
  # @note When making an API call, you may pass ReplicationGroupUpdate
7662
8158
  # data as a hash:
7663
8159
  #
@@ -8043,6 +8539,40 @@ module Aws::DynamoDB
8043
8539
  include Aws::Structure
8044
8540
  end
8045
8541
 
8542
+ # The S3 bucket that is being imported from.
8543
+ #
8544
+ # @note When making an API call, you may pass S3BucketSource
8545
+ # data as a hash:
8546
+ #
8547
+ # {
8548
+ # s3_bucket_owner: "S3BucketOwner",
8549
+ # s3_bucket: "S3Bucket", # required
8550
+ # s3_key_prefix: "S3Prefix",
8551
+ # }
8552
+ #
8553
+ # @!attribute [rw] s3_bucket_owner
8554
+ # The account number of the S3 bucket that is being imported from. If
8555
+ # the bucket is owned by the requester this is optional.
8556
+ # @return [String]
8557
+ #
8558
+ # @!attribute [rw] s3_bucket
8559
+ # The S3 bucket that is being imported from.
8560
+ # @return [String]
8561
+ #
8562
+ # @!attribute [rw] s3_key_prefix
8563
+ # The key prefix shared by all S3 Objects that are being imported.
8564
+ # @return [String]
8565
+ #
8566
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/S3BucketSource AWS API Documentation
8567
+ #
8568
+ class S3BucketSource < Struct.new(
8569
+ :s3_bucket_owner,
8570
+ :s3_bucket,
8571
+ :s3_key_prefix)
8572
+ SENSITIVE = []
8573
+ include Aws::Structure
8574
+ end
8575
+
8046
8576
  # The description of the server-side encryption status on the specified
8047
8577
  # table.
8048
8578
  #
@@ -8233,8 +8763,9 @@ module Aws::DynamoDB
8233
8763
  # matching items themselves.
8234
8764
  #
8235
8765
  # * `SPECIFIC_ATTRIBUTES` - Returns only the attributes listed in
8236
- # `AttributesToGet`. This return value is equivalent to specifying
8237
- # `AttributesToGet` without specifying any value for `Select`.
8766
+ # `ProjectionExpression`. This return value is equivalent to
8767
+ # specifying `ProjectionExpression` without specifying any value for
8768
+ # `Select`.
8238
8769
  #
8239
8770
  # If you query or scan a local secondary index and request only
8240
8771
  # attributes that are projected into that index, the operation reads
@@ -8248,13 +8779,13 @@ module Aws::DynamoDB
8248
8779
  # secondary index queries cannot fetch attributes from the parent
8249
8780
  # table.
8250
8781
  #
8251
- # If neither `Select` nor `AttributesToGet` are specified, DynamoDB
8252
- # defaults to `ALL_ATTRIBUTES` when accessing a table, and
8782
+ # If neither `Select` nor `ProjectionExpression` are specified,
8783
+ # DynamoDB defaults to `ALL_ATTRIBUTES` when accessing a table, and
8253
8784
  # `ALL_PROJECTED_ATTRIBUTES` when accessing an index. You cannot use
8254
- # both `Select` and `AttributesToGet` together in a single request,
8255
- # unless the value for `Select` is `SPECIFIC_ATTRIBUTES`. (This usage
8256
- # is equivalent to specifying `AttributesToGet` without any value for
8257
- # `Select`.)
8785
+ # both `Select` and `ProjectionExpression` together in a single
8786
+ # request, unless the value for `Select` is `SPECIFIC_ATTRIBUTES`.
8787
+ # (This usage is equivalent to specifying `ProjectionExpression`
8788
+ # without any value for `Select`.)
8258
8789
  #
8259
8790
  # <note markdown="1"> If you use the `ProjectionExpression` parameter, then the value for
8260
8791
  # `Select` can only be `SPECIFIC_ATTRIBUTES`. Any other value for
@@ -8385,7 +8916,7 @@ module Aws::DynamoDB
8385
8916
  #
8386
8917
  #
8387
8918
  #
8388
- # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#FilteringResults
8919
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/QueryAndScan.html#Query.FilterExpression
8389
8920
  # @return [String]
8390
8921
  #
8391
8922
  # @!attribute [rw] expression_attribute_names
@@ -8796,6 +9327,111 @@ module Aws::DynamoDB
8796
9327
  include Aws::Structure
8797
9328
  end
8798
9329
 
9330
+ # The parameters for the table created as part of the import operation.
9331
+ #
9332
+ # @note When making an API call, you may pass TableCreationParameters
9333
+ # data as a hash:
9334
+ #
9335
+ # {
9336
+ # table_name: "TableName", # required
9337
+ # attribute_definitions: [ # required
9338
+ # {
9339
+ # attribute_name: "KeySchemaAttributeName", # required
9340
+ # attribute_type: "S", # required, accepts S, N, B
9341
+ # },
9342
+ # ],
9343
+ # key_schema: [ # required
9344
+ # {
9345
+ # attribute_name: "KeySchemaAttributeName", # required
9346
+ # key_type: "HASH", # required, accepts HASH, RANGE
9347
+ # },
9348
+ # ],
9349
+ # billing_mode: "PROVISIONED", # accepts PROVISIONED, PAY_PER_REQUEST
9350
+ # provisioned_throughput: {
9351
+ # read_capacity_units: 1, # required
9352
+ # write_capacity_units: 1, # required
9353
+ # },
9354
+ # sse_specification: {
9355
+ # enabled: false,
9356
+ # sse_type: "AES256", # accepts AES256, KMS
9357
+ # kms_master_key_id: "KMSMasterKeyId",
9358
+ # },
9359
+ # global_secondary_indexes: [
9360
+ # {
9361
+ # index_name: "IndexName", # required
9362
+ # key_schema: [ # required
9363
+ # {
9364
+ # attribute_name: "KeySchemaAttributeName", # required
9365
+ # key_type: "HASH", # required, accepts HASH, RANGE
9366
+ # },
9367
+ # ],
9368
+ # projection: { # required
9369
+ # projection_type: "ALL", # accepts ALL, KEYS_ONLY, INCLUDE
9370
+ # non_key_attributes: ["NonKeyAttributeName"],
9371
+ # },
9372
+ # provisioned_throughput: {
9373
+ # read_capacity_units: 1, # required
9374
+ # write_capacity_units: 1, # required
9375
+ # },
9376
+ # },
9377
+ # ],
9378
+ # }
9379
+ #
9380
+ # @!attribute [rw] table_name
9381
+ # The name of the table created as part of the import operation.
9382
+ # @return [String]
9383
+ #
9384
+ # @!attribute [rw] attribute_definitions
9385
+ # The attributes of the table created as part of the import operation.
9386
+ # @return [Array<Types::AttributeDefinition>]
9387
+ #
9388
+ # @!attribute [rw] key_schema
9389
+ # The primary key and option sort key of the table created as part of
9390
+ # the import operation.
9391
+ # @return [Array<Types::KeySchemaElement>]
9392
+ #
9393
+ # @!attribute [rw] billing_mode
9394
+ # The billing mode for provisioning the table created as part of the
9395
+ # import operation.
9396
+ # @return [String]
9397
+ #
9398
+ # @!attribute [rw] provisioned_throughput
9399
+ # Represents the provisioned throughput settings for a specified table
9400
+ # or index. The settings can be modified using the `UpdateTable`
9401
+ # operation.
9402
+ #
9403
+ # For current minimum and maximum provisioned throughput values, see
9404
+ # [Service, Account, and Table Quotas][1] in the *Amazon DynamoDB
9405
+ # Developer Guide*.
9406
+ #
9407
+ #
9408
+ #
9409
+ # [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Limits.html
9410
+ # @return [Types::ProvisionedThroughput]
9411
+ #
9412
+ # @!attribute [rw] sse_specification
9413
+ # Represents the settings used to enable server-side encryption.
9414
+ # @return [Types::SSESpecification]
9415
+ #
9416
+ # @!attribute [rw] global_secondary_indexes
9417
+ # The Global Secondary Indexes (GSI) of the table to be created as
9418
+ # part of the import operation.
9419
+ # @return [Array<Types::GlobalSecondaryIndex>]
9420
+ #
9421
+ # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/TableCreationParameters AWS API Documentation
9422
+ #
9423
+ class TableCreationParameters < Struct.new(
9424
+ :table_name,
9425
+ :attribute_definitions,
9426
+ :key_schema,
9427
+ :billing_mode,
9428
+ :provisioned_throughput,
9429
+ :sse_specification,
9430
+ :global_secondary_indexes)
9431
+ SENSITIVE = []
9432
+ include Aws::Structure
9433
+ end
9434
+
8799
9435
  # Represents the properties of a table.
8800
9436
  #
8801
9437
  # @!attribute [rw] attribute_definitions
@@ -8943,7 +9579,7 @@ module Aws::DynamoDB
8943
9579
  # * `NonKeyAttributes` - A list of one or more non-key attribute
8944
9580
  # names that are projected into the secondary index. The total
8945
9581
  # count of attributes provided in `NonKeyAttributes`, summed
8946
- # across all of the secondary indexes, must not exceed 20. If you
9582
+ # across all of the secondary indexes, must not exceed 100. If you
8947
9583
  # project the same attribute into two different indexes, this
8948
9584
  # counts as two distinct attributes when determining the total.
8949
9585
  #
@@ -9023,7 +9659,7 @@ module Aws::DynamoDB
9023
9659
  # * `NonKeyAttributes` - A list of one or more non-key attribute
9024
9660
  # names that are projected into the secondary index. The total
9025
9661
  # count of attributes provided in `NonKeyAttributes`, summed
9026
- # across all of the secondary indexes, must not exceed 20. If you
9662
+ # across all of the secondary indexes, must not exceed 100. If you
9027
9663
  # project the same attribute into two different indexes, this
9028
9664
  # counts as two distinct attributes when determining the total.
9029
9665
  #
@@ -9133,7 +9769,8 @@ module Aws::DynamoDB
9133
9769
  end
9134
9770
 
9135
9771
  # A source table with the name `TableName` does not currently exist
9136
- # within the subscriber's account.
9772
+ # within the subscriber's account or the subscriber is operating in the
9773
+ # wrong Amazon Web Services Region.
9137
9774
  #
9138
9775
  # @!attribute [rw] message
9139
9776
  # @return [String]
@@ -9675,7 +10312,7 @@ module Aws::DynamoDB
9675
10312
  # <note markdown="1"> If using Java, DynamoDB lists the cancellation reasons on the
9676
10313
  # `CancellationReasons` property. This property is not set for other
9677
10314
  # languages. Transaction cancellation reasons are ordered in the order
9678
- # of requested items, if an item has no error it will have `NONE` code
10315
+ # of requested items, if an item has no error it will have `None` code
9679
10316
  # and `Null` message.
9680
10317
  #
9681
10318
  # </note>
@@ -9684,7 +10321,7 @@ module Aws::DynamoDB
9684
10321
  #
9685
10322
  # * No Errors:
9686
10323
  #
9687
- # * Code: `NONE`
10324
+ # * Code: `None`
9688
10325
  #
9689
10326
  # * Message: `null`
9690
10327
  #