aws-sdk-sqs 1.88.0 → 1.90.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '02159585f682bce10dd1403643d721ae886f8cb108791d1e39db5f3243d21450'
-  data.tar.gz: 076c2bfd07cec32e870f1053941d4be596273deb8a17bad4357b633315911c51
+  metadata.gz: c122c91aca3570ae9faf5b93a1c376363c5f05cacce7fe0c22c851bd9486d818
+  data.tar.gz: 3a8edebaf3fd41378cabdcd5d450d909c5f072fae9b9ec03b669e7ab77572a2d
 SHA512:
-  metadata.gz: ab6de237ac25015a451ff8cb6b113aeb0fe7ee95d81126d4745c1da9724d5291851b57399044d96301c68f2b0e22b6f42aaa84f61ecd86ded93e904995c31dde
-  data.tar.gz: f2539d781e4869d5f0495a3c2420727933c5fc3f72f91a80f358df28c69e48d51775171120854526c9927eb86210676ef14290d9a736478e5894b122f697e7a2
+  metadata.gz: 8364bfa6a6e1452752c6c07d273853386c8ec299696f0fd16a9fc81d3118b6cd0c9371b32d08780e082e48e4c84131431ad88467e01705a0114940facab50d97
+  data.tar.gz: 779695b4b133442beb45aa61b6de84f19164808535dc1e9817541009ae312c7f8bf217882b67374b6d2fced97c4385d4fb1c9695d6a7972f7fead8321ad78e2d

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.90.0 (2025-01-02)
+------------------
+
+* Feature - In-flight message typo fix from 20k to 120k.
+
+1.89.0 (2024-11-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.88.0 (2024-11-06)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.88.0
+1.90.0

data/lib/aws-sdk-sqs/client.rb

@@ -652,7 +652,7 @@ module Aws::SQS
     # increase the number of queues you use to process your messages. To
     # request a limit increase, [file a support request][2].
     #
-    # For FIFO queues, there can be a maximum of 20,000 in flight messages
+    # For FIFO queues, there can be a maximum of 120,000 in flight messages
     # (received from a queue by a consumer, but not yet deleted from the
     # queue). If you reach this limit, Amazon SQS returns no error messages.
     #
@@ -795,20 +795,24 @@ module Aws::SQS
     #
     #  </note>
     #
-    # To get the queue URL, use the ` GetQueueUrl ` action. ` GetQueueUrl `
-    # requires only the `QueueName` parameter. be aware of existing queue
-    # names:
+    # To retrieve the URL of a queue, use the [ `GetQueueUrl` ][3] action.
+    # This action only requires the [ `QueueName` ][4] parameter.
     #
-    # * If you provide the name of an existing queue along with the exact
-    #   names and values of all the queue's attributes, `CreateQueue`
-    #   returns the queue URL for the existing queue.
+    # When creating queues, keep the following points in mind:
     #
-    # * If the queue name, attribute names, or attribute values don't match
-    #   an existing queue, `CreateQueue` returns an error.
+    # * If you specify the name of an existing queue and provide the exact
+    #   same names and values for all its attributes, the [ `CreateQueue`
+    #   ][5] action will return the URL of the existing queue instead of
+    #   creating a new one.
+    #
+    # * If you attempt to create a queue with a name that already exists but
+    #   with different attribute names or values, the `CreateQueue` action
+    #   will return an error. This ensures that existing queues are not
+    #   inadvertently altered.
     #
     # <note markdown="1"> Cross-account permissions don't apply to this action. For more
     # information, see [Grant cross-account permissions to a role and a
-    # username][3] in the *Amazon SQS Developer Guide*.
+    # username][6] in the *Amazon SQS Developer Guide*.
     #
     #  </note>
     #
@@ -816,7 +820,10 @@ module Aws::SQS
     #
     # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving
     # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
-    # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
+    # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_GetQueueUrl.html
+    # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html#API_CreateQueue_RequestSyntax
+    # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html
+    # [6]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
     #
     # @option params [required, String] :queue_name
     #   The name of the new queue. The following limits apply to this name:
@@ -884,7 +891,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to the
     #       dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON object.
@@ -903,7 +909,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the source
     #       queues that can specify this queue as the dead-letter queue and
     #       redrive messages. You can specify this parameter only when the
@@ -975,7 +980,6 @@ module Aws::SQS
     #
     #       * If the queue has `ContentBasedDeduplication` set, your
     #         `MessageDeduplicationId` overrides the generated one.
-    #
     #     * When `ContentBasedDeduplication` is in effect, messages with
     #       identical content sent within the deduplication interval are
     #       treated as duplicates and only one copy of the message is
@@ -1103,12 +1107,14 @@ module Aws::SQS
     # automatically deletes messages left in a queue longer than the
     # retention period configured for the queue.
     #
-    # <note markdown="1"> The `ReceiptHandle` is associated with a *specific instance* of
-    # receiving a message. If you receive a message more than once, the
-    # `ReceiptHandle` is different each time you receive a message. When you
-    # use the `DeleteMessage` action, you must provide the most recently
-    # received `ReceiptHandle` for the message (otherwise, the request
-    # succeeds, but the message will not be deleted).
+    # <note markdown="1"> Each time you receive a message, meaning when a consumer retrieves a
+    # message from the queue, it comes with a unique `ReceiptHandle`. If you
+    # receive the same message more than once, you will get a different
+    # `ReceiptHandle` each time. When you want to delete a message using the
+    # `DeleteMessage` action, you must use the `ReceiptHandle` from the most
+    # recent time you received the message. If you use an old
+    # `ReceiptHandle`, the request will succeed, but the message might not
+    # be deleted.
     #
     #  For standard queues, it is possible to receive a message even after
     # you delete it. This might happen on rare occasions if one of the
@@ -1348,7 +1354,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to the
     #       dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON object.
@@ -1367,7 +1372,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the source
     #       queues that can specify this queue as the dead-letter queue and
     #       redrive messages. You can specify this parameter only when the
@@ -1481,29 +1485,32 @@ module Aws::SQS
       req.send_request(options)
     end
 
-    # Returns the URL of an existing Amazon SQS queue.
-    #
-    # To access a queue that belongs to another AWS account, use the
-    # `QueueOwnerAWSAccountId` parameter to specify the account ID of the
-    # queue's owner. The queue's owner must grant you permission to access
-    # the queue. For more information about shared queue access, see `
-    # AddPermission ` or see [Allow Developers to Write Messages to a Shared
-    # Queue][1] in the *Amazon SQS Developer Guide*.
+    # The `GetQueueUrl` API returns the URL of an existing Amazon SQS queue.
+    # This is useful when you know the queue's name but need to retrieve
+    # its URL for further operations.
+    #
+    # To access a queue owned by another Amazon Web Services account, use
+    # the `QueueOwnerAWSAccountId` parameter to specify the account ID of
+    # the queue's owner. Note that the queue owner must grant you the
+    # necessary permissions to access the queue. For more information about
+    # accessing shared queues, see the ` AddPermission ` API or [Allow
+    # developers to write messages to a shared queue][1] in the *Amazon SQS
+    # Developer Guide*.
     #
     #
     #
     # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
     #
     # @option params [required, String] :queue_name
-    #   The name of the queue whose URL must be fetched. Maximum 80
-    #   characters. Valid values: alphanumeric characters, hyphens (`-`), and
-    #   underscores (`_`).
-    #
-    #   Queue URLs and names are case-sensitive.
+    #   (Required) The name of the queue for which you want to fetch the URL.
+    #   The name can be up to 80 characters long and can include alphanumeric
+    #   characters, hyphens (-), and underscores (\_). Queue URLs and names
+    #   are case-sensitive.
     #
     # @option params [String] :queue_owner_aws_account_id
-    #   The Amazon Web Services account ID of the account that created the
-    #   queue.
+    #   (Optional) The Amazon Web Services account ID of the account that
+    #   created the queue. This is only required when you are attempting to
+    #   access a queue owned by another Amazon Web Services account.
     #
     # @return [Types::GetQueueUrlResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -1803,7 +1810,7 @@ module Aws::SQS
     # Developer Guide*.
     #
     # Short poll is the default behavior where a weighted random set of
-    # machines is sampled on a `ReceiveMessage` call. Thus, only the
+    # machines is sampled on a `ReceiveMessage` call. Therefore, only the
     # messages on the sampled machines are returned. If the number of
     # messages in the queue is small (fewer than 1,000), you most likely get
     # fewer messages than you requested per `ReceiveMessage` call. If the
@@ -1833,14 +1840,8 @@ module Aws::SQS
     # You can provide the `VisibilityTimeout` parameter in your request. The
     # parameter is applied to the messages that Amazon SQS returns in the
     # response. If you don't include the parameter, the overall visibility
-    # timeout for the queue is used for the returned messages. For more
-    # information, see [Visibility Timeout][4] in the *Amazon SQS Developer
-    # Guide*.
-    #
-    # A message that isn't deleted or a message whose visibility isn't
-    # extended before the visibility timeout expires counts as a failed
-    # receive. Depending on the configuration of the queue, the message
-    # might be sent to the dead-letter queue.
+    # timeout for the queue is used for the returned messages. The default
+    # visibility timeout for a queue is 30 seconds.
     #
     # <note markdown="1"> In the future, new attributes might be added. If you write code that
     # calls this action, we recommend that you structure your code so that
@@ -1853,7 +1854,6 @@ module Aws::SQS
     # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html
     # [2]: https://www.ietf.org/rfc/rfc1321.txt
     # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html
-    # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
     #
     # @option params [required, String] :queue_url
     #   The URL of the Amazon SQS queue from which messages are received.
@@ -1861,9 +1861,9 @@ module Aws::SQS
     #   Queue URLs and names are case-sensitive.
     #
     # @option params [Array<String>] :attribute_names
-    #   This parameter has been deprecated but will be supported for backward
-    #   compatibility. To provide attribute names, you are encouraged to use
-    #   `MessageSystemAttributeNames`.
+    #   This parameter has been discontinued but will be supported for
+    #   backward compatibility. To provide attribute names, you are encouraged
+    #   to use `MessageSystemAttributeNames`.
     #
     #   A list of attributes that need to be returned along with each message.
     #   These attributes include:
@@ -1885,7 +1885,6 @@ module Aws::SQS
     #
     #     * For an IAM role, returns the IAM role ID, for example
     #       `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
-    #
     #   * `SentTimestamp` – Returns the time the message was sent to the queue
     #     ([epoch time][1] in milliseconds).
     #
@@ -1929,7 +1928,6 @@ module Aws::SQS
     #
     #     * For an IAM role, returns the IAM role ID, for example
     #       `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
-    #
     #   * `SentTimestamp` – Returns the time the message was sent to the queue
     #     ([epoch time][1] in milliseconds).
     #
@@ -1982,14 +1980,47 @@ module Aws::SQS
     # @option params [Integer] :visibility_timeout
     #   The duration (in seconds) that the received messages are hidden from
     #   subsequent retrieve requests after being retrieved by a
-    #   `ReceiveMessage` request.
+    #   `ReceiveMessage` request. If not specified, the default visibility
+    #   timeout for the queue is used, which is 30 seconds.
+    #
+    #   Understanding `VisibilityTimeout`:
+    #
+    #   * When a message is received from a queue, it becomes temporarily
+    #     invisible to other consumers for the duration of the visibility
+    #     timeout. This prevents multiple consumers from processing the same
+    #     message simultaneously. If the message is not deleted or its
+    #     visibility timeout is not extended before the timeout expires, it
+    #     becomes visible again and can be retrieved by other consumers.
+    #
+    #   * Setting an appropriate visibility timeout is crucial. If it's too
+    #     short, the message might become visible again before processing is
+    #     complete, leading to duplicate processing. If it's too long, it
+    #     delays the reprocessing of messages if the initial processing fails.
+    #
+    #   * You can adjust the visibility timeout using the
+    #     `--visibility-timeout` parameter in the `receive-message` command to
+    #     match the processing time required by your application.
+    #
+    #   * A message that isn't deleted or a message whose visibility isn't
+    #     extended before the visibility timeout expires counts as a failed
+    #     receive. Depending on the configuration of the queue, the message
+    #     might be sent to the dead-letter queue.
+    #
+    #   For more information, see [Visibility Timeout][1] in the *Amazon SQS
+    #   Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
     #
     # @option params [Integer] :wait_time_seconds
     #   The duration (in seconds) for which the call waits for a message to
     #   arrive in the queue before returning. If a message is available, the
     #   call returns sooner than `WaitTimeSeconds`. If no messages are
     #   available and the wait time expires, the call does not return a
-    #   message list.
+    #   message list. If you are using the Java SDK, it returns a
+    #   `ReceiveMessageResponse` object, which has a empty list instead of a
+    #   Null object.
     #
     #   To avoid HTTP errors, ensure that the HTTP response timeout for
     #   `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -2256,7 +2287,6 @@ module Aws::SQS
     #
     #     * If the queue has `ContentBasedDeduplication` set, your
     #       `MessageDeduplicationId` overrides the generated one.
-    #
     #   * When `ContentBasedDeduplication` is in effect, messages with
     #     identical content sent within the deduplication interval are treated
     #     as duplicates and only one copy of the message is delivered.
@@ -2571,7 +2601,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to the
     #       dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON object.
@@ -2590,7 +2619,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the source
     #       queues that can specify this queue as the dead-letter queue and
     #       redrive messages. You can specify this parameter only when the
@@ -2650,7 +2678,6 @@ module Aws::SQS
     #
     #       * If the queue has `ContentBasedDeduplication` set, your
     #         `MessageDeduplicationId` overrides the generated one.
-    #
     #     * When `ContentBasedDeduplication` is in effect, messages with
     #       identical content sent within the deduplication interval are
     #       treated as duplicates and only one copy of the message is
@@ -2908,7 +2935,7 @@ module Aws::SQS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-sqs'
-      context[:gem_version] = '1.88.0'
+      context[:gem_version] = '1.90.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-sqs/queue.rb

@@ -216,9 +216,9 @@ module Aws::SQS
     #   })
     # @param [Hash] options ({})
     # @option options [Array<String>] :attribute_names
-    #   This parameter has been deprecated but will be supported for backward
-    #   compatibility. To provide attribute names, you are encouraged to use
-    #   `MessageSystemAttributeNames`.
+    #   This parameter has been discontinued but will be supported for
+    #   backward compatibility. To provide attribute names, you are encouraged
+    #   to use `MessageSystemAttributeNames`.
     #
     #   A list of attributes that need to be returned along with each message.
     #   These attributes include:
@@ -240,7 +240,6 @@ module Aws::SQS
     #
     #     * For an IAM role, returns the IAM role ID, for example
     #       `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
-    #
     #   * `SentTimestamp` – Returns the time the message was sent to the queue
     #     ([epoch time][1] in milliseconds).
     #
@@ -283,7 +282,6 @@ module Aws::SQS
     #
     #     * For an IAM role, returns the IAM role ID, for example
     #       `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
-    #
     #   * `SentTimestamp` – Returns the time the message was sent to the queue
     #     ([epoch time][1] in milliseconds).
     #
@@ -333,13 +331,46 @@ module Aws::SQS
     # @option options [Integer] :visibility_timeout
     #   The duration (in seconds) that the received messages are hidden from
     #   subsequent retrieve requests after being retrieved by a
-    #   `ReceiveMessage` request.
+    #   `ReceiveMessage` request. If not specified, the default visibility
+    #   timeout for the queue is used, which is 30 seconds.
+    #
+    #   Understanding `VisibilityTimeout`:
+    #
+    #   * When a message is received from a queue, it becomes temporarily
+    #     invisible to other consumers for the duration of the visibility
+    #     timeout. This prevents multiple consumers from processing the same
+    #     message simultaneously. If the message is not deleted or its
+    #     visibility timeout is not extended before the timeout expires, it
+    #     becomes visible again and can be retrieved by other consumers.
+    #
+    #   * Setting an appropriate visibility timeout is crucial. If it's too
+    #     short, the message might become visible again before processing is
+    #     complete, leading to duplicate processing. If it's too long, it
+    #     delays the reprocessing of messages if the initial processing fails.
+    #
+    #   * You can adjust the visibility timeout using the
+    #     `--visibility-timeout` parameter in the `receive-message` command to
+    #     match the processing time required by your application.
+    #
+    #   * A message that isn't deleted or a message whose visibility isn't
+    #     extended before the visibility timeout expires counts as a failed
+    #     receive. Depending on the configuration of the queue, the message
+    #     might be sent to the dead-letter queue.
+    #
+    #   For more information, see [Visibility Timeout][1] in the *Amazon SQS
+    #   Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
     # @option options [Integer] :wait_time_seconds
     #   The duration (in seconds) for which the call waits for a message to
     #   arrive in the queue before returning. If a message is available, the
     #   call returns sooner than `WaitTimeSeconds`. If no messages are
     #   available and the wait time expires, the call does not return a
-    #   message list.
+    #   message list. If you are using the Java SDK, it returns a
+    #   `ReceiveMessageResponse` object, which has a empty list instead of a
+    #   Null object.
     #
     #   To avoid HTTP errors, ensure that the HTTP response timeout for
     #   `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -548,7 +579,6 @@ module Aws::SQS
     #
     #     * If the queue has `ContentBasedDeduplication` set, your
     #       `MessageDeduplicationId` overrides the generated one.
-    #
     #   * When `ContentBasedDeduplication` is in effect, messages with
     #     identical content sent within the deduplication interval are treated
     #     as duplicates and only one copy of the message is delivered.
@@ -731,7 +761,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to the
     #       dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON object.
@@ -750,7 +779,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the source
     #       queues that can specify this queue as the dead-letter queue and
     #       redrive messages. You can specify this parameter only when the
@@ -810,7 +838,6 @@ module Aws::SQS
     #
     #       * If the queue has `ContentBasedDeduplication` set, your
     #         `MessageDeduplicationId` overrides the generated one.
-    #
     #     * When `ContentBasedDeduplication` is in effect, messages with
     #       identical content sent within the deduplication interval are
     #       treated as duplicates and only one copy of the message is

data/lib/aws-sdk-sqs/queue_poller.rb

@@ -134,7 +134,7 @@ module Aws
     # ### `:idle_timeout` Option
     #
     # This is a configurable, maximum number of seconds to wait for a
-    # new message before the polling loop exists. By default, there is
+    # new message before the polling loop exits. By default, there is
     # no idle timeout.
     #
     #     # stops polling after a minute of no received messages

data/lib/aws-sdk-sqs/resource.rb

@@ -112,7 +112,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to the
     #       dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON object.
@@ -131,7 +130,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the source
     #       queues that can specify this queue as the dead-letter queue and
     #       redrive messages. You can specify this parameter only when the
@@ -203,7 +201,6 @@ module Aws::SQS
     #
     #       * If the queue has `ContentBasedDeduplication` set, your
     #         `MessageDeduplicationId` overrides the generated one.
-    #
     #     * When `ContentBasedDeduplication` is in effect, messages with
     #       identical content sent within the deduplication interval are
     #       treated as duplicates and only one copy of the message is
@@ -311,14 +308,14 @@ module Aws::SQS
     #   })
     # @param [Hash] options ({})
     # @option options [required, String] :queue_name
-    #   The name of the queue whose URL must be fetched. Maximum 80
-    #   characters. Valid values: alphanumeric characters, hyphens (`-`), and
-    #   underscores (`_`).
-    #
-    #   Queue URLs and names are case-sensitive.
+    #   (Required) The name of the queue for which you want to fetch the URL.
+    #   The name can be up to 80 characters long and can include alphanumeric
+    #   characters, hyphens (-), and underscores (\_). Queue URLs and names
+    #   are case-sensitive.
     # @option options [String] :queue_owner_aws_account_id
-    #   The Amazon Web Services account ID of the account that created the
-    #   queue.
+    #   (Optional) The Amazon Web Services account ID of the account that
+    #   created the queue. This is only required when you are attempting to
+    #   access a queue owned by another Amazon Web Services account.
     # @return [Queue]
     def get_queue_by_name(options = {})
       resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do

data/lib/aws-sdk-sqs/types.rb

@@ -334,7 +334,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to
     #       the dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON
@@ -353,7 +352,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
     #       source queues that can specify this queue as the dead-letter
     #       queue and redrive messages. You can specify this parameter only
@@ -426,7 +424,6 @@ module Aws::SQS
     #
     #       * If the queue has `ContentBasedDeduplication` set, your
     #         `MessageDeduplicationId` overrides the generated one.
-    #
     #     * When `ContentBasedDeduplication` is in effect, messages with
     #       identical content sent within the deduplication interval are
     #       treated as duplicates and only one copy of the message is
@@ -766,7 +763,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to
     #       the dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON
@@ -785,7 +781,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
     #       source queues that can specify this queue as the dead-letter
     #       queue and redrive messages. You can specify this parameter only
@@ -898,17 +893,20 @@ module Aws::SQS
       include Aws::Structure
     end
 
-    # @!attribute [rw] queue_name
-    #   The name of the queue whose URL must be fetched. Maximum 80
-    #   characters. Valid values: alphanumeric characters, hyphens (`-`),
-    #   and underscores (`_`).
+    # Retrieves the URL of an existing queue based on its name and,
+    # optionally, the Amazon Web Services account ID.
     #
-    #   Queue URLs and names are case-sensitive.
+    # @!attribute [rw] queue_name
+    #   (Required) The name of the queue for which you want to fetch the
+    #   URL. The name can be up to 80 characters long and can include
+    #   alphanumeric characters, hyphens (-), and underscores (\_). Queue
+    #   URLs and names are case-sensitive.
     #   @return [String]
     #
     # @!attribute [rw] queue_owner_aws_account_id
-    #   The Amazon Web Services account ID of the account that created the
-    #   queue.
+    #   (Optional) The Amazon Web Services account ID of the account that
+    #   created the queue. This is only required when you are attempting to
+    #   access a queue owned by another Amazon Web Services account.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueUrlRequest AWS API Documentation
@@ -939,7 +937,7 @@ module Aws::SQS
       include Aws::Structure
     end
 
-    # The `accountId` is invalid.
+    # The specified ID is invalid.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -1011,7 +1009,7 @@ module Aws::SQS
       include Aws::Structure
     end
 
-    # When the request to a queue is not HTTPS and SigV4.
+    # The request was not made over HTTPS or did not use SigV4 for signing.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -1610,7 +1608,8 @@ module Aws::SQS
       include Aws::Structure
     end
 
-    # The specified queue doesn't exist.
+    # Ensure that the `QueueUrl` is correct and that the queue has not been
+    # deleted.
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -1651,6 +1650,8 @@ module Aws::SQS
       include Aws::Structure
     end
 
+    # Retrieves one or more messages from a specified queue.
+    #
     # @!attribute [rw] queue_url
     #   The URL of the Amazon SQS queue from which messages are received.
     #
@@ -1658,7 +1659,7 @@ module Aws::SQS
     #   @return [String]
     #
     # @!attribute [rw] attribute_names
-    #   This parameter has been deprecated but will be supported for
+    #   This parameter has been discontinued but will be supported for
     #   backward compatibility. To provide attribute names, you are
     #   encouraged to use `MessageSystemAttributeNames`.
     #
@@ -1683,7 +1684,6 @@ module Aws::SQS
     #
     #     * For an IAM role, returns the IAM role ID, for example
     #       `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
-    #
     #   * `SentTimestamp` – Returns the time the message was sent to the
     #     queue ([epoch time][1] in milliseconds).
     #
@@ -1730,7 +1730,6 @@ module Aws::SQS
     #
     #     * For an IAM role, returns the IAM role ID, for example
     #       `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
-    #
     #   * `SentTimestamp` – Returns the time the message was sent to the
     #     queue ([epoch time][1] in milliseconds).
     #
@@ -1787,7 +1786,39 @@ module Aws::SQS
     # @!attribute [rw] visibility_timeout
     #   The duration (in seconds) that the received messages are hidden from
     #   subsequent retrieve requests after being retrieved by a
-    #   `ReceiveMessage` request.
+    #   `ReceiveMessage` request. If not specified, the default visibility
+    #   timeout for the queue is used, which is 30 seconds.
+    #
+    #   Understanding `VisibilityTimeout`:
+    #
+    #   * When a message is received from a queue, it becomes temporarily
+    #     invisible to other consumers for the duration of the visibility
+    #     timeout. This prevents multiple consumers from processing the same
+    #     message simultaneously. If the message is not deleted or its
+    #     visibility timeout is not extended before the timeout expires, it
+    #     becomes visible again and can be retrieved by other consumers.
+    #
+    #   * Setting an appropriate visibility timeout is crucial. If it's too
+    #     short, the message might become visible again before processing is
+    #     complete, leading to duplicate processing. If it's too long, it
+    #     delays the reprocessing of messages if the initial processing
+    #     fails.
+    #
+    #   * You can adjust the visibility timeout using the
+    #     `--visibility-timeout` parameter in the `receive-message` command
+    #     to match the processing time required by your application.
+    #
+    #   * A message that isn't deleted or a message whose visibility isn't
+    #     extended before the visibility timeout expires counts as a failed
+    #     receive. Depending on the configuration of the queue, the message
+    #     might be sent to the dead-letter queue.
+    #
+    #   For more information, see [Visibility Timeout][1] in the *Amazon SQS
+    #   Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
     #   @return [Integer]
     #
     # @!attribute [rw] wait_time_seconds
@@ -1795,7 +1826,9 @@ module Aws::SQS
     #   arrive in the queue before returning. If a message is available, the
     #   call returns sooner than `WaitTimeSeconds`. If no messages are
     #   available and the wait time expires, the call does not return a
-    #   message list.
+    #   message list. If you are using the Java SDK, it returns a
+    #   `ReceiveMessageResponse` object, which has a empty list instead of a
+    #   Null object.
     #
     #   To avoid HTTP errors, ensure that the HTTP response timeout for
     #   `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -1925,18 +1958,16 @@ module Aws::SQS
 
     # The request was denied due to request throttling.
     #
-    # * The rate of requests per second exceeds the Amazon Web Services KMS
-    #   request quota for an account and Region.
+    # * Exceeds the permitted request rate for the queue or for the
+    #   recipient of the request.
     #
-    # * A burst or sustained high rate of requests to change the state of
-    #   the same KMS key. This condition is often known as a "hot key."
+    # * Ensure that the request rate is within the Amazon SQS limits for
+    #   sending messages. For more information, see [Amazon SQS quotas][1]
+    #   in the *Amazon SQS Developer Guide*.
     #
-    # * Requests for operations on KMS keys in a Amazon Web Services
-    #   CloudHSM key store might be throttled at a lower-than-expected rate
-    #   when the Amazon Web Services CloudHSM cluster associated with the
-    #   Amazon Web Services CloudHSM key store is processing numerous
-    #   commands, including those unrelated to the Amazon Web Services
-    #   CloudHSM key store.
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-quotas.html#quotas-requests
     #
     # @!attribute [rw] message
     #   @return [String]
@@ -2062,7 +2093,6 @@ module Aws::SQS
     #
     #     * If the queue has `ContentBasedDeduplication` set, your
     #       `MessageDeduplicationId` overrides the generated one.
-    #
     #   * When `ContentBasedDeduplication` is in effect, messages with
     #     identical content sent within the deduplication interval are
     #     treated as duplicates and only one copy of the message is
@@ -2331,7 +2361,6 @@ module Aws::SQS
     #
     #     * If the queue has `ContentBasedDeduplication` set, your
     #       `MessageDeduplicationId` overrides the generated one.
-    #
     #   * When `ContentBasedDeduplication` is in effect, messages with
     #     identical content sent within the deduplication interval are
     #     treated as duplicates and only one copy of the message is
@@ -2547,7 +2576,6 @@ module Aws::SQS
     #       Default: 10. When the `ReceiveCount` for a message exceeds the
     #       `maxReceiveCount` for a queue, Amazon SQS moves the message to
     #       the dead-letter-queue.
-    #
     #   * `RedriveAllowPolicy` – The string that includes the parameters for
     #     the permissions for the dead-letter queue redrive permission and
     #     which source queues can specify dead-letter queues as a JSON
@@ -2566,7 +2594,6 @@ module Aws::SQS
     #
     #       * `byQueue` – Only queues specified by the `sourceQueueArns`
     #         parameter can specify this queue as the dead-letter queue.
-    #
     #     * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
     #       source queues that can specify this queue as the dead-letter
     #       queue and redrive messages. You can specify this parameter only
@@ -2628,7 +2655,6 @@ module Aws::SQS
     #
     #       * If the queue has `ContentBasedDeduplication` set, your
     #         `MessageDeduplicationId` overrides the generated one.
-    #
     #     * When `ContentBasedDeduplication` is in effect, messages with
     #       identical content sent within the deduplication interval are
     #       treated as duplicates and only one copy of the message is
@@ -2758,7 +2784,16 @@ module Aws::SQS
       include Aws::Structure
     end
 
-    # The batch request contains more entries than permissible.
+    # The batch request contains more entries than permissible. For Amazon
+    # SQS, the maximum number of entries you can include in a single
+    # [SendMessageBatch][1], [DeleteMessageBatch][2], or
+    # [ChangeMessageVisibilityBatch][3] request is 10.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html
+    # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteMessageBatch.html
+    # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ChangeMessageVisibilityBatch.html
     #
     # @!attribute [rw] message
     #   @return [String]

data/lib/aws-sdk-sqs.rb

@@ -56,7 +56,7 @@ module Aws::SQS
   autoload :Message, 'aws-sdk-sqs/message'
   autoload :Queue, 'aws-sdk-sqs/queue'
 
-  GEM_VERSION = '1.88.0'
+  GEM_VERSION = '1.90.0'
 
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-sqs
 version: !ruby/object:Gem::Version
-  version: 1.88.0
+  version: 1.90.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-11-06 00:00:00.000000000 Z
+date: 2025-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core