aws-sdk-sqs 1.89.0 → 1.93.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 0e8eb29e0242ff0070c5c2fba2e36bf9529174f3ccc28efc398798fe100b4645
4
- data.tar.gz: bba2887ad57ef051bd5aaeb1fd2c15a0c0d1a6bc759b470ec0ae43eff89a36ce
3
+ metadata.gz: f0335e2b0ba191485e73b0902284409bba3842354d71da137a9f5d7532f5d213
4
+ data.tar.gz: beb1bc08df049abba890cdcb4b3842147e08d5471b6807adc25becd61d00210b
5
5
  SHA512:
6
- metadata.gz: 89e4a89c54742e1ce39701de265a4135dc67bb940269ed4bd4e9408ddd8f5906feb06b7014ec8cf05d2f7642058813b0de4fb89d35c35d0bfe19484c373e433b
7
- data.tar.gz: afdca3b0a76cac0df36cad66f843300eab6f997d2cb6a406641105a92871c18c56d3372799ecb734746d6c012432ad70fcade0d4b7c2bc96d91d9aedd937ebaf
6
+ metadata.gz: 02c2bcda07bc8e7a753c5ad22da023b4e077cac44f3dde542db72afe7136e60b05bd48860abeb41f0b241904ba4e38997f62e6a634b8502c3ca3ec54035204d4
7
+ data.tar.gz: bc3098c15adc75fd4ecea899096957737706a5ff391f1cc6b3a8d47566c7d5cb4da75c95b4d757c9bdf3baef62165f038f83d2010cc3173cd11098c73dc6328e
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.93.0 (2025-02-18)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.92.0 (2025-02-06)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.91.0 (2025-01-15)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.90.0 (2025-01-02)
20
+ ------------------
21
+
22
+ * Feature - In-flight message typo fix from 20k to 120k.
23
+
4
24
  1.89.0 (2024-11-18)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.89.0
1
+ 1.93.0
@@ -7,36 +7,36 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
- require 'seahorse/client/plugins/content_length.rb'
11
- require 'aws-sdk-core/plugins/credentials_configuration.rb'
12
- require 'aws-sdk-core/plugins/logging.rb'
13
- require 'aws-sdk-core/plugins/param_converter.rb'
14
- require 'aws-sdk-core/plugins/param_validator.rb'
15
- require 'aws-sdk-core/plugins/user_agent.rb'
16
- require 'aws-sdk-core/plugins/helpful_socket_errors.rb'
17
- require 'aws-sdk-core/plugins/retry_errors.rb'
18
- require 'aws-sdk-core/plugins/global_configuration.rb'
19
- require 'aws-sdk-core/plugins/regional_endpoint.rb'
20
- require 'aws-sdk-core/plugins/endpoint_discovery.rb'
21
- require 'aws-sdk-core/plugins/endpoint_pattern.rb'
22
- require 'aws-sdk-core/plugins/response_paging.rb'
23
- require 'aws-sdk-core/plugins/stub_responses.rb'
24
- require 'aws-sdk-core/plugins/idempotency_token.rb'
25
- require 'aws-sdk-core/plugins/invocation_id.rb'
26
- require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
27
- require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
28
- require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
29
- require 'aws-sdk-core/plugins/transfer_encoding.rb'
30
- require 'aws-sdk-core/plugins/http_checksum.rb'
31
- require 'aws-sdk-core/plugins/checksum_algorithm.rb'
32
- require 'aws-sdk-core/plugins/request_compression.rb'
33
- require 'aws-sdk-core/plugins/defaults_mode.rb'
34
- require 'aws-sdk-core/plugins/recursion_detection.rb'
35
- require 'aws-sdk-core/plugins/telemetry.rb'
36
- require 'aws-sdk-core/plugins/sign.rb'
37
- require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
38
- require 'aws-sdk-sqs/plugins/queue_urls.rb'
39
- require 'aws-sdk-sqs/plugins/md5s.rb'
10
+ require 'seahorse/client/plugins/content_length'
11
+ require 'aws-sdk-core/plugins/credentials_configuration'
12
+ require 'aws-sdk-core/plugins/logging'
13
+ require 'aws-sdk-core/plugins/param_converter'
14
+ require 'aws-sdk-core/plugins/param_validator'
15
+ require 'aws-sdk-core/plugins/user_agent'
16
+ require 'aws-sdk-core/plugins/helpful_socket_errors'
17
+ require 'aws-sdk-core/plugins/retry_errors'
18
+ require 'aws-sdk-core/plugins/global_configuration'
19
+ require 'aws-sdk-core/plugins/regional_endpoint'
20
+ require 'aws-sdk-core/plugins/endpoint_discovery'
21
+ require 'aws-sdk-core/plugins/endpoint_pattern'
22
+ require 'aws-sdk-core/plugins/response_paging'
23
+ require 'aws-sdk-core/plugins/stub_responses'
24
+ require 'aws-sdk-core/plugins/idempotency_token'
25
+ require 'aws-sdk-core/plugins/invocation_id'
26
+ require 'aws-sdk-core/plugins/jsonvalue_converter'
27
+ require 'aws-sdk-core/plugins/client_metrics_plugin'
28
+ require 'aws-sdk-core/plugins/client_metrics_send_plugin'
29
+ require 'aws-sdk-core/plugins/transfer_encoding'
30
+ require 'aws-sdk-core/plugins/http_checksum'
31
+ require 'aws-sdk-core/plugins/checksum_algorithm'
32
+ require 'aws-sdk-core/plugins/request_compression'
33
+ require 'aws-sdk-core/plugins/defaults_mode'
34
+ require 'aws-sdk-core/plugins/recursion_detection'
35
+ require 'aws-sdk-core/plugins/telemetry'
36
+ require 'aws-sdk-core/plugins/sign'
37
+ require 'aws-sdk-core/plugins/protocols/json_rpc'
38
+ require 'aws-sdk-sqs/plugins/queue_urls'
39
+ require 'aws-sdk-sqs/plugins/md5s'
40
40
 
