aws-sdk-timestreamwrite 1.9.0 → 1.10.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
  SHA256:
3
- metadata.gz: 0ed0926f26ef5895e753db612ce96de5570003003e98a8979119f6362b7fc9a2
4
- data.tar.gz: e23fa724f319fea59bbaaa2d3a03529b878027129393bea3764b7a0ceb2b244c
3
+ metadata.gz: 0ae40fff8c6c44dc2533748a9344dbd474c400e787af3bc12a388e53f2be4d92
4
+ data.tar.gz: ed15a1ec7c8eb839bb7202e9a104290546e743c1026a3c8f7cac43c692e19d64
5
5
  SHA512:
6
- metadata.gz: 5440535a64776ffc58bbd9ab922590ee6eae0317d368fe4bd4a38cdcce8c836e6bde92af91e6df3d3615cda6e64d759d1ddd7af2eea315526dfe59c7b9f87235
7
- data.tar.gz: adb0764b94c90bfb410429b06813c7164798085b32af9d03fdaa4fe44a8791f994ff786dbe62072cf1fb8bcb03ffbb6c013cdc22311ccc6795d016feab1447c0
6
+ metadata.gz: f60e8d37d951397df7eae9aeedba7e3a63b1dd6282b9c9f560636bc30b27a8350f568e970d5265a38d928aeacb9d3b060f89ed03cac602a2bff5bf7ddf50d252
7
+ data.tar.gz: 0f05c40fb1c3a92bb332c4d888562bf2568aaa93606d182f2de8f5d2ea4739d79756b2d6c223fb43a65aa1aea7bfb9a8e02c57f3109f57f88920cc42ac9cc418
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.10.0 (2021-11-24)
5
+ ------------------
6
+
7
+ * Feature - This release adds support for multi-measure records and magnetic store writes. Multi-measure records allow customers to store multiple measures in a single table row. Magnetic store writes enable customers to write late arrival data (data with timestamp in the past) directly into the magnetic store.
8
+
4
9
  1.9.0 (2021-11-04)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.9.0
1
+ 1.10.0
@@ -348,14 +348,15 @@ module Aws::TimestreamWrite
348
348
 
349
349
  # Creates a new Timestream database. If the KMS key is not specified,
350
350
  # the database will be encrypted with a Timestream managed KMS key
351
- # located in your account. Refer to [AWS managed KMS keys][1] for more
352
- # info. Service quotas apply. For more information, see [Access
353
- # Management][2] in the Timestream Developer Guide.
351
+ # located in your account. Refer to [Amazon Web Services managed KMS
352
+ # keys][1] for more info. [Service quotas apply][2]. See [code
353
+ # sample][3] for details.
354
354
  #
355
355
  #
356
356
  #
357
357
  # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
358
358
  # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
359
+ # [3]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html
359
360
  #
360
361
  # @option params [required, String] :database_name
361
362
  # The name of the Timestream database.
@@ -363,7 +364,8 @@ module Aws::TimestreamWrite
363
364
  # @option params [String] :kms_key_id
364
365
  # The KMS key for the database. If the KMS key is not specified, the
365
366
  # database will be encrypted with a Timestream managed KMS key located
366
- # in your account. Refer to [AWS managed KMS keys][1] for more info.
367
+ # in your account. Refer to [Amazon Web Services managed KMS keys][1]
368
+ # for more info.
367
369
  #
368
370
  #
369
371
  #
@@ -379,7 +381,7 @@ module Aws::TimestreamWrite
379
381
  # @example Request syntax with placeholder values
380
382
  #
381
383
  # resp = client.create_database({
382
- # database_name: "ResourceName", # required
384
+ # database_name: "ResourceCreateAPIName", # required
383
385
  # kms_key_id: "StringValue2048",
384
386
  # tags: [
385
387
  # {
@@ -408,17 +410,17 @@ module Aws::TimestreamWrite
408
410
  end
409
411
 
410
412
  # The CreateTable operation adds a new table to an existing database in
