aws-sdk-sqs 1.88.0 → 1.107.0

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

@@ -7,36 +7,36 @@
 #
 # WARNING ABOUT GENERATED CODE
 
-require 'seahorse/client/plugins/content_length.rb'
-require 'aws-sdk-core/plugins/credentials_configuration.rb'
-require 'aws-sdk-core/plugins/logging.rb'
-require 'aws-sdk-core/plugins/param_converter.rb'
-require 'aws-sdk-core/plugins/param_validator.rb'
-require 'aws-sdk-core/plugins/user_agent.rb'
-require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
-require 'aws-sdk-core/plugins/retry_errors.rb'
-require 'aws-sdk-core/plugins/global_configuration.rb'
-require 'aws-sdk-core/plugins/regional_endpoint.rb'
-require 'aws-sdk-core/plugins/endpoint_discovery.rb'
-require 'aws-sdk-core/plugins/endpoint_pattern.rb'
-require 'aws-sdk-core/plugins/response_paging.rb'
-require 'aws-sdk-core/plugins/stub_responses.rb'
-require 'aws-sdk-core/plugins/idempotency_token.rb'
-require 'aws-sdk-core/plugins/invocation_id.rb'
-require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
-require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
-require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
-require 'aws-sdk-core/plugins/transfer_encoding.rb'
-require 'aws-sdk-core/plugins/http_checksum.rb'
-require 'aws-sdk-core/plugins/checksum_algorithm.rb'
-require 'aws-sdk-core/plugins/request_compression.rb'
-require 'aws-sdk-core/plugins/defaults_mode.rb'
-require 'aws-sdk-core/plugins/recursion_detection.rb'
-require 'aws-sdk-core/plugins/telemetry.rb'
-require 'aws-sdk-core/plugins/sign.rb'
-require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
-require 'aws-sdk-sqs/plugins/queue_urls.rb'
-require 'aws-sdk-sqs/plugins/md5s.rb'
+require 'seahorse/client/plugins/content_length'
+require 'aws-sdk-core/plugins/credentials_configuration'
+require 'aws-sdk-core/plugins/logging'
+require 'aws-sdk-core/plugins/param_converter'
+require 'aws-sdk-core/plugins/param_validator'
+require 'aws-sdk-core/plugins/user_agent'
+require 'aws-sdk-core/plugins/helpful_socket_errors'
+require 'aws-sdk-core/plugins/retry_errors'
+require 'aws-sdk-core/plugins/global_configuration'
+require 'aws-sdk-core/plugins/regional_endpoint'
+require 'aws-sdk-core/plugins/endpoint_discovery'
+require 'aws-sdk-core/plugins/endpoint_pattern'
+require 'aws-sdk-core/plugins/response_paging'
+require 'aws-sdk-core/plugins/stub_responses'
+require 'aws-sdk-core/plugins/idempotency_token'
+require 'aws-sdk-core/plugins/invocation_id'
+require 'aws-sdk-core/plugins/jsonvalue_converter'
+require 'aws-sdk-core/plugins/client_metrics_plugin'
+require 'aws-sdk-core/plugins/client_metrics_send_plugin'
+require 'aws-sdk-core/plugins/transfer_encoding'
+require 'aws-sdk-core/plugins/http_checksum'
+require 'aws-sdk-core/plugins/checksum_algorithm'
+require 'aws-sdk-core/plugins/request_compression'
+require 'aws-sdk-core/plugins/defaults_mode'
+require 'aws-sdk-core/plugins/recursion_detection'
+require 'aws-sdk-core/plugins/telemetry'
+require 'aws-sdk-core/plugins/sign'
+require 'aws-sdk-core/plugins/protocols/json_rpc'
+require 'aws-sdk-sqs/plugins/queue_urls'
+require 'aws-sdk-sqs/plugins/md5s'
 
 module Aws::SQS
   # An API client for SQS.  To construct a client, you need to configure a `:region` and `:credentials`.
@@ -99,8 +99,8 @@ module Aws::SQS
     #     class name or an instance of a plugin class.
     #
     #   @option options [required, Aws::CredentialProvider] :credentials
