aws-sdk-timestreamwrite 1.16.0 → 1.18.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -23,6 +23,153 @@ module Aws::TimestreamWrite
23
23
  include Aws::Structure
24
24
  end
25
25
 
26
+ # Details about the progress of a batch load task.
27
+ #
28
+ # @!attribute [rw] records_processed
29
+ # @return [Integer]
30
+ #
31
+ # @!attribute [rw] records_ingested
32
+ # @return [Integer]
33
+ #
34
+ # @!attribute [rw] parse_failures
35
+ # @return [Integer]
36
+ #
37
+ # @!attribute [rw] record_ingestion_failures
38
+ # @return [Integer]
39
+ #
40
+ # @!attribute [rw] file_failures
41
+ # @return [Integer]
42
+ #
43
+ # @!attribute [rw] bytes_metered
44
+ # @return [Integer]
45
+ #
46
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/BatchLoadProgressReport AWS API Documentation
47
+ #
48
+ class BatchLoadProgressReport < Struct.new(
49
+ :records_processed,
50
+ :records_ingested,
51
+ :parse_failures,
52
+ :record_ingestion_failures,
53
+ :file_failures,
54
+ :bytes_metered)
55
+ SENSITIVE = []
56
+ include Aws::Structure
57
+ end
58
+
59
+ # Details about a batch load task.
60
+ #
61
+ # @!attribute [rw] task_id
62
+ # The ID of the batch load task.
63
+ # @return [String]
64
+ #
65
+ # @!attribute [rw] task_status
66
+ # Status of the batch load task.
67
+ # @return [String]
68
+ #
69
+ # @!attribute [rw] database_name
70
+ # Database name for the database into which a batch load task loads
71
+ # data.
72
+ # @return [String]
73
+ #
74
+ # @!attribute [rw] table_name
75
+ # Table name for the table into which a batch load task loads data.
76
+ # @return [String]
77
+ #
78
+ # @!attribute [rw] creation_time
79
+ # The time when the Timestream batch load task was created.
80
+ # @return [Time]
81
+ #
82
+ # @!attribute [rw] last_updated_time
83
+ # The time when the Timestream batch load task was last updated.
84
+ # @return [Time]
85
+ #
86
+ # @!attribute [rw] resumable_until
87
+ # @return [Time]
88
+ #
89
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/BatchLoadTask AWS API Documentation
90
+ #
91
+ class BatchLoadTask < Struct.new(
92
+ :task_id,
93
+ :task_status,
94
+ :database_name,
95
+ :table_name,
96
+ :creation_time,
97
+ :last_updated_time,
98
+ :resumable_until)
99
+ SENSITIVE = []
100
+ include Aws::Structure
101
+ end
102
+
103
+ # Details about a batch load task.
104
+ #
105
+ # @!attribute [rw] task_id
106
+ # The ID of the batch load task.
107
+ # @return [String]
108
+ #
109
+ # @!attribute [rw] error_message
110
+ # @return [String]
111
+ #
112
+ # @!attribute [rw] data_source_configuration
113
+ # Configuration details about the data source for a batch load task.
114
+ # @return [Types::DataSourceConfiguration]
115
+ #
116
+ # @!attribute [rw] progress_report
117
+ # @return [Types::BatchLoadProgressReport]
118
+ #
119
+ # @!attribute [rw] report_configuration
120
+ # Report configuration for a batch load task. This contains details
121
+ # about where error reports are stored.
122
+ # @return [Types::ReportConfiguration]
123
+ #
124
+ # @!attribute [rw] data_model_configuration
125
+ # Data model configuration for a batch load task. This contains
126
+ # details about where a data model for a batch load task is stored.
127
+ # @return [Types::DataModelConfiguration]
128
+ #
129
+ # @!attribute [rw] target_database_name
130
+ # @return [String]
131
+ #
132
+ # @!attribute [rw] target_table_name
133
+ # @return [String]
134
+ #
135
+ # @!attribute [rw] task_status
136
+ # Status of the batch load task.
137
+ # @return [String]
138
+ #
139
+ # @!attribute [rw] record_version
140
+ # @return [Integer]
141
+ #
142
+ # @!attribute [rw] creation_time
143
+ # The time when the Timestream batch load task was created.
144
+ # @return [Time]
145
+ #
146
+ # @!attribute [rw] last_updated_time
147
+ # The time when the Timestream batch load task was last updated.
148
+ # @return [Time]
149
+ #
150
+ # @!attribute [rw] resumable_until
151
+ # @return [Time]
152
+ #
153
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/BatchLoadTaskDescription AWS API Documentation
154
+ #
155
+ class BatchLoadTaskDescription < Struct.new(
156
+ :task_id,
157
+ :error_message,
158
+ :data_source_configuration,
159
+ :progress_report,
160
+ :report_configuration,
161
+ :data_model_configuration,
162
+ :target_database_name,
163
+ :target_table_name,
164
+ :task_status,
165
+ :record_version,
166
+ :creation_time,
167
+ :last_updated_time,
168
+ :resumable_until)
169
+ SENSITIVE = []
170
+ include Aws::Structure
171
+ end
172
+
26
173
  # Timestream was unable to process this request because it contains
