aws-sdk-timestreamwrite 1.16.0 → 1.17.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 533d244536b4849c1f70f990ebcb131d14ffba6bcfb5be44a0ee4b6af4033c05
-  data.tar.gz: d8a3a9565744e2fbb86629c5be97bf9a88f150cf57ef2c4ee3648c1b566d87d8
+  metadata.gz: 5c2c6cfd35217c1d3d2b03c5524452d8acf0f432fe322fde8002bf4037d4bd7f
+  data.tar.gz: 30b852d39cd4bc76b5c950fba1b0585768802d7167d45ce1a534398727bf7325
 SHA512:
-  metadata.gz: 6565ada6da2f67162fac839376bde5d1588e93b4ab2919e3b126382be143a2b3b7b453b8fceda3a3209698befee5845c51ccb35feb0dd8c389ee95ae9522f310
-  data.tar.gz: c3316d33266829587cdb5c0b8e5196f28003ca198902301fb30664ba62bddca37229e8cd6b2469395982c98bb5ed3fc952baa082656dd99b8ca2ddcd643f3e2d
+  metadata.gz: 75d2a9c987e54b7620cade87544d24a029311ed39695e1d31af1740bacc0970f3079bfa421c9eae26dd109ea5a89c8c3fe7e6a13eaa888e1a2da524574341484
+  data.tar.gz: 75bcefa689a228551a597f85fc4437346b1a7ae64ea6aadf8ecb1618e9603098a59452544617188671ded47fdcf8cf2ddf446e8e84b766b21ae7afa60853fb23

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.17.0 (2023-02-27)
+------------------
+
+* Feature - This release adds the ability to ingest batched historical data or migrate data in bulk from S3 into Timestream using CSV files.
+
 1.16.0 (2023-01-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.16.0
+1.17.0

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

@@ -378,11 +378,139 @@ module Aws::TimestreamWrite
 
     # @!group API Operations
 
+    # Creates a new Timestream batch load task. A batch load task processes
+    # data from a CSV source in an S3 location and writes to a Timestream
+    # table. A mapping from source to target is defined in a batch load
+    # task. Errors and events are written to a report at an S3 location. For
+    # the report, if the KMS key is not specified, the batch load task will
+    # be encrypted with a Timestream managed KMS key located in your
+    # account. For more information, see [Amazon Web Services managed
+    # keys][1]. [Service quotas apply][2]. For details, see [code
+    # sample][3].
+    #
+    #
+    #
+    # [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-batch-load.html
+    #
+    # @option params [String] :client_token
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.**
+    #
+    # @option params [Types::DataModelConfiguration] :data_model_configuration
+    #
+    # @option params [required, Types::DataSourceConfiguration] :data_source_configuration
+    #   Defines configuration details about the data source for a batch load
+    #   task.
+    #
+    # @option params [required, Types::ReportConfiguration] :report_configuration
+    #   Report configuration for a batch load task. This contains details
+    #   about where error reports are stored.
+    #
+    # @option params [required, String] :target_database_name
+    #   Target Timestream database for a batch load task.
+    #
+    # @option params [required, String] :target_table_name
+    #   Target Timestream table for a batch load task.
+    #
+    # @option params [Integer] :record_version
+    #
+    # @return [Types::CreateBatchLoadTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateBatchLoadTaskResponse#task_id #task_id} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_batch_load_task({
+    #     client_token: "ClientRequestToken",
+    #     data_model_configuration: {
+    #       data_model: {
+    #         time_column: "StringValue256",
+    #         time_unit: "MILLISECONDS", # accepts MILLISECONDS, SECONDS, MICROSECONDS, NANOSECONDS
+    #         dimension_mappings: [ # required
+    #           {
+    #             source_column: "SchemaName",
+    #             destination_column: "SchemaName",
+    #           },
+    #         ],
+    #         multi_measure_mappings: {
+    #           target_multi_measure_name: "SchemaName",
+    #           multi_measure_attribute_mappings: [ # required
+    #             {
+    #               source_column: "SchemaName", # required
+    #               target_multi_measure_attribute_name: "SchemaName",
+    #               measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, BOOLEAN, VARCHAR, TIMESTAMP
+    #             },
+    #           ],
+    #         },
+    #         mixed_measure_mappings: [
+    #           {
+    #             measure_name: "SchemaName",
+    #             source_column: "SchemaName",
+    #             target_measure_name: "SchemaName",
+    #             measure_value_type: "DOUBLE", # required, accepts DOUBLE, BIGINT, VARCHAR, BOOLEAN, TIMESTAMP, MULTI
+    #             multi_measure_attribute_mappings: [
+    #               {
+    #                 source_column: "SchemaName", # required
+    #                 target_multi_measure_attribute_name: "SchemaName",
+    #                 measure_value_type: "DOUBLE", # accepts DOUBLE, BIGINT, BOOLEAN, VARCHAR, TIMESTAMP
+    #               },
+    #             ],
+    #           },
+    #         ],
+    #         measure_name_column: "StringValue256",
+    #       },
+    #       data_model_s3_configuration: {
+    #         bucket_name: "S3BucketName",
+    #         object_key: "S3ObjectKey",
+    #       },
+    #     },
+    #     data_source_configuration: { # required
+    #       data_source_s3_configuration: { # required
+    #         bucket_name: "S3BucketName", # required
+    #         object_key_prefix: "S3ObjectKey",
+    #       },
+    #       csv_configuration: {
+    #         column_separator: "StringValue1",
+    #         escape_char: "StringValue1",
+    #         quote_char: "StringValue1",
+    #         null_value: "StringValue256",
+    #         trim_white_space: false,
+    #       },
+    #       data_format: "CSV", # required, accepts CSV
+    #     },
+    #     report_configuration: { # required
+    #       report_s3_configuration: {
+    #         bucket_name: "S3BucketName", # required
+    #         object_key_prefix: "S3ObjectKeyPrefix",
+    #         encryption_option: "SSE_S3", # accepts SSE_S3, SSE_KMS
+    #         kms_key_id: "StringValue2048",
+    #       },
+    #     },
+    #     target_database_name: "ResourceCreateAPIName", # required
+    #     target_table_name: "ResourceCreateAPIName", # required
+    #     record_version: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.task_id #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/CreateBatchLoadTask AWS API Documentation
+    #
+    # @overload create_batch_load_task(params = {})
+    # @param [Hash] params ({})
+    def create_batch_load_task(params = {}, options = {})
+      req = build_request(:create_batch_load_task, params)
+      req.send_request(options)
+    end
+
     # 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 [Amazon Web Services managed KMS
-    # keys][1] for more info. [Service quotas apply][2]. See [code
-    # sample][3] for details.
+    # located in your account. For more information, see [Amazon Web
+    # Services managed keys][1]. [Service quotas apply][2]. For details, see
+    # [code sample][3].
     #
     #
     #
@@ -396,8 +524,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 [Amazon Web Services managed KMS keys][1]
-    #   for more info.
+    #   in your account. For more information, see [Amazon Web Services
+    #   managed keys][1].
     #
     #
     #
@@ -441,13 +569,13 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
-    # The CreateTable operation adds a new table to an existing database in
-    # 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.
+    # Adds a new table to an existing database in 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 might 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.
     #
     #
     #
@@ -461,7 +589,7 @@ module Aws::TimestreamWrite
     #   The name of the Timestream table.
     #
     # @option params [Types::RetentionProperties] :retention_properties
-    #   The duration for which your time series data must be stored in the
+    #   The duration for which your time-series data must be stored in the
     #   memory store and the magnetic store.
     #
     # @option params [Array<Types::Tag>] :tags
@@ -508,7 +636,7 @@ module Aws::TimestreamWrite
     #   resp.table.arn #=> String
     #   resp.table.table_name #=> String
     #   resp.table.database_name #=> String
-    #   resp.table.table_status #=> String, one of "ACTIVE", "DELETING"
+    #   resp.table.table_status #=> String, one of "ACTIVE", "DELETING", "RESTORING"
     #   resp.table.retention_properties.memory_store_retention_period_in_hours #=> Integer
     #   resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.table.creation_time #=> Time
@@ -529,7 +657,7 @@ module Aws::TimestreamWrite
     end
 
     # Deletes a given Timestream database. *This is an irreversible
-    # operation. After a database is deleted, the time series data from its
+    # operation. After a database is deleted, the time-series data from its
     # tables cannot be recovered.*
     #
     # <note markdown="1"> All tables in the database must be deleted first, or a
@@ -568,7 +696,7 @@ module Aws::TimestreamWrite
     end
 
     # Deletes a given Timestream table. This is an irreversible operation.
-    # After a Timestream database table is deleted, the time series data
+    # After a Timestream database table is deleted, the time-series data
     # stored in the table cannot be recovered.
     #
     # <note markdown="1"> Due to the nature of distributed retries, the operation can return
@@ -608,6 +736,89 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
+    # Returns information about the batch load task, including
+    # configurations, mappings, progress, and other details. [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-batch-load.html
+    #
+    # @option params [required, String] :task_id
+    #   The ID of the batch load task.
+    #
+    # @return [Types::DescribeBatchLoadTaskResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeBatchLoadTaskResponse#batch_load_task_description #batch_load_task_description} => Types::BatchLoadTaskDescription
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_batch_load_task({
+    #     task_id: "BatchLoadTaskId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.batch_load_task_description.task_id #=> String
+    #   resp.batch_load_task_description.error_message #=> String
+    #   resp.batch_load_task_description.data_source_configuration.data_source_s3_configuration.bucket_name #=> String
+    #   resp.batch_load_task_description.data_source_configuration.data_source_s3_configuration.object_key_prefix #=> String
+    #   resp.batch_load_task_description.data_source_configuration.csv_configuration.column_separator #=> String
+    #   resp.batch_load_task_description.data_source_configuration.csv_configuration.escape_char #=> String
+    #   resp.batch_load_task_description.data_source_configuration.csv_configuration.quote_char #=> String
+    #   resp.batch_load_task_description.data_source_configuration.csv_configuration.null_value #=> String
+    #   resp.batch_load_task_description.data_source_configuration.csv_configuration.trim_white_space #=> Boolean
+    #   resp.batch_load_task_description.data_source_configuration.data_format #=> String, one of "CSV"
+    #   resp.batch_load_task_description.progress_report.records_processed #=> Integer
+    #   resp.batch_load_task_description.progress_report.records_ingested #=> Integer
+    #   resp.batch_load_task_description.progress_report.parse_failures #=> Integer
+    #   resp.batch_load_task_description.progress_report.record_ingestion_failures #=> Integer
+    #   resp.batch_load_task_description.progress_report.file_failures #=> Integer
+    #   resp.batch_load_task_description.progress_report.bytes_metered #=> Integer
+    #   resp.batch_load_task_description.report_configuration.report_s3_configuration.bucket_name #=> String
+    #   resp.batch_load_task_description.report_configuration.report_s3_configuration.object_key_prefix #=> String
+    #   resp.batch_load_task_description.report_configuration.report_s3_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS"
+    #   resp.batch_load_task_description.report_configuration.report_s3_configuration.kms_key_id #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.time_column #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.time_unit #=> String, one of "MILLISECONDS", "SECONDS", "MICROSECONDS", "NANOSECONDS"
+    #   resp.batch_load_task_description.data_model_configuration.data_model.dimension_mappings #=> Array
+    #   resp.batch_load_task_description.data_model_configuration.data_model.dimension_mappings[0].source_column #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.dimension_mappings[0].destination_column #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.multi_measure_mappings.target_multi_measure_name #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.multi_measure_mappings.multi_measure_attribute_mappings #=> Array
+    #   resp.batch_load_task_description.data_model_configuration.data_model.multi_measure_mappings.multi_measure_attribute_mappings[0].source_column #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.multi_measure_mappings.multi_measure_attribute_mappings[0].target_multi_measure_attribute_name #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.multi_measure_mappings.multi_measure_attribute_mappings[0].measure_value_type #=> String, one of "DOUBLE", "BIGINT", "BOOLEAN", "VARCHAR", "TIMESTAMP"
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings #=> Array
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].measure_name #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].source_column #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].target_measure_name #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].measure_value_type #=> String, one of "DOUBLE", "BIGINT", "VARCHAR", "BOOLEAN", "TIMESTAMP", "MULTI"
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].multi_measure_attribute_mappings #=> Array
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].multi_measure_attribute_mappings[0].source_column #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].multi_measure_attribute_mappings[0].target_multi_measure_attribute_name #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model.mixed_measure_mappings[0].multi_measure_attribute_mappings[0].measure_value_type #=> String, one of "DOUBLE", "BIGINT", "BOOLEAN", "VARCHAR", "TIMESTAMP"
+    #   resp.batch_load_task_description.data_model_configuration.data_model.measure_name_column #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model_s3_configuration.bucket_name #=> String
+    #   resp.batch_load_task_description.data_model_configuration.data_model_s3_configuration.object_key #=> String
+    #   resp.batch_load_task_description.target_database_name #=> String
+    #   resp.batch_load_task_description.target_table_name #=> String
+    #   resp.batch_load_task_description.task_status #=> String, one of "CREATED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "PROGRESS_STOPPED", "PENDING_RESUME"
+    #   resp.batch_load_task_description.record_version #=> Integer
+    #   resp.batch_load_task_description.creation_time #=> Time
+    #   resp.batch_load_task_description.last_updated_time #=> Time
+    #   resp.batch_load_task_description.resumable_until #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/DescribeBatchLoadTask AWS API Documentation
+    #
+    # @overload describe_batch_load_task(params = {})
+    # @param [Hash] params ({})
+    def describe_batch_load_task(params = {}, options = {})
+      req = build_request(:describe_batch_load_task, params)
+      req.send_request(options)
+    end
+
     # 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][1]. See [code
