Merge branch 'release-1.21.28'

* release-1.21.28: Bumping version to 1.21.28 Update to latest models
boto · Aug 24, 2021 · b132d93 · b132d93
2 parents b930ea5 + 1224e13
commit b132d93
Show file tree

Hide file tree

Showing 10 changed files with 540 additions and 71 deletions.
diff --git a/.changes/1.21.28.json b/.changes/1.21.28.json
@@ -0,0 +1,27 @@
+[
+  {
+    "category": "``mediaconvert``",
+    "description": "AWS Elemental MediaConvert SDK has added MBAFF encoding support for AVC video and the ability to pass encryption context from the job settings to S3.",
+    "type": "api-change"
+  },
+  {
+    "category": "``polly``",
+    "description": "Amazon Polly adds new New Zealand English voice - Aria. Aria is available as Neural voice only.",
+    "type": "api-change"
+  },
+  {
+    "category": "``transcribe``",
+    "description": "This release adds support for feature tagging with Amazon Transcribe batch jobs.",
+    "type": "api-change"
+  },
+  {
+    "category": "``ssm``",
+    "description": "Updated Parameter Store property for logging improvements.",
+    "type": "api-change"
+  },
+  {
+    "category": "``iot-data``",
+    "description": "Updated Publish with support for new Retain flag and added two new API operations: GetRetainedMessage, ListRetainedMessages.",
+    "type": "api-change"
+  }
+]
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -2,6 +2,16 @@
 CHANGELOG
 =========
 
+1.21.28
+=======
+
+* api-change:``mediaconvert``: AWS Elemental MediaConvert SDK has added MBAFF encoding support for AVC video and the ability to pass encryption context from the job settings to S3.
+* api-change:``polly``: Amazon Polly adds new New Zealand English voice - Aria. Aria is available as Neural voice only.
+* api-change:``transcribe``: This release adds support for feature tagging with Amazon Transcribe batch jobs.
+* api-change:``ssm``: Updated Parameter Store property for logging improvements.
+* api-change:``iot-data``: Updated Publish with support for new Retain flag and added two new API operations: GetRetainedMessage, ListRetainedMessages.
+
+
 1.21.27
 =======
 

diff --git a/botocore/__init__.py b/botocore/__init__.py
@@ -16,7 +16,7 @@
 import re
 import logging
 
-__version__ = '1.21.27'
+__version__ = '1.21.28'
 
 
 class NullHandler(logging.Handler):

diff --git a/botocore/data/iot-data/2015-05-28/paginators-1.json b/botocore/data/iot-data/2015-05-28/paginators-1.json
@@ -1,3 +1,10 @@
 {
-  "pagination": {}
+  "pagination": {
+    "ListRetainedMessages": {
+      "input_token": "nextToken",
+      "limit_key": "maxResults",
+      "output_token": "nextToken",
+      "result_key": "retainedTopics"
+    }
+  }
 }
diff --git a/botocore/data/iot-data/2015-05-28/service-2.json b/botocore/data/iot-data/2015-05-28/service-2.json
@@ -29,7 +29,26 @@
         {"shape":"MethodNotAllowedException"},
         {"shape":"UnsupportedDocumentEncodingException"}
       ],