27
174
  # resource that already exists.
28
175
  #
@@ -37,6 +184,61 @@ module Aws::TimestreamWrite
37
184
  include Aws::Structure
38
185
  end
39
186
 
187
+ # @!attribute [rw] client_token
188
+ # **A suitable default value is auto-generated.** You should normally
189
+ # not need to pass this option.
190
+ # @return [String]
191
+ #
192
+ # @!attribute [rw] data_model_configuration
193
+ # @return [Types::DataModelConfiguration]
194
+ #
195
+ # @!attribute [rw] data_source_configuration
196
+ # Defines configuration details about the data source for a batch load
197
+ # task.
198
+ # @return [Types::DataSourceConfiguration]
199
+ #
200
+ # @!attribute [rw] report_configuration
201
+ # Report configuration for a batch load task. This contains details
202
+ # about where error reports are stored.
203
+ # @return [Types::ReportConfiguration]
204
+ #
205
+ # @!attribute [rw] target_database_name
206
+ # Target Timestream database for a batch load task.
207
+ # @return [String]
208
+ #
209
+ # @!attribute [rw] target_table_name
210
+ # Target Timestream table for a batch load task.
211
+ # @return [String]
212
+ #
213
+ # @!attribute [rw] record_version
214
+ # @return [Integer]
215
+ #
216
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/CreateBatchLoadTaskRequest AWS API Documentation
217
+ #
218
+ class CreateBatchLoadTaskRequest < Struct.new(
219
+ :client_token,
220
+ :data_model_configuration,
221
+ :data_source_configuration,
222
+ :report_configuration,
223
+ :target_database_name,
224
+ :target_table_name,
225
+ :record_version)
226
+ SENSITIVE = [:client_token]
227
+ include Aws::Structure
228
+ end
229
+
230
+ # @!attribute [rw] task_id
231
+ # The ID of the batch load task.
232
+ # @return [String]
233
+ #
234
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/CreateBatchLoadTaskResponse AWS API Documentation
235
+ #
236
+ class CreateBatchLoadTaskResponse < Struct.new(
237
+ :task_id)
238
+ SENSITIVE = []
239
+ include Aws::Structure
240
+ end
241
+
40
242
  # @!attribute [rw] database_name
41
243
  # The name of the Timestream database.
42
244
  # @return [String]
@@ -44,8 +246,8 @@ module Aws::TimestreamWrite
44
246
  # @!attribute [rw] kms_key_id
45
247
  # The KMS key for the database. If the KMS key is not specified, the
46
248
  # database will be encrypted with a Timestream managed KMS key located
47
- # in your account. Refer to [Amazon Web Services managed KMS keys][1]
48
- # for more info.
249
+ # in your account. For more information, see [Amazon Web Services
250
+ # managed keys][1].
49
251
  #
50
252
  #
51
253
  #
@@ -87,7 +289,7 @@ module Aws::TimestreamWrite
87
289
  # @return [String]
88
290
  #
89
291
  # @!attribute [rw] retention_properties
90
- # The duration for which your time series data must be stored in the
292
+ # The duration for which your time-series data must be stored in the
91
293
  # memory store and the magnetic store.
92
294
  # @return [Types::RetentionProperties]
93
295
  #
@@ -124,7 +326,155 @@ module Aws::TimestreamWrite
124
326
  include Aws::Structure
125
327
  end
126
328
 