-    #     Your AWS credentials. This can be an instance of any one of the
-    #     following classes:
+    #     Your AWS credentials used for authentication. This can be any class that includes and implements
+    #     `Aws::CredentialProvider`, or instance of any one of the following classes:
     #
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
@@ -128,22 +128,24 @@ module Aws::SQS
     #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
     #       from the Cognito Identity service.
     #
-    #     When `:credentials` are not configured directly, the following
-    #     locations will be searched for credentials:
+    #     When `:credentials` are not configured directly, the following locations will be searched for credentials:
     #
     #     * `Aws.config[:credentials]`
+    #
     #     * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
     #       `:account_id` options.
-    #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'],
-    #       ENV['AWS_SESSION_TOKEN'], and ENV['AWS_ACCOUNT_ID']
+    #
+    #     * `ENV['AWS_ACCESS_KEY_ID']`, `ENV['AWS_SECRET_ACCESS_KEY']`,
+    #       `ENV['AWS_SESSION_TOKEN']`, and `ENV['AWS_ACCOUNT_ID']`.
+    #
     #     * `~/.aws/credentials`
+    #
     #     * `~/.aws/config`
-    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
-    #       are very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts. Instance profile credential
-    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
-    #       to true.
+    #
+    #     * EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive.
+    #       Construct and pass an instance of `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
+    #       enable retries and extended timeouts. Instance profile credential fetching can be disabled by
+    #       setting `ENV['AWS_EC2_METADATA_DISABLED']` to `true`.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -171,6 +173,11 @@ module Aws::SQS
     #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
     #     not retry instead of sleeping.
     #
+    #   @option options [Array<String>] :auth_scheme_preference
+    #     A list of preferred authentication schemes to use when making a request. Supported values are:
+    #     `sigv4`, `sigv4a`, `httpBearerAuth`, and `noAuth`. When set using `ENV['AWS_AUTH_SCHEME_PREFERENCE']` or in
+    #     shared config as `auth_scheme_preference`, the value should be a comma-separated list.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -204,8 +211,7 @@ module Aws::SQS
     #     accepted modes and the configuration defaults that are included.
     #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
-    #     Set to true to disable SDK automatically adding host prefix
-    #     to default service endpoint when available.
+    #     When `true`, the SDK will not prepend the modeled host prefix to the endpoint.
     #
     #   @option options [Boolean] :disable_request_compression (false)
     #     When set to 'true' the request body will not be compressed
@@ -258,14 +264,37 @@ module Aws::SQS
     #     4 times. Used in `standard` and `adaptive` retry modes.
     #
     #   @option options [String] :profile ("default")
-    #     Used when loading credentials from the shared credentials file
-    #     at HOME/.aws/credentials.  When not specified, 'default' is used.
+    #     Used when loading credentials from the shared credentials file at `HOME/.aws/credentials`.
+    #     When not specified, 'default' is used.
+    #
+    #   @option options [String] :request_checksum_calculation ("when_supported")
+    #     Determines when a checksum will be calculated for request payloads. Values are:
+    #
+    #     * `when_supported` - (default) When set, a checksum will be
+    #       calculated for all request payloads of operations modeled with the
+    #       `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
+    #       `requestAlgorithmMember` is modeled.
+    #     * `when_required` - When set, a checksum will only be calculated for
+    #       request payloads of operations modeled with the  `httpChecksum` trait where
+    #       `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
+    #       is modeled and supplied.
     #
     #   @option options [Integer] :request_min_compression_size_bytes (10240)
     #     The minimum size in bytes that triggers compression for request
     #     bodies. The value must be non-negative integer value between 0
     #     and 10485780 bytes inclusive.
     #
+    #   @option options [String] :response_checksum_validation ("when_supported")
+    #     Determines when checksum validation will be performed on response payloads. Values are:
+    #
+    #     * `when_supported` - (default) When set, checksum validation is performed on all
+    #       response payloads of operations modeled with the `httpChecksum` trait where
+    #       `responseAlgorithms` is modeled, except when no modeled checksum algorithms
+    #       are supported.
+    #     * `when_required` - When set, checksum validation is not performed on
+    #       response payloads of operations unless the checksum algorithm is supported and
+    #       the `requestValidationModeMember` member is set to `ENABLED`.
+    #
     #   @option options [Proc] :retry_backoff
     #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
     #     This option is only used in the `legacy` retry mode.
