@aws-sdk/client-sqs 3.848.0 → 3.854.0

package/README.md

@@ -60,8 +60,7 @@ following automatically:</p>
 </li>
 <li>
 <p>
-<a href="http://docs.aws.amazon.com/cli/latest/reference/sqs/index.html">Amazon SQS in the <i>Command Line Interface</i>
-</a>
+<a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/index.html">Amazon SQS in the Command Line Interface</a>
 </p>
 </li>
 <li>

package/dist-types/SQS.d.ts

@@ -219,8 +219,7 @@ export interface SQS {
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="http://docs.aws.amazon.com/cli/latest/reference/sqs/index.html">Amazon SQS in the <i>Command Line Interface</i>
- *                   </a>
+ *                   <a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/index.html">Amazon SQS in the Command Line Interface</a>
  *                </p>
  *             </li>
  *             <li>

package/dist-types/SQSClient.d.ts

@@ -252,8 +252,7 @@ export interface SQSClientResolvedConfig extends SQSClientResolvedConfigType {
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="http://docs.aws.amazon.com/cli/latest/reference/sqs/index.html">Amazon SQS in the <i>Command Line Interface</i>
- *                   </a>
+ *                   <a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/index.html">Amazon SQS in the Command Line Interface</a>
  *                </p>
  *             </li>
  *             <li>

package/dist-types/commands/CreateQueueCommand.d.ts

@@ -36,7 +36,7 @@ declare const CreateQueueCommand_base: {
  *                   <p>You can't change the queue type after you create it and you can't convert
  *                         an existing standard queue into a FIFO queue. You must either create a new
  *                         FIFO queue for your application or delete your existing standard queue and
- *                         recreate it as a FIFO queue. For more information, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving">Moving From a Standard Queue to a FIFO Queue</a> in the
+ *                         recreate it as a FIFO queue. For more information, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving">Moving From a standard queue to a FIFO queue</a> in the
  *                             <i>Amazon SQS Developer Guide</i>. </p>
  *                </note>
  *             </li>

package/dist-types/commands/SendMessageBatchCommand.d.ts

@@ -42,7 +42,7 @@ declare const SendMessageBatchCommand_base: {
  *             <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 <code>U+FFFD</code> before storing the message in the queue, as long as the message body contains at least one valid character.</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>
  *          </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>

package/dist-types/commands/SendMessageCommand.d.ts

@@ -33,7 +33,7 @@ declare const SendMessageCommand_base: {
  *             <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 <code>U+FFFD</code> before storing the message in the queue, as long as the message body contains at least one valid character.</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>
  *          </important>
  * @example
  * Use a bare-bones client and the command you need to make an API call.

package/dist-types/index.d.ts

@@ -53,8 +53,7 @@
  *             </li>
  *             <li>
  *                <p>
- *                   <a href="http://docs.aws.amazon.com/cli/latest/reference/sqs/index.html">Amazon SQS in the <i>Command Line Interface</i>
- *                   </a>
+ *                   <a href="https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sqs/index.html">Amazon SQS in the Command Line Interface</a>
  *                </p>
  *             </li>
  *             <li>

package/dist-types/models/models_0.d.ts

@@ -1591,8 +1591,7 @@ export interface ReceiveMessageRequest {
      *                     producer that calls the <code>
      *                      <a>SendMessage</a>
      *                   </code> action.
-     *                     Messages with the same <code>MessageGroupId</code> are returned in
-     *                     sequence.</p>
+     *                     </p>
      *             </li>
      *             <li>
      *                <p>
@@ -1669,9 +1668,7 @@ export interface ReceiveMessageRequest {
      *                   <code>MessageGroupId</code> – Returns the value provided by the
      *                     producer that calls the <code>
      *                      <a>SendMessage</a>
-     *                   </code> action.
-     *                     Messages with the same <code>MessageGroupId</code> are returned in
-     *                     sequence.</p>
+     *                   </code> action.</p>
      *             </li>
      *             <li>
      *                <p>
@@ -1816,10 +1813,10 @@ export interface ReceiveMessageRequest {
      *                </important>
      *             </li>
      *             <li>
-     *                <p>While messages with a particular <code>MessageGroupId</code> are invisible, no
-     *                     more messages belonging to the same <code>MessageGroupId</code> are returned
-     *                     until the visibility timeout expires. You can still receive messages with
-     *                     another <code>MessageGroupId</code> as long as it is also visible.</p>
+     *                <p>While messages with a particular <code>MessageGroupId</code> are invisible,
+     *                 no more messages belonging to the same <code>MessageGroupId</code> are returned
+     *                 until the visibility timeout expires. You can still receive messages
+     *                 with another <code>MessageGroupId</code> from your FIFO queue as long as they are visible.</p>
      *             </li>
      *             <li>
      *                <p>If a caller of <code>ReceiveMessage</code> can't track the
@@ -2092,7 +2089,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 <code>U+FFFD</code> before storing the message in the queue, as long as the message body contains at least one valid character.</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>
      *          </important>
      * @public
      */
@@ -2198,37 +2195,50 @@ export interface SendMessageRequest {
      */
     MessageDeduplicationId?: string | undefined;
     /**
-     * <p>This parameter applies only to FIFO (first-in-first-out) queues.</p>
-     *          <p>The tag that specifies that a message belongs to a specific message group. Messages
-     *             that belong to the same message group are processed in a FIFO manner (however,
-     *             messages in different message groups might be processed out of order). To interleave
-     *             multiple ordered streams within a single queue, use <code>MessageGroupId</code> values
-     *             (for example, session data for multiple users). In this scenario, multiple consumers can
-     *             process the queue, but the session data of each user is processed in a FIFO
-     *             fashion.</p>
+     * <p>
+     *             <code>MessageGroupId</code> is an attribute used in Amazon SQS FIFO (First-In-First-Out) and standard queues.
+     *         In FIFO queues, <code>MessageGroupId</code> organizes messages into distinct groups.
+     *         Messages within the same message group are always processed one at a time, in strict order,
+     *         ensuring that no two messages from the same group are processed simultaneously.
+     *         In standard queues, using <code>MessageGroupId</code> enables fair queues.
+     *         It is used to identify the tenant a message belongs to,
+     *         helping maintain consistent message dwell time across all tenants during noisy neighbor events.
+     *         Unlike FIFO queues, messages with the same <code>MessageGroupId</code> can be processed in parallel,
+     *         maintaining the high throughput of standard queues.</p>
      *          <ul>
      *             <li>
-     *                <p>You must associate a non-empty <code>MessageGroupId</code> with a message. If
-     *                     you don't provide a <code>MessageGroupId</code>, the action fails.</p>
+     *                <p>
+     *                   <b>FIFO queues:</b>
+     *                   <code>MessageGroupId</code> acts as the tag
+     *                 that specifies that a message belongs to a specific message group.
+     *                 Messages that belong to the same message group are processed in a FIFO manner
+     *                 (however, messages in different message groups might be processed out of order).
+     *                 To interleave multiple ordered streams within a single queue, use <code>MessageGroupId</code> values
+     *                 (for example, session data for multiple users).
+     *                 In this scenario, multiple consumers can process the queue,
+     *                 but the session data of each user is processed in a FIFO fashion.</p>
+     *                <p>If you do not provide a <code>MessageGroupId</code> when sending a message to a FIFO queue, the action fails.</p>
+     *                <p>
+     *                   <code>ReceiveMessage</code> might return messages with multiple <code>MessageGroupId</code> values.
+     *                 For each <code>MessageGroupId</code>, the messages are sorted by time sent.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>ReceiveMessage</code> might return messages with multiple
-     *                         <code>MessageGroupId</code> values. For each <code>MessageGroupId</code>,
-     *                     the messages are sorted by time sent. The caller can't specify a
-     *                         <code>MessageGroupId</code>.</p>
+     *                   <b>Standard queues:</b>Use <code>MessageGroupId</code> in standard queues to enable fair queues.
+     *                 The <code>MessageGroupId</code> identifies the tenant a message belongs to.
+     *                 A tenant can be any entity that shares a queue with others, such as your customer, a client application,
+     *                 or a request type. When one tenant sends a disproportionately large volume of messages
+     *                 or has messages that require longer processing time, fair queues ensure other tenants'
+     *                 messages maintain low dwell time. This preserves quality of service for all tenants while
+     *                 maintaining the scalability and throughput of standard queues.
+     *                 We recommend that you include a <code>MessageGroupId</code> in all messages when using fair queues.</p>
      *             </li>
      *          </ul>
-     *          <p>The maximum length of <code>MessageGroupId</code> is 128 characters. Valid values:
+     *          <p>The length of <code>MessageGroupId</code> is 128 characters. Valid values:
      *             alphanumeric characters and punctuation
      *                 <code>(!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~)</code>.</p>
      *          <p>For best practices of using <code>MessageGroupId</code>, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html">Using the MessageGroupId Property</a> in the <i>Amazon SQS Developer
      *                 Guide</i>.</p>
-     *          <important>
-     *             <p>
-     *                <code>MessageGroupId</code> is required for FIFO queues. You can't use it for
-     *                 Standard queues.</p>
-     *          </important>
      * @public
      */
     MessageGroupId?: string | undefined;
@@ -2402,25 +2412,43 @@ export interface SendMessageBatchRequestEntry {
      */
     MessageDeduplicationId?: string | undefined;
     /**
-     * <p>This parameter applies only to FIFO (first-in-first-out) queues.</p>
-     *          <p>The tag that specifies that a message belongs to a specific message group. Messages
-     *             that belong to the same message group are processed in a FIFO manner (however,
-     *             messages in different message groups might be processed out of order). To interleave
-     *             multiple ordered streams within a single queue, use <code>MessageGroupId</code> values
-     *             (for example, session data for multiple users). In this scenario, multiple consumers can
-     *             process the queue, but the session data of each user is processed in a FIFO
-     *             fashion.</p>
+     * <p>
+     *             <code>MessageGroupId</code> is an attribute used in Amazon SQS FIFO (First-In-First-Out) and standard queues.
+     *         In FIFO queues, <code>MessageGroupId</code> organizes messages into distinct groups.
+     *         Messages within the same message group are always processed one at a time, in strict order,
+     *         ensuring that no two messages from the same group are processed simultaneously.
+     *         In standard queues, using <code>MessageGroupId</code> enables fair queues.
+     *         It is used to identify the tenant a message belongs to,
+     *         helping maintain consistent message dwell time across all tenants during noisy neighbor events.
+     *         Unlike FIFO queues, messages with the same <code>MessageGroupId</code> can be processed in parallel,
+     *         maintaining the high throughput of standard queues.</p>
      *          <ul>
      *             <li>
-     *                <p>You must associate a non-empty <code>MessageGroupId</code> with a message. If
-     *                     you don't provide a <code>MessageGroupId</code>, the action fails.</p>
+     *                <p>
+     *                   <b>FIFO queues:</b>
+     *                   <code>MessageGroupId</code> acts as the tag
+     *                 that specifies that a message belongs to a specific message group.
+     *                 Messages that belong to the same message group are processed in a FIFO manner
+     *                 (however, messages in different message groups might be processed out of order).
+     *                 To interleave multiple ordered streams within a single queue, use <code>MessageGroupId</code> values
+     *                 (for example, session data for multiple users).
+     *                 In this scenario, multiple consumers can process the queue,
+     *                 but the session data of each user is processed in a FIFO fashion.</p>
+     *                <p>If you do not provide a <code>MessageGroupId</code> when sending a message to a FIFO queue, the action fails.</p>
+     *                <p>
+     *                   <code>ReceiveMessage</code> might return messages with multiple <code>MessageGroupId</code> values.
+     *                 For each <code>MessageGroupId</code>, the messages are sorted by time sent.</p>
      *             </li>
      *             <li>
      *                <p>
-     *                   <code>ReceiveMessage</code> might return messages with multiple
-     *                         <code>MessageGroupId</code> values. For each <code>MessageGroupId</code>,
-     *                     the messages are sorted by time sent. The caller can't specify a
-     *                         <code>MessageGroupId</code>.</p>
+     *                   <b>Standard queues:</b>Use <code>MessageGroupId</code> in standard queues to enable fair queues.
+     *                 The <code>MessageGroupId</code> identifies the tenant a message belongs to.
+     *                 A tenant can be any entity that shares a queue with others, such as your customer, a client application,
+     *                 or a request type. When one tenant sends a disproportionately large volume of messages
+     *                 or has messages that require longer processing time, fair queues ensure other tenants'
+     *                 messages maintain low dwell time. This preserves quality of service for all tenants while
+     *                 maintaining the scalability and throughput of standard queues.
+     *                 We recommend that you include a <code>MessageGroupId</code> in all messages when using fair queues.</p>
      *             </li>
      *          </ul>
      *          <p>The length of <code>MessageGroupId</code> is 128 characters. Valid values:
@@ -2428,11 +2456,6 @@ export interface SendMessageBatchRequestEntry {
      *                 <code>(!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~)</code>.</p>
      *          <p>For best practices of using <code>MessageGroupId</code>, see <a href="https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html">Using the MessageGroupId Property</a> in the <i>Amazon SQS Developer
      *                 Guide</i>.</p>
-     *          <important>
-     *             <p>
-     *                <code>MessageGroupId</code> is required for FIFO queues. You can't use it for
-     *                 Standard queues.</p>
-     *          </important>
      * @public
      */
     MessageGroupId?: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-sqs",
   "description": "AWS SDK for JavaScript Sqs Client for Node.js, Browser and React Native",
-  "version": "3.848.0",
+  "version": "3.854.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-sqs",