411
- # your account. In an AWS account, table names must be at least unique
412
- # within each Region if they are in the same database. You may have
413
- # identical table names in the same Region if the tables are in seperate
414
- # databases. While creating the table, you must specify the table name,
415
- # database name, and the retention properties. Service quotas apply. For
416
- # more information, see [Access Management][1] in the Timestream
417
- # Developer Guide.
413
+ # your account. In an Amazon Web Services account, table names must be
414
+ # at least unique within each Region if they are in the same database.
415
+ # You may have identical table names in the same Region if the tables
416
+ # are in separate databases. While creating the table, you must specify
417
+ # the table name, database name, and the retention properties. [Service
418
+ # quotas apply][1]. See [code sample][2] for details.
418
419
  #
419
420
  #
420
421
  #
421
422
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
423
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html
422
424
  #
423
425
  # @option params [required, String] :database_name
424
426
  # The name of the Timestream database.
@@ -433,6 +435,10 @@ module Aws::TimestreamWrite
433
435
  # @option params [Array<Types::Tag>] :tags
434
436
  # A list of key-value pairs to label the table.
435
437
  #
438
+ # @option params [Types::MagneticStoreWriteProperties] :magnetic_store_write_properties
439
+ # Contains properties to set on the table when enabling magnetic store
440
+ # writes.
441
+ #
436
442
  # @return [Types::CreateTableResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
437
443
  #
438
444
  # * {Types::CreateTableResponse#table #table} => Types::Table
@@ -440,8 +446,8 @@ module Aws::TimestreamWrite
440
446
  # @example Request syntax with placeholder values
441
447
  #
442
448
  # resp = client.create_table({
443
- # database_name: "ResourceName", # required
444
- # table_name: "ResourceName", # required
449
+ # database_name: "ResourceCreateAPIName", # required
450
+ # table_name: "ResourceCreateAPIName", # required
445
451
  # retention_properties: {
446
452
  # memory_store_retention_period_in_hours: 1, # required
447
453
  # magnetic_store_retention_period_in_days: 1, # required
@@ -452,6 +458,17 @@ module Aws::TimestreamWrite
452
458
  # value: "TagValue", # required
453
459
  # },
454
460
  # ],
461
+ # magnetic_store_write_properties: {
462
+ # enable_magnetic_store_writes: false, # required
463
+ # magnetic_store_rejected_data_location: {
464
+ # s3_configuration: {
465
+ # bucket_name: "S3BucketName",
466
+ # object_key_prefix: "S3ObjectKeyPrefix",
467
+ # encryption_option: "SSE_S3", # accepts SSE_S3, SSE_KMS
468
+ # kms_key_id: "StringValue2048",
469
+ # },
470
+ # },
471
+ # },
455
472
  # })
456
473
  #
457
474
  # @example Response structure
@@ -464,6 +481,11 @@ module Aws::TimestreamWrite
464
481
  # resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
465
482
  # resp.table.creation_time #=> Time
466
483
  # resp.table.last_updated_time #=> Time
484
+ # resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
485
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
486
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
487
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
488
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
467
489
  #
468
490
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/CreateTable AWS API Documentation
469
491
  #
@@ -478,13 +500,21 @@ module Aws::TimestreamWrite
478
500
  # operation. After a database is deleted, the time series data from its
479
501
  # tables cannot be recovered.*
480
502
  #
481
- # All tables in the database must be deleted first, or a
503
+ # <note markdown="1"> All tables in the database must be deleted first, or a
482
504
  # ValidationException error will be thrown.
483
505
  #
484
- # Due to the nature of distributed retries, the operation can return
506
+ # Due to the nature of distributed retries, the operation can return
485
507
  # either success or a ResourceNotFoundException. Clients should consider
486
508
  # them equivalent.
487
509
  #
510
+ # </note>
511
+ #
512
+ # See [code sample][1] for details.
513
+ #
514
+ #
515
+ #
516
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html
517
+ #
488
518
  # @option params [required, String] :database_name
