aws-sdk-sqs 1.88.0 → 1.107.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +95 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-sqs/client.rb +228 -156
- data/lib/aws-sdk-sqs/client_api.rb +4 -4
- data/lib/aws-sdk-sqs/customizations.rb +0 -1
- data/lib/aws-sdk-sqs/endpoint_parameters.rb +4 -4
- data/lib/aws-sdk-sqs/endpoint_provider.rb +14 -18
- data/lib/aws-sdk-sqs/queue.rb +91 -46
- data/lib/aws-sdk-sqs/queue_poller.rb +1 -1
- data/lib/aws-sdk-sqs/resource.rb +9 -12
- data/lib/aws-sdk-sqs/types.rb +167 -96
- data/lib/aws-sdk-sqs.rb +1 -1
- data/sig/client.rbs +3 -0
- data/sig/resource.rbs +3 -0
- metadata +6 -9
data/lib/aws-sdk-sqs/types.rb
CHANGED
|
@@ -291,8 +291,8 @@ module Aws::SQS
|
|
|
291
291
|
#
|
|
292
292
|
# * `MaximumMessageSize` – The limit of how many bytes a message can
|
|
293
293
|
# contain before Amazon SQS rejects it. Valid values: An integer
|
|
294
|
-
# from 1,024 bytes (1 KiB) to
|
|
295
|
-
#
|
|
294
|
+
# from 1,024 bytes (1 KiB) to 1,048,576 bytes (1 MiB). Default:
|
|
295
|
+
# 1,048,576 bytes (1 MiB).
|
|
296
296
|
#
|
|
297
297
|
# * `MessageRetentionPeriod` – The length of time, in seconds, for
|
|
298
298
|
# which Amazon SQS retains a message. Valid values: An integer from
|
|
@@ -334,7 +334,6 @@ module Aws::SQS
|
|
|
334
334
|
# Default: 10. When the `ReceiveCount` for a message exceeds the
|
|
335
335
|
# `maxReceiveCount` for a queue, Amazon SQS moves the message to
|
|
336
336
|
# the dead-letter-queue.
|
|
337
|
-
#
|
|
338
337
|
# * `RedriveAllowPolicy` – The string that includes the parameters for
|
|
339
338
|
# the permissions for the dead-letter queue redrive permission and
|
|
340
339
|
# which source queues can specify dead-letter queues as a JSON
|
|
@@ -353,7 +352,6 @@ module Aws::SQS
|
|
|
353
352
|
#
|
|
354
353
|
# * `byQueue` – Only queues specified by the `sourceQueueArns`
|
|
355
354
|
# parameter can specify this queue as the dead-letter queue.
|
|
356
|
-
#
|
|
357
355
|
# * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
|
|
358
356
|
# source queues that can specify this queue as the dead-letter
|
|
359
357
|
# queue and redrive messages. You can specify this parameter only
|
|
@@ -426,7 +424,6 @@ module Aws::SQS
|
|
|
426
424
|
#
|
|
427
425
|
# * If the queue has `ContentBasedDeduplication` set, your
|
|
428
426
|
# `MessageDeduplicationId` overrides the generated one.
|
|
429
|
-
#
|
|
430
427
|
# * When `ContentBasedDeduplication` is in effect, messages with
|
|
431
428
|
# identical content sent within the deduplication interval are
|
|
432
429
|
# treated as duplicates and only one copy of the message is
|
|
@@ -766,7 +763,6 @@ module Aws::SQS
|
|
|
766
763
|
# Default: 10. When the `ReceiveCount` for a message exceeds the
|
|
767
764
|
# `maxReceiveCount` for a queue, Amazon SQS moves the message to
|
|
768
765
|
# the dead-letter-queue.
|
|
769
|
-
#
|
|
770
766
|
# * `RedriveAllowPolicy` – The string that includes the parameters for
|
|
771
767
|
# the permissions for the dead-letter queue redrive permission and
|
|
772
768
|
# which source queues can specify dead-letter queues as a JSON
|
|
@@ -785,7 +781,6 @@ module Aws::SQS
|
|
|
785
781
|
#
|
|
786
782
|
# * `byQueue` – Only queues specified by the `sourceQueueArns`
|
|
787
783
|
# parameter can specify this queue as the dead-letter queue.
|
|
788
|
-
#
|
|
789
784
|
# * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
|
|
790
785
|
# source queues that can specify this queue as the dead-letter
|
|
791
786
|
# queue and redrive messages. You can specify this parameter only
|
|
@@ -898,17 +893,20 @@ module Aws::SQS
|
|
|
898
893
|
include Aws::Structure
|
|
899
894
|
end
|
|
900
895
|
|
|
901
|
-
#
|
|
902
|
-
#
|
|
903
|
-
# characters. Valid values: alphanumeric characters, hyphens (`-`),
|
|
904
|
-
# and underscores (`_`).
|
|
896
|
+
# Retrieves the URL of an existing queue based on its name and,
|
|
897
|
+
# optionally, the Amazon Web Services account ID.
|
|
905
898
|
#
|
|
906
|
-
#
|
|
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.
|
|
907
904
|
# @return [String]
|
|
908
905
|
#
|
|
909
906
|
# @!attribute [rw] queue_owner_aws_account_id
|
|
910
|
-
# The Amazon Web Services account ID of the account that
|
|
911
|
-
# 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.
|
|
912
910
|
# @return [String]
|
|
913
911
|
#
|
|
914
912
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueUrlRequest AWS API Documentation
|
|
@@ -939,7 +937,7 @@ module Aws::SQS
|
|
|
939
937
|
include Aws::Structure
|
|
940
938
|
end
|
|
941
939
|
|
|
942
|
-
# The
|
|
940
|
+
# The specified ID is invalid.
|
|
943
941
|
#
|
|
944
942
|
# @!attribute [rw] message
|
|
945
943
|
# @return [String]
|
|
@@ -1011,7 +1009,7 @@ module Aws::SQS
|
|
|
1011
1009
|
include Aws::Structure
|
|
1012
1010
|
end
|
|
1013
1011
|
|
|
1014
|
-
#
|
|
1012
|
+
# The request was not made over HTTPS or did not use SigV4 for signing.
|
|
1015
1013
|
#
|
|
1016
1014
|
# @!attribute [rw] message
|
|
1017
1015
|
# @return [String]
|
|
@@ -1440,8 +1438,8 @@ module Aws::SQS
|
|
|
1440
1438
|
#
|
|
1441
1439
|
# `Name`, `type`, `value` and the message body must not be empty or
|
|
1442
1440
|
# null. All parts of the message attribute, including `Name`, `Type`,
|
|
1443
|
-
# and `Value`, are part of the message size restriction (
|
|
1444
|
-
#
|
|
1441
|
+
# and `Value`, are part of the message size restriction (1 MiB or
|
|
1442
|
+
# 1,048,576 bytes).
|
|
1445
1443
|
#
|
|
1446
1444
|
# @!attribute [rw] string_value
|
|
1447
1445
|
# Strings are Unicode with UTF-8 binary encoding. For a list of code
|
|
@@ -1610,7 +1608,8 @@ module Aws::SQS
|
|
|
1610
1608
|
include Aws::Structure
|
|
1611
1609
|
end
|
|
1612
1610
|
|
|
1613
|
-
#
|
|
1611
|
+
# Ensure that the `QueueUrl` is correct and that the queue has not been
|
|
1612
|
+
# deleted.
|
|
1614
1613
|
#
|
|
1615
1614
|
# @!attribute [rw] message
|
|
1616
1615
|
# @return [String]
|
|
@@ -1651,6 +1650,8 @@ module Aws::SQS
|
|
|
1651
1650
|
include Aws::Structure
|
|
1652
1651
|
end
|
|
1653
1652
|
|
|
1653
|
+
# Retrieves one or more messages from a specified queue.
|
|
1654
|
+
#
|
|
1654
1655
|
# @!attribute [rw] queue_url
|
|
1655
1656
|
# The URL of the Amazon SQS queue from which messages are received.
|
|
1656
1657
|
#
|
|
@@ -1658,7 +1659,7 @@ module Aws::SQS
|
|
|
1658
1659
|
# @return [String]
|
|
1659
1660
|
#
|
|
1660
1661
|
# @!attribute [rw] attribute_names
|
|
1661
|
-
# This parameter has been
|
|
1662
|
+
# This parameter has been discontinued but will be supported for
|
|
1662
1663
|
# backward compatibility. To provide attribute names, you are
|
|
1663
1664
|
# encouraged to use `MessageSystemAttributeNames`.
|
|
1664
1665
|
#
|
|
@@ -1683,7 +1684,6 @@ module Aws::SQS
|
|
|
1683
1684
|
#
|
|
1684
1685
|
# * For an IAM role, returns the IAM role ID, for example
|
|
1685
1686
|
# `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
|
|
1686
|
-
#
|
|
1687
1687
|
# * `SentTimestamp` – Returns the time the message was sent to the
|
|
1688
1688
|
# queue ([epoch time][1] in milliseconds).
|
|
1689
1689
|
#
|
|
@@ -1696,8 +1696,7 @@ module Aws::SQS
|
|
|
1696
1696
|
# producer that calls the ` SendMessage ` action.
|
|
1697
1697
|
#
|
|
1698
1698
|
# * `MessageGroupId` – Returns the value provided by the producer that
|
|
1699
|
-
# calls the ` SendMessage ` action.
|
|
1700
|
-
# `MessageGroupId` are returned in sequence.
|
|
1699
|
+
# calls the ` SendMessage ` action.
|
|
1701
1700
|
#
|
|
1702
1701
|
# * `SequenceNumber` – Returns the value provided by Amazon SQS.
|
|
1703
1702
|
#
|
|
@@ -1730,7 +1729,6 @@ module Aws::SQS
|
|
|
1730
1729
|
#
|
|
1731
1730
|
# * For an IAM role, returns the IAM role ID, for example
|
|
1732
1731
|
# `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
|
|
1733
|
-
#
|
|
1734
1732
|
# * `SentTimestamp` – Returns the time the message was sent to the
|
|
1735
1733
|
# queue ([epoch time][1] in milliseconds).
|
|
1736
1734
|
#
|
|
@@ -1743,8 +1741,7 @@ module Aws::SQS
|
|
|
1743
1741
|
# producer that calls the ` SendMessage ` action.
|
|
1744
1742
|
#
|
|
1745
1743
|
# * `MessageGroupId` – Returns the value provided by the producer that
|
|
1746
|
-
# calls the ` SendMessage ` action.
|
|
1747
|
-
# `MessageGroupId` are returned in sequence.
|
|
1744
|
+
# calls the ` SendMessage ` action.
|
|
1748
1745
|
#
|
|
1749
1746
|
# * `SequenceNumber` – Returns the value provided by Amazon SQS.
|
|
1750
1747
|
#
|
|
@@ -1787,7 +1784,39 @@ module Aws::SQS
|
|
|
1787
1784
|
# @!attribute [rw] visibility_timeout
|
|
1788
1785
|
# The duration (in seconds) that the received messages are hidden from
|
|
1789
1786
|
# subsequent retrieve requests after being retrieved by a
|
|
1790
|
-
# `ReceiveMessage` request.
|
|
1787
|
+
# `ReceiveMessage` request. If not specified, the default visibility
|
|
1788
|
+
# timeout for the queue is used, which is 30 seconds.
|
|
1789
|
+
#
|
|
1790
|
+
# Understanding `VisibilityTimeout`:
|
|
1791
|
+
#
|
|
1792
|
+
# * When a message is received from a queue, it becomes temporarily
|
|
1793
|
+
# invisible to other consumers for the duration of the visibility
|
|
1794
|
+
# timeout. This prevents multiple consumers from processing the same
|
|
1795
|
+
# message simultaneously. If the message is not deleted or its
|
|
1796
|
+
# visibility timeout is not extended before the timeout expires, it
|
|
1797
|
+
# becomes visible again and can be retrieved by other consumers.
|
|
1798
|
+
#
|
|
1799
|
+
# * Setting an appropriate visibility timeout is crucial. If it's too
|
|
1800
|
+
# short, the message might become visible again before processing is
|
|
1801
|
+
# complete, leading to duplicate processing. If it's too long, it
|
|
1802
|
+
# delays the reprocessing of messages if the initial processing
|
|
1803
|
+
# fails.
|
|
1804
|
+
#
|
|
1805
|
+
# * You can adjust the visibility timeout using the
|
|
1806
|
+
# `--visibility-timeout` parameter in the `receive-message` command
|
|
1807
|
+
# to match the processing time required by your application.
|
|
1808
|
+
#
|
|
1809
|
+
# * A message that isn't deleted or a message whose visibility isn't
|
|
1810
|
+
# extended before the visibility timeout expires counts as a failed
|
|
1811
|
+
# receive. Depending on the configuration of the queue, the message
|
|
1812
|
+
# might be sent to the dead-letter queue.
|
|
1813
|
+
#
|
|
1814
|
+
# For more information, see [Visibility Timeout][1] in the *Amazon SQS
|
|
1815
|
+
# Developer Guide*.
|
|
1816
|
+
#
|
|
1817
|
+
#
|
|
1818
|
+
#
|
|
1819
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
|
|
1791
1820
|
# @return [Integer]
|
|
1792
1821
|
#
|
|
1793
1822
|
# @!attribute [rw] wait_time_seconds
|
|
@@ -1795,7 +1824,9 @@ module Aws::SQS
|
|
|
1795
1824
|
# arrive in the queue before returning. If a message is available, the
|
|
1796
1825
|
# call returns sooner than `WaitTimeSeconds`. If no messages are
|
|
1797
1826
|
# available and the wait time expires, the call does not return a
|
|
1798
|
-
# message list.
|
|
1827
|
+
# message list. If you are using the Java SDK, it returns a
|
|
1828
|
+
# `ReceiveMessageResponse` object, which has a empty list instead of a
|
|
1829
|
+
# Null object.
|
|
1799
1830
|
#
|
|
1800
1831
|
# To avoid HTTP errors, ensure that the HTTP response timeout for
|
|
1801
1832
|
# `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
|
|
@@ -1851,8 +1882,8 @@ module Aws::SQS
|
|
|
1851
1882
|
# * While messages with a particular `MessageGroupId` are invisible,
|
|
1852
1883
|
# no more messages belonging to the same `MessageGroupId` are
|
|
1853
1884
|
# returned until the visibility timeout expires. You can still
|
|
1854
|
-
# receive messages with another `MessageGroupId`
|
|
1855
|
-
#
|
|
1885
|
+
# receive messages with another `MessageGroupId` from your FIFO
|
|
1886
|
+
# queue as long as they are visible.
|
|
1856
1887
|
#
|
|
1857
1888
|
# * If a caller of `ReceiveMessage` can't track the
|
|
1858
1889
|
# `ReceiveRequestAttemptId`, no retries work until the original
|
|
@@ -1925,18 +1956,16 @@ module Aws::SQS
|
|
|
1925
1956
|
|
|
1926
1957
|
# The request was denied due to request throttling.
|
|
1927
1958
|
#
|
|
1928
|
-
# *
|
|
1929
|
-
#
|
|
1959
|
+
# * Exceeds the permitted request rate for the queue or for the
|
|
1960
|
+
# recipient of the request.
|
|
1961
|
+
#
|
|
1962
|
+
# * Ensure that the request rate is within the Amazon SQS limits for
|
|
1963
|
+
# sending messages. For more information, see [Amazon SQS quotas][1]
|
|
1964
|
+
# in the *Amazon SQS Developer Guide*.
|
|
1965
|
+
#
|
|
1930
1966
|
#
|
|
1931
|
-
# * A burst or sustained high rate of requests to change the state of
|
|
1932
|
-
# the same KMS key. This condition is often known as a "hot key."
|
|
1933
1967
|
#
|
|
1934
|
-
#
|
|
1935
|
-
# CloudHSM key store might be throttled at a lower-than-expected rate
|
|
1936
|
-
# when the Amazon Web Services CloudHSM cluster associated with the
|
|
1937
|
-
# Amazon Web Services CloudHSM key store is processing numerous
|
|
1938
|
-
# commands, including those unrelated to the Amazon Web Services
|
|
1939
|
-
# CloudHSM key store.
|
|
1968
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-quotas.html#quotas-requests
|
|
1940
1969
|
#
|
|
1941
1970
|
# @!attribute [rw] message
|
|
1942
1971
|
# @return [String]
|
|
@@ -2062,7 +2091,6 @@ module Aws::SQS
|
|
|
2062
2091
|
#
|
|
2063
2092
|
# * If the queue has `ContentBasedDeduplication` set, your
|
|
2064
2093
|
# `MessageDeduplicationId` overrides the generated one.
|
|
2065
|
-
#
|
|
2066
2094
|
# * When `ContentBasedDeduplication` is in effect, messages with
|
|
2067
2095
|
# identical content sent within the deduplication interval are
|
|
2068
2096
|
# treated as duplicates and only one copy of the message is
|
|
@@ -2103,24 +2131,46 @@ module Aws::SQS
|
|
|
2103
2131
|
# @return [String]
|
|
2104
2132
|
#
|
|
2105
2133
|
# @!attribute [rw] message_group_id
|
|
2106
|
-
#
|
|
2107
|
-
#
|
|
2108
|
-
#
|
|
2109
|
-
#
|
|
2110
|
-
#
|
|
2111
|
-
#
|
|
2112
|
-
#
|
|
2113
|
-
#
|
|
2114
|
-
#
|
|
2115
|
-
#
|
|
2116
|
-
#
|
|
2117
|
-
#
|
|
2118
|
-
#
|
|
2119
|
-
#
|
|
2120
|
-
#
|
|
2134
|
+
# `MessageGroupId` is an attribute used in Amazon SQS FIFO
|
|
2135
|
+
# (First-In-First-Out) and standard queues. In FIFO queues,
|
|
2136
|
+
# `MessageGroupId` organizes messages into distinct groups. Messages
|
|
2137
|
+
# within the same message group are always processed one at a time, in
|
|
2138
|
+
# strict order, ensuring that no two messages from the same group are
|
|
2139
|
+
# processed simultaneously. In standard queues, using `MessageGroupId`
|
|
2140
|
+
# enables fair queues. It is used to identify the tenant a message
|
|
2141
|
+
# belongs to, helping maintain consistent message dwell time across
|
|
2142
|
+
# all tenants during noisy neighbor events. Unlike FIFO queues,
|
|
2143
|
+
# messages with the same `MessageGroupId` can be processed in
|
|
2144
|
+
# parallel, maintaining the high throughput of standard queues.
|
|
2145
|
+
#
|
|
2146
|
+
# * **FIFO queues:** `MessageGroupId` acts as the tag that specifies
|
|
2147
|
+
# that a message belongs to a specific message group. Messages that
|
|
2148
|
+
# belong to the same message group are processed in a FIFO manner
|
|
2149
|
+
# (however, messages in different message groups might be processed
|
|
2150
|
+
# out of order). To interleave multiple ordered streams within a
|
|
2151
|
+
# single queue, use `MessageGroupId` values (for example, session
|
|
2152
|
+
# data for multiple users). In this scenario, multiple consumers can
|
|
2153
|
+
# process the queue, but the session data of each user is processed
|
|
2154
|
+
# in a FIFO fashion.
|
|
2155
|
+
#
|
|
2156
|
+
# If you do not provide a `MessageGroupId` when sending a message to
|
|
2157
|
+
# a FIFO queue, the action fails.
|
|
2158
|
+
#
|
|
2159
|
+
# `ReceiveMessage` might return messages with multiple
|
|
2121
2160
|
# `MessageGroupId` values. For each `MessageGroupId`, the messages
|
|
2122
|
-
# are sorted by time sent.
|
|
2123
|
-
#
|
|
2161
|
+
# are sorted by time sent.
|
|
2162
|
+
#
|
|
2163
|
+
# * **Standard queues:**Use `MessageGroupId` in standard queues to
|
|
2164
|
+
# enable fair queues. The `MessageGroupId` identifies the tenant a
|
|
2165
|
+
# message belongs to. A tenant can be any entity that shares a queue
|
|
2166
|
+
# with others, such as your customer, a client application, or a
|
|
2167
|
+
# request type. When one tenant sends a disproportionately large
|
|
2168
|
+
# volume of messages or has messages that require longer processing
|
|
2169
|
+
# time, fair queues ensure other tenants' messages maintain low
|
|
2170
|
+
# dwell time. This preserves quality of service for all tenants
|
|
2171
|
+
# while maintaining the scalability and throughput of standard
|
|
2172
|
+
# queues. We recommend that you include a `MessageGroupId` in all
|
|
2173
|
+
# messages when using fair queues.
|
|
2124
2174
|
#
|
|
2125
2175
|
# The length of `MessageGroupId` is 128 characters. Valid values:
|
|
2126
2176
|
# alphanumeric characters and punctuation ``
|
|
@@ -2129,9 +2179,6 @@ module Aws::SQS
|
|
|
2129
2179
|
# For best practices of using `MessageGroupId`, see [Using the
|
|
2130
2180
|
# MessageGroupId Property][1] in the *Amazon SQS Developer Guide*.
|
|
2131
2181
|
#
|
|
2132
|
-
# `MessageGroupId` is required for FIFO queues. You can't use it for
|
|
2133
|
-
# Standard queues.
|
|
2134
|
-
#
|
|
2135
2182
|
#
|
|
2136
2183
|
#
|
|
2137
2184
|
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html
|
|
@@ -2250,7 +2297,7 @@ module Aws::SQS
|
|
|
2250
2297
|
#
|
|
2251
2298
|
# @!attribute [rw] message_body
|
|
2252
2299
|
# The message to send. The minimum size is one character. The maximum
|
|
2253
|
-
# size is
|
|
2300
|
+
# size is 1 MiB or 1,048,576 bytes
|
|
2254
2301
|
#
|
|
2255
2302
|
# A message can include only XML, JSON, and unformatted text. The
|
|
2256
2303
|
# following Unicode characters are allowed. For more information, see
|
|
@@ -2259,11 +2306,11 @@ module Aws::SQS
|
|
|
2259
2306
|
# `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to
|
|
2260
2307
|
# `#xFFFD` \| `#x10000` to `#x10FFFF`
|
|
2261
2308
|
#
|
|
2262
|
-
#
|
|
2263
|
-
#
|
|
2264
|
-
#
|
|
2265
|
-
#
|
|
2266
|
-
#
|
|
2309
|
+
# If a message contains characters outside the allowed set, Amazon
|
|
2310
|
+
# SQS
|
|
2311
|
+
# rejects the message and returns an InvalidMessageContents error.
|
|
2312
|
+
# Ensure that your message body includes only valid characters to
|
|
2313
|
+
# avoid this exception.
|
|
2267
2314
|
#
|
|
2268
2315
|
#
|
|
2269
2316
|
#
|
|
@@ -2331,7 +2378,6 @@ module Aws::SQS
|
|
|
2331
2378
|
#
|
|
2332
2379
|
# * If the queue has `ContentBasedDeduplication` set, your
|
|
2333
2380
|
# `MessageDeduplicationId` overrides the generated one.
|
|
2334
|
-
#
|
|
2335
2381
|
# * When `ContentBasedDeduplication` is in effect, messages with
|
|
2336
2382
|
# identical content sent within the deduplication interval are
|
|
2337
2383
|
# treated as duplicates and only one copy of the message is
|
|
@@ -2372,35 +2418,54 @@ module Aws::SQS
|
|
|
2372
2418
|
# @return [String]
|
|
2373
2419
|
#
|
|
2374
2420
|
# @!attribute [rw] message_group_id
|
|
2375
|
-
#
|
|
2376
|
-
#
|
|
2377
|
-
#
|
|
2378
|
-
#
|
|
2379
|
-
#
|
|
2380
|
-
#
|
|
2381
|
-
#
|
|
2382
|
-
#
|
|
2383
|
-
#
|
|
2384
|
-
#
|
|
2385
|
-
#
|
|
2386
|
-
#
|
|
2387
|
-
#
|
|
2388
|
-
#
|
|
2389
|
-
#
|
|
2421
|
+
# `MessageGroupId` is an attribute used in Amazon SQS FIFO
|
|
2422
|
+
# (First-In-First-Out) and standard queues. In FIFO queues,
|
|
2423
|
+
# `MessageGroupId` organizes messages into distinct groups. Messages
|
|
2424
|
+
# within the same message group are always processed one at a time, in
|
|
2425
|
+
# strict order, ensuring that no two messages from the same group are
|
|
2426
|
+
# processed simultaneously. In standard queues, using `MessageGroupId`
|
|
2427
|
+
# enables fair queues. It is used to identify the tenant a message
|
|
2428
|
+
# belongs to, helping maintain consistent message dwell time across
|
|
2429
|
+
# all tenants during noisy neighbor events. Unlike FIFO queues,
|
|
2430
|
+
# messages with the same `MessageGroupId` can be processed in
|
|
2431
|
+
# parallel, maintaining the high throughput of standard queues.
|
|
2432
|
+
#
|
|
2433
|
+
# * **FIFO queues:** `MessageGroupId` acts as the tag that specifies
|
|
2434
|
+
# that a message belongs to a specific message group. Messages that
|
|
2435
|
+
# belong to the same message group are processed in a FIFO manner
|
|
2436
|
+
# (however, messages in different message groups might be processed
|
|
2437
|
+
# out of order). To interleave multiple ordered streams within a
|
|
2438
|
+
# single queue, use `MessageGroupId` values (for example, session
|
|
2439
|
+
# data for multiple users). In this scenario, multiple consumers can
|
|
2440
|
+
# process the queue, but the session data of each user is processed
|
|
2441
|
+
# in a FIFO fashion.
|
|
2442
|
+
#
|
|
2443
|
+
# If you do not provide a `MessageGroupId` when sending a message to
|
|
2444
|
+
# a FIFO queue, the action fails.
|
|
2445
|
+
#
|
|
2446
|
+
# `ReceiveMessage` might return messages with multiple
|
|
2390
2447
|
# `MessageGroupId` values. For each `MessageGroupId`, the messages
|
|
2391
|
-
# are sorted by time sent.
|
|
2392
|
-
#
|
|
2448
|
+
# are sorted by time sent.
|
|
2449
|
+
#
|
|
2450
|
+
# * **Standard queues:**Use `MessageGroupId` in standard queues to
|
|
2451
|
+
# enable fair queues. The `MessageGroupId` identifies the tenant a
|
|
2452
|
+
# message belongs to. A tenant can be any entity that shares a queue
|
|
2453
|
+
# with others, such as your customer, a client application, or a
|
|
2454
|
+
# request type. When one tenant sends a disproportionately large
|
|
2455
|
+
# volume of messages or has messages that require longer processing
|
|
2456
|
+
# time, fair queues ensure other tenants' messages maintain low
|
|
2457
|
+
# dwell time. This preserves quality of service for all tenants
|
|
2458
|
+
# while maintaining the scalability and throughput of standard
|
|
2459
|
+
# queues. We recommend that you include a `MessageGroupId` in all
|
|
2460
|
+
# messages when using fair queues.
|
|
2393
2461
|
#
|
|
2394
|
-
# The
|
|
2395
|
-
#
|
|
2462
|
+
# The length of `MessageGroupId` is 128 characters. Valid values:
|
|
2463
|
+
# alphanumeric characters and punctuation ``
|
|
2396
2464
|
# (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
|
|
2397
2465
|
#
|
|
2398
2466
|
# For best practices of using `MessageGroupId`, see [Using the
|
|
2399
2467
|
# MessageGroupId Property][1] in the *Amazon SQS Developer Guide*.
|
|
2400
2468
|
#
|
|
2401
|
-
# `MessageGroupId` is required for FIFO queues. You can't use it for
|
|
2402
|
-
# Standard queues.
|
|
2403
|
-
#
|
|
2404
2469
|
#
|
|
2405
2470
|
#
|
|
2406
2471
|
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html
|
|
@@ -2503,8 +2568,8 @@ module Aws::SQS
|
|
|
2503
2568
|
#
|
|
2504
2569
|
# * `MaximumMessageSize` – The limit of how many bytes a message can
|
|
2505
2570
|
# contain before Amazon SQS rejects it. Valid values: An integer
|
|
2506
|
-
# from 1,024 bytes (1 KiB) up to
|
|
2507
|
-
#
|
|
2571
|
+
# from 1,024 bytes (1 KiB) up to 1,048,576 bytes (1 MiB). Default:
|
|
2572
|
+
# 1,048,576 bytes (1 MiB).
|
|
2508
2573
|
#
|
|
2509
2574
|
# * `MessageRetentionPeriod` – The length of time, in seconds, for
|
|
2510
2575
|
# which Amazon SQS retains a message. Valid values: An integer
|
|
@@ -2547,7 +2612,6 @@ module Aws::SQS
|
|
|
2547
2612
|
# Default: 10. When the `ReceiveCount` for a message exceeds the
|
|
2548
2613
|
# `maxReceiveCount` for a queue, Amazon SQS moves the message to
|
|
2549
2614
|
# the dead-letter-queue.
|
|
2550
|
-
#
|
|
2551
2615
|
# * `RedriveAllowPolicy` – The string that includes the parameters for
|
|
2552
2616
|
# the permissions for the dead-letter queue redrive permission and
|
|
2553
2617
|
# which source queues can specify dead-letter queues as a JSON
|
|
@@ -2566,7 +2630,6 @@ module Aws::SQS
|
|
|
2566
2630
|
#
|
|
2567
2631
|
# * `byQueue` – Only queues specified by the `sourceQueueArns`
|
|
2568
2632
|
# parameter can specify this queue as the dead-letter queue.
|
|
2569
|
-
#
|
|
2570
2633
|
# * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
|
|
2571
2634
|
# source queues that can specify this queue as the dead-letter
|
|
2572
2635
|
# queue and redrive messages. You can specify this parameter only
|
|
@@ -2628,7 +2691,6 @@ module Aws::SQS
|
|
|
2628
2691
|
#
|
|
2629
2692
|
# * If the queue has `ContentBasedDeduplication` set, your
|
|
2630
2693
|
# `MessageDeduplicationId` overrides the generated one.
|
|
2631
|
-
#
|
|
2632
2694
|
# * When `ContentBasedDeduplication` is in effect, messages with
|
|
2633
2695
|
# identical content sent within the deduplication interval are
|
|
2634
2696
|
# treated as duplicates and only one copy of the message is
|
|
@@ -2758,7 +2820,16 @@ module Aws::SQS
|
|
|
2758
2820
|
include Aws::Structure
|
|
2759
2821
|
end
|
|
2760
2822
|
|
|
2761
|
-
# The batch request contains more entries than permissible.
|
|
2823
|
+
# The batch request contains more entries than permissible. For Amazon
|
|
2824
|
+
# SQS, the maximum number of entries you can include in a single
|
|
2825
|
+
# [SendMessageBatch][1], [DeleteMessageBatch][2], or
|
|
2826
|
+
# [ChangeMessageVisibilityBatch][3] request is 10.
|
|
2827
|
+
#
|
|
2828
|
+
#
|
|
2829
|
+
#
|
|
2830
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_SendMessageBatch.html
|
|
2831
|
+
# [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_DeleteMessageBatch.html
|
|
2832
|
+
# [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/APIReference/API_ChangeMessageVisibilityBatch.html
|
|
2762
2833
|
#
|
|
2763
2834
|
# @!attribute [rw] message
|
|
2764
2835
|
# @return [String]
|
data/lib/aws-sdk-sqs.rb
CHANGED
data/sig/client.rbs
CHANGED
|
@@ -18,6 +18,7 @@ module Aws
|
|
|
18
18
|
?account_id: String,
|
|
19
19
|
?active_endpoint_cache: bool,
|
|
20
20
|
?adaptive_retry_wait_to_fill: bool,
|
|
21
|
+
?auth_scheme_preference: Array[String],
|
|
21
22
|
?client_side_monitoring: bool,
|
|
22
23
|
?client_side_monitoring_client_id: String,
|
|
23
24
|
?client_side_monitoring_host: String,
|
|
@@ -39,7 +40,9 @@ module Aws
|
|
|
39
40
|
?logger: untyped,
|
|
40
41
|
?max_attempts: Integer,
|
|
41
42
|
?profile: String,
|
|
43
|
+
?request_checksum_calculation: String,
|
|
42
44
|
?request_min_compression_size_bytes: Integer,
|
|
45
|
+
?response_checksum_validation: String,
|
|
43
46
|
?retry_backoff: Proc,
|
|
44
47
|
?retry_base_delay: Float,
|
|
45
48
|
?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
|
data/sig/resource.rbs
CHANGED
|
@@ -18,6 +18,7 @@ module Aws
|
|
|
18
18
|
?account_id: String,
|
|
19
19
|
?active_endpoint_cache: bool,
|
|
20
20
|
?adaptive_retry_wait_to_fill: bool,
|
|
21
|
+
?auth_scheme_preference: Array[String],
|
|
21
22
|
?client_side_monitoring: bool,
|
|
22
23
|
?client_side_monitoring_client_id: String,
|
|
23
24
|
?client_side_monitoring_host: String,
|
|
@@ -39,7 +40,9 @@ module Aws
|
|
|
39
40
|
?logger: untyped,
|
|
40
41
|
?max_attempts: Integer,
|
|
41
42
|
?profile: String,
|
|
43
|
+
?request_checksum_calculation: String,
|
|
42
44
|
?request_min_compression_size_bytes: Integer,
|
|
45
|
+
?response_checksum_validation: String,
|
|
43
46
|
?retry_backoff: Proc,
|
|
44
47
|
?retry_base_delay: Float,
|
|
45
48
|
?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),
|
metadata
CHANGED
|
@@ -1,14 +1,13 @@
|
|
|
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.107.0
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Amazon Web Services
|
|
8
|
-
autorequire:
|
|
9
8
|
bindir: bin
|
|
10
9
|
cert_chain: []
|
|
11
|
-
date:
|
|
10
|
+
date: 1980-01-02 00:00:00.000000000 Z
|
|
12
11
|
dependencies:
|
|
13
12
|
- !ruby/object:Gem::Dependency
|
|
14
13
|
name: aws-sdk-core
|
|
@@ -19,7 +18,7 @@ dependencies:
|
|
|
19
18
|
version: '3'
|
|
20
19
|
- - ">="
|
|
21
20
|
- !ruby/object:Gem::Version
|
|
22
|
-
version: 3.
|
|
21
|
+
version: 3.239.1
|
|
23
22
|
type: :runtime
|
|
24
23
|
prerelease: false
|
|
25
24
|
version_requirements: !ruby/object:Gem::Requirement
|
|
@@ -29,7 +28,7 @@ dependencies:
|
|
|
29
28
|
version: '3'
|
|
30
29
|
- - ">="
|
|
31
30
|
- !ruby/object:Gem::Version
|
|
32
|
-
version: 3.
|
|
31
|
+
version: 3.239.1
|
|
33
32
|
- !ruby/object:Gem::Dependency
|
|
34
33
|
name: aws-sigv4
|
|
35
34
|
requirement: !ruby/object:Gem::Requirement
|
|
@@ -84,7 +83,6 @@ licenses:
|
|
|
84
83
|
metadata:
|
|
85
84
|
source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-sqs
|
|
86
85
|
changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-sqs/CHANGELOG.md
|
|
87
|
-
post_install_message:
|
|
88
86
|
rdoc_options: []
|
|
89
87
|
require_paths:
|
|
90
88
|
- lib
|
|
@@ -92,15 +90,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
|
92
90
|
requirements:
|
|
93
91
|
- - ">="
|
|
94
92
|
- !ruby/object:Gem::Version
|
|
95
|
-
version: '2.
|
|
93
|
+
version: '2.7'
|
|
96
94
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
|
97
95
|
requirements:
|
|
98
96
|
- - ">="
|
|
99
97
|
- !ruby/object:Gem::Version
|
|
100
98
|
version: '0'
|
|
101
99
|
requirements: []
|
|
102
|
-
rubygems_version: 3.
|
|
103
|
-
signing_key:
|
|
100
|
+
rubygems_version: 3.6.7
|
|
104
101
|
specification_version: 4
|
|
105
102
|
summary: AWS SDK for Ruby - Amazon SQS
|
|
106
103
|
test_files: []
|