@@ -356,8 +385,8 @@ module Aws::SQS
     #     `Aws::Telemetry::OTelProvider` for telemetry provider.
     #
     #   @option options [Aws::TokenProvider] :token_provider
-    #     A Bearer Token Provider. This can be an instance of any one of the
-    #     following classes:
+    #     Your Bearer token used for authentication. This can be any class that includes and implements
+    #     `Aws::TokenProvider`, or instance of any one of the following classes:
     #
     #     * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
     #       tokens.
@@ -652,7 +681,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.
     #
@@ -775,7 +804,7 @@ module Aws::SQS
     #   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 [Moving From a Standard Queue to a FIFO Queue][1]
+    #   information, see [Moving From a standard queue to a FIFO queue][1]
     #   in the *Amazon SQS Developer Guide*.
     #
     #    </note>
@@ -795,20 +824,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.
+    #
+    # When creating queues, keep the following points in mind:
     #
-    # * 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.
+    # * 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 the queue name, attribute names, or attribute values don't match
-    #   an existing queue, `CreateQueue` returns an error.
+    # * 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 +849,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:
@@ -842,8 +878,8 @@ module Aws::SQS
     #
     #   * `MaximumMessageSize` – The limit of how many bytes a message can
     #     contain before Amazon SQS rejects it. Valid values: An integer from
-    #     1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). Default: 262,144
-    #     (256 KiB).
+    #     1,024 bytes (1 KiB) to 1,048,576 bytes (1 MiB). Default: 1,048,576
+    #     bytes (1 MiB).
     #
     #   * `MessageRetentionPeriod` – The length of time, in seconds, for which
     #     Amazon SQS retains a message. Valid values: An integer from 60
@@ -884,7 +920,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 +938,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 +1009,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 +1136,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 +1383,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 +1401,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 +1514,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 +1839,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 +1869,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 +1883,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 +1890,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 +1914,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).
     #
@@ -1897,8 +1925,7 @@ module Aws::SQS
     #     producer that calls the ` SendMessage ` action.
     #
     #   * `MessageGroupId` – Returns the value provided by the producer that
-    #     calls the ` SendMessage ` action. Messages with the same
-    #     `MessageGroupId` are returned in sequence.
+    #     calls the ` SendMessage ` action.
     #
     #   * `SequenceNumber` – Returns the value provided by Amazon SQS.
     #
@@ -1929,7 +1956,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).
     #
@@ -1941,8 +1967,7 @@ module Aws::SQS
     #     producer that calls the ` SendMessage ` action.
     #
     #   * `MessageGroupId` – Returns the value provided by the producer that
-    #     calls the ` SendMessage ` action. Messages with the same
-    #     `MessageGroupId` are returned in sequence.
+    #     calls the ` SendMessage ` action.
     #
     #   * `SequenceNumber` – Returns the value provided by Amazon SQS.
     #
@@ -1982,14 +2007,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`
@@ -2042,7 +2100,8 @@ module Aws::SQS
     #   * While messages with a particular `MessageGroupId` are invisible, no
     #     more messages belonging to the same `MessageGroupId` are returned
     #     until the visibility timeout expires. You can still receive messages
-    #     with another `MessageGroupId` as long as it is also visible.
+    #     with another `MessageGroupId` from your FIFO queue as long as they
+    #     are visible.
     #
     #   * If a caller of `ReceiveMessage` can't track the
     #     `ReceiveRequestAttemptId`, no retries work until the original
@@ -2163,11 +2222,10 @@ module Aws::SQS
     #  `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
     # \| `#x10000` to `#x10FFFF`
     #
-    #  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.
+    #  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.
     #
     #
     #
@@ -2180,7 +2238,7 @@ module Aws::SQS
     #
     # @option params [required, String] :message_body
     #   The message to send. The minimum size is one character. The maximum