127
- # A top level container for a table. Databases and tables are the
329
+ # A delimited data format where the column separator can be a comma and
330
+ # the record separator is a newline character.
331
+ #
332
+ # @!attribute [rw] column_separator
333
+ # Column separator can be one of comma (','), pipe ('\|), semicolon
334
+ # (';'), tab('/t'), or blank space (' ').
335
+ # @return [String]
336
+ #
337
+ # @!attribute [rw] escape_char
338
+ # Escape character can be one of
339
+ # @return [String]
340
+ #
341
+ # @!attribute [rw] quote_char
342
+ # Can be single quote (') or double quote (").
343
+ # @return [String]
344
+ #
345
+ # @!attribute [rw] null_value
346
+ # Can be blank space (' ').
347
+ # @return [String]
348
+ #
349
+ # @!attribute [rw] trim_white_space
350
+ # Specifies to trim leading and trailing white space.
351
+ # @return [Boolean]
352
+ #
353
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/CsvConfiguration AWS API Documentation
354
+ #
355
+ class CsvConfiguration < Struct.new(
356
+ :column_separator,
357
+ :escape_char,
358
+ :quote_char,
359
+ :null_value,
360
+ :trim_white_space)
361
+ SENSITIVE = []
362
+ include Aws::Structure
363
+ end
364
+
365
+ # Data model for a batch load task.
366
+ #
367
+ # @!attribute [rw] time_column
368
+ # Source column to be mapped to time.
369
+ # @return [String]
370
+ #
371
+ # @!attribute [rw] time_unit
372
+ # The granularity of the timestamp unit. It indicates if the time
373
+ # value is in seconds, milliseconds, nanoseconds, or other supported
374
+ # values. Default is `MILLISECONDS`.
375
+ # @return [String]
376
+ #
377
+ # @!attribute [rw] dimension_mappings
378
+ # Source to target mappings for dimensions.
379
+ # @return [Array<Types::DimensionMapping>]
380
+ #
381
+ # @!attribute [rw] multi_measure_mappings
382
+ # Source to target mappings for multi-measure records.
383
+ # @return [Types::MultiMeasureMappings]
384
+ #
385
+ # @!attribute [rw] mixed_measure_mappings
386
+ # Source to target mappings for measures.
387
+ # @return [Array<Types::MixedMeasureMapping>]
388
+ #
389
+ # @!attribute [rw] measure_name_column
390
+ # @return [String]
391
+ #
392
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DataModel AWS API Documentation
393
+ #
394
+ class DataModel < Struct.new(
395
+ :time_column,
396
+ :time_unit,
397
+ :dimension_mappings,
398
+ :multi_measure_mappings,
399
+ :mixed_measure_mappings,
400
+ :measure_name_column)
401
+ SENSITIVE = []
402
+ include Aws::Structure
403
+ end
404
+
405
+ # @!attribute [rw] data_model
406
+ # @return [Types::DataModel]
407
+ #
408
+ # @!attribute [rw] data_model_s3_configuration
409
+ # @return [Types::DataModelS3Configuration]
410
+ #
411
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DataModelConfiguration AWS API Documentation
412
+ #
413
+ class DataModelConfiguration < Struct.new(
414
+ :data_model,
415
+ :data_model_s3_configuration)
416
+ SENSITIVE = []
417
+ include Aws::Structure
418
+ end
419
+
420
+ # @!attribute [rw] bucket_name
421
+ # @return [String]
422
+ #
423
+ # @!attribute [rw] object_key
424
+ # @return [String]
425
+ #
426
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DataModelS3Configuration AWS API Documentation
427
+ #
428
+ class DataModelS3Configuration < Struct.new(
429
+ :bucket_name,
430
+ :object_key)
431
+ SENSITIVE = []
432
+ include Aws::Structure
433
+ end
434
+
435
+ # Defines configuration details about the data source.
436
+ #
437
+ # @!attribute [rw] data_source_s3_configuration
438
+ # Configuration of an S3 location for a file which contains data to
439
+ # load.
440
+ # @return [Types::DataSourceS3Configuration]
441
+ #
442
+ # @!attribute [rw] csv_configuration
443
+ # A delimited data format where the column separator can be a comma
444
+ # and the record separator is a newline character.
445
+ # @return [Types::CsvConfiguration]
446
+ #
447
+ # @!attribute [rw] data_format
448
+ # This is currently CSV.
449
+ # @return [String]
450
+ #
451
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DataSourceConfiguration AWS API Documentation
452
+ #
453
+ class DataSourceConfiguration < Struct.new(
454
+ :data_source_s3_configuration,
455
+ :csv_configuration,
456
+ :data_format)
457
+ SENSITIVE = []
458
+ include Aws::Structure
459
+ end
460
+
461
+ # @!attribute [rw] bucket_name
462
+ # The bucket name of the customer S3 bucket.
463
+ # @return [String]
464
+ #
465
+ # @!attribute [rw] object_key_prefix
466
+ # @return [String]
467
+ #
468
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DataSourceS3Configuration AWS API Documentation
469
+ #
470
+ class DataSourceS3Configuration < Struct.new(
471
+ :bucket_name,
472
+ :object_key_prefix)
473
+ SENSITIVE = []
474
+ include Aws::Structure
475
+ end
476
+
477
+ # A top-level container for a table. Databases and tables are the
128
478
  # fundamental management concepts in Amazon Timestream. All tables in a
129
479
  # database are encrypted with the same KMS key.
130
480
  #
@@ -197,6 +547,30 @@ module Aws::TimestreamWrite
197
547
  include Aws::Structure
198
548
  end
199
549
 