@@ -649,14 +860,14 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
-    # DescribeEndpoints returns a list of available endpoints to make
-    # Timestream API calls against. This API is available through both Write
-    # and Query.
+    # Returns a list of available endpoints to make Timestream API calls
+    # against. This API operation is available through both the Write and
+    # Query APIs.
     #
     # 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*\:
+    # the service endpoints, *we don't recommend that you use this API
+    # operation unless*\:
     #
     # * You are using [VPC endpoints (Amazon Web Services PrivateLink) with
     #   Timestream][1]
@@ -724,7 +935,7 @@ module Aws::TimestreamWrite
     #   resp.table.arn #=> String
     #   resp.table.table_name #=> String
     #   resp.table.database_name #=> String
-    #   resp.table.table_status #=> String, one of "ACTIVE", "DELETING"
+    #   resp.table.table_status #=> String, one of "ACTIVE", "DELETING", "RESTORING"
     #   resp.table.retention_properties.memory_store_retention_period_in_hours #=> Integer
     #   resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.table.creation_time #=> Time
@@ -744,6 +955,63 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
+    # Provides a list of batch load tasks, along with the name, status, when
+    # the task is resumable until, and other details. See [code sample][1]
+    # for details.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html
+    #
+    # @option params [String] :next_token
+    #   A token to specify where to start paginating. This is the NextToken
+    #   from a previously truncated response.
+    #
+    # @option params [Integer] :max_results
+    #   The total number of items to return in the output. If the total number
+    #   of items available is more than the value specified, a NextToken is
+    #   provided in the output. To resume pagination, provide the NextToken
+    #   value as argument of a subsequent API invocation.
+    #
+    # @option params [String] :task_status
+    #   Status of the batch load task.
+    #
+    # @return [Types::ListBatchLoadTasksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListBatchLoadTasksResponse#next_token #next_token} => String
+    #   * {Types::ListBatchLoadTasksResponse#batch_load_tasks #batch_load_tasks} => Array&lt;Types::BatchLoadTask&gt;
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_batch_load_tasks({
+    #     next_token: "String",
+    #     max_results: 1,
+    #     task_status: "CREATED", # accepts CREATED, IN_PROGRESS, FAILED, SUCCEEDED, PROGRESS_STOPPED, PENDING_RESUME
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.next_token #=> String
+    #   resp.batch_load_tasks #=> Array
+    #   resp.batch_load_tasks[0].task_id #=> String
+    #   resp.batch_load_tasks[0].task_status #=> String, one of "CREATED", "IN_PROGRESS", "FAILED", "SUCCEEDED", "PROGRESS_STOPPED", "PENDING_RESUME"
+    #   resp.batch_load_tasks[0].database_name #=> String
+    #   resp.batch_load_tasks[0].table_name #=> String
+    #   resp.batch_load_tasks[0].creation_time #=> Time
+    #   resp.batch_load_tasks[0].last_updated_time #=> Time
+    #   resp.batch_load_tasks[0].resumable_until #=> Time
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ListBatchLoadTasks AWS API Documentation
+    #
+    # @overload list_batch_load_tasks(params = {})
+    # @param [Hash] params ({})
+    def list_batch_load_tasks(params = {}, options = {})
+      req = build_request(:list_batch_load_tasks, params)
+      req.send_request(options)
+    end
+
     # Returns a list of your Timestream databases. [Service quotas
     # apply][1]. See [code sample][2] for details.
     #
@@ -796,8 +1064,8 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
-    # A list of tables, along with the name, status and retention properties
-    # of each table. See [code sample][1] for details.
+    # Provides a list of tables, along with the name, status, and retention
+    # properties of each table. See [code sample][1] for details.
     #
     #
     #
@@ -837,7 +1105,7 @@ module Aws::TimestreamWrite
     #   resp.tables[0].arn #=> String
     #   resp.tables[0].table_name #=> String
     #   resp.tables[0].database_name #=> String
-    #   resp.tables[0].table_status #=> String, one of "ACTIVE", "DELETING"
+    #   resp.tables[0].table_status #=> String, one of "ACTIVE", "DELETING", "RESTORING"
     #   resp.tables[0].retention_properties.memory_store_retention_period_in_hours #=> Integer
     #   resp.tables[0].retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.tables[0].creation_time #=> Time
@@ -858,7 +1126,7 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
-    # List all tags on a Timestream resource.
+    # Lists all tags on a Timestream resource.
     #
     # @option params [required, String] :resource_arn
     #   The Timestream resource with tags to be listed. This value is an
@@ -889,7 +1157,27 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
-    # Associate a set of tags with a Timestream resource. You can then
+    # @option params [required, String] :task_id
+    #   The ID of the batch load task to resume.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.resume_batch_load_task({
+    #     task_id: "BatchLoadTaskId", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/timestream-write-2018-11-01/ResumeBatchLoadTask AWS API Documentation
+    #
+    # @overload resume_batch_load_task(params = {})
+    # @param [Hash] params ({})
+    def resume_batch_load_task(params = {}, options = {})
+      req = build_request(:resume_batch_load_task, params)
+      req.send_request(options)
+    end
+
+    # Associates a set of tags with a Timestream resource. You can then
     # activate these user-defined tags so that they appear on the Billing
     # and Cost Management console for cost allocation tracking.
     #
@@ -1070,7 +1358,7 @@ module Aws::TimestreamWrite
     #   resp.table.arn #=> String
     #   resp.table.table_name #=> String
     #   resp.table.database_name #=> String
-    #   resp.table.table_status #=> String, one of "ACTIVE", "DELETING"
+    #   resp.table.table_status #=> String, one of "ACTIVE", "DELETING", "RESTORING"
     #   resp.table.retention_properties.memory_store_retention_period_in_hours #=> Integer
     #   resp.table.retention_properties.magnetic_store_retention_period_in_days #=> Integer
     #   resp.table.creation_time #=> Time
@@ -1090,13 +1378,14 @@ module Aws::TimestreamWrite
       req.send_request(options)
     end
 
-    # The WriteRecords operation enables you to write your time series data
-    # into Timestream. You can specify a single data point or a batch of
-    # data points to be inserted into the system. Timestream offers you with
-    # a flexible schema that auto detects the column names and data types
-    # for your Timestream tables based on the dimension names and data types
-    # of the data points you specify when invoking writes into the database.
-    # Timestream support eventual consistency read semantics. This means
+    # Enables you to write your time-series data into Timestream. You can
+    # specify a single data point or a batch of data points to be inserted
+    # into the system. Timestream offers you a flexible schema that auto
+    # detects the column names and data types for your Timestream tables
+    # based on the dimension names and data types of the data points you
+    # specify when invoking writes into the database.
+    #
+    # Timestream supports eventual consistency read semantics. This means
     # that when you query data immediately after writing a batch of data
     # into Timestream, the query results might not reflect the results of a
     # recently completed write operation. The results may also include some
@@ -1109,30 +1398,32 @@ module Aws::TimestreamWrite
     #
     # 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.
+    # record. `Version` defaults to `1` when it's not specified for the
+    # record in the request. Timestream updates an existing record’s measure
+    # value along with its `Version` when it receives a write request with a
+    # higher `Version` number for that record. When it receives 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` in the request. Timestream stores 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`.
+    # 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`.
     #
     #
     #
@@ -1146,17 +1437,17 @@ module Aws::TimestreamWrite
     #   The name of the Timestream table.
     #
     # @option params [Types::Record] :common_attributes
-    #   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. Dimensions may not overlap, or a
+    #   A record that contains 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. 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 measure, dimension, time,
-    #   and version attributes for each time series data point.
+    #   An array of records that contain the unique measure, dimension, time,
+    #   and version attributes for each time-series data point.
     #
     # @return [Types::WriteRecordsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1243,7 +1534,7 @@ module Aws::TimestreamWrite
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-timestreamwrite'
-      context[:gem_version] = '1.16.0'
+      context[:gem_version] = '1.17.0'
       Seahorse::Client::Request.new(handlers, context)
     end