-    #   size is 256 KiB.
+    #   size is 1 MiB or 1,048,576 bytes
     #
     #   A message can include only XML, JSON, and unformatted text. The
     #   following Unicode characters are allowed. For more information, see
@@ -2189,11 +2247,10 @@ module Aws::SQS
     #    `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
     #   \| `#x10000` to `#x10FFFF`
     #
-    #    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.
+    #    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.
     #
     #
     #
@@ -2256,7 +2313,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.
@@ -2294,34 +2350,54 @@ module Aws::SQS
     #   [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagededuplicationid-property.html
     #
     # @option params [String] :message_group_id
-    #   This parameter applies only to FIFO (first-in-first-out) queues.
-    #
-    #   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 `MessageGroupId` 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.
-    #
-    #   * You must associate a non-empty `MessageGroupId` with a message. If
-    #     you don't provide a `MessageGroupId`, the action fails.
-    #
-    #   * `ReceiveMessage` might return messages with multiple
+    #   `MessageGroupId` is an attribute used in Amazon SQS FIFO
+    #   (First-In-First-Out) and standard queues. In FIFO queues,
+    #   `MessageGroupId` 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 `MessageGroupId`
+    #   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 `MessageGroupId` can be processed in parallel,
+    #   maintaining the high throughput of standard queues.
+    #
+    #   * **FIFO queues:** `MessageGroupId` 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 `MessageGroupId` 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.
+    #
+    #     If you do not provide a `MessageGroupId` when sending a message to a
+    #     FIFO queue, the action fails.
+    #
+    #     `ReceiveMessage` might return messages with multiple
     #     `MessageGroupId` values. For each `MessageGroupId`, the messages are
-    #     sorted by time sent. The caller can't specify a `MessageGroupId`.
-    #
-    #   The maximum length of `MessageGroupId` is 128 characters. Valid
-    #   values: alphanumeric characters and punctuation ``
+    #     sorted by time sent.
+    #
+    #   * **Standard queues:**Use `MessageGroupId` in standard queues to
+    #     enable fair queues. The `MessageGroupId` 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 `MessageGroupId` in all messages when
+    #     using fair queues.
+    #
+    #   The length of `MessageGroupId` is 128 characters. Valid values:
+    #   alphanumeric characters and punctuation ``
     #   (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
     #
     #   For best practices of using `MessageGroupId`, see [Using the
     #   MessageGroupId Property][1] in the *Amazon SQS Developer Guide*.
     #
-    #   `MessageGroupId` is required for FIFO queues. You can't use it for
-    #   Standard queues.
-    #
     #
     #
     #   [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html
@@ -2392,7 +2468,7 @@ module Aws::SQS
     #
     # The maximum allowed individual message size and the maximum total
     # payload size (the sum of the individual lengths of all of the batched
-    # messages) are both 256 KiB (262,144 bytes).
+    # messages) are both 1 MiB 1,048,576 bytes.
     #
     # A message can include only XML, JSON, and unformatted text. The
     # following Unicode characters are allowed. For more information, see
@@ -2401,11 +2477,10 @@ module Aws::SQS
     #  `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
     # \| `#x10000` to `#x10FFFF`
     #
-    #  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.
+    #  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.
     #
     # If you don't specify the `DelaySeconds` parameter for an entry,
     # Amazon SQS uses the default value for the queue.
@@ -2528,8 +2603,8 @@ module Aws::SQS
     #
     #   * `MaximumMessageSize` – The limit of how many bytes a message can
     #     contain before Amazon SQS rejects it. Valid values: An integer from
-    #     1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). Default: 262,144
-    #     (256 KiB).
+    #     1,024 bytes (1 KiB) up to 1,048,576 bytes (1 MiB). Default:
+    #     1,048,576 bytes (1 MiB).
     #
     #   * `MessageRetentionPeriod` – The length of time, in seconds, for which
     #     Amazon SQS retains a message. Valid values: An integer representing
@@ -2571,7 +2646,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 +2664,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 +2723,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 +2980,7 @@ module Aws::SQS
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-sqs'
-      context[:gem_version] = '1.88.0'
+      context[:gem_version] = '1.107.0'
       Seahorse::Client::Request.new(handlers, context)
     end