41
41
  module Aws::SQS
42
42
  # An API client for SQS. To construct a client, you need to configure a `:region` and `:credentials`.
@@ -261,11 +261,34 @@ module Aws::SQS
261
261
  # Used when loading credentials from the shared credentials file
262
262
  # at HOME/.aws/credentials. When not specified, 'default' is used.
263
263
  #
264
+ # @option options [String] :request_checksum_calculation ("when_supported")
265
+ # Determines when a checksum will be calculated for request payloads. Values are:
266
+ #
267
+ # * `when_supported` - (default) When set, a checksum will be
268
+ # calculated for all request payloads of operations modeled with the
269
+ # `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
270
+ # `requestAlgorithmMember` is modeled.
271
+ # * `when_required` - When set, a checksum will only be calculated for
272
+ # request payloads of operations modeled with the `httpChecksum` trait where
273
+ # `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
274
+ # is modeled and supplied.
275
+ #
264
276
  # @option options [Integer] :request_min_compression_size_bytes (10240)
265
277
  # The minimum size in bytes that triggers compression for request
266
278
  # bodies. The value must be non-negative integer value between 0
267
279
  # and 10485780 bytes inclusive.
268
280
  #
281
+ # @option options [String] :response_checksum_validation ("when_supported")
282
+ # Determines when checksum validation will be performed on response payloads. Values are:
283
+ #
284
+ # * `when_supported` - (default) When set, checksum validation is performed on all
285
+ # response payloads of operations modeled with the `httpChecksum` trait where
286
+ # `responseAlgorithms` is modeled, except when no modeled checksum algorithms
287
+ # are supported.
288
+ # * `when_required` - When set, checksum validation is not performed on
289
+ # response payloads of operations unless the checksum algorithm is supported and
290
+ # the `requestValidationModeMember` member is set to `ENABLED`.
291
+ #
269
292
  # @option options [Proc] :retry_backoff
270
293
  # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
271
294
  # This option is only used in the `legacy` retry mode.
@@ -652,7 +675,7 @@ module Aws::SQS
652
675
  # increase the number of queues you use to process your messages. To
653
676
  # request a limit increase, [file a support request][2].
654
677
  #
655
- # For FIFO queues, there can be a maximum of 20,000 in flight messages
678
+ # For FIFO queues, there can be a maximum of 120,000 in flight messages
656
679
  # (received from a queue by a consumer, but not yet deleted from the
657
680
  # queue). If you reach this limit, Amazon SQS returns no error messages.
658
681
  #
@@ -795,20 +818,24 @@ module Aws::SQS
795
818
  #
796
819
  # </note>
797
820
  #
798
- # To get the queue URL, use the ` GetQueueUrl ` action. ` GetQueueUrl `
799
- # requires only the `QueueName` parameter. be aware of existing queue
800
- # names:
821
+ # To retrieve the URL of a queue, use the [ `GetQueueUrl` ][3] action.
822
+ # This action only requires the [ `QueueName` ][4] parameter.
801
823
  #
802
- # * If you provide the name of an existing queue along with the exact
803
- # names and values of all the queue's attributes, `CreateQueue`
804
- # returns the queue URL for the existing queue.
824
+ # When creating queues, keep the following points in mind:
805
825
  #