550
+ # @!attribute [rw] task_id
551
+ # The ID of the batch load task.
552
+ # @return [String]
553
+ #
554
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DescribeBatchLoadTaskRequest AWS API Documentation
555
+ #
556
+ class DescribeBatchLoadTaskRequest < Struct.new(
557
+ :task_id)
558
+ SENSITIVE = []
559
+ include Aws::Structure
560
+ end
561
+
562
+ # @!attribute [rw] batch_load_task_description
563
+ # Description of the batch load task.
564
+ # @return [Types::BatchLoadTaskDescription]
565
+ #
566
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DescribeBatchLoadTaskResponse AWS API Documentation
567
+ #
568
+ class DescribeBatchLoadTaskResponse < Struct.new(
569
+ :batch_load_task_description)
570
+ SENSITIVE = []
571
+ include Aws::Structure
572
+ end
573
+
200
574
  # @!attribute [rw] database_name
201
575
  # The name of the Timestream database.
202
576
  # @return [String]
@@ -269,16 +643,16 @@ module Aws::TimestreamWrite
269
643
  include Aws::Structure
270
644
  end
271
645
 
272
- # Dimension represents the meta data attributes of the time series. For
273
- # example, the name and availability zone of an EC2 instance or the name
274
- # of the manufacturer of a wind turbine are dimensions.
646
+ # Represents the metadata attributes of the time series. For example,
647
+ # the name and Availability Zone of an EC2 instance or the name of the
648
+ # manufacturer of a wind turbine are dimensions.
275
649
  #
276
650
  # @!attribute [rw] name
277
- # Dimension represents the meta data attributes of the time series.
278
- # For example, the name and availability zone of an EC2 instance or
279
- # the name of the manufacturer of a wind turbine are dimensions.
651
+ # Dimension represents the metadata attributes of the time series. For
652
+ # example, the name and Availability Zone of an EC2 instance or the
653
+ # name of the manufacturer of a wind turbine are dimensions.
280
654
  #
281
- # For constraints on Dimension names, see [Naming Constraints][1].
655
+ # For constraints on dimension names, see [Naming Constraints][1].
282
656
  #
283
657
  #
284
658
  #
@@ -290,7 +664,7 @@ module Aws::TimestreamWrite
290
664
  # @return [String]
291
665
  #
292
666
  # @!attribute [rw] dimension_value_type
293
- # The data type of the dimension for the time series data point.
667
+ # The data type of the dimension for the time-series data point.
294
668
  # @return [String]
295
669
  #
296
670
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/Dimension AWS API Documentation
@@ -303,8 +677,23 @@ module Aws::TimestreamWrite
303
677
  include Aws::Structure
304
678
  end
305
679
 
680
+ # @!attribute [rw] source_column
681
+ # @return [String]
682
+ #
683
+ # @!attribute [rw] destination_column
684
+ # @return [String]
685
+ #
686
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DimensionMapping AWS API Documentation
687
+ #
688
+ class DimensionMapping < Struct.new(
689
+ :source_column,
690
+ :destination_column)
691
+ SENSITIVE = []
692
+ include Aws::Structure
693
+ end
694
+
306
695
  # Represents an available endpoint against which to make API calls
307
- # agaisnt, as well as the TTL for that endpoint.
696
+ # against, as well as the TTL for that endpoint.
308
697
  #
309
698
  # @!attribute [rw] address
310
699
  # An endpoint address.
@@ -337,7 +726,7 @@ module Aws::TimestreamWrite
337
726
  include Aws::Structure
338
727
  end
339
728
 
340
- # The requested endpoint was invalid.
729
+ # The requested endpoint was not valid.
341
730
  #
342
731
  # @!attribute [rw] message
343
732
  # @return [String]
@@ -350,6 +739,50 @@ module Aws::TimestreamWrite
350
739
  include Aws::Structure
351
740
  end
352
741
 
742
+ # @!attribute [rw] next_token
743
+ # A token to specify where to start paginating. This is the NextToken
744
+ # from a previously truncated response.
745
+ # @return [String]
746
+ #
747
+ # @!attribute [rw] max_results
748
+ # The total number of items to return in the output. If the total
749
+ # number of items available is more than the value specified, a
750
+ # NextToken is provided in the output. To resume pagination, provide
751
+ # the NextToken value as argument of a subsequent API invocation.
752
+ # @return [Integer]
753
+ #
754
+ # @!attribute [rw] task_status
755
+ # Status of the batch load task.
756
+ # @return [String]
757
+ #
758
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ListBatchLoadTasksRequest AWS API Documentation
759
+ #
760
+ class ListBatchLoadTasksRequest < Struct.new(
761
+ :next_token,
762
+ :max_results,
763
+ :task_status)
764
+ SENSITIVE = []
765
+ include Aws::Structure
766
+ end
767
+
768
+ # @!attribute [rw] next_token
769
+ # A token to specify where to start paginating. Provide the next
770
+ # ListBatchLoadTasksRequest.
771
+ # @return [String]
772
+ #
773
+ # @!attribute [rw] batch_load_tasks
774
+ # A list of batch load task details.
775
+ # @return [Array<Types::BatchLoadTask>]
776
+ #
777
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ListBatchLoadTasksResponse AWS API Documentation
778
+ #
779
+ class ListBatchLoadTasksResponse < Struct.new(
780
+ :next_token,
781
+ :batch_load_tasks)
782
+ SENSITIVE = []
783
+ include Aws::Structure
784
+ end
785
+
353
786
  # @!attribute [rw] next_token