489
519
  # The name of the Timestream database to be deleted.
490
520
  #
@@ -509,10 +539,18 @@ module Aws::TimestreamWrite
509
539
  # After a Timestream database table is deleted, the time series data
510
540
  # stored in the table cannot be recovered.
511
541
  #
512
- # Due to the nature of distributed retries, the operation can return
542
+ # <note markdown="1"> Due to the nature of distributed retries, the operation can return
513
543
  # either success or a ResourceNotFoundException. Clients should consider
514
544
  # them equivalent.
515
545
  #
546
+ # </note>
547
+ #
548
+ # See [code sample][1] for details.
549
+ #
550
+ #
551
+ #
552
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html
553
+ #
516
554
  # @option params [required, String] :database_name
517
555
  # The name of the database where the Timestream database is to be
518
556
  # deleted.
@@ -540,12 +578,13 @@ module Aws::TimestreamWrite
540
578
 
541
579
  # Returns information about the database, including the database name,
542
580
  # time that the database was created, and the total number of tables
543
- # found within the database. Service quotas apply. For more information,
544
- # see [Access Management][1] in the Timestream Developer Guide.
581
+ # found within the database. [Service quotas apply][1]. See [code
582
+ # sample][2] for details.
545
583
  #
546
584
  #
547
585
  #
548
586
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
587
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html
549
588
  #
550
589
  # @option params [required, String] :database_name
551
590
  # The name of the Timestream database.
@@ -582,22 +621,26 @@ module Aws::TimestreamWrite
582
621
  # Timestream API calls against. This API is available through both Write
583
622
  # and Query.
584
623
  #
585
- # Because Timestream’s SDKs are designed to transparently work with the
586
- # service’s architecture, including the management and mapping of the
587
- # service endpoints, *it is not recommended that you use this API
624
+ # Because the Timestream SDKs are designed to transparently work with
625
+ # the service’s architecture, including the management and mapping of
626
+ # the service endpoints, *it is not recommended that you use this API
588
627
  # unless*\:
589
628
  #
629
+ # * You are using [VPC endpoints (Amazon Web Services PrivateLink) with
630
+ # Timestream][1]
631
+ #
590
632
  # * Your application uses a programming language that does not yet have
591
633
  # SDK support
592
634
  #
593
635
  # * You require better control over the client-side implementation
594
636
  #
595
- # For detailed information on how to use DescribeEndpoints, see [The
596
- # Endpoint Discovery Pattern and REST APIs][1].
637
+ # For detailed information on how and when to use and implement
638
+ # DescribeEndpoints, see [The Endpoint Discovery Pattern][2].
597
639
  #
598
640
  #
599
641
  #
600
- # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/Using-API.endpoint-discovery.html
642
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints
643
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery
601
644
  #
602
645
  # @return [Types::DescribeEndpointsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
603
646
  #
@@ -620,12 +663,12 @@ module Aws::TimestreamWrite
620
663
 
621
664
  # Returns information about the table, including the table name,
622
665
  # database name, retention duration of the memory store and the magnetic
623
- # store. Service quotas apply. For more information, see [Access
624
- # Management][1] in the Timestream Developer Guide.
666
+ # store. [Service quotas apply][1]. See [code sample][2] for details.
625
667
  #
626
668
  #
627
669
  #
628
670
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
671
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html
629
672
  #
630
673
  # @option params [required, String] :database_name
631
674
  # The name of the Timestream database.
@@ -654,6 +697,11 @@ module Aws::TimestreamWrite
654
697
  # resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
655
698
  # resp.table.creation_time #=> Time
656
699
  # resp.table.last_updated_time #=> Time
700
+ # resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
701
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
702
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
703
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
704
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
657
705
  #
658
706
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DescribeTable AWS API Documentation
659
707
  #
@@ -664,13 +712,13 @@ module Aws::TimestreamWrite
664
712
  req.send_request(options)
665
713
  end