-      "documentation":"<p>Deletes the shadow for the specified thing.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/API_DeleteThingShadow.html\">DeleteThingShadow</a> in the AWS IoT Developer Guide.</p>"
+      "documentation":"<p>Deletes the shadow for the specified thing.</p> <p>Requires permission to access the <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions\">DeleteThingShadow</a> action.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/API_DeleteThingShadow.html\">DeleteThingShadow</a> in the IoT Developer Guide.</p>"
+    },
+    "GetRetainedMessage":{
+      "name":"GetRetainedMessage",
+      "http":{
+        "method":"GET",
+        "requestUri":"/retainedMessage/{topic}"
+      },
+      "input":{"shape":"GetRetainedMessageRequest"},
+      "output":{"shape":"GetRetainedMessageResponse"},
+      "errors":[
+        {"shape":"InvalidRequestException"},
+        {"shape":"ResourceNotFoundException"},
+        {"shape":"ThrottlingException"},
+        {"shape":"UnauthorizedException"},
+        {"shape":"ServiceUnavailableException"},
+        {"shape":"InternalFailureException"},
+        {"shape":"MethodNotAllowedException"}
+      ],
+      "documentation":"<p>Gets the details of a single retained message for the specified topic.</p> <p>This action returns the message payload of the retained message, which can incur messaging costs. To list only the topic names of the retained messages, call <a href=\"/iot/latest/developerguide/API_iotdata_ListRetainedMessages.html\">ListRetainedMessages</a>.</p> <p>Requires permission to access the <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotfleethubfordevicemanagement.html#awsiotfleethubfordevicemanagement-actions-as-permissions\">GetRetainedMessage</a> action.</p> <p>For more information about messaging costs, see <a href=\"http://aws.amazon.com/iot-core/pricing/#Messaging\">IoT Core pricing - Messaging</a>.</p>"
     },
     "GetThingShadow":{
       "name":"GetThingShadow",
@@ -49,7 +68,7 @@
         {"shape":"MethodNotAllowedException"},
         {"shape":"UnsupportedDocumentEncodingException"}
       ],
-      "documentation":"<p>Gets the shadow for the specified thing.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/API_GetThingShadow.html\">GetThingShadow</a> in the AWS IoT Developer Guide.</p>"
+      "documentation":"<p>Gets the shadow for the specified thing.</p> <p>Requires permission to access the <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions\">GetThingShadow</a> action.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/API_GetThingShadow.html\">GetThingShadow</a> in the IoT Developer Guide.</p>"
     },
     "ListNamedShadowsForThing":{
       "name":"ListNamedShadowsForThing",
@@ -68,7 +87,25 @@
         {"shape":"InternalFailureException"},
         {"shape":"MethodNotAllowedException"}
       ],
-      "documentation":"<p>Lists the shadows for the specified thing.</p>"
+      "documentation":"<p>Lists the shadows for the specified thing.</p> <p>Requires permission to access the <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions\">ListNamedShadowsForThing</a> action.</p>"
+    },
+    "ListRetainedMessages":{
+      "name":"ListRetainedMessages",
+      "http":{
+        "method":"GET",
+        "requestUri":"/retainedMessage"
+      },
+      "input":{"shape":"ListRetainedMessagesRequest"},
+      "output":{"shape":"ListRetainedMessagesResponse"},
+      "errors":[
+        {"shape":"InvalidRequestException"},
+        {"shape":"ThrottlingException"},
+        {"shape":"UnauthorizedException"},
+        {"shape":"ServiceUnavailableException"},
+        {"shape":"InternalFailureException"},
+        {"shape":"MethodNotAllowedException"}
+      ],
+      "documentation":"<p>Lists summary information about the retained messages stored for the account.</p> <p>This action returns only the topic names of the retained messages. It doesn't return any message payloads. Although this action doesn't return a message payload, it can still incur messaging costs.</p> <p>To get the message payload of a retained message, call <a href=\"https://docs.aws.amazon.com/iot/latest/developerguide/API_iotdata_GetRetainedMessage.html\">GetRetainedMessage</a> with the topic name of the retained message.</p> <p>Requires permission to access the <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotfleethubfordevicemanagement.html#awsiotfleethubfordevicemanagement-actions-as-permissions\">ListRetainedMessages</a> action.</p> <p>For more information about messaging costs, see <a href=\"http://aws.amazon.com/iot-core/pricing/#Messaging\">IoT Core pricing - Messaging</a>.</p>"
     },
     "Publish":{
       "name":"Publish",
@@ -83,7 +120,7 @@
         {"shape":"UnauthorizedException"},
         {"shape":"MethodNotAllowedException"}
       ],
