aws-sdk-timestreamwrite 1.7.0 → 1.11.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: fec58703e398e2f0a0597b47be96580b122681b40880bb33cef41e4624f293e3
4
- data.tar.gz: d22a84f3c8d7ca6e747d4bfcf8d7ffba7ed436b3a20a7ca3ef74ceca69c0ce46
3
+ metadata.gz: 2a5892f550a65ce5e7d2bd4db7c03ae5c36a73aaa6144252f62ad8d502215715
4
+ data.tar.gz: 94a47bce477a59063f3350f38e2da5ccbb428fedc610516ef6ee9774e754664d
5
5
  SHA512:
6
- metadata.gz: 2a73f53ed2899742c14199263c46f508c9f9f01298c21348d25d4b82a248a024198b0424e5e112df7f612e35c3cb1ca44c94b88e096e462d238189831c5d41b1
7
- data.tar.gz: eb906886d8e6e319fb9062f7758c55ab25eb94bf4c162c85d03f3185aecf3941f4d66b03c75f157432bdfc1065192a7d30a9f2c5f05c89c48faf8980df9c9e88
6
+ metadata.gz: 1ee840a993609eb649b4f17f5faef1c5ec1dcda5bd0c22c05d5d90f911d92c4bb15be2a750629022d5f3545675d1d99e2e79cc27d94f8405f5e8ad6bb26ccdb3
7
+ data.tar.gz: 1b272558c373f4e0ecb6fe766e7df5b07e1d6d0360dab7c5af01d71b05b52c4f2cc35617ef4d907120415f6576e74d9178ae4a2ee061938dce535e562f0ef65c
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.11.0 (2021-11-30)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.10.0 (2021-11-24)
10
+ ------------------
11
+
12
+ * 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.
13
+
14
+ 1.9.0 (2021-11-04)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.8.0 (2021-10-18)
20
+ ------------------
21
+
22
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
23
+
4
24
  1.7.0 (2021-09-01)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.7.0
1
+ 1.11.0
@@ -119,7 +119,9 @@ module Aws::TimestreamWrite
119
119
  # * EC2/ECS IMDS instance profile - When used by default, the timeouts
120
120
  # are very aggressive. Construct and pass an instance of
121
121
  # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
122
- # enable retries and extended timeouts.
122
+ # enable retries and extended timeouts. Instance profile credential
123
+ # fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
124
+ # to true.
123
125
  #
124
126
  # @option options [required, String] :region
125
127
  # The AWS region to connect to. The configured `:region` is
@@ -285,6 +287,15 @@ module Aws::TimestreamWrite
285
287
  # ** Please note ** When response stubbing is enabled, no HTTP
286
288
  # requests are made, and retries are disabled.
287
289
  #
290
+ # @option options [Boolean] :use_dualstack_endpoint
291
+ # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
292
+ # will be used if available.
293
+ #
294
+ # @option options [Boolean] :use_fips_endpoint
295
+ # When set to `true`, fips compatible endpoints will be used if available.
296
+ # When a `fips` region is used, the region is normalized and this config
297
+ # is set to `true`.
298
+ #
288
299
  # @option options [Boolean] :validate_params (true)
289
300
  # When `true`, request parameters are validated before
290
301
  # sending the request.
@@ -339,14 +350,15 @@ module Aws::TimestreamWrite
339
350
 
340
351
  # Creates a new Timestream database. If the KMS key is not specified,
341
352
  # the database will be encrypted with a Timestream managed KMS key
342
- # located in your account. Refer to [AWS managed KMS keys][1] for more
343
- # info. Service quotas apply. For more information, see [Access
344
- # Management][2] in the Timestream Developer Guide.
353
+ # located in your account. Refer to [Amazon Web Services managed KMS
354
+ # keys][1] for more info. [Service quotas apply][2]. See [code
355
+ # sample][3] for details.
345
356
  #
346
357
  #
347
358
  #
348
359
  # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
349
360
  # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
361
+ # [3]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html
350
362
  #
351
363
  # @option params [required, String] :database_name
352
364
  # The name of the Timestream database.
@@ -354,7 +366,8 @@ module Aws::TimestreamWrite
354
366
  # @option params [String] :kms_key_id
