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 +4 -4
- data/CHANGELOG.md +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-sqs/client.rb +139 -78
- data/lib/aws-sdk-sqs/endpoint_provider.rb +14 -18
- data/lib/aws-sdk-sqs/queue.rb +38 -5
- data/lib/aws-sdk-sqs/queue_poller.rb +1 -1
- data/lib/aws-sdk-sqs/resource.rb +7 -7
- data/lib/aws-sdk-sqs/types.rb +71 -24
- data/lib/aws-sdk-sqs.rb +1 -1
- data/sig/client.rbs +2 -0
- data/sig/resource.rbs +2 -0
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: f0335e2b0ba191485e73b0902284409bba3842354d71da137a9f5d7532f5d213
|
4
|
+
data.tar.gz: beb1bc08df049abba890cdcb4b3842147e08d5471b6807adc25becd61d00210b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
1
|
+
1.93.0
|
data/lib/aws-sdk-sqs/client.rb
CHANGED
@@ -7,36 +7,36 @@
|
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
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
|
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
|
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
|
799
|
-
#
|
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
|
-
#
|
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
|
807
|
-
#
|
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][
|
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/
|
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">
|
1104
|
-
#
|
1105
|
-
#
|
1106
|
-
#
|
1107
|
-
#
|
1108
|
-
#
|
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
|
-
#
|
1480
|
-
#
|
1481
|
-
#
|
1482
|
-
#
|
1483
|
-
#
|
1484
|
-
# the
|
1485
|
-
#
|
1486
|
-
#
|
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
|
1494
|
-
#
|
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
|
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.
|
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.
|
1832
|
-
#
|
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
|
1860
|
-
# compatibility. To provide attribute names, you are encouraged
|
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.
|
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
|
-
|
14
|
-
|
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"
|
data/lib/aws-sdk-sqs/queue.rb
CHANGED
@@ -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
|
220
|
-
# compatibility. To provide attribute names, you are encouraged
|
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
|
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
|
data/lib/aws-sdk-sqs/resource.rb
CHANGED
@@ -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
|
312
|
-
#
|
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
|
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
|
data/lib/aws-sdk-sqs/types.rb
CHANGED
@@ -893,17 +893,20 @@ module Aws::SQS
|
|
893
893
|
include Aws::Structure
|
894
894
|
end
|
895
895
|
|
896
|
-
#
|
897
|
-
#
|
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
|
-
#
|
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
|
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
|
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
|
-
#
|
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
|
-
#
|
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
|
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
|
-
# *
|
1922
|
-
#
|
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
|
-
#
|
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
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.
|
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:
|
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.
|
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.
|
32
|
+
version: 3.216.0
|
33
33
|
- !ruby/object:Gem::Dependency
|
34
34
|
name: aws-sigv4
|
35
35
|
requirement: !ruby/object:Gem::Requirement
|