354
787
  # The pagination token. To resume pagination, provide the NextToken
355
788
  # value as argument of a subsequent API invocation.
@@ -495,19 +928,19 @@ module Aws::TimestreamWrite
495
928
  include Aws::Structure
496
929
  end
497
930
 
498
- # MeasureValue represents the data attribute of the time series. For
499
- # example, the CPU utilization of an EC2 instance or the RPM of a wind
500
- # turbine are measures. MeasureValue has both name and value.
931
+ # Represents the data attribute of the time series. For example, the CPU
932
+ # utilization of an EC2 instance or the RPM of a wind turbine are
933
+ # measures. MeasureValue has both name and value.
501
934
  #
502
935
  # MeasureValue is only allowed for type `MULTI`. Using `MULTI` type, you
503
936
  # can pass multiple data attributes associated with the same time series
504
937
  # in a single record
505
938
  #
506
939
  # @!attribute [rw] name
507
- # Name of the MeasureValue.
940
+ # The name of the MeasureValue.
508
941
  #
509
- # For constraints on MeasureValue names, refer to [ Naming
510
- # Constraints][1] in the Timestream developer guide.
942
+ # For constraints on MeasureValue names, see [ Naming Constraints][1]
943
+ # in the Amazon Timestream Developer Guide.
511
944
  #
512
945
  #
513
946
  #
@@ -515,11 +948,11 @@ module Aws::TimestreamWrite
515
948
  # @return [String]
516
949
  #
517
950
  # @!attribute [rw] value
518
- # Value for the MeasureValue.
951
+ # The value for the MeasureValue.
519
952
  # @return [String]
520
953
  #
521
954
  # @!attribute [rw] type
522
- # Contains the data type of the MeasureValue for the time series data
955
+ # Contains the data type of the MeasureValue for the time-series data
523
956
  # point.
524
957
  # @return [String]
525
958
  #
@@ -533,16 +966,77 @@ module Aws::TimestreamWrite
533
966
  include Aws::Structure
534
967
  end
535
968
 
536
- # Record represents a time series data point being written into
537
- # Timestream. Each record contains an array of dimensions. Dimensions
538
- # represent the meta data attributes of a time series data point such as
539
- # the instance name or availability zone of an EC2 instance. A record
540
- # also contains the measure name which is the name of the measure being
541
- # collected for example the CPU utilization of an EC2 instance. A record
542
- # also contains the measure value and the value type which is the data
543
- # type of the measure value. In addition, the record contains the
544
- # timestamp when the measure was collected that the timestamp unit which
545
- # represents the granularity of the timestamp.
969
+ # @!attribute [rw] measure_name
970
+ # @return [String]
971
+ #
972
+ # @!attribute [rw] source_column
973
+ # @return [String]
974
+ #
975
+ # @!attribute [rw] target_measure_name
976
+ # @return [String]
977
+ #
978
+ # @!attribute [rw] measure_value_type
979
+ # @return [String]
980
+ #
981
+ # @!attribute [rw] multi_measure_attribute_mappings
982
+ # @return [Array<Types::MultiMeasureAttributeMapping>]
983
+ #
984
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/MixedMeasureMapping AWS API Documentation
985
+ #
986
+ class MixedMeasureMapping < Struct.new(
987
+ :measure_name,
988
+ :source_column,
989
+ :target_measure_name,
990
+ :measure_value_type,
991
+ :multi_measure_attribute_mappings)
992
+ SENSITIVE = []
993
+ include Aws::Structure
994
+ end
995
+
996
+ # @!attribute [rw] source_column
997
+ # @return [String]
998
+ #
999
+ # @!attribute [rw] target_multi_measure_attribute_name
1000
+ # @return [String]
1001
+ #
1002
+ # @!attribute [rw] measure_value_type
1003
+ # @return [String]
1004
+ #
1005
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/MultiMeasureAttributeMapping AWS API Documentation
1006
+ #
1007
+ class MultiMeasureAttributeMapping < Struct.new(
1008
+ :source_column,
1009
+ :target_multi_measure_attribute_name,
1010
+ :measure_value_type)
1011
+ SENSITIVE = []
1012
+ include Aws::Structure
1013
+ end
1014
+
1015
+ # @!attribute [rw] target_multi_measure_name
1016
+ # @return [String]
1017
+ #
1018
+ # @!attribute [rw] multi_measure_attribute_mappings
1019
+ # @return [Array<Types::MultiMeasureAttributeMapping>]
1020
+ #
1021
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/MultiMeasureMappings AWS API Documentation
1022
+ #
1023
+ class MultiMeasureMappings < Struct.new(
1024
+ :target_multi_measure_name,
1025
+ :multi_measure_attribute_mappings)
1026
+ SENSITIVE = []
1027
+ include Aws::Structure
1028
+ end
1029
+
1030
+ # Represents a time-series data point being written into Timestream.
1031
+ # Each record contains an array of dimensions. Dimensions represent the
1032
+ # metadata attributes of a time-series data point, such as the instance
1033
+ # name or Availability Zone of an EC2 instance. A record also contains
1034
+ # the measure name, which is the name of the measure being collected
1035
+ # (for example, the CPU utilization of an EC2 instance). Additionally, a
1036
+ # record contains the measure value and the value type, which is the
1037
+ # data type of the measure value. Also, the record contains the
1038
+ # timestamp of when the measure was collected and the timestamp unit,
1039
+ # which represents the granularity of the timestamp.
546
1040
  #
