@aws-sdk/client-timestream-write 3.42.0 → 3.43.0

package/dist-types/TimestreamWrite.d.ts

@@ -16,26 +16,36 @@ import { UpdateTableCommandInput, UpdateTableCommandOutput } from "./commands/Up
 import { WriteRecordsCommandInput, WriteRecordsCommandOutput } from "./commands/WriteRecordsCommand";
 import { TimestreamWriteClient } from "./TimestreamWriteClient";
 /**
- * <p>Amazon Timestream is a fast, scalable, fully managed time series database service that makes it easy to store and analyze trillions of time series data points per day. With Timestream, you can easily store and analyze IoT sensor data to derive insights from your IoT applications. You can analyze industrial telemetry to streamline equipment management and maintenance. You can also store and analyze log data and metrics to improve the performance and availability of your applications. Timestream is built from the ground up to effectively ingest, process, and store time series data. It organizes data to optimize query processing. It automatically scales based on the volume of data ingested and on the query volume to ensure you receive optimal performance while inserting and querying data. As your data grows over time, Timestream’s adaptive query processing engine spans across storage tiers to provide fast analysis while reducing costs.</p>
+ * <fullname>Amazon Timestream Write</fullname>
+ *          <p>Amazon Timestream is a fast, scalable, fully managed time series database service that makes it easy to store and analyze trillions of time series data points per day.
+ *        With Timestream, you can easily store and analyze IoT sensor data to derive insights from your IoT applications.
+ *          You can analyze industrial telemetry to streamline equipment management and maintenance.
+ *          You can also store and analyze log data and metrics to improve the performance and availability of your applications.
+ *        Timestream is built from the ground up to effectively ingest, process,
+ *          and store time series data. It organizes data to optimize query processing. It automatically scales based on the volume of data ingested and on the query volume to ensure you receive optimal performance while inserting and querying data. As your data grows over time, Timestream’s adaptive query processing engine spans across storage tiers to provide fast analysis while reducing costs.</p>
  */
 export declare class TimestreamWrite extends TimestreamWriteClient {
     /**
-     * <p>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 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">AWS managed KMS keys</a> for more info.
-     *          Service quotas apply. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+     * <p>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 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed KMS keys</a> for more info.
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>.
+     *          See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html">code sample</a> for details.
      *       </p>
      */
     createDatabase(args: CreateDatabaseCommandInput, options?: __HttpHandlerOptions): Promise<CreateDatabaseCommandOutput>;
     createDatabase(args: CreateDatabaseCommandInput, cb: (err: any, data?: CreateDatabaseCommandOutput) => void): void;
     createDatabase(args: CreateDatabaseCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateDatabaseCommandOutput) => void): void;
     /**
-     * <p>The CreateTable operation adds a new table to an existing database in your account. In an AWS account,
+     * <p>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 seperate databases.
+     *       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. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a>
-     *          in the Timestream Developer Guide.
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>.
+     *          See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html">code sample</a> for details.
      *          </p>
      */
     createTable(args: CreateTableCommandInput, options?: __HttpHandlerOptions): Promise<CreateTableCommandOutput>;
@@ -46,11 +56,16 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
      *       After a database is deleted, the time series data from its tables cannot be recovered.</i>
      *          </p>
      *
-     *          <p>All tables in the database must be deleted first, or a ValidationException error will be thrown.
+     *          <note>
+     *             <p>All tables in the database must be deleted first, or a ValidationException error will be thrown.
      *       </p>
      *
-     *          <p>Due to the nature of distributed retries,
+     *             <p>Due to the nature of distributed retries,
      *          the operation can return either success or a ResourceNotFoundException. Clients should consider them equivalent.</p>
+     *          </note>
+     *
+     *          <p>See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html">code sample</a> for details.</p>
      */
     deleteDatabase(args: DeleteDatabaseCommandInput, options?: __HttpHandlerOptions): Promise<DeleteDatabaseCommandOutput>;
     deleteDatabase(args: DeleteDatabaseCommandInput, cb: (err: any, data?: DeleteDatabaseCommandOutput) => void): void;
@@ -60,8 +75,12 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
      *        After a Timestream database table is deleted, the time series data stored in
      *        the table cannot be recovered.
      *        </p>
-     *          <p>Due to the nature of distributed retries,
+     *          <note>
+     *             <p>Due to the nature of distributed retries,
      *          the operation can return either success or a ResourceNotFoundException. Clients should consider them equivalent.</p>