806
- # * If the queue name, attribute names, or attribute values don't match
807
- # an existing queue, `CreateQueue` returns an error.
826
+ # * If you specify the name of an existing queue and provide the exact
827
+ # same names and values for all its attributes, the [ `CreateQueue`
828
+ # ][5] action will return the URL of the existing queue instead of
829
+ # creating a new one.
830
+ #
831
+ # * If you attempt to create a queue with a name that already exists but
832
+ # with different attribute names or values, the `CreateQueue` action
833
+ # will return an error. This ensures that existing queues are not
834
+ # inadvertently altered.
808
835
  #
809
836
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
810
837
  # information, see [Grant cross-account permissions to a role and a
811
- # username][3] in the *Amazon SQS Developer Guide*.
838
+ # username][6] in the *Amazon SQS Developer Guide*.
812
839
  #
813
840
  # </note>
814
841
  #
@@ -816,7 +843,10 @@ module Aws::SQS
816
843
  #
817
844
  # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving
818
845
  # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
819
- # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
846
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_GetQueueUrl.html
847
+ # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html#API_CreateQueue_RequestSyntax
848
+ # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_CreateQueue.html
849
+ # [6]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
820
850
  #
821
851
  # @option params [required, String] :queue_name
822
852
  # The name of the new queue. The following limits apply to this name:
@@ -1100,12 +1130,14 @@ module Aws::SQS
1100
1130
  # automatically deletes messages left in a queue longer than the
1101
1131
  # retention period configured for the queue.
1102
1132
  #
1103
- # <note markdown="1"> The `ReceiptHandle` is associated with a *specific instance* of
1104
- # receiving a message. If you receive a message more than once, the
1105
- # `ReceiptHandle` is different each time you receive a message. When you
1106
- # use the `DeleteMessage` action, you must provide the most recently
1107
- # received `ReceiptHandle` for the message (otherwise, the request
1108
- # succeeds, but the message will not be deleted).
1133
+ # <note markdown="1"> Each time you receive a message, meaning when a consumer retrieves a
1134
+ # message from the queue, it comes with a unique `ReceiptHandle`. If you
1135
+ # receive the same message more than once, you will get a different
1136
+ # `ReceiptHandle` each time. When you want to delete a message using the
1137
+ # `DeleteMessage` action, you must use the `ReceiptHandle` from the most
1138
+ # recent time you received the message. If you use an old
1139
+ # `ReceiptHandle`, the request will succeed, but the message might not
1140
+ # be deleted.
1109
1141
  #
1110
1142
  # For standard queues, it is possible to receive a message even after
1111
1143
  # you delete it. This might happen on rare occasions if one of the
@@ -1476,29 +1508,32 @@ module Aws::SQS
1476
1508
  req.send_request(options)
1477
1509
  end
1478
1510
 
1479
- # Returns the URL of an existing Amazon SQS queue.
1480
- #
1481
- # To access a queue that belongs to another AWS account, use the
1482
- # `QueueOwnerAWSAccountId` parameter to specify the account ID of the
1483
- # queue's owner. The queue's owner must grant you permission to access
1484
- # the queue. For more information about shared queue access, see `
1485
- # AddPermission ` or see [Allow Developers to Write Messages to a Shared
1486
- # Queue][1] in the *Amazon SQS Developer Guide*.
1511
+ # The `GetQueueUrl` API returns the URL of an existing Amazon SQS queue.
1512
+ # This is useful when you know the queue's name but need to retrieve
1513
+ # its URL for further operations.
1514
+ #
1515
+ # To access a queue owned by another Amazon Web Services account, use
1516
+ # the `QueueOwnerAWSAccountId` parameter to specify the account ID of
1517
+ # the queue's owner. Note that the queue owner must grant you the
1518
+ # necessary permissions to access the queue. For more information about
1519
+ # accessing shared queues, see the ` AddPermission ` API or [Allow
1520
+ # developers to write messages to a shared queue][1] in the *Amazon SQS
1521
+ # Developer Guide*.
1487
1522
  #
1488
1523
  #
1489
1524
  #
1490
1525
  # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
1491
1526
  #
1492
1527
  # @option params [required, String] :queue_name
1493
- # The name of the queue whose URL must be fetched. Maximum 80
1494
- # characters. Valid values: alphanumeric characters, hyphens (`-`), and
1495
- # underscores (`_`).
1496
- #
1497
- # Queue URLs and names are case-sensitive.
1528
+ # (Required) The name of the queue for which you want to fetch the URL.
1529
+ # The name can be up to 80 characters long and can include alphanumeric
1530
+ # characters, hyphens (-), and underscores (\_). Queue URLs and names
1531
+ # are case-sensitive.
1498
1532
  #
1499
1533
  # @option params [String] :queue_owner_aws_account_id