355
367
  # The KMS key for the database. If the KMS key is not specified, the
356
368
  # database will be encrypted with a Timestream managed KMS key located
357
- # in your account. Refer to [AWS managed KMS keys][1] for more info.
369
+ # in your account. Refer to [Amazon Web Services managed KMS keys][1]
370
+ # for more info.
358
371
  #
359
372
  #
360
373
  #
@@ -370,7 +383,7 @@ module Aws::TimestreamWrite
370
383
  # @example Request syntax with placeholder values
371
384
  #
372
385
  # resp = client.create_database({
373
- # database_name: "ResourceName", # required
386
+ # database_name: "ResourceCreateAPIName", # required
374
387
  # kms_key_id: "StringValue2048",
375
388
  # tags: [
376
389
  # {
@@ -399,17 +412,17 @@ module Aws::TimestreamWrite
399
412
  end
400
413
 
401
414
  # The CreateTable operation adds a new table to an existing database in
402
- # your account. In an AWS account, table names must be at least unique
403
- # within each Region if they are in the same database. You may have
404
- # identical table names in the same Region if the tables are in seperate
405
- # databases. While creating the table, you must specify the table name,
406
- # database name, and the retention properties. Service quotas apply. For
407
- # more information, see [Access Management][1] in the Timestream
408
- # Developer Guide.
415
+ # your account. In an Amazon Web Services account, table names must be
416
+ # at least unique within each Region if they are in the same database.
417
+ # You may have identical table names in the same Region if the tables
418
+ # are in separate databases. While creating the table, you must specify
419
+ # the table name, database name, and the retention properties. [Service
420
+ # quotas apply][1]. See [code sample][2] for details.
409
421
  #
410
422
  #
411
423
  #
412
424
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
425
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html
413
426
  #
414
427
  # @option params [required, String] :database_name
415
428
  # The name of the Timestream database.
@@ -424,6 +437,10 @@ module Aws::TimestreamWrite
424
437
  # @option params [Array<Types::Tag>] :tags
425
438
  # A list of key-value pairs to label the table.
426
439
  #
440
+ # @option params [Types::MagneticStoreWriteProperties] :magnetic_store_write_properties
441
+ # Contains properties to set on the table when enabling magnetic store
442
+ # writes.
443
+ #
427
444
  # @return [Types::CreateTableResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
428
445
  #
429
446
  # * {Types::CreateTableResponse#table #table} => Types::Table
@@ -431,8 +448,8 @@ module Aws::TimestreamWrite
431
448
  # @example Request syntax with placeholder values
432
449
  #
433
450
  # resp = client.create_table({
434
- # database_name: "ResourceName", # required
435
- # table_name: "ResourceName", # required
451
+ # database_name: "ResourceCreateAPIName", # required
452
+ # table_name: "ResourceCreateAPIName", # required
436
453
  # retention_properties: {
437
454
  # memory_store_retention_period_in_hours: 1, # required
438
455
  # magnetic_store_retention_period_in_days: 1, # required
@@ -443,6 +460,17 @@ module Aws::TimestreamWrite
443
460
  # value: "TagValue", # required
444
461
  # },
445
462
  # ],
463
+ # magnetic_store_write_properties: {
464
+ # enable_magnetic_store_writes: false, # required
465
+ # magnetic_store_rejected_data_location: {
466
+ # s3_configuration: {
467
+ # bucket_name: "S3BucketName",
468
+ # object_key_prefix: "S3ObjectKeyPrefix",
469
+ # encryption_option: "SSE_S3", # accepts SSE_S3, SSE_KMS
470
+ # kms_key_id: "StringValue2048",
471
+ # },
472
+ # },
473
+ # },
446
474
  # })
447
475
  #
448
476
  # @example Response structure
@@ -455,6 +483,11 @@ module Aws::TimestreamWrite
455
483
  # resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
456
484
  # resp.table.creation_time #=> Time
457
485
  # resp.table.last_updated_time #=> Time
486
+ # resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
487
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
488
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
489
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
490
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
458
491
  #
459
492
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/CreateTable AWS API Documentation
460
493
  #
