AWS IoT Update: This release adds a batchMode parameter to the IotEvents, IotAnalytics, and Firehose actions which allows customers to send an array of messages to the corresponding services

Author: AWS

.changes/next-release/feature-AWSIoT-90ab102.json

@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "AWS IoT",
+    "contributor": "",
+    "description": "This release adds a batchMode parameter to the IotEvents, IotAnalytics, and Firehose actions which allows customers to send an array of messages to the corresponding services"
+}

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

@@ -4933,6 +4933,7 @@
       "documentation":"<p>Specifies the amount of time each device has to finish its execution of the job. A timer is started when the job execution status is set to <code>IN_PROGRESS</code>. If the job execution status is not set to another terminal state before the timer expires, it will be automatically set to <code>TIMED_OUT</code>.</p>"
     },
     "AwsJobTimeoutInProgressTimeoutInMinutes":{"type":"long"},
+    "BatchMode":{"type":"boolean"},
     "Behavior":{
       "type":"structure",
       "required":["name"],
@@ -9082,6 +9083,10 @@
         "separator":{
           "shape":"FirehoseSeparator",
           "documentation":"<p>A character separator that will be used to separate records written to the Firehose stream. Valid values are: '\\n' (newline), '\\t' (tab), '\\r\\n' (Windows newline), ',' (comma).</p>"
+        },
+        "batchMode":{
+          "shape":"BatchMode",
+          "documentation":"<p>Whether to deliver the Kinesis Data Firehose stream as a batch by using <a href=\"https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html\"> <code>PutRecordBatch</code> </a>. The default value is <code>false</code>.</p> <p>When <code>batchMode</code> is <code>true</code> and the rule's SQL statement evaluates to an Array, each Array element forms one record in the <a href=\"https://docs.aws.amazon.com/firehose/latest/APIReference/API_PutRecordBatch.html\"> <code>PutRecordBatch</code> </a> request. The resulting array can't have more than 500 records.</p>"
         }
       },
       "documentation":"<p>Describes an action that writes data to an Amazon Kinesis Firehose stream.</p>"
@@ -9789,6 +9794,10 @@
           "shape":"ChannelName",
           "documentation":"<p>The name of the IoT Analytics channel to which message data will be sent.</p>"
         },
+        "batchMode":{
+          "shape":"BatchMode",
+          "documentation":"<p>Whether to process the action as a batch. The default value is <code>false</code>.</p> <p>When <code>batchMode</code> is <code>true</code> and the rule SQL statement evaluates to an Array, each Array element is delivered as a separate message when passed by <a href=\"https://docs.aws.amazon.com/iotanalytics/latest/APIReference/API_BatchPutMessage.html\"> <code>BatchPutMessage</code> </a> to the AWS IoT Analytics channel. The resulting array can't have more than 100 messages.</p>"
+        },
         "roleArn":{
           "shape":"AwsArn",
           "documentation":"<p>The ARN of the role which has a policy that grants IoT Analytics permission to send message data via IoT Analytics (iotanalytics:BatchPutMessage).</p>"
@@ -9809,7 +9818,11 @@
         },
         "messageId":{
           "shape":"MessageId",
-          "documentation":"<p>[Optional] Use this to ensure that only one input (message) with a given messageId will be processed by an AWS IoT Events detector.</p>"
+          "documentation":"<p>The ID of the message. The default <code>messageId</code> is a new UUID value.</p> <p>When <code>batchMode</code> is <code>true</code>, you can't specify a <code>messageId</code>--a new UUID value will be assigned.</p> <p>Assign a value to this property to ensure that only one input (message) with a given <code>messageId</code> will be processed by an AWS IoT Events detector.</p>"
+        },
+        "batchMode":{
+          "shape":"BatchMode",
+          "documentation":"<p>Whether to process the event actions as a batch. The default value is <code>false</code>.</p> <p>When <code>batchMode</code> is <code>true</code>, you can't specify a <code>messageId</code>. </p> <p>When <code>batchMode</code> is <code>true</code> and the rule SQL statement evaluates to an Array, each Array element is treated as a separate message when it's sent to AWS IoT Events by calling <a href=\"https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchPutMessage.html\"> <code>BatchPutMessage</code> </a>. The resulting array can't have more than 10 messages.</p>"
         },
         "roleArn":{
           "shape":"AwsArn",
@@ -13724,7 +13737,7 @@
         },
         "key":{
           "shape":"Key",
-          "documentation":"<p>The object key.</p>"
+          "documentation":"<p>The object key. For more information, see <a href=\"https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html\">Actions, resources, and condition keys for Amazon S3</a>.</p>"
         },
         "cannedAcl":{
           "shape":"CannedAccessControlList",
@@ -14141,7 +14154,7 @@
           "documentation":"<p>The ARN of the signing role.</p>"
         }
       },
-      "documentation":"<p>Use Sig V4 authorization.</p>"
+      "documentation":"<p>For more information, see <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Signature Version 4 signing process</a>.</p>"
     },
     "Signature":{"type":"blob"},
     "SignatureAlgorithm":{"type":"string"},