-      "documentation":"<p>Publishes state information.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/protocols.html#http\">HTTP Protocol</a> in the AWS IoT Developer Guide.</p>"
+      "documentation":"<p>Publishes an MQTT message.</p> <p>Requires permission to access the <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions\">Publish</a> action.</p> <p>For more information about MQTT messages, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/mqtt.html\">MQTT Protocol</a> in the IoT Developer Guide.</p> <p>For more information about messaging costs, see <a href=\"http://aws.amazon.com/iot-core/pricing/#Messaging\">IoT Core pricing - Messaging</a>.</p>"
     },
     "UpdateThingShadow":{
       "name":"UpdateThingShadow",
@@ -104,7 +141,7 @@
         {"shape":"MethodNotAllowedException"},
         {"shape":"UnsupportedDocumentEncodingException"}
       ],
-      "documentation":"<p>Updates the shadow for the specified thing.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/API_UpdateThingShadow.html\">UpdateThingShadow</a> in the AWS IoT Developer Guide.</p>"
+      "documentation":"<p>Updates the shadow for the specified thing.</p> <p>Requires permission to access the <a href=\"https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions\">UpdateThingShadow</a> action.</p> <p>For more information, see <a href=\"http://docs.aws.amazon.com/iot/latest/developerguide/API_UpdateThingShadow.html\">UpdateThingShadow</a> in the IoT Developer Guide.</p>"
     }
   },
   "shapes":{
@@ -151,6 +188,41 @@
       "documentation":"<p>The output from the DeleteThingShadow operation.</p>",
       "payload":"payload"
     },
+    "GetRetainedMessageRequest":{
+      "type":"structure",
+      "required":["topic"],
+      "members":{
+        "topic":{
+          "shape":"Topic",
+          "documentation":"<p>The topic name of the retained message to retrieve.</p>",
+          "location":"uri",
+          "locationName":"topic"
+        }
+      },
+      "documentation":"<p>The input for the GetRetainedMessage operation.</p>"
+    },
+    "GetRetainedMessageResponse":{
+      "type":"structure",
+      "members":{
+        "topic":{
+          "shape":"Topic",
+          "documentation":"<p>The topic name to which the retained message was published.</p>"
+        },
+        "payload":{
+          "shape":"Payload",
+          "documentation":"<p>The Base64-encoded message payload of the retained message body.</p>"
+        },
+        "qos":{
+          "shape":"Qos",
+          "documentation":"<p>The quality of service (QoS) level used to publish the retained message.</p>"
+        },
+        "lastModifiedTime":{
+          "shape":"Timestamp",
+          "documentation":"<p>The Epoch date and time, in milliseconds, when the retained message was stored by IoT.</p>"
+        }
+      },
+      "documentation":"<p>The output from the GetRetainedMessage operation.</p>"
+    },
     "GetThingShadowRequest":{
       "type":"structure",
       "required":["thingName"],
@@ -240,14 +312,49 @@
         },
         "nextToken":{
           "shape":"NextToken",
-          "documentation":"<p>The token for the next set of results, or null if there are no additional results.</p>"
+          "documentation":"<p>The token to use to get the next set of results, or <b>null</b> if there are no additional results.</p>"
         },
         "timestamp":{
           "shape":"Timestamp",
-          "documentation":"<p>The Epoch date and time the response was generated by AWS IoT.</p>"
+          "documentation":"<p>The Epoch date and time the response was generated by IoT.</p>"
+        }
+      }
+    },
+    "ListRetainedMessagesRequest":{
+      "type":"structure",
+      "members":{
+        "nextToken":{
+          "shape":"NextToken",
+          "documentation":"<p>To retrieve the next set of results, the <code>nextToken</code> value from a previous response; otherwise <b>null</b> to receive the first set of results.</p>",
+          "location":"querystring",
+          "locationName":"nextToken"
+        },
+        "maxResults":{
+          "shape":"MaxResults",
+          "documentation":"<p>The maximum number of results to return at one time.</p>",
+          "location":"querystring",
+          "locationName":"maxResults"
+        }
+      }
+    },
+    "ListRetainedMessagesResponse":{
+      "type":"structure",
+      "members":{
+        "retainedTopics":{
+          "shape":"RetainedMessageList",
+          "documentation":"<p>A summary list the account's retained messages. The information returned doesn't include the message payloads of the retained messages.</p>"
+        },
+        "nextToken":{
+          "shape":"NextToken",
+          "documentation":"<p>The token for the next set of results, or null if there are no additional results.</p>"
         }
       }
     },
+    "MaxResults":{
+      "type":"integer",
+      "max":200,
+      "min":1
+    },
     "MethodNotAllowedException":{
       "type":"structure",
       "members":{
@@ -271,6 +378,7 @@
       "min":1
     },
     "Payload":{"type":"blob"},
+    "PayloadSize":{"type":"long"},
     "PublishRequest":{
       "type":"structure",
       "required":["topic"],
@@ -287,9 +395,15 @@
           "location":"querystring",
           "locationName":"qos"
         },
+        "retain":{
+          "shape":"Retain",
+          "documentation":"<p>A Boolean value that determines whether to set the RETAIN flag when the message is published.</p> <p>Setting the RETAIN flag causes the message to be retained and sent to new subscribers to the topic.</p> <p>Valid values: <code>true</code> | <code>false</code> </p> <p>Default value: <code>false</code> </p>",
+          "location":"querystring",
+          "locationName":"retain"
+        },
         "payload":{
           "shape":"Payload",
-          "documentation":"<p>The state information, in JSON format.</p>"
+          "documentation":"<p>The message body. MQTT accepts text, binary, and empty (null) message payloads.</p> <p>Publishing an empty (null) payload with <b>retain</b> = <code>true</code> deletes the retained message identified by <b>topic</b> from IoT Core.</p>"
         }
       },
       "documentation":"<p>The input for the Publish operation.</p>",
@@ -324,6 +438,33 @@
       "error":{"httpStatusCode":404},
       "exception":true
     },
+    "Retain":{"type":"boolean"},
+    "RetainedMessageList":{
+      "type":"list",
+      "member":{"shape":"RetainedMessageSummary"}
+    },
+    "RetainedMessageSummary":{
+      "type":"structure",
+      "members":{
+        "topic":{
+          "shape":"Topic",
+          "documentation":"<p>The topic name to which the retained message was published.</p>"
+        },
+        "payloadSize":{
+          "shape":"PayloadSize",
+          "documentation":"<p>The size of the retained message's payload in bytes.</p>"
+        },
+        "qos":{
+          "shape":"Qos",
+          "documentation":"<p>The quality of service (QoS) level used to publish the retained message.</p>"
+        },
+        "lastModifiedTime":{
+          "shape":"Timestamp",
+          "documentation":"<p>The Epoch date and time, in milliseconds, when the retained message was stored by IoT.</p>"
+        }
+      },
+      "documentation":"<p>Information about a single retained message.</p>"
+    },
     "ServiceUnavailableException":{
       "type":"structure",
       "members":{
@@ -427,5 +568,5 @@
     },
     "errorMessage":{"type":"string"}
   },
-  "documentation":"<fullname>AWS IoT</fullname> <p>AWS IoT-Data enables secure, bi-directional communication between Internet-connected things (such as sensors, actuators, embedded devices, or smart appliances) and the AWS cloud. It implements a broker for applications and things to publish messages over HTTP (Publish) and retrieve, update, and delete shadows. A shadow is a persistent representation of your things and their state in the AWS cloud.</p> <p>Find the endpoint address for actions in the AWS IoT data plane by running this CLI command:</p> <p> <code>aws iot describe-endpoint --endpoint-type iot:Data-ATS</code> </p> <p>The service name used by <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">AWS Signature Version 4</a> to sign requests is: <i>iotdevicegateway</i>.</p>"
+  "documentation":"<fullname>IoT data</fullname> <p>IoT data enables secure, bi-directional communication between Internet-connected things (such as sensors, actuators, embedded devices, or smart appliances) and the Amazon Web Services cloud. It implements a broker for applications and things to publish messages over HTTP (Publish) and retrieve, update, and delete shadows. A shadow is a persistent representation of your things and their state in the Amazon Web Services cloud.</p> <p>Find the endpoint address for actions in IoT data by running this CLI command:</p> <p> <code>aws iot describe-endpoint --endpoint-type iot:Data-ATS</code> </p> <p>The service name used by <a href=\"https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html\">Amazon Web ServicesSignature Version 4</a> to sign requests is: <i>iotdevicegateway</i>.</p>"
 }