aws-sdk-timestreamwrite 1.8.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b694dc0ba8b2a9ff1037ba694587b6617e8c43cf9e806c50a4741e6ef231ce0
-  data.tar.gz: 85d45a5d13da7db6cb0896c43ea48995412989df6cb48c91ad0467e5c92c15aa
+  metadata.gz: dd058ce467240da1e4f5cdcb172e7f36265732931e9fd5377f0f56b2a021d8b1
+  data.tar.gz: 619210847bd710628f593a9d4d7976f46a499712590fac4dc01a6ac1bd16720e
 SHA512:
-  metadata.gz: '0458dc4869860e4326cc9df35d360b2834ebafb0c165dc386cf34dbac1db97705dff99655b315998f515b843102d70f51bc82f1a082bd675ed574a12ef0e0ed7'
-  data.tar.gz: 16c1d0ce3485196f1b48439c4b6c26c163fb3adcce63b244378a4a4de5606e89cab70e4adef15110a0dfce5cd66b7a359777e3e0bfbb4a3ffb7c4f70223e6125
+  metadata.gz: b7bd29eda4c39c39dc42555046ab5145ac3657c548e92061493c96cc35bd93894131c348713609555a8c157ff3ebc3f82298a571e57af10a51e1ef6305a753a1
+  data.tar.gz: b6bab0315d750e74a66d122d05206ce0cc35331d4709fb6e88c6ce2caa8749f0b50211114c59386ecd13601084fea90f16f5a458f8301426d5a399ad8443ff06

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.12.0 (2021-12-21)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.11.0 (2021-11-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.10.0 (2021-11-24)
+------------------
+
+* 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.
+
+1.9.0 (2021-11-04)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.8.0 (2021-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.8.0
+1.12.0

data/lib/aws-sdk-timestreamwrite/client.rb

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -73,6 +74,7 @@ module Aws::TimestreamWrite
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -119,7 +121,9 @@ module Aws::TimestreamWrite
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::TimestreamWrite
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -285,6 +293,15 @@ module Aws::TimestreamWrite
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Boolean] :use_dualstack_endpoint
+    #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
+    #     will be used if available.
+    #
+    #   @option options [Boolean] :use_fips_endpoint
+    #     When set to `true`, fips compatible endpoints will be used if available.
+    #     When a `fips` region is used, the region is normalized and this config
+    #     is set to `true`.
+    #
     #   @option options [Boolean] :validate_params (true)
     #     When `true`, request parameters are validated before
     #     sending the request.
@@ -296,7 +313,7 @@ module Aws::TimestreamWrite
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -312,6 +329,9 @@ module Aws::TimestreamWrite
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -339,14 +359,15 @@ module Aws::TimestreamWrite
 
     # Creates a new Timestream database. If the KMS key is not specified,
     # the database will be encrypted with a Timestream managed KMS key
-    # located in your account. Refer to [AWS managed KMS keys][1] for more
-    # info. Service quotas apply. For more information, see [Access
-    # Management][2] in the Timestream Developer Guide.
+    # located in your account. Refer to [Amazon Web Services managed KMS
+    # keys][1] for more info. [Service quotas apply][2]. See [code
+    # sample][3] for details.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk
     # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
+    # [3]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html
     #
     # @option params [required, String] :database_name
     #   The name of the Timestream database.
@@ -354,7 +375,8 @@ module Aws::TimestreamWrite
     # @option params [String] :kms_key_id
     #   The KMS key for the database. If the KMS key is not specified, the
     #   database will be encrypted with a Timestream managed KMS key located
-    #   in your account. Refer to [AWS managed KMS keys][1] for more info.
+    #   in your account. Refer to [Amazon Web Services managed KMS keys][1]
+    #   for more info.
     #
     #
     #
@@ -370,7 +392,7 @@ module Aws::TimestreamWrite
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_database({
-    #     database_name: "ResourceName", # required
+    #     database_name: "ResourceCreateAPIName", # required
     #     kms_key_id: "StringValue2048",
     #     tags: [
     #       {
@@ -399,17 +421,17 @@ module Aws::TimestreamWrite
     end
 
     # The CreateTable operation adds a new table to an existing database in
-    # your account. In an AWS account, table names must be at least unique
-    # within each Region if they are in the same database. You may have
-    # identical table names in the same Region if the tables are in seperate
-    # databases. While creating the table, you must specify the table name,
-    # database name, and the retention properties. Service quotas apply. For
-    # more information, see [Access Management][1] in the Timestream
-    # Developer Guide.
+    # your account. In an Amazon Web Services account, table names must be
+    # at least unique within each Region if they are in the same database.
+    # You may have identical table names in the same Region if the tables
+    # are in separate databases. While creating the table, you must specify
+    # the table name, database name, and the retention properties. [Service
+    # quotas apply][1]. See [code sample][2] for details.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
+    # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html
     #
     # @option params [required, String] :database_name
     #   The name of the Timestream database.
@@ -424,6 +446,10 @@ module Aws::TimestreamWrite
     # @option params [Array<Types::Tag>] :tags
     #   A list of key-value pairs to label the table.
     #
+    # @option params [Types::MagneticStoreWriteProperties] :magnetic_store_write_properties
+    #   Contains properties to set on the table when enabling magnetic store
+    #   writes.
+    #
     # @return [Types::CreateTableResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTableResponse#table #table} => Types::Table
@@ -431,8 +457,8 @@ module Aws::TimestreamWrite
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_table({
-    #     database_name: "ResourceName", # required
-    #     table_name: "ResourceName", # required
+    #     database_name: "ResourceCreateAPIName", # required
+    #     table_name: "ResourceCreateAPIName", # required
     #     retention_properties: {
     #       memory_store_retention_period_in_hours: 1, # required
     #       magnetic_store_retention_period_in_days: 1, # required
@@ -443,6 +469,17 @@ module Aws::TimestreamWrite
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     magnetic_store_write_properties: {
+    #       enable_magnetic_store_writes: false, # required
+    #       magnetic_store_rejected_data_location: {
+    #         s3_configuration: {
+    #           bucket_name: "S3BucketName",
+    #           object_key_prefix: "S3ObjectKeyPrefix",
+    #           encryption_option: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #           kms_key_id: "StringValue2048",
+    #         },
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -455,6 +492,11 @@ module Aws::TimestreamWrite
     #   resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.table.creation_time #=> Time
     #   resp.table.last_updated_time #=> Time
+    #   resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/CreateTable AWS API Documentation
     #
@@ -469,13 +511,21 @@ module Aws::TimestreamWrite
     # operation. After a database is deleted, the time series data from its
     # tables cannot be recovered.*
     #
-    # All tables in the database must be deleted first, or a
+    # <note markdown="1"> All tables in the database must be deleted first, or a
     # ValidationException error will be thrown.
     #
-    # Due to the nature of distributed retries, the operation can return
+    #  Due to the nature of distributed retries, the operation can return
     # either success or a ResourceNotFoundException. Clients should consider
     # them equivalent.
     #
+    #  </note>
+    #
+    # See [code sample][1] for details.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html
+    #
     # @option params [required, String] :database_name
     #   The name of the Timestream database to be deleted.
     #
@@ -500,10 +550,18 @@ module Aws::TimestreamWrite
     # After a Timestream database table is deleted, the time series data
     # stored in the table cannot be recovered.
     #
-    # Due to the nature of distributed retries, the operation can return
+    # <note markdown="1"> Due to the nature of distributed retries, the operation can return
     # either success or a ResourceNotFoundException. Clients should consider
     # them equivalent.
     #
+    #  </note>
+    #
+    # See [code sample][1] for details.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html
+    #
     # @option params [required, String] :database_name
     #   The name of the database where the Timestream database is to be
     #   deleted.
@@ -531,12 +589,13 @@ module Aws::TimestreamWrite
 
     # Returns information about the database, including the database name,
     # time that the database was created, and the total number of tables
-    # found within the database. Service quotas apply. For more information,
-    # see [Access Management][1] in the Timestream Developer Guide.
+    # found within the database. [Service quotas apply][1]. See [code
+    # sample][2] for details.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
+    # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html
     #
     # @option params [required, String] :database_name
     #   The name of the Timestream database.
@@ -573,22 +632,26 @@ module Aws::TimestreamWrite
     # Timestream API calls against. This API is available through both Write
     # and Query.
     #
-    # Because Timestream’s SDKs are designed to transparently work with the
-    # service’s architecture, including the management and mapping of the
-    # service endpoints, *it is not recommended that you use this API
+    # Because the Timestream SDKs are designed to transparently work with
+    # the service’s architecture, including the management and mapping of
+    # the service endpoints, *it is not recommended that you use this API
     # unless*\:
     #
+    # * You are using [VPC endpoints (Amazon Web Services PrivateLink) with
+    #   Timestream][1]
+    #
     # * Your application uses a programming language that does not yet have
     #   SDK support
     #
     # * You require better control over the client-side implementation
     #
-    # For detailed information on how to use DescribeEndpoints, see [The
-    # Endpoint Discovery Pattern and REST APIs][1].
+    # For detailed information on how and when to use and implement
+    # DescribeEndpoints, see [The Endpoint Discovery Pattern][2].
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/Using-API.endpoint-discovery.html
+    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints
+    # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery
     #
     # @return [Types::DescribeEndpointsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -611,12 +674,12 @@ module Aws::TimestreamWrite
 
     # Returns information about the table, including the table name,
     # database name, retention duration of the memory store and the magnetic
-    # store. Service quotas apply. For more information, see [Access
-    # Management][1] in the Timestream Developer Guide.
+    # store. [Service quotas apply][1]. See [code sample][2] for details.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
+    # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html
     #
     # @option params [required, String] :database_name
     #   The name of the Timestream database.
@@ -645,6 +708,11 @@ module Aws::TimestreamWrite
     #   resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.table.creation_time #=> Time
     #   resp.table.last_updated_time #=> Time
+    #   resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DescribeTable AWS API Documentation
     #
@@ -655,13 +723,13 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
-    # Returns a list of your Timestream databases. Service quotas apply. For
-    # more information, see [Access Management][1] in the Timestream
-    # Developer Guide.
+    # Returns a list of your Timestream databases. [Service quotas
+    # apply][1]. See [code sample][2] for details.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
+    # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html
     #
     # @option params [String] :next_token
     #   The pagination token. To resume pagination, provide the NextToken
@@ -708,7 +776,11 @@ module Aws::TimestreamWrite
     end
 
     # A list of tables, along with the name, status and retention properties
-    # of each table.
+    # of each table. See [code sample][1] for details.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html
     #
     # @option params [String] :database_name
     #   The name of the Timestream database.
@@ -749,6 +821,11 @@ module Aws::TimestreamWrite
     #   resp.tables[0].retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.tables[0].creation_time #=> Time
     #   resp.tables[0].last_updated_time #=> Time
+    #   resp.tables[0].magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
+    #   resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
+    #   resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
+    #   resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.tables[0].magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ListTables AWS API Documentation
@@ -858,6 +935,12 @@ module Aws::TimestreamWrite
     # new KMS key to be used (`KmsKeyId`). If there are any concurrent
     # `UpdateDatabase` requests, first writer wins.
     #
+    # See [code sample][1] for details.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html
+    #
     # @option params [required, String] :database_name
     #   The name of the database.
     #
@@ -916,22 +999,25 @@ module Aws::TimestreamWrite
     # was made. Timestream does not retrieve data from the magnetic store to
     # populate the memory store.
     #
-    # Service quotas apply. For more information, see [Access Management][1]
-    # in the Timestream Developer Guide.
+    # See [code sample][1] for details.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
+    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html
     #
     # @option params [required, String] :database_name
     #   The name of the Timestream database.
     #
     # @option params [required, String] :table_name
-    #   The name of the Timesream table.
+    #   The name of the Timestream table.
     #
-    # @option params [required, Types::RetentionProperties] :retention_properties
+    # @option params [Types::RetentionProperties] :retention_properties
     #   The retention duration of the memory store and the magnetic store.
     #
+    # @option params [Types::MagneticStoreWriteProperties] :magnetic_store_write_properties
+    #   Contains properties to set on the table when enabling magnetic store
+    #   writes.
+    #
     # @return [Types::UpdateTableResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateTableResponse#table #table} => Types::Table
@@ -941,10 +1027,21 @@ module Aws::TimestreamWrite
     #   resp = client.update_table({
     #     database_name: "ResourceName", # required
     #     table_name: "ResourceName", # required
-    #     retention_properties: { # required
+    #     retention_properties: {
     #       memory_store_retention_period_in_hours: 1, # required
     #       magnetic_store_retention_period_in_days: 1, # required
     #     },
+    #     magnetic_store_write_properties: {
+    #       enable_magnetic_store_writes: false, # required
+    #       magnetic_store_rejected_data_location: {
+    #         s3_configuration: {
+    #           bucket_name: "S3BucketName",
+    #           object_key_prefix: "S3ObjectKeyPrefix",
+    #           encryption_option: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #           kms_key_id: "StringValue2048",
+    #         },
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -957,6 +1054,11 @@ module Aws::TimestreamWrite
     #   resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.table.creation_time #=> Time
     #   resp.table.last_updated_time #=> Time
+    #   resp.table.magnetic_store_write_properties.enable_magnetic_store_writes #=> Boolean
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.bucket_name #=> String
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.object_key_prefix #=> String
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.table.magnetic_store_write_properties.magnetic_store_rejected_data_location.s3_configuration.kms_key_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/UpdateTable AWS API Documentation
     #
@@ -978,32 +1080,66 @@ module Aws::TimestreamWrite
     # into Timestream, the query results might not reflect the results of a
     # recently completed write operation. The results may also include some
     # stale data. If you repeat the query request after a short time, the
-    # results should return the latest data. Service quotas apply. For more
-    # information, see [Access Management][1] in the Timestream Developer
-    # Guide.
+    # results should return the latest data. [Service quotas apply][1].
+    #
+    # See [code sample][2] for details.
+    #
+    # **Upserts**
+    #
+    # You can use the `Version` parameter in a `WriteRecords` request to
+    # update data points. Timestream tracks a version number with each
+    # record. `Version` defaults to `1` when not specified for the record in
+    # the request. Timestream will update an existing record’s measure value
+    # along with its `Version` upon receiving a write request with a higher
+    # `Version` number for that record. Upon receiving an update request
+    # where the measure value is the same as that of the existing record,
+    # Timestream still updates `Version`, if it is greater than the existing
+    # value of `Version`. You can update a data point as many times as
+    # desired, as long as the value of `Version` continuously increases.
+    #
+    # For example, suppose you write a new record without indicating
+    # `Version` in the request. Timestream will store this record, and set
+    # `Version` to `1`. Now, suppose you try to update this record with a
+    # `WriteRecords` request of the same record with a different measure
+    # value but, like before, do not provide `Version`. In this case,
+    # Timestream will reject this update with a `RejectedRecordsException`
+    # since the updated record’s version is not greater than the existing
+    # value of Version. However, if you were to resend the update request
+    # with `Version` set to `2`, Timestream would then succeed in updating
+    # the record’s value, and the `Version` would be set to `2`. Next,
+    # suppose you sent a `WriteRecords` request with this same record and an
+    # identical measure value, but with `Version` set to `3`. In this case,
+    # Timestream would only update `Version` to `3`. Any further updates
+    # would need to send a version number greater than `3`, or the update
+    # requests would receive a `RejectedRecordsException`.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html
+    # [2]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html
     #
     # @option params [required, String] :database_name
     #   The name of the Timestream database.
     #
     # @option params [required, String] :table_name
-    #   The name of the Timesream table.
+    #   The name of the Timestream table.
     #
     # @option params [Types::Record] :common_attributes
-    #   A record containing the common measure and dimension attributes shared
-    #   across all the records in the request. The measure and dimension
-    #   attributes specified in here will be merged with the measure and
+    #   A record containing the common measure, dimension, time, and version
+    #   attributes shared across all the records in the request. The measure
+    #   and dimension attributes specified will be merged with the measure and
     #   dimension attributes in the records object when the data is written
-    #   into Timestream.
+    #   into Timestream. Dimensions may not overlap, or a
+    #   `ValidationException` will be thrown. In other words, a record must
+    #   contain dimensions with unique names.
     #
     # @option params [required, Array<Types::Record>] :records
-    #   An array of records containing the unique dimension and measure
-    #   attributes for each time series data point.
+    #   An array of records containing the unique measure, dimension, time,
+    #   and version attributes for each time series data point.
     #
-    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    # @return [Types::WriteRecordsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::WriteRecordsResponse#records_ingested #records_ingested} => Types::RecordsIngested
     #
     # @example Request syntax with placeholder values
     #
@@ -1013,37 +1149,57 @@ module Aws::TimestreamWrite
     #     common_attributes: {
     #       dimensions: [
     #         {
-    #           name: "StringValue256", # required
-    #           value: "StringValue2048", # required
+    #           name: "SchemaName", # required
+    #           value: "SchemaValue", # required
     #           dimension_value_type: "VARCHAR", # accepts VARCHAR
     #         },
     #       ],
-    #       measure_name: "StringValue256",
+    #       measure_name: "SchemaName",
     #       measure_value: "StringValue2048",
-    #       measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN
+    #       measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
     #       time: "StringValue256",
     #       time_unit: "MILLISECONDS", # accepts MILLISECONDS, SECONDS, MICROSECONDS, NANOSECONDS
     #       version: 1,
+    #       measure_values: [
+    #         {
+    #           name: "SchemaName", # required
+    #           value: "StringValue2048", # required
+    #           type: "DOUBLE", # required, accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
+    #         },
+    #       ],
     #     },
     #     records: [ # required
     #       {
     #         dimensions: [
     #           {
-    #             name: "StringValue256", # required
-    #             value: "StringValue2048", # required
+    #             name: "SchemaName", # required
+    #             value: "SchemaValue", # required
     #             dimension_value_type: "VARCHAR", # accepts VARCHAR
     #           },
     #         ],
-    #         measure_name: "StringValue256",
+    #         measure_name: "SchemaName",
     #         measure_value: "StringValue2048",
-    #         measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN
+    #         measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
     #         time: "StringValue256",
     #         time_unit: "MILLISECONDS", # accepts MILLISECONDS, SECONDS, MICROSECONDS, NANOSECONDS
     #         version: 1,
+    #         measure_values: [
+    #           {
+    #             name: "SchemaName", # required
+    #             value: "StringValue2048", # required
+    #             type: "DOUBLE", # required, accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
+    #           },
+    #         ],
     #       },
     #     ],
     #   })
     #
+    # @example Response structure
+    #
+    #   resp.records_ingested.total #=> Integer
+    #   resp.records_ingested.memory_store #=> Integer
+    #   resp.records_ingested.magnetic_store #=> Integer
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/WriteRecords AWS API Documentation
     #
     # @overload write_records(params = {})
@@ -1066,7 +1222,7 @@ module Aws::TimestreamWrite
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-timestreamwrite'
-      context[:gem_version] = '1.8.0'
+      context[:gem_version] = '1.12.0'
       Seahorse::Client::Request.new(handlers, context)
     end