666
714
 
667
- # Returns a list of your Timestream databases. Service quotas apply. For
668
- # more information, see [Access Management][1] in the Timestream
669
- # Developer Guide.
715
+ # Returns a list of your Timestream databases. [Service quotas
716
+ # apply][1]. See [code sample][2] for details.
670
717
  #
671
718
  #
672
719
  #
673
720
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
721
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html
674
722
  #
675
723
  # @option params [String] :next_token
676
724
  # The pagination token. To resume pagination, provide the NextToken
@@ -717,7 +765,11 @@ module Aws::TimestreamWrite
717
765
  end
718
766
 
719
767
  # A list of tables, along with the name, status and retention properties
720
- # of each table.
768
+ # of each table. See [code sample][1] for details.
769
+ #
770
+ #
771
+ #
772
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html
721
773
  #
722
774
  # @option params [String] :database_name
723
775
  # The name of the Timestream database.
@@ -758,6 +810,11 @@ module Aws::TimestreamWrite
758
810
  # resp.tables[0].retention_properties.magnetic_store_retention_period_in_days #=> Integer
759
811
  # resp.tables[0].creation_time #=> Time
760
812
  # resp.tables[0].last_updated_time #=> Time
813
+ # resp.tables[0].magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
814
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
815
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
816
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
817
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
761
818
  # resp.next_token #=> String
762
819
  #
763
820
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ListTables AWS API Documentation
@@ -867,6 +924,12 @@ module Aws::TimestreamWrite
867
924
  # new KMS key to be used (`KmsKeyId`). If there are any concurrent
868
925
  # `UpdateDatabase` requests, first writer wins.
869
926
  #
927
+ # See [code sample][1] for details.
928
+ #
929
+ #
930
+ #
931
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html
932
+ #
870
933
  # @option params [required, String] :database_name
871
934
  # The name of the database.
872
935
  #
@@ -925,22 +988,25 @@ module Aws::TimestreamWrite
925
988
  # was made. Timestream does not retrieve data from the magnetic store to
926
989
  # populate the memory store.
927
990
  #
928
- # Service quotas apply. For more information, see [Access Management][1]
929
- # in the Timestream Developer Guide.
991
+ # See [code sample][1] for details.
930
992
  #
931
993
  #
932
994
  #
933
- # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
995
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html
934
996
  #
935
997
  # @option params [required, String] :database_name
936
998
  # The name of the Timestream database.
937
999
  #
938
1000
  # @option params [required, String] :table_name
939
- # The name of the Timesream table.
1001
+ # The name of the Timestream table.
940
1002
  #
941
- # @option params [required, Types::RetentionProperties] :retention_properties
1003
+ # @option params [Types::RetentionProperties] :retention_properties
942
1004
  # The retention duration of the memory store and the magnetic store.
943
1005
  #
1006
+ # @option params [Types::MagneticStoreWriteProperties] :magnetic_store_write_properties
1007
+ # Contains properties to set on the table when enabling magnetic store
1008
+ # writes.
1009
+ #
944
1010
  # @return [Types::UpdateTableResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
945
1011
  #
946
1012
  # * {Types::UpdateTableResponse#table #table} => Types::Table
@@ -950,10 +1016,21 @@ module Aws::TimestreamWrite
950
1016
  # resp = client.update_table({
951
1017
  # database_name: "ResourceName", # required
952
1018
  # table_name: "ResourceName", # required
953
- # retention_properties: { # required
1019
+ # retention_properties: {
954
1020
  # memory_store_retention_period_in_hours: 1, # required
955
1021
  # magnetic_store_retention_period_in_days: 1, # required
956
1022
  # },
1023
+ # magnetic_store_write_properties: {
1024
+ # enable_magnetic_store_writes: false, # required
1025
+ # magnetic_store_rejected_data_location: {
1026
+ # s3_configuration: {
1027
+ # bucket_name: "S3BucketName",
1028
+ # object_key_prefix: "S3ObjectKeyPrefix",
1029
+ # encryption_option: "SSE_S3", # accepts SSE_S3, SSE_KMS
1030
+ # kms_key_id: "StringValue2048",
1031
+ # },
1032
+ # },
1033
+ # },
957
1034
  # })
