aws-sdk-sqs 1.30.0 → 1.35.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/lib/aws-sdk-sqs.rb +3 -2
- data/lib/aws-sdk-sqs/client.rb +228 -53
- data/lib/aws-sdk-sqs/message.rb +2 -2
- data/lib/aws-sdk-sqs/queue.rb +52 -5
- data/lib/aws-sdk-sqs/queue_poller.rb +1 -1
- data/lib/aws-sdk-sqs/resource.rb +57 -11
- data/lib/aws-sdk-sqs/types.rb +176 -29
- 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: dbce67a43e0664fd8755ad1f20631934a97159a8c2299113a2475903d58f73fd
|
4
|
+
data.tar.gz: eb03e73924f36fbbae23f600790076cc64a8be349bec4bf78657125c271a434b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 35092c039c91742d2d3c9861ee5a4dbfb1de8c3001cfbfae3adb0d305dd4bb525f3b08b80d4eb3b17628873cbb5eb1bd153b982331d3c8b3b68cae0ac888fa84
|
7
|
+
data.tar.gz: 9d40dd1bdb7ec855ddeb1d33c00d62c693006487380f33c17b4052c302db259c0bcd7519cc60a5666113aba6e5310308bf20a2a0c0b1112cd1d360688d591cbf
|
data/lib/aws-sdk-sqs.rb
CHANGED
@@ -7,6 +7,7 @@
|
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
10
|
+
|
10
11
|
require 'aws-sdk-core'
|
11
12
|
require 'aws-sigv4'
|
12
13
|
|
@@ -46,9 +47,9 @@ require_relative 'aws-sdk-sqs/customizations'
|
|
46
47
|
#
|
47
48
|
# See {Errors} for more information.
|
48
49
|
#
|
49
|
-
#
|
50
|
+
# @!group service
|
50
51
|
module Aws::SQS
|
51
52
|
|
52
|
-
GEM_VERSION = '1.
|
53
|
+
GEM_VERSION = '1.35.0'
|
53
54
|
|
54
55
|
end
|
data/lib/aws-sdk-sqs/client.rb
CHANGED
@@ -89,13 +89,28 @@ module Aws::SQS
|
|
89
89
|
# * `Aws::Credentials` - Used for configuring static, non-refreshing
|
90
90
|
# credentials.
|
91
91
|
#
|
92
|
+
# * `Aws::SharedCredentials` - Used for loading static credentials from a
|
93
|
+
# shared file, such as `~/.aws/config`.
|
94
|
+
#
|
95
|
+
# * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
|
96
|
+
#
|
97
|
+
# * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
|
98
|
+
# assume a role after providing credentials via the web.
|
99
|
+
#
|
100
|
+
# * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
|
101
|
+
# access token generated from `aws login`.
|
102
|
+
#
|
103
|
+
# * `Aws::ProcessCredentials` - Used for loading credentials from a
|
104
|
+
# process that outputs to stdout.
|
105
|
+
#
|
92
106
|
# * `Aws::InstanceProfileCredentials` - Used for loading credentials
|
93
107
|
# from an EC2 IMDS on an EC2 instance.
|
94
108
|
#
|
95
|
-
# * `Aws::
|
96
|
-
#
|
109
|
+
# * `Aws::ECSCredentials` - Used for loading credentials from
|
110
|
+
# instances running in ECS.
|
97
111
|
#
|
98
|
-
# * `Aws::
|
112
|
+
# * `Aws::CognitoIdentityCredentials` - Used for loading credentials
|
113
|
+
# from the Cognito Identity service.
|
99
114
|
#
|
100
115
|
# When `:credentials` are not configured directly, the following
|
101
116
|
# locations will be searched for credentials:
|
@@ -105,10 +120,10 @@ module Aws::SQS
|
|
105
120
|
# * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
|
106
121
|
# * `~/.aws/credentials`
|
107
122
|
# * `~/.aws/config`
|
108
|
-
# * EC2 IMDS instance profile - When used by default, the timeouts
|
109
|
-
# very aggressive. Construct and pass an instance of
|
110
|
-
# `Aws::InstanceProfileCredentails`
|
111
|
-
# timeouts.
|
123
|
+
# * EC2/ECS IMDS instance profile - When used by default, the timeouts
|
124
|
+
# are very aggressive. Construct and pass an instance of
|
125
|
+
# `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
|
126
|
+
# enable retries and extended timeouts.
|
112
127
|
#
|
113
128
|
# @option options [required, String] :region
|
114
129
|
# The AWS region to connect to. The configured `:region` is
|
@@ -353,8 +368,8 @@ module Aws::SQS
|
|
353
368
|
# `&AttributeName.2=second`
|
354
369
|
#
|
355
370
|
# <note markdown="1"> Cross-account permissions don't apply to this action. For more
|
356
|
-
# information, see [Grant
|
357
|
-
#
|
371
|
+
# information, see [Grant cross-account permissions to a role and a user
|
372
|
+
# name][4] in the *Amazon Simple Queue Service Developer Guide*.
|
358
373
|
#
|
359
374
|
# </note>
|
360
375
|
#
|
@@ -502,7 +517,7 @@ module Aws::SQS
|
|
502
517
|
#
|
503
518
|
# @option params [required, Integer] :visibility_timeout
|
504
519
|
# The new value for the message's visibility timeout (in seconds).
|
505
|
-
# Values
|
520
|
+
# Values range: `0` to `43200`. Maximum: 12 hours.
|
506
521
|
#
|
507
522
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
508
523
|
#
|
@@ -638,8 +653,8 @@ module Aws::SQS
|
|
638
653
|
# `&AttributeName.2=second`
|
639
654
|
#
|
640
655
|
# <note markdown="1"> Cross-account permissions don't apply to this action. For more
|
641
|
-
# information, see [Grant
|
642
|
-
#
|
656
|
+
# information, see [Grant cross-account permissions to a role and a user
|
657
|
+
# name][3] in the *Amazon Simple Queue Service Developer Guide*.
|
643
658
|
#
|
644
659
|
# </note>
|
645
660
|
#
|
@@ -737,22 +752,22 @@ module Aws::SQS
|
|
737
752
|
# The following attributes apply only to [FIFO (first-in-first-out)
|
738
753
|
# queues][9]\:
|
739
754
|
#
|
740
|
-
# * `FifoQueue` – Designates a queue as FIFO. Valid values
|
741
|
-
# `false`. If you don't specify the `FifoQueue` attribute, Amazon
|
742
|
-
# creates a standard queue. You can provide this attribute only
|
743
|
-
# queue creation. You can't change it for an existing queue.
|
744
|
-
# set this attribute, you must also provide the
|
745
|
-
# your messages explicitly.
|
755
|
+
# * `FifoQueue` – Designates a queue as FIFO. Valid values are `true`
|
756
|
+
# and `false`. If you don't specify the `FifoQueue` attribute, Amazon
|
757
|
+
# SQS creates a standard queue. You can provide this attribute only
|
758
|
+
# during queue creation. You can't change it for an existing queue.
|
759
|
+
# When you set this attribute, you must also provide the
|
760
|
+
# `MessageGroupId` for your messages explicitly.
|
746
761
|
#
|
747
762
|
# For more information, see [FIFO Queue Logic][10] in the *Amazon
|
748
763
|
# Simple Queue Service Developer Guide*.
|
749
764
|
#
|
750
765
|
# * `ContentBasedDeduplication` – Enables content-based deduplication.
|
751
|
-
# Valid values
|
766
|
+
# Valid values are `true` and `false`. For more information, see
|
752
767
|
# [Exactly-Once Processing][11] in the *Amazon Simple Queue Service
|
753
|
-
# Developer Guide*.
|
768
|
+
# Developer Guide*. Note the following:
|
754
769
|
#
|
755
|
-
# * Every message must have a unique `MessageDeduplicationId
|
770
|
+
# * Every message must have a unique `MessageDeduplicationId`.
|
756
771
|
#
|
757
772
|
# * You may provide a `MessageDeduplicationId` explicitly.
|
758
773
|
#
|
@@ -780,6 +795,50 @@ module Aws::SQS
|
|
780
795
|
# `MessageDeduplicationId`, the two messages are treated as
|
781
796
|
# duplicates and only one copy of the message is delivered.
|
782
797
|
#
|
798
|
+
# **Preview: High throughput for FIFO queues**
|
799
|
+
#
|
800
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release and
|
801
|
+
# is subject to change.** This feature provides a high number of
|
802
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
803
|
+
# information on throughput quotas, see [Quotas related to messages][12]
|
804
|
+
# in the *Amazon Simple Queue Service Developer Guide*.
|
805
|
+
#
|
806
|
+
# This preview includes two new attributes:
|
807
|
+
#
|
808
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
809
|
+
# occurs at the message group or queue level. Valid values are
|
810
|
+
# `messageGroup` and `queue`.
|
811
|
+
#
|
812
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
|
813
|
+
# quota applies to the entire queue or per message group. Valid values
|
814
|
+
# are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
|
815
|
+
# value is allowed only when the value for `DeduplicationScope` is
|
816
|
+
# `messageGroup`.
|
817
|
+
#
|
818
|
+
# To enable high throughput for FIFO queues, do the following:
|
819
|
+
#
|
820
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
821
|
+
#
|
822
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
823
|
+
#
|
824
|
+
# If you set these attributes to anything other than the values shown
|
825
|
+
# for enabling high throughput, standard throughput is in effect and
|
826
|
+
# deduplication occurs as specified.
|
827
|
+
#
|
828
|
+
# This preview is available in the following AWS Regions:
|
829
|
+
#
|
830
|
+
# * US East (Ohio); us-east-2
|
831
|
+
#
|
832
|
+
# * US East (N. Virginia); us-east-1
|
833
|
+
#
|
834
|
+
# * US West (Oregon); us-west-2
|
835
|
+
#
|
836
|
+
# * Europe (Ireland); eu-west-1
|
837
|
+
#
|
838
|
+
# For more information about high throughput for FIFO queues, see
|
839
|
+
# [Preview: High throughput for FIFO queues][13] in the *Amazon Simple
|
840
|
+
# Queue Service Developer Guide*.
|
841
|
+
#
|
783
842
|
#
|
784
843
|
#
|
785
844
|
# [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
@@ -793,6 +852,8 @@ module Aws::SQS
|
|
793
852
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
794
853
|
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
|
795
854
|
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
855
|
+
# [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
856
|
+
# [13]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
796
857
|
#
|
797
858
|
# @option params [Hash<String,String>] :tags
|
798
859
|
# Add cost allocation tags to the specified Amazon SQS queue. For an
|
@@ -818,8 +879,8 @@ module Aws::SQS
|
|
818
879
|
# `sqs:CreateQueue` and `sqs:TagQueue` permissions.
|
819
880
|
#
|
820
881
|
# Cross-account permissions don't apply to this action. For more
|
821
|
-
# information, see [Grant
|
822
|
-
#
|
882
|
+
# information, see [Grant cross-account permissions to a role and a user
|
883
|
+
# name][3] in the *Amazon Simple Queue Service Developer Guide*.
|
823
884
|
#
|
824
885
|
# </note>
|
825
886
|
#
|
@@ -984,8 +1045,8 @@ module Aws::SQS
|
|
984
1045
|
# creating a queue with the same name.
|
985
1046
|
#
|
986
1047
|
# <note markdown="1"> Cross-account permissions don't apply to this action. For more
|
987
|
-
# information, see [Grant
|
988
|
-
#
|
1048
|
+
# information, see [Grant cross-account permissions to a role and a user
|
1049
|
+
# name][1] in the *Amazon Simple Queue Service Developer Guide*.
|
989
1050
|
#
|
990
1051
|
# </note>
|
991
1052
|
#
|
@@ -1121,9 +1182,9 @@ module Aws::SQS
|
|
1121
1182
|
# The following attributes apply only to [FIFO (first-in-first-out)
|
1122
1183
|
# queues][7]\:
|
1123
1184
|
#
|
1124
|
-
# * `FifoQueue` – Returns whether the queue is FIFO.
|
1125
|
-
# information, see [FIFO Queue Logic][8] in the *Amazon
|
1126
|
-
# Service Developer Guide*.
|
1185
|
+
# * `FifoQueue` – Returns information about whether the queue is FIFO.
|
1186
|
+
# For more information, see [FIFO Queue Logic][8] in the *Amazon
|
1187
|
+
# Simple Queue Service Developer Guide*.
|
1127
1188
|
#
|
1128
1189
|
# <note markdown="1"> To determine whether a queue is [FIFO][7], you can check whether
|
1129
1190
|
# `QueueName` ends with the `.fifo` suffix.
|
@@ -1135,6 +1196,50 @@ module Aws::SQS
|
|
1135
1196
|
# [Exactly-Once Processing][9] in the *Amazon Simple Queue Service
|
1136
1197
|
# Developer Guide*.
|
1137
1198
|
#
|
1199
|
+
# **Preview: High throughput for FIFO queues**
|
1200
|
+
#
|
1201
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release and
|
1202
|
+
# is subject to change.** This feature provides a high number of
|
1203
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
1204
|
+
# information on throughput quotas, see [Quotas related to messages][10]
|
1205
|
+
# in the *Amazon Simple Queue Service Developer Guide*.
|
1206
|
+
#
|
1207
|
+
# This preview includes two new attributes:
|
1208
|
+
#
|
1209
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
1210
|
+
# occurs at the message group or queue level. Valid values are
|
1211
|
+
# `messageGroup` and `queue`.
|
1212
|
+
#
|
1213
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
|
1214
|
+
# quota applies to the entire queue or per message group. Valid values
|
1215
|
+
# are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
|
1216
|
+
# value is allowed only when the value for `DeduplicationScope` is
|
1217
|
+
# `messageGroup`.
|
1218
|
+
#
|
1219
|
+
# To enable high throughput for FIFO queues, do the following:
|
1220
|
+
#
|
1221
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
1222
|
+
#
|
1223
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
1224
|
+
#
|
1225
|
+
# If you set these attributes to anything other than the values shown
|
1226
|
+
# for enabling high throughput, standard throughput is in effect and
|
1227
|
+
# deduplication occurs as specified.
|
1228
|
+
#
|
1229
|
+
# This preview is available in the following AWS Regions:
|
1230
|
+
#
|
1231
|
+
# * US East (Ohio); us-east-2
|
1232
|
+
#
|
1233
|
+
# * US East (N. Virginia); us-east-1
|
1234
|
+
#
|
1235
|
+
# * US West (Oregon); us-west-2
|
1236
|
+
#
|
1237
|
+
# * Europe (Ireland); eu-west-1
|
1238
|
+
#
|
1239
|
+
# For more information about high throughput for FIFO queues, see
|
1240
|
+
# [Preview: High throughput for FIFO queues][11] in the *Amazon Simple
|
1241
|
+
# Queue Service Developer Guide*.
|
1242
|
+
#
|
1138
1243
|
#
|
1139
1244
|
#
|
1140
1245
|
# [1]: http://en.wikipedia.org/wiki/Unix_time
|
@@ -1146,6 +1251,8 @@ module Aws::SQS
|
|
1146
1251
|
# [7]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
1147
1252
|
# [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
|
1148
1253
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
1254
|
+
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
1255
|
+
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
1149
1256
|
#
|
1150
1257
|
# @return [Types::GetQueueAttributesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1151
1258
|
#
|
@@ -1155,7 +1262,7 @@ module Aws::SQS
|
|
1155
1262
|
#
|
1156
1263
|
# resp = client.get_queue_attributes({
|
1157
1264
|
# queue_url: "String", # required
|
1158
|
-
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
|
1265
|
+
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit
|
1159
1266
|
# })
|
1160
1267
|
#
|
1161
1268
|
# @example Response structure
|
@@ -1222,6 +1329,15 @@ module Aws::SQS
|
|
1222
1329
|
# Returns a list of your queues that have the `RedrivePolicy` queue
|
1223
1330
|
# attribute configured with a dead-letter queue.
|
1224
1331
|
#
|
1332
|
+
# The `ListDeadLetterSourceQueues` methods supports pagination. Set
|
1333
|
+
# parameter `MaxResults` in the request to specify the maximum number of
|
1334
|
+
# results to be returned in the response. If you do not set
|
1335
|
+
# `MaxResults`, the response includes a maximum of 1,000 results. If you
|
1336
|
+
# set `MaxResults` and there are additional results to display, the
|
1337
|
+
# response includes a value for `NextToken`. Use `NextToken` as a
|
1338
|
+
# parameter in your next request to `ListDeadLetterSourceQueues` to
|
1339
|
+
# receive the next page of results.
|
1340
|
+
#
|
1225
1341
|
# For more information about using dead-letter queues, see [Using Amazon
|
1226
1342
|
# SQS Dead-Letter Queues][1] in the *Amazon Simple Queue Service
|
1227
1343
|
# Developer Guide*.
|
@@ -1239,7 +1355,9 @@ module Aws::SQS
|
|
1239
1355
|
# Pagination token to request the next set of results.
|
1240
1356
|
#
|
1241
1357
|
# @option params [Integer] :max_results
|
1242
|
-
# Maximum number of results to include in the response.
|
1358
|
+
# Maximum number of results to include in the response. Value range is 1
|
1359
|
+
# to 1000. You must set `MaxResults` to receive a value for `NextToken`
|
1360
|
+
# in the response.
|
1243
1361
|
#
|
1244
1362
|
# @return [Types::ListDeadLetterSourceQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1245
1363
|
#
|
@@ -1276,8 +1394,8 @@ module Aws::SQS
|
|
1276
1394
|
# *Amazon Simple Queue Service Developer Guide*.
|
1277
1395
|
#
|
1278
1396
|
# <note markdown="1"> Cross-account permissions don't apply to this action. For more
|
1279
|
-
# information, see [Grant
|
1280
|
-
#
|
1397
|
+
# information, see [Grant cross-account permissions to a role and a user
|
1398
|
+
# name][2] in the *Amazon Simple Queue Service Developer Guide*.
|
1281
1399
|
#
|
1282
1400
|
# </note>
|
1283
1401
|
#
|
@@ -1313,14 +1431,22 @@ module Aws::SQS
|
|
1313
1431
|
req.send_request(options)
|
1314
1432
|
end
|
1315
1433
|
|
1316
|
-
# Returns a list of your queues
|
1317
|
-
#
|
1318
|
-
# `QueueNamePrefix` parameter, only queues with a name that
|
1319
|
-
# the specified value are returned.
|
1434
|
+
# Returns a list of your queues in the current region. The response
|
1435
|
+
# includes a maximum of 1,000 results. If you specify a value for the
|
1436
|
+
# optional `QueueNamePrefix` parameter, only queues with a name that
|
1437
|
+
# begins with the specified value are returned.
|
1438
|
+
#
|
1439
|
+
# The `listQueues` methods supports pagination. Set parameter
|
1440
|
+
# `MaxResults` in the request to specify the maximum number of results
|
1441
|
+
# to be returned in the response. If you do not set `MaxResults`, the
|
1442
|
+
# response includes a maximum of 1,000 results. If you set `MaxResults`
|
1443
|
+
# and there are additional results to display, the response includes a
|
1444
|
+
# value for `NextToken`. Use `NextToken` as a parameter in your next
|
1445
|
+
# request to `listQueues` to receive the next page of results.
|
1320
1446
|
#
|
1321
1447
|
# <note markdown="1"> Cross-account permissions don't apply to this action. For more
|
1322
|
-
# information, see [Grant
|
1323
|
-
#
|
1448
|
+
# information, see [Grant cross-account permissions to a role and a user
|
1449
|
+
# name][1] in the *Amazon Simple Queue Service Developer Guide*.
|
1324
1450
|
#
|
1325
1451
|
# </note>
|
1326
1452
|
#
|
@@ -1338,7 +1464,9 @@ module Aws::SQS
|
|
1338
1464
|
# Pagination token to request the next set of results.
|
1339
1465
|
#
|
1340
1466
|
# @option params [Integer] :max_results
|
1341
|
-
# Maximum number of results to include in the response.
|
1467
|
+
# Maximum number of results to include in the response. Value range is 1
|
1468
|
+
# to 1000. You must set `MaxResults` to receive a value for `NextToken`
|
1469
|
+
# in the response.
|
1342
1470
|
#
|
1343
1471
|
# @return [Types::ListQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1344
1472
|
#
|
@@ -1631,7 +1759,7 @@ module Aws::SQS
|
|
1631
1759
|
#
|
1632
1760
|
# resp = client.receive_message({
|
1633
1761
|
# queue_url: "String", # required
|
1634
|
-
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
|
1762
|
+
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit
|
1635
1763
|
# message_attribute_names: ["MessageAttributeName"],
|
1636
1764
|
# max_number_of_messages: 1,
|
1637
1765
|
# visibility_timeout: 1,
|
@@ -1673,8 +1801,8 @@ module Aws::SQS
|
|
1673
1801
|
# <note markdown="1"> * Only the owner of a queue can remove permissions from it.
|
1674
1802
|
#
|
1675
1803
|
# * Cross-account permissions don't apply to this action. For more
|
1676
|
-
# information, see [Grant
|
1677
|
-
#
|
1804
|
+
# information, see [Grant cross-account permissions to a role and a
|
1805
|
+
# user name][1] in the *Amazon Simple Queue Service Developer Guide*.
|
1678
1806
|
#
|
1679
1807
|
# * To remove the ability to change queue permissions, you must deny
|
1680
1808
|
# permission to the `AddPermission`, `RemovePermission`, and
|
@@ -1734,7 +1862,8 @@ module Aws::SQS
|
|
1734
1862
|
# Queue URLs and names are case-sensitive.
|
1735
1863
|
#
|
1736
1864
|
# @option params [required, String] :message_body
|
1737
|
-
# The message to send. The
|
1865
|
+
# The message to send. The minimum size is one character. The maximum
|
1866
|
+
# size is 256 KB.
|
1738
1867
|
#
|
1739
1868
|
# A message can include only XML, JSON, and unformatted text. The
|
1740
1869
|
# following Unicode characters are allowed:
|
@@ -1768,7 +1897,7 @@ module Aws::SQS
|
|
1768
1897
|
#
|
1769
1898
|
#
|
1770
1899
|
#
|
1771
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
1900
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
1772
1901
|
#
|
1773
1902
|
# @option params [Hash<String,Types::MessageSystemAttributeValue>] :message_system_attributes
|
1774
1903
|
# The message system attribute to send. Each message system attribute
|
@@ -2048,8 +2177,8 @@ module Aws::SQS
|
|
2048
2177
|
# it can handle new attributes gracefully.
|
2049
2178
|
#
|
2050
2179
|
# * Cross-account permissions don't apply to this action. For more
|
2051
|
-
# information, see [Grant
|
2052
|
-
#
|
2180
|
+
# information, see [Grant cross-account permissions to a role and a
|
2181
|
+
# user name][1] in the *Amazon Simple Queue Service Developer Guide*.
|
2053
2182
|
#
|
2054
2183
|
# * To remove the ability to change queue permissions, you must deny
|
2055
2184
|
# permission to the `AddPermission`, `RemovePermission`, and
|
@@ -2144,9 +2273,9 @@ module Aws::SQS
|
|
2144
2273
|
#
|
2145
2274
|
# * `ContentBasedDeduplication` – Enables content-based deduplication.
|
2146
2275
|
# For more information, see [Exactly-Once Processing][10] in the
|
2147
|
-
# *Amazon Simple Queue Service Developer Guide*.
|
2276
|
+
# *Amazon Simple Queue Service Developer Guide*. Note the following:
|
2148
2277
|
#
|
2149
|
-
# * Every message must have a unique `MessageDeduplicationId
|
2278
|
+
# * Every message must have a unique `MessageDeduplicationId`.
|
2150
2279
|
#
|
2151
2280
|
# * You may provide a `MessageDeduplicationId` explicitly.
|
2152
2281
|
#
|
@@ -2174,6 +2303,50 @@ module Aws::SQS
|
|
2174
2303
|
# `MessageDeduplicationId`, the two messages are treated as
|
2175
2304
|
# duplicates and only one copy of the message is delivered.
|
2176
2305
|
#
|
2306
|
+
# **Preview: High throughput for FIFO queues**
|
2307
|
+
#
|
2308
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release and
|
2309
|
+
# is subject to change.** This feature provides a high number of
|
2310
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
2311
|
+
# information on throughput quotas, see [Quotas related to messages][11]
|
2312
|
+
# in the *Amazon Simple Queue Service Developer Guide*.
|
2313
|
+
#
|
2314
|
+
# This preview includes two new attributes:
|
2315
|
+
#
|
2316
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
2317
|
+
# occurs at the message group or queue level. Valid values are
|
2318
|
+
# `messageGroup` and `queue`.
|
2319
|
+
#
|
2320
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
|
2321
|
+
# quota applies to the entire queue or per message group. Valid values
|
2322
|
+
# are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
|
2323
|
+
# value is allowed only when the value for `DeduplicationScope` is
|
2324
|
+
# `messageGroup`.
|
2325
|
+
#
|
2326
|
+
# To enable high throughput for FIFO queues, do the following:
|
2327
|
+
#
|
2328
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
2329
|
+
#
|
2330
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
2331
|
+
#
|
2332
|
+
# If you set these attributes to anything other than the values shown
|
2333
|
+
# for enabling high throughput, standard throughput is in effect and
|
2334
|
+
# deduplication occurs as specified.
|
2335
|
+
#
|
2336
|
+
# This preview is available in the following AWS Regions:
|
2337
|
+
#
|
2338
|
+
# * US East (Ohio); us-east-2
|
2339
|
+
#
|
2340
|
+
# * US East (N. Virginia); us-east-1
|
2341
|
+
#
|
2342
|
+
# * US West (Oregon); us-west-2
|
2343
|
+
#
|
2344
|
+
# * Europe (Ireland); eu-west-1
|
2345
|
+
#
|
2346
|
+
# For more information about high throughput for FIFO queues, see
|
2347
|
+
# [Preview: High throughput for FIFO queues][12] in the *Amazon Simple
|
2348
|
+
# Queue Service Developer Guide*.
|
2349
|
+
#
|
2177
2350
|
#
|
2178
2351
|
#
|
2179
2352
|
# [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
@@ -2186,6 +2359,8 @@ module Aws::SQS
|
|
2186
2359
|
# [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
|
2187
2360
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
2188
2361
|
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
2362
|
+
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
2363
|
+
# [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
2189
2364
|
#
|
2190
2365
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
2191
2366
|
#
|
@@ -2227,8 +2402,8 @@ module Aws::SQS
|
|
2227
2402
|
# in the *Amazon Simple Queue Service Developer Guide*.
|
2228
2403
|
#
|
2229
2404
|
# <note markdown="1"> Cross-account permissions don't apply to this action. For more
|
2230
|
-
# information, see [Grant
|
2231
|
-
#
|
2405
|
+
# information, see [Grant cross-account permissions to a role and a user
|
2406
|
+
# name][3] in the *Amazon Simple Queue Service Developer Guide*.
|
2232
2407
|
#
|
2233
2408
|
# </note>
|
2234
2409
|
#
|
@@ -2269,8 +2444,8 @@ module Aws::SQS
|
|
2269
2444
|
# Simple Queue Service Developer Guide*.
|
2270
2445
|
#
|
2271
2446
|
# <note markdown="1"> Cross-account permissions don't apply to this action. For more
|
2272
|
-
# information, see [Grant
|
2273
|
-
#
|
2447
|
+
# information, see [Grant cross-account permissions to a role and a user
|
2448
|
+
# name][2] in the *Amazon Simple Queue Service Developer Guide*.
|
2274
2449
|
#
|
2275
2450
|
# </note>
|
2276
2451
|
#
|
@@ -2316,7 +2491,7 @@ module Aws::SQS
|
|
2316
2491
|
params: params,
|
2317
2492
|
config: config)
|
2318
2493
|
context[:gem_name] = 'aws-sdk-sqs'
|
2319
|
-
context[:gem_version] = '1.
|
2494
|
+
context[:gem_version] = '1.35.0'
|
2320
2495
|
Seahorse::Client::Request.new(handlers, context)
|
2321
2496
|
end
|
2322
2497
|
|
data/lib/aws-sdk-sqs/message.rb
CHANGED
@@ -109,7 +109,7 @@ module Aws::SQS
|
|
109
109
|
#
|
110
110
|
#
|
111
111
|
#
|
112
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
112
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
113
113
|
# @return [Hash<String,Types::MessageAttributeValue>]
|
114
114
|
def message_attributes
|
115
115
|
data[:message_attributes]
|
@@ -155,7 +155,7 @@ module Aws::SQS
|
|
155
155
|
# @param [Hash] options ({})
|
156
156
|
# @option options [required, Integer] :visibility_timeout
|
157
157
|
# The new value for the message's visibility timeout (in seconds).
|
158
|
-
# Values
|
158
|
+
# Values range: `0` to `43200`. Maximum: 12 hours.
|
159
159
|
# @return [EmptyStructure]
|
160
160
|
def change_visibility(options = {})
|
161
161
|
options = options.merge(
|
data/lib/aws-sdk-sqs/queue.rb
CHANGED
@@ -195,7 +195,7 @@ module Aws::SQS
|
|
195
195
|
# @example Request syntax with placeholder values
|
196
196
|
#
|
197
197
|
# message = queue.receive_messages({
|
198
|
-
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
|
198
|
+
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit
|
199
199
|
# message_attribute_names: ["MessageAttributeName"],
|
200
200
|
# max_number_of_messages: 1,
|
201
201
|
# visibility_timeout: 1,
|
@@ -410,7 +410,8 @@ module Aws::SQS
|
|
410
410
|
# })
|
411
411
|
# @param [Hash] options ({})
|
412
412
|
# @option options [required, String] :message_body
|
413
|
-
# The message to send. The
|
413
|
+
# The message to send. The minimum size is one character. The maximum
|
414
|
+
# size is 256 KB.
|
414
415
|
#
|
415
416
|
# A message can include only XML, JSON, and unformatted text. The
|
416
417
|
# following Unicode characters are allowed:
|
@@ -442,7 +443,7 @@ module Aws::SQS
|
|
442
443
|
#
|
443
444
|
#
|
444
445
|
#
|
445
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
446
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
446
447
|
# @option options [Hash<String,Types::MessageSystemAttributeValue>] :message_system_attributes
|
447
448
|
# The message system attribute to send. Each message system attribute
|
448
449
|
# consists of a `Name`, `Type`, and `Value`.
|
@@ -681,9 +682,9 @@ module Aws::SQS
|
|
681
682
|
#
|
682
683
|
# * `ContentBasedDeduplication` – Enables content-based deduplication.
|
683
684
|
# For more information, see [Exactly-Once Processing][10] in the
|
684
|
-
# *Amazon Simple Queue Service Developer Guide*.
|
685
|
+
# *Amazon Simple Queue Service Developer Guide*. Note the following:
|
685
686
|
#
|
686
|
-
# * Every message must have a unique `MessageDeduplicationId
|
687
|
+
# * Every message must have a unique `MessageDeduplicationId`.
|
687
688
|
#
|
688
689
|
# * You may provide a `MessageDeduplicationId` explicitly.
|
689
690
|
#
|
@@ -711,6 +712,50 @@ module Aws::SQS
|
|
711
712
|
# `MessageDeduplicationId`, the two messages are treated as
|
712
713
|
# duplicates and only one copy of the message is delivered.
|
713
714
|
#
|
715
|
+
# **Preview: High throughput for FIFO queues**
|
716
|
+
#
|
717
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release and
|
718
|
+
# is subject to change.** This feature provides a high number of
|
719
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
720
|
+
# information on throughput quotas, see [Quotas related to messages][11]
|
721
|
+
# in the *Amazon Simple Queue Service Developer Guide*.
|
722
|
+
#
|
723
|
+
# This preview includes two new attributes:
|
724
|
+
#
|
725
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
726
|
+
# occurs at the message group or queue level. Valid values are
|
727
|
+
# `messageGroup` and `queue`.
|
728
|
+
#
|
729
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
|
730
|
+
# quota applies to the entire queue or per message group. Valid values
|
731
|
+
# are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
|
732
|
+
# value is allowed only when the value for `DeduplicationScope` is
|
733
|
+
# `messageGroup`.
|
734
|
+
#
|
735
|
+
# To enable high throughput for FIFO queues, do the following:
|
736
|
+
#
|
737
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
738
|
+
#
|
739
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
740
|
+
#
|
741
|
+
# If you set these attributes to anything other than the values shown
|
742
|
+
# for enabling high throughput, standard throughput is in effect and
|
743
|
+
# deduplication occurs as specified.
|
744
|
+
#
|
745
|
+
# This preview is available in the following AWS Regions:
|
746
|
+
#
|
747
|
+
# * US East (Ohio); us-east-2
|
748
|
+
#
|
749
|
+
# * US East (N. Virginia); us-east-1
|
750
|
+
#
|
751
|
+
# * US West (Oregon); us-west-2
|
752
|
+
#
|
753
|
+
# * Europe (Ireland); eu-west-1
|
754
|
+
#
|
755
|
+
# For more information about high throughput for FIFO queues, see
|
756
|
+
# [Preview: High throughput for FIFO queues][12] in the *Amazon Simple
|
757
|
+
# Queue Service Developer Guide*.
|
758
|
+
#
|
714
759
|
#
|
715
760
|
#
|
716
761
|
# [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
@@ -723,6 +768,8 @@ module Aws::SQS
|
|
723
768
|
# [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
|
724
769
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
725
770
|
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
771
|
+
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
772
|
+
# [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
726
773
|
# @return [EmptyStructure]
|
727
774
|
def set_attributes(options = {})
|
728
775
|
options = options.merge(queue_url: @url)
|
@@ -290,7 +290,7 @@ module Aws
|
|
290
290
|
# @option options [Integer] :visibility_timeout (nil)
|
291
291
|
# The number of seconds you have to process a message before
|
292
292
|
# it is put back into the queue and can be received again.
|
293
|
-
# By default, the queue's
|
293
|
+
# By default, the queue's visibility timeout is not set.
|
294
294
|
#
|
295
295
|
# @option options [Array<String>] :attribute_names ([])
|
296
296
|
# The list of attributes that need to be returned along with each
|
data/lib/aws-sdk-sqs/resource.rb
CHANGED
@@ -134,22 +134,22 @@ module Aws::SQS
|
|
134
134
|
# The following attributes apply only to [FIFO (first-in-first-out)
|
135
135
|
# queues][9]\:
|
136
136
|
#
|
137
|
-
# * `FifoQueue` – Designates a queue as FIFO. Valid values
|
138
|
-
# `false`. If you don't specify the `FifoQueue` attribute, Amazon
|
139
|
-
# creates a standard queue. You can provide this attribute only
|
140
|
-
# queue creation. You can't change it for an existing queue.
|
141
|
-
# set this attribute, you must also provide the
|
142
|
-
# your messages explicitly.
|
137
|
+
# * `FifoQueue` – Designates a queue as FIFO. Valid values are `true`
|
138
|
+
# and `false`. If you don't specify the `FifoQueue` attribute, Amazon
|
139
|
+
# SQS creates a standard queue. You can provide this attribute only
|
140
|
+
# during queue creation. You can't change it for an existing queue.
|
141
|
+
# When you set this attribute, you must also provide the
|
142
|
+
# `MessageGroupId` for your messages explicitly.
|
143
143
|
#
|
144
144
|
# For more information, see [FIFO Queue Logic][10] in the *Amazon
|
145
145
|
# Simple Queue Service Developer Guide*.
|
146
146
|
#
|
147
147
|
# * `ContentBasedDeduplication` – Enables content-based deduplication.
|
148
|
-
# Valid values
|
148
|
+
# Valid values are `true` and `false`. For more information, see
|
149
149
|
# [Exactly-Once Processing][11] in the *Amazon Simple Queue Service
|
150
|
-
# Developer Guide*.
|
150
|
+
# Developer Guide*. Note the following:
|
151
151
|
#
|
152
|
-
# * Every message must have a unique `MessageDeduplicationId
|
152
|
+
# * Every message must have a unique `MessageDeduplicationId`.
|
153
153
|
#
|
154
154
|
# * You may provide a `MessageDeduplicationId` explicitly.
|
155
155
|
#
|
@@ -177,6 +177,50 @@ module Aws::SQS
|
|
177
177
|
# `MessageDeduplicationId`, the two messages are treated as
|
178
178
|
# duplicates and only one copy of the message is delivered.
|
179
179
|
#
|
180
|
+
# **Preview: High throughput for FIFO queues**
|
181
|
+
#
|
182
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release and
|
183
|
+
# is subject to change.** This feature provides a high number of
|
184
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
185
|
+
# information on throughput quotas, see [Quotas related to messages][12]
|
186
|
+
# in the *Amazon Simple Queue Service Developer Guide*.
|
187
|
+
#
|
188
|
+
# This preview includes two new attributes:
|
189
|
+
#
|
190
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
191
|
+
# occurs at the message group or queue level. Valid values are
|
192
|
+
# `messageGroup` and `queue`.
|
193
|
+
#
|
194
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
|
195
|
+
# quota applies to the entire queue or per message group. Valid values
|
196
|
+
# are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
|
197
|
+
# value is allowed only when the value for `DeduplicationScope` is
|
198
|
+
# `messageGroup`.
|
199
|
+
#
|
200
|
+
# To enable high throughput for FIFO queues, do the following:
|
201
|
+
#
|
202
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
203
|
+
#
|
204
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
205
|
+
#
|
206
|
+
# If you set these attributes to anything other than the values shown
|
207
|
+
# for enabling high throughput, standard throughput is in effect and
|
208
|
+
# deduplication occurs as specified.
|
209
|
+
#
|
210
|
+
# This preview is available in the following AWS Regions:
|
211
|
+
#
|
212
|
+
# * US East (Ohio); us-east-2
|
213
|
+
#
|
214
|
+
# * US East (N. Virginia); us-east-1
|
215
|
+
#
|
216
|
+
# * US West (Oregon); us-west-2
|
217
|
+
#
|
218
|
+
# * Europe (Ireland); eu-west-1
|
219
|
+
#
|
220
|
+
# For more information about high throughput for FIFO queues, see
|
221
|
+
# [Preview: High throughput for FIFO queues][13] in the *Amazon Simple
|
222
|
+
# Queue Service Developer Guide*.
|
223
|
+
#
|
180
224
|
#
|
181
225
|
#
|
182
226
|
# [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
@@ -190,6 +234,8 @@ module Aws::SQS
|
|
190
234
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
191
235
|
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
|
192
236
|
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
237
|
+
# [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
238
|
+
# [13]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
193
239
|
# @option options [Hash<String,String>] :tags
|
194
240
|
# Add cost allocation tags to the specified Amazon SQS queue. For an
|
195
241
|
# overview, see [Tagging Your Amazon SQS Queues][1] in the *Amazon
|
@@ -214,8 +260,8 @@ module Aws::SQS
|
|
214
260
|
# `sqs:CreateQueue` and `sqs:TagQueue` permissions.
|
215
261
|
#
|
216
262
|
# Cross-account permissions don't apply to this action. For more
|
217
|
-
# information, see [Grant
|
218
|
-
#
|
263
|
+
# information, see [Grant cross-account permissions to a role and a user
|
264
|
+
# name][3] in the *Amazon Simple Queue Service Developer Guide*.
|
219
265
|
#
|
220
266
|
# </note>
|
221
267
|
#
|
data/lib/aws-sdk-sqs/types.rb
CHANGED
@@ -268,7 +268,7 @@ module Aws::SQS
|
|
268
268
|
#
|
269
269
|
# @!attribute [rw] visibility_timeout
|
270
270
|
# The new value for the message's visibility timeout (in seconds).
|
271
|
-
# Values
|
271
|
+
# Values range: `0` to `43200`. Maximum: 12 hours.
|
272
272
|
# @return [Integer]
|
273
273
|
#
|
274
274
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ChangeMessageVisibilityRequest AWS API Documentation
|
@@ -385,22 +385,22 @@ module Aws::SQS
|
|
385
385
|
# The following attributes apply only to [FIFO (first-in-first-out)
|
386
386
|
# queues][9]\:
|
387
387
|
#
|
388
|
-
# * `FifoQueue` – Designates a queue as FIFO. Valid values
|
389
|
-
# `false`. If you don't specify the `FifoQueue` attribute,
|
390
|
-
# SQS creates a standard queue. You can provide this
|
391
|
-
# during queue creation. You can't change it for an
|
392
|
-
# When you set this attribute, you must also provide
|
393
|
-
# `MessageGroupId` for your messages explicitly.
|
388
|
+
# * `FifoQueue` – Designates a queue as FIFO. Valid values are `true`
|
389
|
+
# and `false`. If you don't specify the `FifoQueue` attribute,
|
390
|
+
# Amazon SQS creates a standard queue. You can provide this
|
391
|
+
# attribute only during queue creation. You can't change it for an
|
392
|
+
# existing queue. When you set this attribute, you must also provide
|
393
|
+
# the `MessageGroupId` for your messages explicitly.
|
394
394
|
#
|
395
395
|
# For more information, see [FIFO Queue Logic][10] in the *Amazon
|
396
396
|
# Simple Queue Service Developer Guide*.
|
397
397
|
#
|
398
398
|
# * `ContentBasedDeduplication` – Enables content-based deduplication.
|
399
|
-
# Valid values
|
399
|
+
# Valid values are `true` and `false`. For more information, see
|
400
400
|
# [Exactly-Once Processing][11] in the *Amazon Simple Queue Service
|
401
|
-
# Developer Guide*.
|
401
|
+
# Developer Guide*. Note the following:
|
402
402
|
#
|
403
|
-
# * Every message must have a unique `MessageDeduplicationId
|
403
|
+
# * Every message must have a unique `MessageDeduplicationId`.
|
404
404
|
#
|
405
405
|
# * You may provide a `MessageDeduplicationId` explicitly.
|
406
406
|
#
|
@@ -428,6 +428,50 @@ module Aws::SQS
|
|
428
428
|
# `MessageDeduplicationId`, the two messages are treated as
|
429
429
|
# duplicates and only one copy of the message is delivered.
|
430
430
|
#
|
431
|
+
# **Preview: High throughput for FIFO queues**
|
432
|
+
#
|
433
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release
|
434
|
+
# and is subject to change.** This feature provides a high number of
|
435
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
436
|
+
# information on throughput quotas, see [Quotas related to
|
437
|
+
# messages][12] in the *Amazon Simple Queue Service Developer Guide*.
|
438
|
+
#
|
439
|
+
# This preview includes two new attributes:
|
440
|
+
#
|
441
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
442
|
+
# occurs at the message group or queue level. Valid values are
|
443
|
+
# `messageGroup` and `queue`.
|
444
|
+
#
|
445
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue
|
446
|
+
# throughput quota applies to the entire queue or per message group.
|
447
|
+
# Valid values are `perQueue` and `perMessageGroupId`. The
|
448
|
+
# `perMessageGroupId` value is allowed only when the value for
|
449
|
+
# `DeduplicationScope` is `messageGroup`.
|
450
|
+
#
|
451
|
+
# To enable high throughput for FIFO queues, do the following:
|
452
|
+
#
|
453
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
454
|
+
#
|
455
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
456
|
+
#
|
457
|
+
# If you set these attributes to anything other than the values shown
|
458
|
+
# for enabling high throughput, standard throughput is in effect and
|
459
|
+
# deduplication occurs as specified.
|
460
|
+
#
|
461
|
+
# This preview is available in the following AWS Regions:
|
462
|
+
#
|
463
|
+
# * US East (Ohio); us-east-2
|
464
|
+
#
|
465
|
+
# * US East (N. Virginia); us-east-1
|
466
|
+
#
|
467
|
+
# * US West (Oregon); us-west-2
|
468
|
+
#
|
469
|
+
# * Europe (Ireland); eu-west-1
|
470
|
+
#
|
471
|
+
# For more information about high throughput for FIFO queues, see
|
472
|
+
# [Preview: High throughput for FIFO queues][13] in the *Amazon Simple
|
473
|
+
# Queue Service Developer Guide*.
|
474
|
+
#
|
431
475
|
#
|
432
476
|
#
|
433
477
|
# [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
@@ -441,6 +485,8 @@ module Aws::SQS
|
|
441
485
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
442
486
|
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
|
443
487
|
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
488
|
+
# [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
489
|
+
# [13]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
444
490
|
# @return [Hash<String,String>]
|
445
491
|
#
|
446
492
|
# @!attribute [rw] tags
|
@@ -467,8 +513,8 @@ module Aws::SQS
|
|
467
513
|
# `sqs:CreateQueue` and `sqs:TagQueue` permissions.
|
468
514
|
#
|
469
515
|
# Cross-account permissions don't apply to this action. For more
|
470
|
-
# information, see [Grant
|
471
|
-
#
|
516
|
+
# information, see [Grant cross-account permissions to a role and a
|
517
|
+
# user name][3] in the *Amazon Simple Queue Service Developer Guide*.
|
472
518
|
#
|
473
519
|
# </note>
|
474
520
|
#
|
@@ -665,7 +711,7 @@ module Aws::SQS
|
|
665
711
|
#
|
666
712
|
# {
|
667
713
|
# queue_url: "String", # required
|
668
|
-
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
|
714
|
+
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit
|
669
715
|
# }
|
670
716
|
#
|
671
717
|
# @!attribute [rw] queue_url
|
@@ -768,9 +814,9 @@ module Aws::SQS
|
|
768
814
|
# The following attributes apply only to [FIFO (first-in-first-out)
|
769
815
|
# queues][7]\:
|
770
816
|
#
|
771
|
-
# * `FifoQueue` – Returns whether the queue is FIFO.
|
772
|
-
# information, see [FIFO Queue Logic][8] in the *Amazon
|
773
|
-
# Service Developer Guide*.
|
817
|
+
# * `FifoQueue` – Returns information about whether the queue is FIFO.
|
818
|
+
# For more information, see [FIFO Queue Logic][8] in the *Amazon
|
819
|
+
# Simple Queue Service Developer Guide*.
|
774
820
|
#
|
775
821
|
# <note markdown="1"> To determine whether a queue is [FIFO][7], you can check whether
|
776
822
|
# `QueueName` ends with the `.fifo` suffix.
|
@@ -782,6 +828,50 @@ module Aws::SQS
|
|
782
828
|
# [Exactly-Once Processing][9] in the *Amazon Simple Queue Service
|
783
829
|
# Developer Guide*.
|
784
830
|
#
|
831
|
+
# **Preview: High throughput for FIFO queues**
|
832
|
+
#
|
833
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release
|
834
|
+
# and is subject to change.** This feature provides a high number of
|
835
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
836
|
+
# information on throughput quotas, see [Quotas related to
|
837
|
+
# messages][10] in the *Amazon Simple Queue Service Developer Guide*.
|
838
|
+
#
|
839
|
+
# This preview includes two new attributes:
|
840
|
+
#
|
841
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
842
|
+
# occurs at the message group or queue level. Valid values are
|
843
|
+
# `messageGroup` and `queue`.
|
844
|
+
#
|
845
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue
|
846
|
+
# throughput quota applies to the entire queue or per message group.
|
847
|
+
# Valid values are `perQueue` and `perMessageGroupId`. The
|
848
|
+
# `perMessageGroupId` value is allowed only when the value for
|
849
|
+
# `DeduplicationScope` is `messageGroup`.
|
850
|
+
#
|
851
|
+
# To enable high throughput for FIFO queues, do the following:
|
852
|
+
#
|
853
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
854
|
+
#
|
855
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
856
|
+
#
|
857
|
+
# If you set these attributes to anything other than the values shown
|
858
|
+
# for enabling high throughput, standard throughput is in effect and
|
859
|
+
# deduplication occurs as specified.
|
860
|
+
#
|
861
|
+
# This preview is available in the following AWS Regions:
|
862
|
+
#
|
863
|
+
# * US East (Ohio); us-east-2
|
864
|
+
#
|
865
|
+
# * US East (N. Virginia); us-east-1
|
866
|
+
#
|
867
|
+
# * US West (Oregon); us-west-2
|
868
|
+
#
|
869
|
+
# * Europe (Ireland); eu-west-1
|
870
|
+
#
|
871
|
+
# For more information about high throughput for FIFO queues, see
|
872
|
+
# [Preview: High throughput for FIFO queues][11] in the *Amazon Simple
|
873
|
+
# Queue Service Developer Guide*.
|
874
|
+
#
|
785
875
|
#
|
786
876
|
#
|
787
877
|
# [1]: http://en.wikipedia.org/wiki/Unix_time
|
@@ -793,6 +883,8 @@ module Aws::SQS
|
|
793
883
|
# [7]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
794
884
|
# [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
|
795
885
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
886
|
+
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
887
|
+
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
796
888
|
# @return [Array<String>]
|
797
889
|
#
|
798
890
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueAttributesRequest AWS API Documentation
|
@@ -911,7 +1003,9 @@ module Aws::SQS
|
|
911
1003
|
# @return [String]
|
912
1004
|
#
|
913
1005
|
# @!attribute [rw] max_results
|
914
|
-
# Maximum number of results to include in the response.
|
1006
|
+
# Maximum number of results to include in the response. Value range is
|
1007
|
+
# 1 to 1000. You must set `MaxResults` to receive a value for
|
1008
|
+
# `NextToken` in the response.
|
915
1009
|
# @return [Integer]
|
916
1010
|
#
|
917
1011
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListDeadLetterSourceQueuesRequest AWS API Documentation
|
@@ -932,7 +1026,9 @@ module Aws::SQS
|
|
932
1026
|
# @return [Array<String>]
|
933
1027
|
#
|
934
1028
|
# @!attribute [rw] next_token
|
935
|
-
# Pagination token to include in the next request.
|
1029
|
+
# Pagination token to include in the next request. Token value is
|
1030
|
+
# `null` if there are no additional results to request, or if you did
|
1031
|
+
# not set `MaxResults` in the request.
|
936
1032
|
# @return [String]
|
937
1033
|
#
|
938
1034
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListDeadLetterSourceQueuesResult AWS API Documentation
|
@@ -996,7 +1092,9 @@ module Aws::SQS
|
|
996
1092
|
# @return [String]
|
997
1093
|
#
|
998
1094
|
# @!attribute [rw] max_results
|
999
|
-
# Maximum number of results to include in the response.
|
1095
|
+
# Maximum number of results to include in the response. Value range is
|
1096
|
+
# 1 to 1000. You must set `MaxResults` to receive a value for
|
1097
|
+
# `NextToken` in the response.
|
1000
1098
|
# @return [Integer]
|
1001
1099
|
#
|
1002
1100
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueuesRequest AWS API Documentation
|
@@ -1017,7 +1115,9 @@ module Aws::SQS
|
|
1017
1115
|
# @return [Array<String>]
|
1018
1116
|
#
|
1019
1117
|
# @!attribute [rw] next_token
|
1020
|
-
# Pagination token to include in the next request.
|
1118
|
+
# Pagination token to include in the next request. Token value is
|
1119
|
+
# `null` if there are no additional results to request, or if you did
|
1120
|
+
# not set `MaxResults` in the request.
|
1021
1121
|
# @return [String]
|
1022
1122
|
#
|
1023
1123
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueuesResult AWS API Documentation
|
@@ -1097,7 +1197,7 @@ module Aws::SQS
|
|
1097
1197
|
#
|
1098
1198
|
#
|
1099
1199
|
#
|
1100
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
1200
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
1101
1201
|
# @return [Hash<String,Types::MessageAttributeValue>]
|
1102
1202
|
#
|
1103
1203
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/Message AWS API Documentation
|
@@ -1167,7 +1267,7 @@ module Aws::SQS
|
|
1167
1267
|
#
|
1168
1268
|
#
|
1169
1269
|
#
|
1170
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
1270
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
1171
1271
|
# @return [String]
|
1172
1272
|
#
|
1173
1273
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/MessageAttributeValue AWS API Documentation
|
@@ -1239,7 +1339,7 @@ module Aws::SQS
|
|
1239
1339
|
#
|
1240
1340
|
#
|
1241
1341
|
#
|
1242
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
1342
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
1243
1343
|
# @return [String]
|
1244
1344
|
#
|
1245
1345
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/MessageSystemAttributeValue AWS API Documentation
|
@@ -1325,7 +1425,7 @@ module Aws::SQS
|
|
1325
1425
|
#
|
1326
1426
|
# {
|
1327
1427
|
# queue_url: "String", # required
|
1328
|
-
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
|
1428
|
+
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit
|
1329
1429
|
# message_attribute_names: ["MessageAttributeName"],
|
1330
1430
|
# max_number_of_messages: 1,
|
1331
1431
|
# visibility_timeout: 1,
|
@@ -1681,7 +1781,7 @@ module Aws::SQS
|
|
1681
1781
|
#
|
1682
1782
|
#
|
1683
1783
|
#
|
1684
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
1784
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
1685
1785
|
# @return [Hash<String,Types::MessageAttributeValue>]
|
1686
1786
|
#
|
1687
1787
|
# @!attribute [rw] message_system_attributes
|
@@ -1940,7 +2040,8 @@ module Aws::SQS
|
|
1940
2040
|
# @return [String]
|
1941
2041
|
#
|
1942
2042
|
# @!attribute [rw] message_body
|
1943
|
-
# The message to send. The
|
2043
|
+
# The message to send. The minimum size is one character. The maximum
|
2044
|
+
# size is 256 KB.
|
1944
2045
|
#
|
1945
2046
|
# A message can include only XML, JSON, and unformatted text. The
|
1946
2047
|
# following Unicode characters are allowed:
|
@@ -1976,7 +2077,7 @@ module Aws::SQS
|
|
1976
2077
|
#
|
1977
2078
|
#
|
1978
2079
|
#
|
1979
|
-
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-
|
2080
|
+
# [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
|
1980
2081
|
# @return [Hash<String,Types::MessageAttributeValue>]
|
1981
2082
|
#
|
1982
2083
|
# @!attribute [rw] message_system_attributes
|
@@ -2269,9 +2370,9 @@ module Aws::SQS
|
|
2269
2370
|
#
|
2270
2371
|
# * `ContentBasedDeduplication` – Enables content-based deduplication.
|
2271
2372
|
# For more information, see [Exactly-Once Processing][10] in the
|
2272
|
-
# *Amazon Simple Queue Service Developer Guide*.
|
2373
|
+
# *Amazon Simple Queue Service Developer Guide*. Note the following:
|
2273
2374
|
#
|
2274
|
-
# * Every message must have a unique `MessageDeduplicationId
|
2375
|
+
# * Every message must have a unique `MessageDeduplicationId`.
|
2275
2376
|
#
|
2276
2377
|
# * You may provide a `MessageDeduplicationId` explicitly.
|
2277
2378
|
#
|
@@ -2299,6 +2400,50 @@ module Aws::SQS
|
|
2299
2400
|
# `MessageDeduplicationId`, the two messages are treated as
|
2300
2401
|
# duplicates and only one copy of the message is delivered.
|
2301
2402
|
#
|
2403
|
+
# **Preview: High throughput for FIFO queues**
|
2404
|
+
#
|
2405
|
+
# **High throughput for Amazon SQS FIFO queues is in preview release
|
2406
|
+
# and is subject to change.** This feature provides a high number of
|
2407
|
+
# transactions per second (TPS) for messages in FIFO queues. For
|
2408
|
+
# information on throughput quotas, see [Quotas related to
|
2409
|
+
# messages][11] in the *Amazon Simple Queue Service Developer Guide*.
|
2410
|
+
#
|
2411
|
+
# This preview includes two new attributes:
|
2412
|
+
#
|
2413
|
+
# * `DeduplicationScope` – Specifies whether message deduplication
|
2414
|
+
# occurs at the message group or queue level. Valid values are
|
2415
|
+
# `messageGroup` and `queue`.
|
2416
|
+
#
|
2417
|
+
# * `FifoThroughputLimit` – Specifies whether the FIFO queue
|
2418
|
+
# throughput quota applies to the entire queue or per message group.
|
2419
|
+
# Valid values are `perQueue` and `perMessageGroupId`. The
|
2420
|
+
# `perMessageGroupId` value is allowed only when the value for
|
2421
|
+
# `DeduplicationScope` is `messageGroup`.
|
2422
|
+
#
|
2423
|
+
# To enable high throughput for FIFO queues, do the following:
|
2424
|
+
#
|
2425
|
+
# * Set `DeduplicationScope` to `messageGroup`.
|
2426
|
+
#
|
2427
|
+
# * Set `FifoThroughputLimit` to `perMessageGroupId`.
|
2428
|
+
#
|
2429
|
+
# If you set these attributes to anything other than the values shown
|
2430
|
+
# for enabling high throughput, standard throughput is in effect and
|
2431
|
+
# deduplication occurs as specified.
|
2432
|
+
#
|
2433
|
+
# This preview is available in the following AWS Regions:
|
2434
|
+
#
|
2435
|
+
# * US East (Ohio); us-east-2
|
2436
|
+
#
|
2437
|
+
# * US East (N. Virginia); us-east-1
|
2438
|
+
#
|
2439
|
+
# * US West (Oregon); us-west-2
|
2440
|
+
#
|
2441
|
+
# * Europe (Ireland); eu-west-1
|
2442
|
+
#
|
2443
|
+
# For more information about high throughput for FIFO queues, see
|
2444
|
+
# [Preview: High throughput for FIFO queues][12] in the *Amazon Simple
|
2445
|
+
# Queue Service Developer Guide*.
|
2446
|
+
#
|
2302
2447
|
#
|
2303
2448
|
#
|
2304
2449
|
# [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
@@ -2311,6 +2456,8 @@ module Aws::SQS
|
|
2311
2456
|
# [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
|
2312
2457
|
# [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
2313
2458
|
# [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
2459
|
+
# [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
|
2460
|
+
# [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
|
2314
2461
|
# @return [Hash<String,String>]
|
2315
2462
|
#
|
2316
2463
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SetQueueAttributesRequest AWS API Documentation
|
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.35.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: 2020-
|
11
|
+
date: 2020-12-17 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.109.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.109.0
|
33
33
|
- !ruby/object:Gem::Dependency
|
34
34
|
name: aws-sigv4
|
35
35
|
requirement: !ruby/object:Gem::Requirement
|