547
1041
  # Records have a `Version` field, which is a 64-bit `long` that you can
548
1042
  # use for updating data points. Writes of a duplicate record with the
@@ -553,7 +1047,7 @@ module Aws::TimestreamWrite
553
1047
  # `Version` field.
554
1048
  #
555
1049
  # @!attribute [rw] dimensions
556
- # Contains the list of dimensions for time series data points.
1050
+ # Contains the list of dimensions for time-series data points.
557
1051
  # @return [Array<Types::Dimension>]
558
1052
  #
559
1053
  # @!attribute [rw] measure_name
@@ -563,11 +1057,11 @@ module Aws::TimestreamWrite
563
1057
  # @return [String]
564
1058
  #
565
1059
  # @!attribute [rw] measure_value
566
- # Contains the measure value for the time series data point.
1060
+ # Contains the measure value for the time-series data point.
567
1061
  # @return [String]
568
1062
  #
569
1063
  # @!attribute [rw] measure_value_type
570
- # Contains the data type of the measure value for the time series data
1064
+ # Contains the data type of the measure value for the time-series data
571
1065
  # point. Default type is `DOUBLE`.
572
1066
  # @return [String]
573
1067
  #
@@ -580,7 +1074,7 @@ module Aws::TimestreamWrite
580
1074
  #
581
1075
  # @!attribute [rw] time_unit
582
1076
  # The granularity of the timestamp unit. It indicates if the time
583
- # value is in seconds, milliseconds, nanoseconds or other supported
1077
+ # value is in seconds, milliseconds, nanoseconds, or other supported
584
1078
  # values. Default is `MILLISECONDS`.
585
1079
  # @return [String]
586
1080
  #
@@ -588,7 +1082,7 @@ module Aws::TimestreamWrite
588
1082
  # 64-bit attribute used for record updates. Write requests for
589
1083
  # duplicate data with a higher version number will update the existing
590
1084
  # measure value and version. In cases where the measure value is the
591
- # same, `Version` will still be updated . Default value is `1`.
1085
+ # same, `Version` will still be updated. Default value is `1`.
592
1086
  #
593
1087
  # <note markdown="1"> `Version` must be `1` or greater, or you will receive a
594
1088
  # `ValidationException` error.
@@ -597,10 +1091,10 @@ module Aws::TimestreamWrite
597
1091
  # @return [Integer]
598
1092
  #
599
1093
  # @!attribute [rw] measure_values
600
- # Contains the list of MeasureValue for time series data points.
1094
+ # Contains the list of MeasureValue for time-series data points.
601
1095
  #
602
1096
  # This is only allowed for type `MULTI`. For scalar values, use
603
- # `MeasureValue` attribute of the Record directly.
1097
+ # `MeasureValue` attribute of the record directly.
604
1098
  # @return [Array<Types::MeasureValue>]
605
1099
  #
606
1100
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/Record AWS API Documentation
@@ -642,9 +1136,9 @@ module Aws::TimestreamWrite
642
1136
  include Aws::Structure
643
1137
  end
644
1138
 
645
- # Records that were not successfully inserted into Timestream due to
646
- # data validation issues that must be resolved prior to reinserting time
647
- # series data into the system.
1139
+ # Represents records that were not successfully inserted into Timestream
1140
+ # due to data validation issues that must be resolved before reinserting
1141
+ # time-series data into the system.
648
1142
  #
649
1143
  # @!attribute [rw] record_index
650
1144
  # The index of the record in the input request for WriteRecords.
@@ -660,7 +1154,7 @@ module Aws::TimestreamWrite
660
1154
  #
661
1155
  # * Measure values are different
662
1156
  #
663
- # * Version is not present in the request *or* the value of version
1157
+ # * Version is not present in the request, *or* the value of version
664
1158
  # in the new record is equal to or lower than the existing value