958
1035
  #
959
1036
  # @example Response structure
@@ -966,6 +1043,11 @@ module Aws::TimestreamWrite
966
1043
  # resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
967
1044
  # resp.table.creation_time #=> Time
968
1045
  # resp.table.last_updated_time #=> Time
1046
+ # resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
1047
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
1048
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
1049
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
1050
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
969
1051
  #
970
1052
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/UpdateTable AWS API Documentation
971
1053
  #
@@ -987,32 +1069,66 @@ module Aws::TimestreamWrite
987
1069
  # into Timestream, the query results might not reflect the results of a
988
1070
  # recently completed write operation. The results may also include some
989
1071
  # stale data. If you repeat the query request after a short time, the
990
- # results should return the latest data. Service quotas apply. For more
991
- # information, see [Access Management][1] in the Timestream Developer
992
- # Guide.
1072
+ # results should return the latest data. [Service quotas apply][1].
1073
+ #
1074
+ # See [code sample][2] for details.
1075
+ #
1076
+ # **Upserts**
1077
+ #
1078
+ # You can use the `Version` parameter in a `WriteRecords` request to
1079
+ # update data points. Timestream tracks a version number with each
1080
+ # record. `Version` defaults to `1` when not specified for the record in
1081
+ # the request. Timestream will update an existing record’s measure value
1082
+ # along with its `Version` upon receiving a write request with a higher
1083
+ # `Version` number for that record. Upon receiving an update request
1084
+ # where the measure value is the same as that of the existing record,
1085
+ # Timestream still updates `Version`, if it is greater than the existing
1086
+ # value of `Version`. You can update a data point as many times as
1087
+ # desired, as long as the value of `Version` continuously increases.
1088
+ #
1089
+ # For example, suppose you write a new record without indicating
1090
+ # `Version` in the request. Timestream will store this record, and set
1091
+ # `Version` to `1`. Now, suppose you try to update this record with a
1092
+ # `WriteRecords` request of the same record with a different measure
1093
+ # value but, like before, do not provide `Version`. In this case,
1094
+ # Timestream will reject this update with a `RejectedRecordsException`
1095
+ # since the updated record’s version is not greater than the existing
1096
+ # value of Version. However, if you were to resend the update request
1097
+ # with `Version` set to `2`, Timestream would then succeed in updating
1098
+ # the record’s value, and the `Version` would be set to `2`. Next,
1099
+ # suppose you sent a `WriteRecords` request with this same record and an
1100
+ # identical measure value, but with `Version` set to `3`. In this case,
1101
+ # Timestream would only update `Version` to `3`. Any further updates
1102
+ # would need to send a version number greater than `3`, or the update
1103
+ # requests would receive a `RejectedRecordsException`.
993
1104
  #
994
1105
  #
995
1106
  #
996
1107
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
1108
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html
997
1109
  #
998
1110
  # @option params [required, String] :database_name
999
1111
  # The name of the Timestream database.
1000
1112
  #
1001
1113
  # @option params [required, String] :table_name
1002
- # The name of the Timesream table.
1114
+ # The name of the Timestream table.
1003
1115
  #
1004
1116
  # @option params [Types::Record] :common_attributes
1005
- # A record containing the common measure and dimension attributes shared
1006
- # across all the records in the request. The measure and dimension
1007
- # attributes specified in here will be merged with the measure and
1117
+ # A record containing the common measure, dimension, time, and version
1118
+ # attributes shared across all the records in the request. The measure
1119
+ # and dimension attributes specified will be merged with the measure and
1008
1120
  # dimension attributes in the records object when the data is written