1500
- # The Amazon Web Services account ID of the account that created the
1501
- # queue.
1534
+ # (Optional) The Amazon Web Services account ID of the account that
1535
+ # created the queue. This is only required when you are attempting to
1536
+ # access a queue owned by another Amazon Web Services account.
1502
1537
  #
1503
1538
  # @return [Types::GetQueueUrlResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1504
1539
  #
@@ -1798,7 +1833,7 @@ module Aws::SQS
1798
1833
  # Developer Guide*.
1799
1834
  #
1800
1835
  # Short poll is the default behavior where a weighted random set of
1801
- # machines is sampled on a `ReceiveMessage` call. Thus, only the
1836
+ # machines is sampled on a `ReceiveMessage` call. Therefore, only the
1802
1837
  # messages on the sampled machines are returned. If the number of
1803
1838
  # messages in the queue is small (fewer than 1,000), you most likely get
1804
1839
  # fewer messages than you requested per `ReceiveMessage` call. If the
@@ -1828,14 +1863,8 @@ module Aws::SQS
1828
1863
  # You can provide the `VisibilityTimeout` parameter in your request. The
1829
1864
  # parameter is applied to the messages that Amazon SQS returns in the
1830
1865
  # response. If you don't include the parameter, the overall visibility
1831
- # timeout for the queue is used for the returned messages. For more
1832
- # information, see [Visibility Timeout][4] in the *Amazon SQS Developer
1833
- # Guide*.
1834
- #
1835
- # A message that isn't deleted or a message whose visibility isn't
1836
- # extended before the visibility timeout expires counts as a failed
1837
- # receive. Depending on the configuration of the queue, the message
1838
- # might be sent to the dead-letter queue.
1866
+ # timeout for the queue is used for the returned messages. The default
1867
+ # visibility timeout for a queue is 30 seconds.
1839
1868
  #
1840
1869
  # <note markdown="1"> In the future, new attributes might be added. If you write code that
1841
1870
  # calls this action, we recommend that you structure your code so that
@@ -1848,7 +1877,6 @@ module Aws::SQS
1848
1877
  # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html
1849
1878
  # [2]: https://www.ietf.org/rfc/rfc1321.txt
1850
1879
  # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html
1851
- # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1852
1880
  #
1853
1881
  # @option params [required, String] :queue_url
1854
1882
  # The URL of the Amazon SQS queue from which messages are received.
@@ -1856,9 +1884,9 @@ module Aws::SQS
1856
1884
  # Queue URLs and names are case-sensitive.
1857
1885
  #
1858
1886
  # @option params [Array<String>] :attribute_names
1859
- # This parameter has been deprecated but will be supported for backward
1860
- # compatibility. To provide attribute names, you are encouraged to use
1861
- # `MessageSystemAttributeNames`.
1887
+ # This parameter has been discontinued but will be supported for
1888
+ # backward compatibility. To provide attribute names, you are encouraged
1889
+ # to use `MessageSystemAttributeNames`.
1862
1890
  #
1863
1891
  # A list of attributes that need to be returned along with each message.
1864
1892
  # These attributes include:
@@ -1975,14 +2003,47 @@ module Aws::SQS
1975
2003
  # @option params [Integer] :visibility_timeout
1976
2004
  # The duration (in seconds) that the received messages are hidden from
1977
2005
  # subsequent retrieve requests after being retrieved by a
1978
- # `ReceiveMessage` request.
2006
+ # `ReceiveMessage` request. If not specified, the default visibility
2007
+ # timeout for the queue is used, which is 30 seconds.
2008
+ #
2009
+ # Understanding `VisibilityTimeout`:
2010
+ #
2011
+ # * When a message is received from a queue, it becomes temporarily
2012
+ # invisible to other consumers for the duration of the visibility
2013
+ # timeout. This prevents multiple consumers from processing the same
2014
+ # message simultaneously. If the message is not deleted or its
2015
+ # visibility timeout is not extended before the timeout expires, it
2016
+ # becomes visible again and can be retrieved by other consumers.
2017
+ #
2018
+ # * Setting an appropriate visibility timeout is crucial. If it's too
2019
+ # short, the message might become visible again before processing is
2020
+ # complete, leading to duplicate processing. If it's too long, it
2021
+ # delays the reprocessing of messages if the initial processing fails.
2022
+ #
2023
+ # * You can adjust the visibility timeout using the
2024
+ # `--visibility-timeout` parameter in the `receive-message` command to
2025
+ # match the processing time required by your application.
2026
+ #
2027
+ # * A message that isn't deleted or a message whose visibility isn't
2028
+ # extended before the visibility timeout expires counts as a failed
2029
+ # receive. Depending on the configuration of the queue, the message
2030
+ # might be sent to the dead-letter queue.
2031
+ #
2032
+ # For more information, see [Visibility Timeout][1] in the *Amazon SQS
2033
+ # Developer Guide*.
2034
+ #
2035
+ #
2036
+ #
2037
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1979
2038
  #
1980
2039
  # @option params [Integer] :wait_time_seconds
1981
2040
  # The duration (in seconds) for which the call waits for a message to
1982
2041
  # arrive in the queue before returning. If a message is available, the
1983
2042
  # call returns sooner than `WaitTimeSeconds`. If no messages are
1984
2043
  # available and the wait time expires, the call does not return a
1985
- # message list.
2044
+ # message list. If you are using the Java SDK, it returns a
2045
+ # `ReceiveMessageResponse` object, which has a empty list instead of a
2046
+ # Null object.
1986
2047
  #
1987
2048
  # To avoid HTTP errors, ensure that the HTTP response timeout for
1988
2049
  # `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -2897,7 +2958,7 @@ module Aws::SQS
2897
2958
  tracer: tracer
2898
2959
  )
2899
2960
  context[:gem_name] = 'aws-sdk-sqs'
2900
- context[:gem_version] = '1.89.0'
2961
+ context[:gem_version] = '1.93.0'
2901
2962
  Seahorse::Client::Request.new(handlers, context)
2902
2963
  end
2903
2964
 
@@ -10,43 +10,39 @@
10
10
  module Aws::SQS
11
11
  class EndpointProvider
12
12
  def resolve_endpoint(parameters)
13
- region = parameters.region
14
- use_dual_stack = parameters.use_dual_stack
15
- use_fips = parameters.use_fips
16
- endpoint = parameters.endpoint
17
- if Aws::Endpoints::Matchers.set?(endpoint)
18
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
13
+ if Aws::Endpoints::Matchers.set?(parameters.endpoint)
14
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
19
15
  raise ArgumentError, "Invalid Configuration: FIPS and custom endpoint are not supported"
20
16
  end
21
- if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
17
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
22
18
  raise ArgumentError, "Invalid Configuration: Dualstack and custom endpoint are not supported"
23
19
  end
24
- return Aws::Endpoints::Endpoint.new(url: endpoint, headers: {}, properties: {})
20
+ return Aws::Endpoints::Endpoint.new(url: parameters.endpoint, headers: {}, properties: {})
25
21
  end
26
- if Aws::Endpoints::Matchers.set?(region)
27
- if (partition_result = Aws::Endpoints::Matchers.aws_partition(region))
28
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
22
+ if Aws::Endpoints::Matchers.set?(parameters.region)
23
+ if (partition_result = Aws::Endpoints::Matchers.aws_partition(parameters.region))
24
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true) && Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
29
25
  if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS")) && Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
