feat(aws-android-sdk-iot): update models to latest (#2592)

Co-authored-by: Rafael Juliano <[email protected]>

Author: awsmobilesdk

aws-android-sdk-iot/src/main/java/com/amazonaws/services/iotdata/AWSIotData.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License").
  * You may not use this file except in compliance with the License.
@@ -20,26 +20,27 @@
 import com.amazonaws.services.iotdata.model.*;
 
 /**
- * Interface for accessing AWS IoT Data <fullname>AWS IoT</fullname>
+ * Interface for accessing AWS IoT Data <fullname>IoT data</fullname>
  * <p>
- * AWS IoT-Data enables secure, bi-directional communication between
+ * 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.
+ * 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 the AWS IoT data plane by running
- * this CLI command:
+ * 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">AWS
- * Signature Version 4</a> to sign requests is: <i>iotdevicegateway</i>.
+ * "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>
  **/
 public interface AWSIotData {
@@ -107,9 +108,14 @@ public interface AWSIotData {
      * 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 AWS IoT Developer Guide.
+     * >DeleteThingShadow</a> in the IoT Developer Guide.
      * </p>
      * 
      * @param deleteThingShadowRequest <p>
@@ -136,14 +142,64 @@ public interface AWSIotData {
     DeleteThingShadowResult deleteThingShadow(DeleteThingShadowRequest deleteThingShadowRequest)
             throws AmazonClientException, AmazonServiceException;
 
+    /**
+     * <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>
+     * 
+     * @param getRetainedMessageRequest <p>
+     *            The input for the GetRetainedMessage operation.
+     *            </p>
+     * @return getRetainedMessageResult The response from the GetRetainedMessage
+     *         service method, as returned by AWS IoT Data.
+     * @throws InvalidRequestException
+     * @throws ResourceNotFoundException
+     * @throws ThrottlingException
+     * @throws UnauthorizedException
+     * @throws ServiceUnavailableException
+     * @throws InternalFailureException
+     * @throws MethodNotAllowedException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by AWS
+     *             IoT Data indicating either a problem with the data in the
+     *             request, or a server side issue.
+     */
+    GetRetainedMessageResult getRetainedMessage(GetRetainedMessageRequest getRetainedMessageRequest)
+            throws AmazonClientException, AmazonServiceException;
+
     /**
      * <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 AWS IoT Developer Guide.
+     * >GetThingShadow</a> in the IoT Developer Guide.
      * </p>
      * 
      * @param getThingShadowRequest <p>
@@ -174,6 +230,11 @@ GetThingShadowResult getThingShadow(GetThingShadowRequest getThingShadowRequest)
      * <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>
      * 
      * @param listNamedShadowsForThingRequest
      * @return listNamedShadowsForThingResult The response from the
@@ -200,12 +261,69 @@ ListNamedShadowsForThingResult listNamedShadowsForThing(
 
     /**
      * <p>
-     * Publishes state information.
+     * Lists summary information about the retained messages stored for the
+     * account.
      * </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.
+     * 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>
+     * 
+     * @param listRetainedMessagesRequest
+     * @return listRetainedMessagesResult The response from the
+     *         ListRetainedMessages service method, as returned by AWS IoT Data.
+     * @throws InvalidRequestException
+     * @throws ThrottlingException
+     * @throws UnauthorizedException
+     * @throws ServiceUnavailableException
+     * @throws InternalFailureException
+     * @throws MethodNotAllowedException
+     * @throws AmazonClientException If any internal errors are encountered
+     *             inside the client while attempting to make the request or
+     *             handle the response. For example if a network connection is
+     *             not available.
+     * @throws AmazonServiceException If an error response is returned by AWS
+     *             IoT Data indicating either a problem with the data in the
+     *             request, or a server side issue.
+     */
+    ListRetainedMessagesResult listRetainedMessages(
+            ListRetainedMessagesRequest listRetainedMessagesRequest) throws AmazonClientException,
+            AmazonServiceException;
+
+    /**
+     * <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>
      * 
      * @param publishRequest <p>
@@ -231,9 +349,14 @@ void publish(PublishRequest publishRequest) throws AmazonClientException,
      * 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 AWS IoT Developer Guide.
+     * >UpdateThingShadow</a> in the IoT Developer Guide.
      * </p>
      * 
      * @param updateThingShadowRequest <p>