@@ -469,13 +502,21 @@ module Aws::TimestreamWrite
469
502
  # operation. After a database is deleted, the time series data from its
470
503
  # tables cannot be recovered.*
471
504
  #
472
- # All tables in the database must be deleted first, or a
505
+ # <note markdown="1"> All tables in the database must be deleted first, or a
473
506
  # ValidationException error will be thrown.
474
507
  #
475
- # Due to the nature of distributed retries, the operation can return
508
+ # Due to the nature of distributed retries, the operation can return
476
509
  # either success or a ResourceNotFoundException. Clients should consider
477
510
  # them equivalent.
478
511
  #
512
+ # </note>
513
+ #
514
+ # See [code sample][1] for details.
515
+ #
516
+ #
517
+ #
518
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html
519
+ #
479
520
  # @option params [required, String] :database_name
480
521
  # The name of the Timestream database to be deleted.
481
522
  #
@@ -500,10 +541,18 @@ module Aws::TimestreamWrite
500
541
  # After a Timestream database table is deleted, the time series data
501
542
  # stored in the table cannot be recovered.
502
543
  #
503
- # Due to the nature of distributed retries, the operation can return
544
+ # <note markdown="1"> Due to the nature of distributed retries, the operation can return
504
545
  # either success or a ResourceNotFoundException. Clients should consider
505
546
  # them equivalent.
506
547
  #
548
+ # </note>
549
+ #
550
+ # See [code sample][1] for details.
551
+ #
552
+ #
553
+ #
554
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html
555
+ #
507
556
  # @option params [required, String] :database_name
508
557
  # The name of the database where the Timestream database is to be
509
558
  # deleted.
@@ -531,12 +580,13 @@ module Aws::TimestreamWrite
531
580
 
532
581
  # Returns information about the database, including the database name,
533
582
  # time that the database was created, and the total number of tables
534
- # found within the database. Service quotas apply. For more information,
535
- # see [Access Management][1] in the Timestream Developer Guide.
583
+ # found within the database. [Service quotas apply][1]. See [code
584
+ # sample][2] for details.
536
585
  #
537
586
  #
538
587
  #
539
588
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
589
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html
540
590
  #
541
591
  # @option params [required, String] :database_name
542
592
  # The name of the Timestream database.
@@ -573,22 +623,26 @@ module Aws::TimestreamWrite
573
623
  # Timestream API calls against. This API is available through both Write
574
624
  # and Query.
575
625
  #
576
- # Because Timestream’s SDKs are designed to transparently work with the
577
- # service’s architecture, including the management and mapping of the
578
- # service endpoints, *it is not recommended that you use this API
626
+ # Because the Timestream SDKs are designed to transparently work with
627
+ # the service’s architecture, including the management and mapping of
628
+ # the service endpoints, *it is not recommended that you use this API
579
629
  # unless*\:
580
630
  #
631
+ # * You are using [VPC endpoints (Amazon Web Services PrivateLink) with
632
+ # Timestream][1]
633
+ #
581
634
  # * Your application uses a programming language that does not yet have
582
635
  # SDK support
583
636
  #
584
637
  # * You require better control over the client-side implementation
585
638
  #
586
- # For detailed information on how to use DescribeEndpoints, see [The
587
- # Endpoint Discovery Pattern and REST APIs][1].
639
+ # For detailed information on how and when to use and implement
640
+ # DescribeEndpoints, see [The Endpoint Discovery Pattern][2].
588
641
  #
589
642
  #
590
643
  #
591
- # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/Using-API.endpoint-discovery.html
644
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints
645
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery
592
646
  #
593
647
  # @return [Types::DescribeEndpointsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
594
648
  #
@@ -611,12 +665,12 @@ module Aws::TimestreamWrite
611
665
 
612
666
  # Returns information about the table, including the table name,
613
667
  # database name, retention duration of the memory store and the magnetic
614
- # store. Service quotas apply. For more information, see [Access
615
- # Management][1] in the Timestream Developer Guide.
668
+ # store. [Service quotas apply][1]. See [code sample][2] for details.
616
669
  #
617
670
  #
618
671
  #
619
672
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
673
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html
620
674
  #