+     *          </note>
+     *          <p>See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html">code sample</a> for details.</p>
      */
     deleteTable(args: DeleteTableCommandInput, options?: __HttpHandlerOptions): Promise<DeleteTableCommandOutput>;
     deleteTable(args: DeleteTableCommandInput, cb: (err: any, data?: DeleteTableCommandOutput) => void): void;
@@ -69,26 +88,32 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
     /**
      * <p>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 <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.</p>
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html">code sample</a> for details.</p>
      */
     describeDatabase(args: DescribeDatabaseCommandInput, options?: __HttpHandlerOptions): Promise<DescribeDatabaseCommandOutput>;
     describeDatabase(args: DescribeDatabaseCommandInput, cb: (err: any, data?: DescribeDatabaseCommandOutput) => void): void;
     describeDatabase(args: DescribeDatabaseCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeDatabaseCommandOutput) => void): void;
     /**
-     * <p>DescribeEndpoints returns a list of available endpoints to make Timestream API calls against. This API is available through both Write and Query.</p>
-     *          <p>Because Timestream’s SDKs are designed to transparently work with the service’s architecture,
+     * <p>DescribeEndpoints returns a list of available endpoints to make Timestream API calls against.
+     *          This API is available through both Write and Query.</p>
+     *          <p>Because the Timestream SDKs are designed to transparently work with the service’s architecture,
      *          including the management and mapping of the service endpoints,
      *          <i>it is not recommended that you use this API unless</i>:</p>
      *          <ul>
      *             <li>
+     *                <p>You are using <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints">VPC endpoints (Amazon Web Services PrivateLink) with Timestream</a>
+     *                </p>
+     *             </li>
+     *             <li>
      *                <p>Your application uses a programming language that does not yet have SDK support</p>
      *             </li>
      *             <li>
      *                <p>You require better control over the client-side implementation</p>
      *             </li>
      *          </ul>
-     *          <p>For detailed information on how to use DescribeEndpoints,
-     *          see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/Using-API.endpoint-discovery.html">The Endpoint Discovery Pattern and REST APIs</a>.</p>
+     *          <p>For detailed information on how and when to use and implement DescribeEndpoints,
+     *          see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery">The Endpoint Discovery Pattern</a>.</p>
      */
     describeEndpoints(args: DescribeEndpointsCommandInput, options?: __HttpHandlerOptions): Promise<DescribeEndpointsCommandOutput>;
     describeEndpoints(args: DescribeEndpointsCommandInput, cb: (err: any, data?: DescribeEndpointsCommandOutput) => void): void;
@@ -96,7 +121,8 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
     /**
      * <p>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 <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html">code sample</a> for details.
      *       </p>
      */
     describeTable(args: DescribeTableCommandInput, options?: __HttpHandlerOptions): Promise<DescribeTableCommandOutput>;
@@ -104,7 +130,8 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
     describeTable(args: DescribeTableCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeTableCommandOutput) => void): void;
     /**
      * <p>Returns a list of your Timestream databases.
-     *          Service quotas apply. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html">code sample</a> for details.
      *       </p>
      */
     listDatabases(args: ListDatabasesCommandInput, options?: __HttpHandlerOptions): Promise<ListDatabasesCommandOutput>;
@@ -112,6 +139,8 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
     listDatabases(args: ListDatabasesCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListDatabasesCommandOutput) => void): void;
     /**
      * <p>A list of tables, along with the name, status and retention properties of each table.
+     *          See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html">code sample</a> for details.
      *       </p>
      */
     listTables(args: ListTablesCommandInput, options?: __HttpHandlerOptions): Promise<ListTablesCommandOutput>;
@@ -149,6 +178,8 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
      *     you must specify the database name and the identifier of the new KMS key to be used (<code>KmsKeyId</code>).
      *     If there are any concurrent <code>UpdateDatabase</code> requests, first writer wins.
      *    </p>
+     *          <p>See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html">code sample</a> for details.</p>
      */
     updateDatabase(args: UpdateDatabaseCommandInput, options?: __HttpHandlerOptions): Promise<UpdateDatabaseCommandOutput>;
     updateDatabase(args: UpdateDatabaseCommandInput, cb: (err: any, data?: UpdateDatabaseCommandOutput) => void): void;
@@ -160,7 +191,8 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
      *          the memory store will be capable of holding 24 hours of data, but will
      *          be populated with 24 hours of data 22 hours after this change was made.
      *          Timestream does not retrieve data from the magnetic store to populate the memory store. </p>