1009
- # into Timestream.
1121
+ # into Timestream. Dimensions may not overlap, or a
1122
+ # `ValidationException` will be thrown. In other words, a record must
1123
+ # contain dimensions with unique names.
1010
1124
  #
1011
1125
  # @option params [required, Array<Types::Record>] :records
1012
- # An array of records containing the unique dimension and measure
1013
- # attributes for each time series data point.
1126
+ # An array of records containing the unique measure, dimension, time,
1127
+ # and version attributes for each time series data point.
1014
1128
  #
1015
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1129
+ # @return [Types::WriteRecordsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1130
+ #
1131
+ # * {Types::WriteRecordsResponse#records_ingested #records_ingested} => Types::RecordsIngested
1016
1132
  #
1017
1133
  # @example Request syntax with placeholder values
1018
1134
  #
@@ -1022,37 +1138,57 @@ module Aws::TimestreamWrite
1022
1138
  # common_attributes: {
1023
1139
  # dimensions: [
1024
1140
  # {
1025
- # name: "StringValue256", # required
1026
- # value: "StringValue2048", # required
1141
+ # name: "SchemaName", # required
1142
+ # value: "SchemaValue", # required
1027
1143
  # dimension_value_type: "VARCHAR", # accepts VARCHAR
1028
1144
  # },
1029
1145
  # ],
1030
- # measure_name: "StringValue256",
1146
+ # measure_name: "SchemaName",
1031
1147
  # measure_value: "StringValue2048",
1032
- # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN
1148
+ # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1033
1149
  # time: "StringValue256",
1034
1150
  # time_unit: "MILLISECONDS", # accepts MILLISECONDS, SECONDS, MICROSECONDS, NANOSECONDS
1035
1151
  # version: 1,
1152
+ # measure_values: [
1153
+ # {
1154
+ # name: "SchemaName", # required
1155
+ # value: "StringValue2048", # required
1156
+ # type: "DOUBLE", # required, accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1157
+ # },
1158
+ # ],
1036
1159
  # },
1037
1160
  # records: [ # required
1038
1161
  # {
1039
1162
  # dimensions: [
1040
1163
  # {
1041
- # name: "StringValue256", # required
1042
- # value: "StringValue2048", # required
1164
+ # name: "SchemaName", # required
1165
+ # value: "SchemaValue", # required
1043
1166
  # dimension_value_type: "VARCHAR", # accepts VARCHAR
1044
1167
  # },
1045
1168
  # ],
1046
- # measure_name: "StringValue256",
1169
+ # measure_name: "SchemaName",
1047
1170
  # measure_value: "StringValue2048",
1048
- # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN
1171
+ # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1049
1172
  # time: "StringValue256",
1050
1173
  # time_unit: "MILLISECONDS", # accepts MILLISECONDS, SECONDS, MICROSECONDS, NANOSECONDS
1051
1174
  # version: 1,
1175
+ # measure_values: [
1176
+ # {
1177
+ # name: "SchemaName", # required
1178
+ # value: "StringValue2048", # required
1179
+ # type: "DOUBLE", # required, accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1180
+ # },
1181
+ # ],
1052
1182
  # },
1053
1183
  # ],
1054
1184
  # })
1055
1185
  #
1186
+ # @example Response structure
1187
+ #
1188
+ # resp.records_ingested.total #=> Integer
1189
+ # resp.records_ingested.memory_store #=> Integer
1190
+ # resp.records_ingested.magnetic_store #=> Integer
1191
+ #
1056
1192
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/WriteRecords AWS API Documentation
1057
1193
  #
1058
1194
  # @overload write_records(params = {})
@@ -1075,7 +1211,7 @@ module Aws::TimestreamWrite
1075
1211
  params: params,
1076
1212
  config: config)
1077
1213
  context[:gem_name] = 'aws-sdk-timestreamwrite'
1078
- context[:gem_version] = '1.9.0'
1214
+ context[:gem_version] = '1.10.0'
1079
1215
  Seahorse::Client::Request.new(handlers, context)
1080
1216
  end
1081
1217