621
675
  # @option params [required, String] :database_name
622
676
  # The name of the Timestream database.
@@ -645,6 +699,11 @@ module Aws::TimestreamWrite
645
699
  # resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
646
700
  # resp.table.creation_time #=> Time
647
701
  # resp.table.last_updated_time #=> Time
702
+ # resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
703
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
704
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
705
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
706
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
648
707
  #
649
708
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DescribeTable AWS API Documentation
650
709
  #
@@ -655,13 +714,13 @@ module Aws::TimestreamWrite
655
714
  req.send_request(options)
656
715
  end
657
716
 
658
- # Returns a list of your Timestream databases. Service quotas apply. For
659
- # more information, see [Access Management][1] in the Timestream
660
- # Developer Guide.
717
+ # Returns a list of your Timestream databases. [Service quotas
718
+ # apply][1]. See [code sample][2] for details.
661
719
  #
662
720
  #
663
721
  #
664
722
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
723
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html
665
724
  #
666
725
  # @option params [String] :next_token
667
726
  # The pagination token. To resume pagination, provide the NextToken
@@ -708,7 +767,11 @@ module Aws::TimestreamWrite
708
767
  end
709
768
 
710
769
  # A list of tables, along with the name, status and retention properties
711
- # of each table.
770
+ # of each table. See [code sample][1] for details.
771
+ #
772
+ #
773
+ #
774
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html
712
775
  #
713
776
  # @option params [String] :database_name
714
777
  # The name of the Timestream database.
@@ -749,6 +812,11 @@ module Aws::TimestreamWrite
749
812
  # resp.tables[0].retention_properties.magnetic_store_retention_period_in_days #=> Integer
750
813
  # resp.tables[0].creation_time #=> Time
751
814
  # resp.tables[0].last_updated_time #=> Time
815
+ # resp.tables[0].magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
816
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
817
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
818
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
819
+ # resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
752
820
  # resp.next_token #=> String
753
821
  #
754
822
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ListTables AWS API Documentation
@@ -858,6 +926,12 @@ module Aws::TimestreamWrite
858
926
  # new KMS key to be used (`KmsKeyId`). If there are any concurrent
859
927
  # `UpdateDatabase` requests, first writer wins.
860
928
  #
929
+ # See [code sample][1] for details.
930
+ #
931
+ #
932
+ #
933
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html
934
+ #
861
935
  # @option params [required, String] :database_name
862
936
  # The name of the database.
863
937
  #
@@ -916,22 +990,25 @@ module Aws::TimestreamWrite
916
990
  # was made. Timestream does not retrieve data from the magnetic store to
917
991
  # populate the memory store.
918
992
  #
919
- # Service quotas apply. For more information, see [Access Management][1]
920
- # in the Timestream Developer Guide.
993
+ # See [code sample][1] for details.
921
994
  #
922
995
  #
923
996
  #
924
- # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
997
+ # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html
925
998
  #
926
999
  # @option params [required, String] :database_name
927
1000
  # The name of the Timestream database.
928
1001
  #
929
1002
  # @option params [required, String] :table_name
930
- # The name of the Timesream table.
1003
+ # The name of the Timestream table.
931
1004
  #
932
- # @option params [required, Types::RetentionProperties] :retention_properties
1005
+ # @option params [Types::RetentionProperties] :retention_properties
933
1006
  # The retention duration of the memory store and the magnetic store.
934
1007
  #
1008
+ # @option params [Types::MagneticStoreWriteProperties] :magnetic_store_write_properties
1009
+ # Contains properties to set on the table when enabling magnetic store
1010
+ # writes.
1011
+ #
935
1012
  # @return [Types::UpdateTableResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
936
1013
  #
937
1014
  # * {Types::UpdateTableResponse#table #table} => Types::Table
@@ -941,10 +1018,21 @@ module Aws::TimestreamWrite
941
1018
  # resp = client.update_table({
942
1019
  # database_name: "ResourceName", # required
943
1020
  # table_name: "ResourceName", # required
944
- # retention_properties: { # required
1021
+ # retention_properties: {
945
1022
  # memory_store_retention_period_in_hours: 1, # required