-     *          <p>Service quotas apply. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.</p>
+     *          <p>See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html">code sample</a> for details.</p>
      */
     updateTable(args: UpdateTableCommandInput, options?: __HttpHandlerOptions): Promise<UpdateTableCommandOutput>;
     updateTable(args: UpdateTableCommandInput, cb: (err: any, data?: UpdateTableCommandOutput) => void): void;
@@ -177,9 +209,39 @@ export declare class TimestreamWrite extends TimestreamWriteClient {
      *       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 <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>.
      *         </p>
+     *
+     *          <p>See
+     *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html">code sample</a> for details.</p>
+     *
+     *          <p>
+     *             <b>Upserts</b>
+     *          </p>
+     *
+     *          <p>You can use the <code>Version</code> parameter in a <code>WriteRecords</code> request to update data points.
+     *          Timestream tracks a version number with each record. <code>Version</code> defaults to <code>1</code> when not specified for the record in the request.
+     *          Timestream will update an existing record’s measure value along with its <code>Version</code> upon receiving a write request with a higher
+     *          <code>Version</code> 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 <code>Version</code>, if it is greater than the existing value of <code>Version</code>.
+     *          You can update a data point as many times as desired, as long as the value of <code>Version</code> continuously increases.
+     *       </p>
+     *          <p>
+     *          For example, suppose you write a new record without indicating <code>Version</code> in the request.
+     *          Timestream will store this record, and set <code>Version</code> to <code>1</code>.
+     *          Now, suppose you try to update this record with a <code>WriteRecords</code> request of the same record with a different measure value but,
+     *          like before, do not provide <code>Version</code>.
+     *          In this case, Timestream will reject this update with a <code>RejectedRecordsException</code> 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 <code>Version</code> set to <code>2</code>,
+     *          Timestream would then succeed in updating the record’s value,
+     *          and the <code>Version</code> would be set to <code>2</code>.
+     *          Next, suppose you sent a <code>WriteRecords</code> request with this same record and an identical measure value,
+     *          but with <code>Version</code> set to <code>3</code>.
+     *          In this case, Timestream would only update <code>Version</code> to <code>3</code>.
+     *          Any further updates would need to send a version number greater than <code>3</code>,
+     *          or the update requests would receive a <code>RejectedRecordsException</code>.
+     *       </p>
      */
     writeRecords(args: WriteRecordsCommandInput, options?: __HttpHandlerOptions): Promise<WriteRecordsCommandOutput>;
     writeRecords(args: WriteRecordsCommandInput, cb: (err: any, data?: WriteRecordsCommandOutput) => void): void;

package/dist-types/TimestreamWriteClient.d.ts

@@ -144,7 +144,13 @@ declare type TimestreamWriteClientResolvedConfigType = __SmithyResolvedConfigura
 export interface TimestreamWriteClientResolvedConfig extends TimestreamWriteClientResolvedConfigType {
 }
 /**
- * <p>Amazon Timestream is a fast, scalable, fully managed time series database service that makes it easy to store and analyze trillions of time series data points per day. With Timestream, you can easily store and analyze IoT sensor data to derive insights from your IoT applications. You can analyze industrial telemetry to streamline equipment management and maintenance. You can also store and analyze log data and metrics to improve the performance and availability of your applications. Timestream is built from the ground up to effectively ingest, process, and store time series data. It organizes data to optimize query processing. It automatically scales based on the volume of data ingested and on the query volume to ensure you receive optimal performance while inserting and querying data. As your data grows over time, Timestream’s adaptive query processing engine spans across storage tiers to provide fast analysis while reducing costs.</p>
+ * <fullname>Amazon Timestream Write</fullname>
+ *          <p>Amazon Timestream is a fast, scalable, fully managed time series database service that makes it easy to store and analyze trillions of time series data points per day.
+ *        With Timestream, you can easily store and analyze IoT sensor data to derive insights from your IoT applications.
+ *          You can analyze industrial telemetry to streamline equipment management and maintenance.
+ *          You can also store and analyze log data and metrics to improve the performance and availability of your applications.
+ *        Timestream is built from the ground up to effectively ingest, process,
+ *          and store time series data. It organizes data to optimize query processing. It automatically scales based on the volume of data ingested and on the query volume to ensure you receive optimal performance while inserting and querying data. As your data grows over time, Timestream’s adaptive query processing engine spans across storage tiers to provide fast analysis while reducing costs.</p>
  */
 export declare class TimestreamWriteClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, TimestreamWriteClientResolvedConfig> {
     /**

package/dist-types/commands/CreateDatabaseCommand.d.ts

@@ -7,9 +7,12 @@ export interface CreateDatabaseCommandInput extends CreateDatabaseRequest {
 export interface CreateDatabaseCommandOutput extends CreateDatabaseResponse, __MetadataBearer {
 }
 /**
- * <p>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 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">AWS managed KMS keys</a> for more info.
- *          Service quotas apply. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+ * <p>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 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed KMS keys</a> for more info.
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>.
+ *          See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html">code sample</a> for details.
  *       </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/CreateTableCommand.d.ts

@@ -7,13 +7,14 @@ export interface CreateTableCommandInput extends CreateTableRequest {
 export interface CreateTableCommandOutput extends CreateTableResponse, __MetadataBearer {
 }
 /**
- * <p>The CreateTable operation adds a new table to an existing database in your account. In an AWS account,
+ * <p>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 seperate databases.
+ *       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. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a>
- *          in the Timestream Developer Guide.
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>.
+ *          See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html">code sample</a> for details.
  *          </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/DeleteDatabaseCommand.d.ts

@@ -11,11 +11,16 @@ export interface DeleteDatabaseCommandOutput extends __MetadataBearer {
  *       After a database is deleted, the time series data from its tables cannot be recovered.</i>
  *          </p>
  *
- *          <p>All tables in the database must be deleted first, or a ValidationException error will be thrown.
+ *          <note>
+ *             <p>All tables in the database must be deleted first, or a ValidationException error will be thrown.
  *       </p>
  *
- *          <p>Due to the nature of distributed retries,
+ *             <p>Due to the nature of distributed retries,
  *          the operation can return either success or a ResourceNotFoundException. Clients should consider them equivalent.</p>
+ *          </note>
+ *
+ *          <p>See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html">code sample</a> for details.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteTableCommand.d.ts

@@ -11,8 +11,12 @@ export interface DeleteTableCommandOutput extends __MetadataBearer {
  *        After a Timestream database table is deleted, the time series data stored in
  *        the table cannot be recovered.
  *        </p>
- *          <p>Due to the nature of distributed retries,
+ *          <note>
+ *             <p>Due to the nature of distributed retries,
  *          the operation can return either success or a ResourceNotFoundException. Clients should consider them equivalent.</p>
+ *          </note>
+ *          <p>See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html">code sample</a> for details.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DescribeDatabaseCommand.d.ts

@@ -9,7 +9,8 @@ export interface DescribeDatabaseCommandOutput extends DescribeDatabaseResponse,
 /**
  * <p>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 <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.</p>
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html">code sample</a> for details.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DescribeEndpointsCommand.d.ts

@@ -7,20 +7,25 @@ export interface DescribeEndpointsCommandInput extends DescribeEndpointsRequest
 export interface DescribeEndpointsCommandOutput extends DescribeEndpointsResponse, __MetadataBearer {
 }
 /**
- * <p>DescribeEndpoints returns a list of available endpoints to make Timestream API calls against. This API is available through both Write and Query.</p>
- *          <p>Because Timestream’s SDKs are designed to transparently work with the service’s architecture,
+ * <p>DescribeEndpoints returns a list of available endpoints to make Timestream API calls against.
+ *          This API is available through both Write and Query.</p>
+ *          <p>Because the Timestream SDKs are designed to transparently work with the service’s architecture,
  *          including the management and mapping of the service endpoints,
  *          <i>it is not recommended that you use this API unless</i>:</p>
  *          <ul>
  *             <li>
+ *                <p>You are using <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints">VPC endpoints (Amazon Web Services PrivateLink) with Timestream</a>
+ *                </p>
+ *             </li>
+ *             <li>
  *                <p>Your application uses a programming language that does not yet have SDK support</p>
  *             </li>
  *             <li>
  *                <p>You require better control over the client-side implementation</p>
  *             </li>
  *          </ul>
- *          <p>For detailed information on how to use DescribeEndpoints,
- *          see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/Using-API.endpoint-discovery.html">The Endpoint Discovery Pattern and REST APIs</a>.</p>
+ *          <p>For detailed information on how and when to use and implement DescribeEndpoints,
+ *          see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery">The Endpoint Discovery Pattern</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DescribeTableCommand.d.ts

@@ -9,7 +9,8 @@ export interface DescribeTableCommandOutput extends DescribeTableResponse, __Met
 /**
  * <p>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 <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html">code sample</a> for details.
  *       </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/ListDatabasesCommand.d.ts

@@ -8,7 +8,8 @@ export interface ListDatabasesCommandOutput extends ListDatabasesResponse, __Met
 }
 /**
  * <p>Returns a list of your Timestream databases.
- *          Service quotas apply. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>. See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html">code sample</a> for details.
  *       </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/ListTablesCommand.d.ts

@@ -8,6 +8,8 @@ export interface ListTablesCommandOutput extends ListTablesResponse, __MetadataB
 }
 /**
  * <p>A list of tables, along with the name, status and retention properties of each table.
+ *          See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html">code sample</a> for details.
  *       </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/commands/UpdateDatabaseCommand.d.ts

@@ -12,6 +12,8 @@ export interface UpdateDatabaseCommandOutput extends UpdateDatabaseResponse, __M
  *     you must specify the database name and the identifier of the new KMS key to be used (<code>KmsKeyId</code>).
  *     If there are any concurrent <code>UpdateDatabase</code> requests, first writer wins.
  *    </p>
+ *          <p>See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html">code sample</a> for details.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateTableCommand.d.ts

@@ -13,7 +13,8 @@ export interface UpdateTableCommandOutput extends UpdateTableResponse, __Metadat
  *          the memory store will be capable of holding 24 hours of data, but will
  *          be populated with 24 hours of data 22 hours after this change was made.
  *          Timestream does not retrieve data from the magnetic store to populate the memory store. </p>
- *          <p>Service quotas apply. For more information, see <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.</p>
+ *          <p>See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html">code sample</a> for details.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/WriteRecordsCommand.d.ts

@@ -1,10 +1,10 @@
 import { Command as $Command } from "@aws-sdk/smithy-client";
 import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as __MetadataBearer, MiddlewareStack } from "@aws-sdk/types";
-import { WriteRecordsRequest } from "../models/models_0";
+import { WriteRecordsRequest, WriteRecordsResponse } from "../models/models_0";
 import { ServiceInputTypes, ServiceOutputTypes, TimestreamWriteClientResolvedConfig } from "../TimestreamWriteClient";
 export interface WriteRecordsCommandInput extends WriteRecordsRequest {
 }
-export interface WriteRecordsCommandOutput extends __MetadataBearer {
+export interface WriteRecordsCommandOutput extends WriteRecordsResponse, __MetadataBearer {
 }
 /**
  * <p>The WriteRecords operation enables you to write your time series
@@ -18,9 +18,39 @@ export interface WriteRecordsCommandOutput extends __MetadataBearer {
  *       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 <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Access Management</a> in the Timestream Developer Guide.
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html">Service quotas apply</a>.
  *         </p>
+ *
+ *          <p>See
+ *          <a href="https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html">code sample</a> for details.</p>
+ *
+ *          <p>
+ *             <b>Upserts</b>
+ *          </p>
+ *
+ *          <p>You can use the <code>Version</code> parameter in a <code>WriteRecords</code> request to update data points.
+ *          Timestream tracks a version number with each record. <code>Version</code> defaults to <code>1</code> when not specified for the record in the request.
+ *          Timestream will update an existing record’s measure value along with its <code>Version</code> upon receiving a write request with a higher
+ *          <code>Version</code> 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 <code>Version</code>, if it is greater than the existing value of <code>Version</code>.
+ *          You can update a data point as many times as desired, as long as the value of <code>Version</code> continuously increases.
+ *       </p>
+ *          <p>
+ *          For example, suppose you write a new record without indicating <code>Version</code> in the request.
+ *          Timestream will store this record, and set <code>Version</code> to <code>1</code>.
+ *          Now, suppose you try to update this record with a <code>WriteRecords</code> request of the same record with a different measure value but,
+ *          like before, do not provide <code>Version</code>.
+ *          In this case, Timestream will reject this update with a <code>RejectedRecordsException</code> 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 <code>Version</code> set to <code>2</code>,
+ *          Timestream would then succeed in updating the record’s value,
+ *          and the <code>Version</code> would be set to <code>2</code>.
+ *          Next, suppose you sent a <code>WriteRecords</code> request with this same record and an identical measure value,
+ *          but with <code>Version</code> set to <code>3</code>.
+ *          In this case, Timestream would only update <code>Version</code> to <code>3</code>.
+ *          Any further updates would need to send a version number greater than <code>3</code>,
+ *          or the update requests would receive a <code>RejectedRecordsException</code>.
+ *       </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript