docs(client-sqs): Update invalid character handling documentation for SQS SendMessage API

Author: awstools

clients/client-sqs/src/commands/SendMessageBatchCommand.ts

@@ -44,7 +44,7 @@ export interface SendMessageBatchCommandOutput extends SendMessageBatchResult, _
  *             <p>
  *                <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>
  *             </p>
- *             <p>Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message body contains at least one valid character.</p>
+ *             <p>If a message contains characters outside the allowed set, Amazon SQS rejects the message and returns an InvalidMessageContents error. Ensure that your message body includes only valid characters to avoid this exception.</p>
  *          </important>
  *          <p>If you don't specify the <code>DelaySeconds</code> parameter for an entry, Amazon SQS uses
  *             the default value for the queue.</p>

clients/client-sqs/src/commands/SendMessageCommand.ts

@@ -35,7 +35,7 @@ export interface SendMessageCommandOutput extends SendMessageResult, __MetadataB
  *             <p>
  *                <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>
  *             </p>
- *             <p>Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message body contains at least one valid character.</p>
+ *             <p>If a message contains characters outside the allowed set, Amazon SQS rejects the message and returns an InvalidMessageContents error. Ensure that your message body includes only valid characters to avoid this exception.</p>
  *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

clients/client-sqs/src/models/models_0.ts

@@ -2410,7 +2410,7 @@ export interface SendMessageRequest {
    *             <p>
    *                <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>
    *             </p>
-   *             <p>Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message body contains at least one valid character.</p>
+   *             <p>If a message contains characters outside the allowed set, Amazon SQS rejects the message and returns an InvalidMessageContents error. Ensure that your message body includes only valid characters to avoid this exception.</p>
    *          </important>
    * @public
    */

codegen/sdk-codegen/aws-models/sqs.json

@@ -3499,7 +3499,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Delivers a message to the specified queue.</p>\n         <important>\n            <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p>\n            <p>\n               <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>\n            </p>\n            <p>Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message body contains at least one valid character.</p>\n         </important>"
+        "smithy.api#documentation": "<p>Delivers a message to the specified queue.</p>\n         <important>\n            <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p>\n            <p>\n               <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>\n            </p>\n            <p>If a message contains characters outside the allowed set, Amazon SQS rejects the message and returns an InvalidMessageContents error. Ensure that your message body includes only valid characters to avoid this exception.</p>\n         </important>"
       }
     },
     "com.amazonaws.sqs#SendMessageBatch": {
@@ -3564,7 +3564,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>You can use <code>SendMessageBatch</code> to send up to 10 messages to the specified\n            queue by assigning either identical or different values to each message (or by not\n            assigning values at all). This is a batch version of <code>\n               <a>SendMessage</a>.</code> For a FIFO queue, multiple messages within a single batch are enqueued\n            in the order they are sent.</p>\n         <p>The result of sending each message is reported individually in the response.\n            Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p>\n         <p>The maximum allowed individual message size and the maximum total payload size (the\n            sum of the individual lengths of all of the batched messages) are both 1 MiB \n            1,048,576 bytes.</p>\n         <important>\n            <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p>\n            <p>\n               <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>\n            </p>\n            <p>Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message body contains at least one valid character.</p>\n         </important>\n         <p>If you don't specify the <code>DelaySeconds</code> parameter for an entry, Amazon SQS uses\n            the default value for the queue.</p>"
+        "smithy.api#documentation": "<p>You can use <code>SendMessageBatch</code> to send up to 10 messages to the specified\n            queue by assigning either identical or different values to each message (or by not\n            assigning values at all). This is a batch version of <code>\n               <a>SendMessage</a>.</code> For a FIFO queue, multiple messages within a single batch are enqueued\n            in the order they are sent.</p>\n         <p>The result of sending each message is reported individually in the response.\n            Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of <code>200</code>.</p>\n         <p>The maximum allowed individual message size and the maximum total payload size (the\n            sum of the individual lengths of all of the batched messages) are both 1 MiB \n            1,048,576 bytes.</p>\n         <important>\n            <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p>\n            <p>\n               <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>\n            </p>\n            <p>If a message contains characters outside the allowed set, Amazon SQS rejects the message and returns an InvalidMessageContents error. Ensure that your message body includes only valid characters to avoid this exception.</p>\n         </important>\n         <p>If you don't specify the <code>DelaySeconds</code> parameter for an entry, Amazon SQS uses\n            the default value for the queue.</p>"
       }
     },
     "com.amazonaws.sqs#SendMessageBatchRequest": {
@@ -3747,7 +3747,7 @@
         "MessageBody": {
           "target": "com.amazonaws.sqs#String",
           "traits": {
-            "smithy.api#documentation": "<p>The message to send. The minimum size is one character. The maximum size is \n        1 MiB or 1,048,576 bytes</p>\n         <important>\n            <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p>\n            <p>\n               <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>\n            </p>\n            <p>Amazon SQS does not throw an exception or completely reject the message if it contains invalid characters. Instead, it replaces those invalid characters with U+FFFD before storing the message in the queue, as long as the message body contains at least one valid character.</p>\n         </important>",
+            "smithy.api#documentation": "<p>The message to send. The minimum size is one character. The maximum size is \n        1 MiB or 1,048,576 bytes</p>\n         <important>\n            <p>A message can include only XML, JSON, and unformatted text. The following Unicode characters are allowed. For more information, see the <a href=\"http://www.w3.org/TR/REC-xml/#charsets\">W3C specification for characters</a>.</p>\n            <p>\n               <code>#x9</code> | <code>#xA</code> | <code>#xD</code> | <code>#x20</code> to <code>#xD7FF</code> | <code>#xE000</code> to <code>#xFFFD</code> | <code>#x10000</code> to <code>#x10FFFF</code>\n            </p>\n            <p>If a message contains characters outside the allowed set, Amazon SQS rejects the message and returns an InvalidMessageContents error. Ensure that your message body includes only valid characters to avoid this exception.</p>\n         </important>",
             "smithy.api#required": {}
           }
         },