946
1023
  # magnetic_store_retention_period_in_days: 1, # required
947
1024
  # },
1025
+ # magnetic_store_write_properties: {
1026
+ # enable_magnetic_store_writes: false, # required
1027
+ # magnetic_store_rejected_data_location: {
1028
+ # s3_configuration: {
1029
+ # bucket_name: "S3BucketName",
1030
+ # object_key_prefix: "S3ObjectKeyPrefix",
1031
+ # encryption_option: "SSE_S3", # accepts SSE_S3, SSE_KMS
1032
+ # kms_key_id: "StringValue2048",
1033
+ # },
1034
+ # },
1035
+ # },
948
1036
  # })
949
1037
  #
950
1038
  # @example Response structure
@@ -957,6 +1045,11 @@ module Aws::TimestreamWrite
957
1045
  # resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
958
1046
  # resp.table.creation_time #=> Time
959
1047
  # resp.table.last_updated_time #=> Time
1048
+ # resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
1049
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
1050
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
1051
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
1052
+ # resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
960
1053
  #
961
1054
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/UpdateTable AWS API Documentation
962
1055
  #
@@ -978,32 +1071,66 @@ module Aws::TimestreamWrite
978
1071
  # into Timestream, the query results might not reflect the results of a
979
1072
  # recently completed write operation. The results may also include some
980
1073
  # stale data. If you repeat the query request after a short time, the
981
- # results should return the latest data. Service quotas apply. For more
982
- # information, see [Access Management][1] in the Timestream Developer
983
- # Guide.
1074
+ # results should return the latest data. [Service quotas apply][1].
1075
+ #
1076
+ # See [code sample][2] for details.
1077
+ #
1078
+ # **Upserts**
1079
+ #
1080
+ # You can use the `Version` parameter in a `WriteRecords` request to
1081
+ # update data points. Timestream tracks a version number with each
1082
+ # record. `Version` defaults to `1` when not specified for the record in
1083
+ # the request. Timestream will update an existing record’s measure value
1084
+ # along with its `Version` upon receiving a write request with a higher
1085
+ # `Version` number for that record. Upon receiving an update request
1086
+ # where the measure value is the same as that of the existing record,
1087
+ # Timestream still updates `Version`, if it is greater than the existing
1088
+ # value of `Version`. You can update a data point as many times as
1089
+ # desired, as long as the value of `Version` continuously increases.
1090
+ #
1091
+ # For example, suppose you write a new record without indicating
1092
+ # `Version` in the request. Timestream will store this record, and set
1093
+ # `Version` to `1`. Now, suppose you try to update this record with a
1094
+ # `WriteRecords` request of the same record with a different measure
1095
+ # value but, like before, do not provide `Version`. In this case,
1096
+ # Timestream will reject this update with a `RejectedRecordsException`
1097
+ # since the updated record’s version is not greater than the existing
1098
+ # value of Version. However, if you were to resend the update request
1099
+ # with `Version` set to `2`, Timestream would then succeed in updating
1100
+ # the record’s value, and the `Version` would be set to `2`. Next,
1101
+ # suppose you sent a `WriteRecords` request with this same record and an
1102
+ # identical measure value, but with `Version` set to `3`. In this case,
1103
+ # Timestream would only update `Version` to `3`. Any further updates
1104
+ # would need to send a version number greater than `3`, or the update
1105
+ # requests would receive a `RejectedRecordsException`.
984
1106
  #
985
1107
  #
986
1108
  #
987
1109
  # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
1110
+ # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html
988
1111
  #
989
1112
  # @option params [required, String] :database_name
990
1113
  # The name of the Timestream database.
991
1114
  #
992
1115
  # @option params [required, String] :table_name
993
- # The name of the Timesream table.
1116
+ # The name of the Timestream table.
994
1117
  #
995
1118
  # @option params [Types::Record] :common_attributes
996
- # A record containing the common measure and dimension attributes shared
997
- # across all the records in the request. The measure and dimension
998
- # attributes specified in here will be merged with the measure and
1119
+ # A record containing the common measure, dimension, time, and version
1120
+ # attributes shared across all the records in the request. The measure
1121
+ # and dimension attributes specified will be merged with the measure and
999
1122
  # dimension attributes in the records object when the data is written
1000
- # into Timestream.
1123
+ # into Timestream. Dimensions may not overlap, or a
1124
+ # `ValidationException` will be thrown. In other words, a record must
1125
+ # contain dimensions with unique names.
1001
1126
  #
1002
1127
  # @option params [required, Array<Types::Record>] :records
1003
- # An array of records containing the unique dimension and measure
1004
- # attributes for each time series data point.
1128
+ # An array of records containing the unique measure, dimension, time,
1129
+ # and version attributes for each time series data point.
1005
1130
  #
1006
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1131
+ # @return [Types::WriteRecordsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1132
+ #
1133
+ # * {Types::WriteRecordsResponse#records_ingested #records_ingested} => Types::RecordsIngested
1007
1134
  #
1008
1135
  # @example Request syntax with placeholder values
1009
1136
  #
@@ -1013,37 +1140,57 @@ module Aws::TimestreamWrite
1013
1140
  # common_attributes: {
1014
1141
  # dimensions: [
1015
1142
  # {
1016
- # name: "StringValue256", # required
1017
- # value: "StringValue2048", # required
1143
+ # name: "SchemaName", # required
1144
+ # value: "SchemaValue", # required
1018
1145
  # dimension_value_type: "VARCHAR", # accepts VARCHAR
1019
1146
  # },
1020
1147
  # ],
1021
- # measure_name: "StringValue256",
1148
+ # measure_name: "SchemaName",
1022
1149
  # measure_value: "StringValue2048",
1023
- # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN
1150
+ # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1024
1151
  # time: "StringValue256",
1025
1152
  # time_unit: "MILLISECONDS", # accepts MILLISECONDS, SECONDS, MICROSECONDS, NANOSECONDS
1026
1153
  # version: 1,
1154
+ # measure_values: [
1155
+ # {
1156
+ # name: "SchemaName", # required
1157
+ # value: "StringValue2048", # required
1158
+ # type: "DOUBLE", # required, accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1159
+ # },
1160
+ # ],
1027
1161
  # },
1028
1162
  # records: [ # required
1029
1163
  # {
1030
1164
  # dimensions: [
1031
1165
  # {
1032
- # name: "StringValue256", # required
1033
- # value: "StringValue2048", # required
1166
+ # name: "SchemaName", # required
1167
+ # value: "SchemaValue", # required
1034
1168
  # dimension_value_type: "VARCHAR", # accepts VARCHAR
1035
1169
  # },
1036
1170
  # ],
1037
- # measure_name: "StringValue256",
1171
+ # measure_name: "SchemaName",
1038
1172
  # measure_value: "StringValue2048",
1039
- # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN
1173
+ # measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1040
1174
  # time: "StringValue256",
1041
1175
  # time_unit: "MILLISECONDS", # accepts MILLISECONDS, SECONDS, MICROSECONDS, NANOSECONDS
1042
1176
  # version: 1,
1177
+ # measure_values: [
1178
+ # {
1179
+ # name: "SchemaName", # required
1180
+ # value: "StringValue2048", # required
1181
+ # type: "DOUBLE", # required, accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
1182
+ # },
1183
+ # ],
1043
1184
  # },
1044
1185
  # ],
1045
1186
  # })
1046
1187
  #
1188
+ # @example Response structure
1189
+ #
1190
+ # resp.records_ingested.total #=> Integer
1191
+ # resp.records_ingested.memory_store #=> Integer
1192
+ # resp.records_ingested.magnetic_store #=> Integer
1193
+ #
1047
1194
  # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/WriteRecords AWS API Documentation
1048
1195
  #
1049
1196
  # @overload write_records(params = {})
@@ -1066,7 +1213,7 @@ module Aws::TimestreamWrite
1066
1213
  params: params,
1067
1214
  config: config)
1068
1215
  context[:gem_name] = 'aws-sdk-timestreamwrite'
1069
- context[:gem_version] = '1.7.0'
1216
+ context[:gem_version] = '1.11.0'
1070
1217
  Seahorse::Client::Request.new(handlers, context)
1071
1218
  end
1072
1219