665
1159
  #
666
1160
  # If Timestream rejects data for this case, the `ExistingVersion`
@@ -670,7 +1164,7 @@ module Aws::TimestreamWrite
670
1164
  # `ExistingVersion`.
671
1165
  #
672
1166
  # * Records with timestamps that lie outside the retention duration of
673
- # the memory store
1167
+ # the memory store.
674
1168
  #
675
1169
  # <note markdown="1"> When the retention window is updated, you will receive a
676
1170
  # `RejectedRecords` exception if you immediately try to ingest data
@@ -728,13 +1222,13 @@ module Aws::TimestreamWrite
728
1222
  # `ExistingVersion`.
729
1223
  #
730
1224
  # * Records with timestamps that lie outside the retention duration of
731
- # the memory store
1225
+ # the memory store.
732
1226
  #
733
1227
  # * Records with dimensions or measures that exceed the Timestream
734
1228
  # defined limits.
735
1229
  #
736
- # For more information, see [Quotas][1] in the Timestream Developer
737
- # Guide.
1230
+ # For more information, see [Quotas][1] in the Amazon Timestream
1231
+ # Developer Guide.
738
1232
  #
739
1233
  #
740
1234
  #
@@ -755,6 +1249,45 @@ module Aws::TimestreamWrite
755
1249
  include Aws::Structure
756
1250
  end
757
1251
 
1252
+ # Report configuration for a batch load task. This contains details
1253
+ # about where error reports are stored.
1254
+ #
1255
+ # @!attribute [rw] report_s3_configuration
1256
+ # Configuration of an S3 location to write error reports and events
1257
+ # for a batch load.
1258
+ # @return [Types::ReportS3Configuration]
1259
+ #
1260
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ReportConfiguration AWS API Documentation
1261
+ #
1262
+ class ReportConfiguration < Struct.new(
1263
+ :report_s3_configuration)
1264
+ SENSITIVE = []
1265
+ include Aws::Structure
1266
+ end
1267
+
1268
+ # @!attribute [rw] bucket_name
1269
+ # @return [String]
1270
+ #
1271
+ # @!attribute [rw] object_key_prefix
1272
+ # @return [String]
1273
+ #
1274
+ # @!attribute [rw] encryption_option
1275
+ # @return [String]
1276
+ #
1277
+ # @!attribute [rw] kms_key_id
1278
+ # @return [String]
1279
+ #
1280
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ReportS3Configuration AWS API Documentation
1281
+ #
1282
+ class ReportS3Configuration < Struct.new(
1283
+ :bucket_name,
1284
+ :object_key_prefix,
1285
+ :encryption_option,
1286
+ :kms_key_id)
1287
+ SENSITIVE = []
1288
+ include Aws::Structure
1289
+ end
1290
+
758
1291
  # The operation tried to access a nonexistent resource. The resource
759
1292
  # might not be specified correctly, or its status might not be ACTIVE.
760
1293
  #
@@ -769,7 +1302,23 @@ module Aws::TimestreamWrite
769
1302
  include Aws::Structure
770
1303
  end
771
1304
 
772
- # Retention properties contain the duration for which your time series
1305
+ # @!attribute [rw] task_id
1306
+ # The ID of the batch load task to resume.
1307
+ # @return [String]
1308
+ #
1309
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ResumeBatchLoadTaskRequest AWS API Documentation
1310
+ #
1311
+ class ResumeBatchLoadTaskRequest < Struct.new(
1312
+ :task_id)
1313
+ SENSITIVE = []
1314
+ include Aws::Structure
1315
+ end
1316
+
1317
+ # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ResumeBatchLoadTaskResponse AWS API Documentation
1318
+ #
1319
+ class ResumeBatchLoadTaskResponse < Aws::EmptyStructure; end
1320
+
1321
+ # Retention properties contain the duration for which your time-series
773
1322
  # data must be stored in the magnetic store and the memory store.
774
1323
  #
775
1324
  # @!attribute [rw] memory_store_retention_period_in_hours
@@ -789,24 +1338,25 @@ module Aws::TimestreamWrite
789
1338
  include Aws::Structure
790
1339
  end
791
1340
 
792
- # Configuration specifing an S3 location.
1341
+ # The configuration that specifies an S3 location.
793
1342
  #
794
1343
  # @!attribute [rw] bucket_name
795
- # &gt;Bucket name of the customer S3 bucket.
1344
+ # The bucket name of the customer S3 bucket.
796
1345
  # @return [String]
797
1346
  #
798
1347
  # @!attribute [rw] object_key_prefix
799
- # Object key preview for the customer S3 location.
1348
+ # The object key preview for the customer S3 location.
800
1349
  # @return [String]
801
1350
  #
802
1351
  # @!attribute [rw] encryption_option
