Amazon Timestream Write Update: Adds support of upserts for idempotent updates to Timestream.

Author: AWS

.changes/next-release/feature-AmazonTimestreamWrite-8adb878.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "Amazon Timestream Write",
+    "contributor": "",
+    "description": "Adds support of upserts for idempotent updates to Timestream."
+}

services/timestreamwrite/src/main/resources/codegen-resources/service-2.json

@@ -70,7 +70,7 @@
         {"shape":"AccessDeniedException"},
         {"shape":"InvalidEndpointException"}
       ],
-      "documentation":"<p>Deletes a given Timestream database. <i>This is an irreversible operation. 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. </p>",
+      "documentation":"<p>Deletes a given Timestream database. <i>This is an irreversible operation. 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. </p> <p>Due to the nature of distributed retries, the operation can return either success or a ResourceNotFoundException. Clients should consider them equivalent.</p>",
       "endpointdiscovery":{"required":true}
     },
     "DeleteTable":{
@@ -88,7 +88,7 @@
         {"shape":"AccessDeniedException"},
         {"shape":"InvalidEndpointException"}
       ],
-      "documentation":"<p>Deletes a given Timestream table. This is an irreversible operation. After a Timestream database table is deleted, the time series data stored in the table cannot be recovered. </p>",
+      "documentation":"<p>Deletes a given Timestream table. This is an irreversible operation. 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, the operation can return either success or a ResourceNotFoundException. Clients should consider them equivalent.</p>",
       "endpointdiscovery":{"required":true}
     },
     "DescribeDatabase":{
@@ -192,6 +192,7 @@
       "output":{"shape":"ListTagsForResourceResponse"},
       "errors":[
         {"shape":"ResourceNotFoundException"},
+        {"shape":"ThrottlingException"},
         {"shape":"ValidationException"},
         {"shape":"InvalidEndpointException"}
       ],
@@ -209,6 +210,7 @@
       "errors":[
         {"shape":"ResourceNotFoundException"},
         {"shape":"ServiceQuotaExceededException"},
+        {"shape":"ThrottlingException"},
         {"shape":"ValidationException"},
         {"shape":"InvalidEndpointException"}
       ],
@@ -226,6 +228,7 @@
       "errors":[
         {"shape":"ValidationException"},
         {"shape":"ServiceQuotaExceededException"},
+        {"shape":"ThrottlingException"},
         {"shape":"ResourceNotFoundException"},
         {"shape":"InvalidEndpointException"}
       ],
@@ -507,7 +510,7 @@
       "members":{
         "Name":{
           "shape":"StringValue256",
-          "documentation":"<p> Dimension represents the meta data attributes of the time series. For example, the name and availability zone of an EC2 instance or the name of the manufacturer of a wind turbine are dimensions. <i>Dimension names can only contain alphanumeric characters and underscores. Dimension names cannot end with an underscore.</i> </p>"
+          "documentation":"<p> Dimension represents the meta data attributes of the time series. For example, the name and availability zone of an EC2 instance or the name of the manufacturer of a wind turbine are dimensions. </p> <p>For constraints on Dimension names, see <a href=\"https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming\">Naming Constraints</a>.</p>"
         },
         "Value":{
           "shape":"StringValue2048",
@@ -692,16 +695,22 @@
         },
         "Time":{
           "shape":"StringValue256",
-          "documentation":"<p> Contains the time at which the measure value for the data point was collected. </p>"
+          "documentation":"<p> Contains the time at which the measure value for the data point was collected. The time value plus the unit provides the time elapsed since the epoch. For example, if the time value is <code>12345</code> and the unit is <code>ms</code>, then <code>12345 ms</code> have elapsed since the epoch. </p>"
         },
         "TimeUnit":{
           "shape":"TimeUnit",
           "documentation":"<p> The granularity of the timestamp unit. It indicates if the time value is in seconds, milliseconds, nanoseconds or other supported values. </p>"
+        },
+        "Version":{
+          "shape":"RecordVersion",
+          "documentation":"<p>64-bit attribute used for record updates. Write requests for duplicate data with a higher version number will update the existing measure value and version. In cases where the measure value is the same, <code>Version</code> will still be updated . Default value is to 1.</p>",
+          "box":true
         }
       },
       "documentation":"<p>Record represents a time series data point being written into Timestream. Each record contains an array of dimensions. Dimensions represent the meta data attributes of a time series data point such as the instance name or availability zone of an EC2 instance. A record also contains the measure name which is the name of the measure being collected for example the CPU utilization of an EC2 instance. A record also contains the measure value and the value type which is the data type of the measure value. In addition, the record contains the timestamp when the measure was collected that the timestamp unit which represents the granularity of the timestamp. </p>"
     },
     "RecordIndex":{"type":"integer"},
+    "RecordVersion":{"type":"long"},
     "Records":{
       "type":"list",
       "member":{"shape":"Record"},
@@ -717,7 +726,12 @@
         },
         "Reason":{
           "shape":"ErrorMessage",
-          "documentation":"<p> The reason why a record was not successfully inserted into Timestream. Possible causes of failure include: </p> <ul> <li> <p> Records with duplicate data where there are multiple records with the same dimensions, timestamps, and measure names but different measure values. </p> </li> <li> <p> Records with timestamps that lie outside the retention duration of the memory store </p> </li> <li> <p> Records with dimensions or measures that exceed the Timestream defined limits. </p> </li> </ul> <p> 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>"
+          "documentation":"<p> The reason why a record was not successfully inserted into Timestream. Possible causes of failure include: </p> <ul> <li> <p> Records with duplicate data where there are multiple records with the same dimensions, timestamps, and measure names but different measure values. </p> </li> <li> <p> Records with timestamps that lie outside the retention duration of the memory store </p> <note> <p>When the retention window is updated, you will receive a <code>RejectedRecords</code> exception if you immediately try to ingest data within the new window. To avoid a <code>RejectedRecords</code> exception, wait until the duration of the new window to ingest new data. For further information, see <a href=\"https://docs.aws.amazon.com/timestream/latest/developerguide/best-practices.html#configuration\"> Best Practices for Configuring Timestream</a> and <a href=\"https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html\">the explanation of how storage works in Timestream</a>.</p> </note> </li> <li> <p> Records with dimensions or measures that exceed the Timestream defined limits. </p> </li> </ul> <p> 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>"
+        },
+        "ExistingVersion":{
+          "shape":"RecordVersion",
+          "documentation":"<p>The existing version of the record. This value is populated in scenarios where an identical record exists with a higher version than the version in the write request.</p>",
+          "box":true
         }
       },
       "documentation":"<p> Records that were not successfully inserted into Timestream due to data validation issues that must be resolved prior to reinserting time series data into the system. </p>"