kinesisfirehose Update models to latest

aws-android-sdk-kinesis/src/main/java/com/amazonaws/services/kinesisfirehose/AmazonKinesisFirehose.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 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,13 +20,17 @@
 import com.amazonaws.services.kinesisfirehose.model.*;
 
 /**
- * Interface for accessing Amazon Kinesis Firehose <fullname>Amazon Kinesis Data
- * Firehose API Reference</fullname>
+ * Interface for accessing Amazon Kinesis Firehose <fullname>Amazon Data
+ * Firehose</fullname> <note>
  * <p>
- * Amazon Kinesis Data Firehose is a fully managed service that delivers
- * real-time streaming data to destinations such as Amazon Simple Storage
- * Service (Amazon S3), Amazon OpenSearch Service, Amazon Redshift, Splunk, and
- * various other supportd destinations.
+ * Amazon Data Firehose was previously known as Amazon Kinesis Data Firehose.
+ * </p>
+ * </note>
+ * <p>
+ * Amazon Data Firehose is a fully managed service that delivers real-time
+ * streaming data to destinations such as Amazon Simple Storage Service (Amazon
+ * S3), Amazon OpenSearch Service, Amazon Redshift, Splunk, and various other
+ * supported destinations.
  * </p>
  **/
 public interface AmazonKinesisFirehose {
@@ -98,9 +102,16 @@ public interface AmazonKinesisFirehose {
      * producers.
      * </p>
      * <p>
+     * Firehose accumulates and publishes a particular metric for a customer
+     * account in one minute intervals. It is possible that the bursts of
+     * incoming bytes/records ingested to a delivery stream last only for a few
+     * seconds. Due to this, the actual spikes in the traffic might not be fully
+     * visible in the customer's 1 minute CloudWatch metrics.
+     * </p>
+     * <p>
      * For information about service quota, see <a
      * href="https://docs.aws.amazon.com/firehose/latest/dev/limits.html">Amazon
-     * Kinesis Data Firehose Quota</a>.
+     * Firehose Quota</a>.
      * </p>
      * <p>
      * Each <a>PutRecordBatch</a> request supports up to 500 records. Each
@@ -116,12 +127,12 @@ public interface AmazonKinesisFirehose {
      * data, and so on.
      * </p>
      * <p>
-     * Kinesis Data Firehose buffers records before delivering them to the
-     * destination. To disambiguate the data blobs at the destination, a common
-     * solution is to use delimiters in the data, such as a newline (
-     * <code>\n</code>) or some other character unique within the data. This
-     * allows the consumer application to parse individual data items when
-     * reading the data from the destination.
+     * Firehose buffers records before delivering them to the destination. To
+     * disambiguate the data blobs at the destination, a common solution is to
+     * use delimiters in the data, such as a newline (<code>\n</code>) or some
+     * other character unique within the data. This allows the consumer
+     * application to parse individual data items when reading the data from the
+     * destination.
      * </p>
      * <p>
      * The <a>PutRecordBatch</a> response includes a count of failed records,
@@ -134,9 +145,9 @@ public interface AmazonKinesisFirehose {
      * record in the request array using the same ordering, from the top to the
      * bottom. The response array always includes the same number of records as
      * the request array. <code>RequestResponses</code> includes both
-     * successfully and unsuccessfully processed records. Kinesis Data Firehose
-     * tries to process all records in each <a>PutRecordBatch</a> request. A
-     * single record failure does not stop the processing of subsequent records.
+     * successfully and unsuccessfully processed records. Firehose tries to
+     * process all records in each <a>PutRecordBatch</a> request. A single
+     * record failure does not stop the processing of subsequent records.
      * </p>
      * <p>
      * A successfully processed record includes a <code>RecordId</code> value,
@@ -157,14 +168,20 @@ public interface AmazonKinesisFirehose {
      * </p>
      * <p>
      * If <a>PutRecordBatch</a> throws <code>ServiceUnavailableException</code>,
-     * back off and retry. If the exception persists, it is possible that the
-     * throughput limits have been exceeded for the delivery stream.
+     * the API is automatically reinvoked (retried) 3 times. If the exception
+     * persists, it is possible that the throughput limits have been exceeded
+     * for the delivery stream.
+     * </p>
+     * <p>
+     * Re-invoking the Put API operations (for example, PutRecord and
+     * PutRecordBatch) can result in data duplicates. For larger data assets,
+     * allow for a longer time out before retrying Put API operations.
      * </p>
      * <p>
-     * Data records sent to Kinesis Data Firehose are stored for 24 hours from
-     * the time they are added to a delivery stream as it attempts to send the
-     * records to the destination. If the destination is unreachable for more
-     * than 24 hours, the data is no longer available.
+     * Data records sent to Firehose are stored for 24 hours from the time they
+     * are added to a delivery stream as it attempts to send the records to the
+     * destination. If the destination is unreachable for more than 24 hours,
+     * the data is no longer available.
      * </p>
      * <important>
      * <p>
@@ -180,6 +197,7 @@ public interface AmazonKinesisFirehose {
      * @throws ResourceNotFoundException
      * @throws InvalidArgumentException
      * @throws InvalidKMSResourceException
+     * @throws InvalidSourceException
      * @throws ServiceUnavailableException
      * @throws AmazonClientException If any internal errors are encountered
      *             inside the client while attempting to make the request or

aws-android-sdk-kinesis/src/main/java/com/amazonaws/services/kinesisfirehose/AmazonKinesisFirehoseClient.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 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.
@@ -35,12 +35,16 @@
  * this client are blocking, and will not return until the service call
  * completes.
  * <p>
- * <fullname>Amazon Kinesis Data Firehose API Reference</fullname>
+ * <fullname>Amazon Data Firehose</fullname> <note>
  * <p>
- * Amazon Kinesis Data Firehose is a fully managed service that delivers
- * real-time streaming data to destinations such as Amazon Simple Storage
- * Service (Amazon S3), Amazon OpenSearch Service, Amazon Redshift, Splunk, and
- * various other supportd destinations.
+ * Amazon Data Firehose was previously known as Amazon Kinesis Data Firehose.
+ * </p>
+ * </note>
+ * <p>
+ * Amazon Data Firehose is a fully managed service that delivers real-time
+ * streaming data to destinations such as Amazon Simple Storage Service (Amazon
+ * S3), Amazon OpenSearch Service, Amazon Redshift, Splunk, and various other
+ * supported destinations.
  * </p>
  */
 public class AmazonKinesisFirehoseClient extends AmazonWebServiceClient implements
@@ -339,6 +343,7 @@ private void init() {
         jsonErrorUnmarshallers = new ArrayList<JsonErrorUnmarshaller>();
         jsonErrorUnmarshallers.add(new InvalidArgumentExceptionUnmarshaller());
         jsonErrorUnmarshallers.add(new InvalidKMSResourceExceptionUnmarshaller());
+        jsonErrorUnmarshallers.add(new InvalidSourceExceptionUnmarshaller());
         jsonErrorUnmarshallers.add(new ResourceNotFoundExceptionUnmarshaller());
         jsonErrorUnmarshallers.add(new ServiceUnavailableExceptionUnmarshaller());
         jsonErrorUnmarshallers.add(new JsonErrorUnmarshaller());
@@ -369,9 +374,16 @@ private static ClientConfiguration adjustClientConfiguration(ClientConfiguration
      * producers.
      * </p>
      * <p>
+     * Firehose accumulates and publishes a particular metric for a customer
+     * account in one minute intervals. It is possible that the bursts of
+     * incoming bytes/records ingested to a delivery stream last only for a few
+     * seconds. Due to this, the actual spikes in the traffic might not be fully
+     * visible in the customer's 1 minute CloudWatch metrics.
+     * </p>
+     * <p>
      * For information about service quota, see <a
      * href="https://docs.aws.amazon.com/firehose/latest/dev/limits.html">Amazon
-     * Kinesis Data Firehose Quota</a>.
+     * Firehose Quota</a>.
      * </p>
      * <p>
      * Each <a>PutRecordBatch</a> request supports up to 500 records. Each
@@ -387,12 +399,12 @@ private static ClientConfiguration adjustClientConfiguration(ClientConfiguration
      * data, and so on.
      * </p>
      * <p>
-     * Kinesis Data Firehose buffers records before delivering them to the
-     * destination. To disambiguate the data blobs at the destination, a common
-     * solution is to use delimiters in the data, such as a newline (
-     * <code>\n</code>) or some other character unique within the data. This
-     * allows the consumer application to parse individual data items when
-     * reading the data from the destination.
+     * Firehose buffers records before delivering them to the destination. To
+     * disambiguate the data blobs at the destination, a common solution is to
+     * use delimiters in the data, such as a newline (<code>\n</code>) or some
+     * other character unique within the data. This allows the consumer
+     * application to parse individual data items when reading the data from the
+     * destination.
      * </p>
      * <p>
      * The <a>PutRecordBatch</a> response includes a count of failed records,
@@ -405,9 +417,9 @@ private static ClientConfiguration adjustClientConfiguration(ClientConfiguration
      * record in the request array using the same ordering, from the top to the
      * bottom. The response array always includes the same number of records as
      * the request array. <code>RequestResponses</code> includes both
-     * successfully and unsuccessfully processed records. Kinesis Data Firehose
-     * tries to process all records in each <a>PutRecordBatch</a> request. A
-     * single record failure does not stop the processing of subsequent records.
+     * successfully and unsuccessfully processed records. Firehose tries to
+     * process all records in each <a>PutRecordBatch</a> request. A single
+     * record failure does not stop the processing of subsequent records.
      * </p>
      * <p>
      * A successfully processed record includes a <code>RecordId</code> value,
@@ -428,14 +440,20 @@ private static ClientConfiguration adjustClientConfiguration(ClientConfiguration
      * </p>
      * <p>
      * If <a>PutRecordBatch</a> throws <code>ServiceUnavailableException</code>,
-     * back off and retry. If the exception persists, it is possible that the
-     * throughput limits have been exceeded for the delivery stream.
+     * the API is automatically reinvoked (retried) 3 times. If the exception
+     * persists, it is possible that the throughput limits have been exceeded
+     * for the delivery stream.
+     * </p>
+     * <p>
+     * Re-invoking the Put API operations (for example, PutRecord and
+     * PutRecordBatch) can result in data duplicates. For larger data assets,
+     * allow for a longer time out before retrying Put API operations.
      * </p>
      * <p>
-     * Data records sent to Kinesis Data Firehose are stored for 24 hours from
-     * the time they are added to a delivery stream as it attempts to send the
-     * records to the destination. If the destination is unreachable for more
-     * than 24 hours, the data is no longer available.
+     * Data records sent to Firehose are stored for 24 hours from the time they
+     * are added to a delivery stream as it attempts to send the records to the
+     * destination. If the destination is unreachable for more than 24 hours,
+     * the data is no longer available.
      * </p>
      * <important>
      * <p>
@@ -451,6 +469,7 @@ private static ClientConfiguration adjustClientConfiguration(ClientConfiguration
      * @throws ResourceNotFoundException
      * @throws InvalidArgumentException
      * @throws InvalidKMSResourceException
+     * @throws InvalidSourceException
      * @throws ServiceUnavailableException
      * @throws AmazonClientException If any internal errors are encountered
      *             inside the client while attempting to make the request or

aws-android-sdk-kinesis/src/main/java/com/amazonaws/services/kinesisfirehose/model/InvalidArgumentException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 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.

aws-android-sdk-kinesis/src/main/java/com/amazonaws/services/kinesisfirehose/model/InvalidKMSResourceException.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2010-2022 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * Copyright 2010-2024 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.
@@ -19,9 +19,9 @@
 
 /**
  * <p>
- * Kinesis Data Firehose throws this exception when an attempt to put records or
- * to start or stop delivery stream encryption fails. This happens when the KMS
- * service throws one of the following exception types:
+ * Firehose throws this exception when an attempt to put records or to start or
+ * stop delivery stream encryption fails. This happens when the KMS service
+ * throws one of the following exception types:
  * <code>AccessDeniedException</code>, <code>InvalidStateException</code>,
  * <code>DisabledException</code>, or <code>NotFoundException</code>.
  * </p>

aws-android-sdk-kinesis/src/main/java/com/amazonaws/services/kinesisfirehose/model/InvalidSourceException.java

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2010-2024 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.
+ * A copy of the License is located at
+ *
+ *  http://aws.amazon.com/apache2.0
+ *
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+package com.amazonaws.services.kinesisfirehose.model;
+
+import com.amazonaws.AmazonServiceException;
+
+/**
+ * <p>
+ * Only requests from CloudWatch Logs are supported when CloudWatch Logs
+ * decompression is enabled.
+ * </p>
+ */
+public class InvalidSourceException extends AmazonServiceException {
+    private static final long serialVersionUID = 1L;
+
+    private String code;
+
+    /**
+     * Constructs a new InvalidSourceException with the specified error message.
+     *
+     * @param message Describes the error encountered.
+     */
+    public InvalidSourceException(String message) {
+        super(message);
+    }
+
+    /**
+     * Returns the value of the code property for this object.
+     *
+     * @return The value of the code property for this object.
+     */
+    public String getCode() {
+        return code;
+    }
+
+    /**
+     * Sets the value of code
+     *
+     * @param code The new value for the code property for this object.
+     */
+    public void setCode(String code) {
+        this.code = code;
+    }
+}