803
- # Encryption option for the customer s3 location. Options are S3
804
- # server side encryption with an S3-managed key or KMS managed key.
1352
+ # The encryption option for the customer S3 location. Options are S3
1353
+ # server-side encryption with an S3 managed key or Amazon Web Services
1354
+ # managed key.
805
1355
  # @return [String]
806
1356
  #
807
1357
  # @!attribute [rw] kms_key_id
808
- # KMS key id for the customer s3 location when encrypting with a KMS
809
- # managed key.
1358
+ # The KMS key ID for the customer S3 location when encrypting with an
1359
+ # Amazon Web Services managed key.
810
1360
  # @return [String]
811
1361
  #
812
1362
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/S3Configuration AWS API Documentation
@@ -820,7 +1370,7 @@ module Aws::TimestreamWrite
820
1370
  include Aws::Structure
821
1371
  end
822
1372
 
823
- # Instance quota of resource exceeded for this account.
1373
+ # The instance quota of resource exceeded for this account.
824
1374
  #
825
1375
  # @!attribute [rw] message
826
1376
  # @return [String]
@@ -833,8 +1383,8 @@ module Aws::TimestreamWrite
833
1383
  include Aws::Structure
834
1384
  end
835
1385
 
836
- # Table represents a database table in Timestream. Tables contain one or
837
- # more related time series. You can modify the retention duration of the
1386
+ # Represents a database table in Timestream. Tables contain one or more
1387
+ # related time series. You can modify the retention duration of the
838
1388
  # memory store and the magnetic store for a table.
839
1389
  #
840
1390
  # @!attribute [rw] arn
@@ -891,7 +1441,7 @@ module Aws::TimestreamWrite
891
1441
 
892
1442
  # A tag is a label that you assign to a Timestream database and/or
893
1443
  # table. Each tag consists of a key and an optional value, both of which
894
- # you define. Tags enable you to categorize databases and/or tables, for
1444
+ # you define. With tags, you can categorize databases and/or tables, for
895
1445
  # example, by purpose, owner, or environment.
896
1446
  #
897
1447
  # @!attribute [rw] key
@@ -933,8 +1483,8 @@ module Aws::TimestreamWrite
933
1483
  #
934
1484
  class TagResourceResponse < Aws::EmptyStructure; end
935
1485
 
936
- # Too many requests were made by a user exceeding service quotas. The
937
- # request was throttled.
1486
+ # Too many requests were made by a user and they exceeded the service
1487
+ # quotas. The request was throttled.
938
1488
  #
939
1489
  # @!attribute [rw] message
940
1490
  # @return [String]
@@ -1002,7 +1552,7 @@ module Aws::TimestreamWrite
1002
1552
  end
1003
1553
 
1004
1554
  # @!attribute [rw] database
1005
- # A top level container for a table. Databases and tables are the
1555
+ # A top-level container for a table. Databases and tables are the
1006
1556
  # fundamental management concepts in Amazon Timestream. All tables in
1007
1557
  # a database are encrypted with the same KMS key.
1008
1558
  # @return [Types::Database]
@@ -1055,7 +1605,7 @@ module Aws::TimestreamWrite
1055
1605
  include Aws::Structure
1056
1606
  end
1057
1607
 
1058
- # Invalid or malformed request.
1608
+ # An invalid or malformed request.
1059
1609
  #
1060
1610
  # @!attribute [rw] message
1061
1611
  # @return [String]
@@ -1077,18 +1627,18 @@ module Aws::TimestreamWrite
1077
1627
  # @return [String]
1078
1628
  #
1079
1629
  # @!attribute [rw] common_attributes
1080
- # A record containing the common measure, dimension, time, and version
1081
- # attributes shared across all the records in the request. The measure
1082
- # and dimension attributes specified will be merged with the measure
1083
- # and dimension attributes in the records object when the data is
1084
- # written into Timestream. Dimensions may not overlap, or a
1630
+ # A record that contains the common measure, dimension, time, and
1631
+ # version attributes shared across all the records in the request. The
1632
+ # measure and dimension attributes specified will be merged with the
1633
+ # measure and dimension attributes in the records object when the data
1634
+ # is written into Timestream. Dimensions may not overlap, or a
1085
1635
  # `ValidationException` will be thrown. In other words, a record must
1086
1636
  # contain dimensions with unique names.
1087
1637
  # @return [Types::Record]
1088
1638
  #
1089
1639
  # @!attribute [rw] records
1090
- # An array of records containing the unique measure, dimension, time,
1091
- # and version attributes for each time series data point.
1640
+ # An array of records that contain the unique measure, dimension,
1641
+ # time, and version attributes for each time-series data point.
1092
1642
  # @return [Array<Types::Record>]
1093
1643
  #
1094
1644
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/WriteRecordsRequest AWS API Documentation