30
- return Aws::Endpoints::Endpoint.new(url: "https://sqs-fips.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
26
+ return Aws::Endpoints::Endpoint.new(url: "https://sqs-fips.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
31
27
  end
32
28
  raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
33
29
  end
34
- if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
30
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_fips, true)
35
31
  if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
36
32
  if Aws::Endpoints::Matchers.string_equals?(Aws::Endpoints::Matchers.attr(partition_result, "name"), "aws-us-gov")
37
- return Aws::Endpoints::Endpoint.new(url: "https://sqs.#{region}.amazonaws.com", headers: {}, properties: {})
33
+ return Aws::Endpoints::Endpoint.new(url: "https://sqs.#{parameters.region}.amazonaws.com", headers: {}, properties: {})
38
34
  end
39
- return Aws::Endpoints::Endpoint.new(url: "https://sqs-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
35
+ return Aws::Endpoints::Endpoint.new(url: "https://sqs-fips.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
40
36
  end
41
37
  raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
42
38
  end
43
- if Aws::Endpoints::Matchers.boolean_equals?(use_dual_stack, true)
39
+ if Aws::Endpoints::Matchers.boolean_equals?(parameters.use_dual_stack, true)
44
40
  if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsDualStack"))
45
- return Aws::Endpoints::Endpoint.new(url: "https://sqs.#{region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
41
+ return Aws::Endpoints::Endpoint.new(url: "https://sqs.#{parameters.region}.#{partition_result['dualStackDnsSuffix']}", headers: {}, properties: {})
46
42
  end
47
43
  raise ArgumentError, "DualStack is enabled but this partition does not support DualStack"
48
44
  end
49
- return Aws::Endpoints::Endpoint.new(url: "https://sqs.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
45
+ return Aws::Endpoints::Endpoint.new(url: "https://sqs.#{parameters.region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
50
46
  end
51
47
  end
52
48
  raise ArgumentError, "Invalid Configuration: Missing Region"
@@ -216,9 +216,9 @@ module Aws::SQS
216
216
  # })
217
217
  # @param [Hash] options ({})
218
218
  # @option options [Array<String>] :attribute_names
219
- # This parameter has been deprecated but will be supported for backward
220
- # compatibility. To provide attribute names, you are encouraged to use
221
- # `MessageSystemAttributeNames`.
219
+ # This parameter has been discontinued but will be supported for
220
+ # backward compatibility. To provide attribute names, you are encouraged
221
+ # to use `MessageSystemAttributeNames`.
222
222
  #
223
223
  # A list of attributes that need to be returned along with each message.
224
224
  # These attributes include:
@@ -331,13 +331,46 @@ module Aws::SQS
331
331
  # @option options [Integer] :visibility_timeout
332
332
  # The duration (in seconds) that the received messages are hidden from
333
333
  # subsequent retrieve requests after being retrieved by a
334
- # `ReceiveMessage` request.
334
+ # `ReceiveMessage` request. If not specified, the default visibility
335
+ # timeout for the queue is used, which is 30 seconds.
336
+ #
337
+ # Understanding `VisibilityTimeout`:
338
+ #
339
+ # * When a message is received from a queue, it becomes temporarily
340
+ # invisible to other consumers for the duration of the visibility
341
+ # timeout. This prevents multiple consumers from processing the same
342
+ # message simultaneously. If the message is not deleted or its
343
+ # visibility timeout is not extended before the timeout expires, it
344
+ # becomes visible again and can be retrieved by other consumers.
345
+ #
346
+ # * Setting an appropriate visibility timeout is crucial. If it's too
347
+ # short, the message might become visible again before processing is
348
+ # complete, leading to duplicate processing. If it's too long, it
349
+ # delays the reprocessing of messages if the initial processing fails.
350
+ #
351
+ # * You can adjust the visibility timeout using the
352
+ # `--visibility-timeout` parameter in the `receive-message` command to
353
+ # match the processing time required by your application.
354
+ #
355
+ # * A message that isn't deleted or a message whose visibility isn't
356
+ # extended before the visibility timeout expires counts as a failed
357
+ # receive. Depending on the configuration of the queue, the message
358
+ # might be sent to the dead-letter queue.
359
+ #
360
+ # For more information, see [Visibility Timeout][1] in the *Amazon SQS
361
+ # Developer Guide*.
362
+ #
363
+ #
364
+ #
365
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
335
366
  # @option options [Integer] :wait_time_seconds
336
367
  # The duration (in seconds) for which the call waits for a message to
337
368
  # arrive in the queue before returning. If a message is available, the
338
369
  # call returns sooner than `WaitTimeSeconds`. If no messages are
339
370
  # available and the wait time expires, the call does not return a
340
- # message list.
371
+ # message list. If you are using the Java SDK, it returns a
372
+ # `ReceiveMessageResponse` object, which has a empty list instead of a
373
+ # Null object.
341
374
  #
342
375
  # To avoid HTTP errors, ensure that the HTTP response timeout for
343
376
  # `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -134,7 +134,7 @@ module Aws
134
134
  # ### `:idle_timeout` Option
135
135
  #
136
136
  # This is a configurable, maximum number of seconds to wait for a
137
- # new message before the polling loop exists. By default, there is
137
+ # new message before the polling loop exits. By default, there is
138
138
  # no idle timeout.
139
139
  #
140
140
  # # stops polling after a minute of no received messages
@@ -308,14 +308,14 @@ module Aws::SQS
308
308
  # })
309
309
  # @param [Hash] options ({})
310
310
  # @option options [required, String] :queue_name
311
- # The name of the queue whose URL must be fetched. Maximum 80
312
- # characters. Valid values: alphanumeric characters, hyphens (`-`), and
313
- # underscores (`_`).
314
- #
315
- # Queue URLs and names are case-sensitive.
311
+ # (Required) The name of the queue for which you want to fetch the URL.
312
+ # The name can be up to 80 characters long and can include alphanumeric
313
+ # characters, hyphens (-), and underscores (\_). Queue URLs and names
314
+ # are case-sensitive.
316
315
  # @option options [String] :queue_owner_aws_account_id
317
- # The Amazon Web Services account ID of the account that created the
318
- # queue.
316
+ # (Optional) The Amazon Web Services account ID of the account that
317
+ # created the queue. This is only required when you are attempting to
318
+ # access a queue owned by another Amazon Web Services account.
319
319
  # @return [Queue]
320
320
  def get_queue_by_name(options = {})
321
321
  resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
@@ -893,17 +893,20 @@ module Aws::SQS
893
893
  include Aws::Structure
894
894
  end
895
895
 
896
- # @!attribute [rw] queue_name
897
- # The name of the queue whose URL must be fetched. Maximum 80
898
- # characters. Valid values: alphanumeric characters, hyphens (`-`),
899
- # and underscores (`_`).
896
+ # Retrieves the URL of an existing queue based on its name and,
897
+ # optionally, the Amazon Web Services account ID.
900
898
  #
901
- # Queue URLs and names are case-sensitive.
899
+ # @!attribute [rw] queue_name
900
+ # (Required) The name of the queue for which you want to fetch the
901
+ # URL. The name can be up to 80 characters long and can include
902
+ # alphanumeric characters, hyphens (-), and underscores (\_). Queue
903
+ # URLs and names are case-sensitive.
902
904
  # @return [String]
903
905
  #
904
906
  # @!attribute [rw] queue_owner_aws_account_id
905
- # The Amazon Web Services account ID of the account that created the
906
- # queue.
907
+ # (Optional) The Amazon Web Services account ID of the account that
908
+ # created the queue. This is only required when you are attempting to
909
+ # access a queue owned by another Amazon Web Services account.
907
910
  # @return [String]
908
911
  #
909
912
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueUrlRequest AWS API Documentation
@@ -934,7 +937,7 @@ module Aws::SQS
934
937
  include Aws::Structure
935
938
  end
936
939
 
937
- # The `accountId` is invalid.
940
+ # The specified ID is invalid.
938
941
  #
939
942
  # @!attribute [rw] message
940
943
  # @return [String]
@@ -1006,7 +1009,7 @@ module Aws::SQS
1006
1009
  include Aws::Structure
1007
1010
  end
1008
1011
 
1009
- # When the request to a queue is not HTTPS and SigV4.
1012
+ # The request was not made over HTTPS or did not use SigV4 for signing.
1010
1013
  #
1011
1014
  # @!attribute [rw] message
1012
1015
  # @return [String]
@@ -1605,7 +1608,8 @@ module Aws::SQS
1605
1608
  include Aws::Structure
1606
1609
  end
1607
1610
 
1608
- # The specified queue doesn't exist.
1611
+ # Ensure that the `QueueUrl` is correct and that the queue has not been
1612
+ # deleted.
1609
1613
  #
1610
1614
  # @!attribute [rw] message
1611
1615
  # @return [String]
@@ -1646,6 +1650,8 @@ module Aws::SQS
1646
1650
  include Aws::Structure
1647
1651
  end
1648
1652
 
1653
+ # Retrieves one or more messages from a specified queue.
1654
+ #
1649
1655
  # @!attribute [rw] queue_url
1650
1656
  # The URL of the Amazon SQS queue from which messages are received.
1651
1657
  #
@@ -1653,7 +1659,7 @@ module Aws::SQS
1653
1659
  # @return [String]
1654
1660
  #
1655
1661
  # @!attribute [rw] attribute_names
1656
- # This parameter has been deprecated but will be supported for
1662
+ # This parameter has been discontinued but will be supported for
1657
1663
  # backward compatibility. To provide attribute names, you are
1658
1664
  # encouraged to use `MessageSystemAttributeNames`.
1659
1665
  #
@@ -1780,7 +1786,39 @@ module Aws::SQS
1780
1786
  # @!attribute [rw] visibility_timeout
1781
1787
  # The duration (in seconds) that the received messages are hidden from
1782
1788
  # subsequent retrieve requests after being retrieved by a
1783
- # `ReceiveMessage` request.
1789
+ # `ReceiveMessage` request. If not specified, the default visibility
1790
+ # timeout for the queue is used, which is 30 seconds.
1791
+ #
1792
+ # Understanding `VisibilityTimeout`:
1793
+ #
1794
+ # * When a message is received from a queue, it becomes temporarily
1795
+ # invisible to other consumers for the duration of the visibility
1796
+ # timeout. This prevents multiple consumers from processing the same
1797
+ # message simultaneously. If the message is not deleted or its
1798
+ # visibility timeout is not extended before the timeout expires, it
1799
+ # becomes visible again and can be retrieved by other consumers.
1800
+ #
1801
+ # * Setting an appropriate visibility timeout is crucial. If it's too
1802
+ # short, the message might become visible again before processing is
1803
+ # complete, leading to duplicate processing. If it's too long, it
1804
+ # delays the reprocessing of messages if the initial processing
1805
+ # fails.
1806
+ #
1807
+ # * You can adjust the visibility timeout using the
1808
+ # `--visibility-timeout` parameter in the `receive-message` command
1809
+ # to match the processing time required by your application.
1810
+ #
1811
+ # * A message that isn't deleted or a message whose visibility isn't
1812
+ # extended before the visibility timeout expires counts as a failed
1813
+ # receive. Depending on the configuration of the queue, the message
1814
+ # might be sent to the dead-letter queue.
1815
+ #
1816
+ # For more information, see [Visibility Timeout][1] in the *Amazon SQS
1817
+ # Developer Guide*.
1818
+ #
1819
+ #
1820
+ #
1821
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1784
1822
  # @return [Integer]
1785
1823
  #
1786
1824
  # @!attribute [rw] wait_time_seconds
@@ -1788,7 +1826,9 @@ module Aws::SQS
1788
1826
  # arrive in the queue before returning. If a message is available, the
1789
1827
  # call returns sooner than `WaitTimeSeconds`. If no messages are
1790
1828
  # available and the wait time expires, the call does not return a
1791
- # message list.
1829
+ # message list. If you are using the Java SDK, it returns a
1830
+ # `ReceiveMessageResponse` object, which has a empty list instead of a
1831
+ # Null object.
1792
1832
  #
1793
1833
  # To avoid HTTP errors, ensure that the HTTP response timeout for
1794
1834
  # `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -1918,18 +1958,16 @@ module Aws::SQS
1918
1958
 
1919
1959
  # The request was denied due to request throttling.
1920
1960
  #
1921
- # * The rate of requests per second exceeds the Amazon Web Services KMS
1922
- # request quota for an account and Region.
1961
+ # * Exceeds the permitted request rate for the queue or for the
1962
+ # recipient of the request.
1963
+ #
1964
+ # * Ensure that the request rate is within the Amazon SQS limits for
1965
+ # sending messages. For more information, see [Amazon SQS quotas][1]
1966
+ # in the *Amazon SQS Developer Guide*.
1967
+ #
1923
1968
  #
1924
- # * A burst or sustained high rate of requests to change the state of
1925
- # the same KMS key. This condition is often known as a "hot key."
1926
1969
  #
1927
- # * Requests for operations on KMS keys in a Amazon Web Services
1928
- # CloudHSM key store might be throttled at a lower-than-expected rate
1929
- # when the Amazon Web Services CloudHSM cluster associated with the
1930
- # Amazon Web Services CloudHSM key store is processing numerous
1931
- # commands, including those unrelated to the Amazon Web Services
1932
- # CloudHSM key store.
1970
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-quotas.html#quotas-requests
1933
1971
  #
1934
1972
  # @!attribute [rw] message
1935
1973
  # @return [String]
@@ -2746,7 +2784,16 @@ module Aws::SQS
2746
2784
  include Aws::Structure
2747
2785
  end
2748
2786
 
2749
- # The batch request contains more entries than permissible.
2787
+ # The batch request contains more entries than permissible. For Amazon
2788
+ # SQS, the maximum number of entries you can include in a single
2789
+ # [SendMessageBatch][1], [DeleteMessageBatch][2], or
2790
+ # [ChangeMessageVisibilityBatch][3] request is 10.
2791
+ #
2792
+ #
2793
+ #
2794
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html
2795
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteMessageBatch.html
2796
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ChangeMessageVisibilityBatch.html
2750
2797
  #
2751
2798
  # @!attribute [rw] message
2752
2799
  # @return [String]
data/lib/aws-sdk-sqs.rb CHANGED
@@ -56,7 +56,7 @@ module Aws::SQS
56
56
  autoload :Message, 'aws-sdk-sqs/message'
57
57
  autoload :Queue, 'aws-sdk-sqs/queue'
58
58
 
59
- GEM_VERSION = '1.89.0'
59
+ GEM_VERSION = '1.93.0'
60
60
 
61
61
  end
62
62
 
data/sig/client.rbs CHANGED
@@ -39,7 +39,9 @@ module Aws
39
39
  ?logger: untyped,
40
40
  ?max_attempts: Integer,
41
41
  ?profile: String,
42
+ ?request_checksum_calculation: String,
42
43
  ?request_min_compression_size_bytes: Integer,
44
+ ?response_checksum_validation: String,
43
45
  ?retry_backoff: Proc,
44
46
  ?retry_base_delay: Float,
45
47
  ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
data/sig/resource.rbs CHANGED
@@ -39,7 +39,9 @@ module Aws
39
39
  ?logger: untyped,
40
40
  ?max_attempts: Integer,
41
41
  ?profile: String,
42
+ ?request_checksum_calculation: String,
42
43
  ?request_min_compression_size_bytes: Integer,
44
+ ?response_checksum_validation: String,
43
45
  ?retry_backoff: Proc,
44
46
  ?retry_base_delay: Float,
45
47
  ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-sqs
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.89.0
4
+ version: 1.93.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-11-18 00:00:00.000000000 Z
11
+ date: 2025-02-18 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.210.0
22
+ version: 3.216.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.210.0
32
+ version: 3.216.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement