aws-sdk-sqs 1.30.0 → 1.35.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 93422dad4111b4a299d380fccf8232897db5c969c05f6a57c4176ae0df3de130
4
- data.tar.gz: 2a9e5b1ab1f9e2f1a3414698336306b7dacdc19e43ff3ac3bae0116ead4db456
3
+ metadata.gz: dbce67a43e0664fd8755ad1f20631934a97159a8c2299113a2475903d58f73fd
4
+ data.tar.gz: eb03e73924f36fbbae23f600790076cc64a8be349bec4bf78657125c271a434b
5
5
  SHA512:
6
- metadata.gz: 732109c5f0afec252ab4ee6fda4250071e98982e1fd87389c2d5fce96d1aa74ac4fd4e4bcd6f62242451a388e7c173eeec41def4b03a66c3a2268f96fbf73e94
7
- data.tar.gz: 3c83b377ede6677cc3f378f974b56eb93efaa428a303b687a6cda41beb0e4c286bfac01ffd19b13aa79023629943b2192366001fb805b3e72cc018f3f7d7f8ed
6
+ metadata.gz: 35092c039c91742d2d3c9861ee5a4dbfb1de8c3001cfbfae3adb0d305dd4bb525f3b08b80d4eb3b17628873cbb5eb1bd153b982331d3c8b3b68cae0ac888fa84
7
+ data.tar.gz: 9d40dd1bdb7ec855ddeb1d33c00d62c693006487380f33c17b4052c302db259c0bcd7519cc60a5666113aba6e5310308bf20a2a0c0b1112cd1d360688d591cbf
@@ -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
- # @service
50
+ # @!group service
50
51
  module Aws::SQS
51
52
 
52
- GEM_VERSION = '1.30.0'
53
+ GEM_VERSION = '1.35.0'
53
54
 
54
55
  end
@@ -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::SharedCredentials` - Used for loading credentials from a
96
- # shared file, such as `~/.aws/config`.
109
+ # * `Aws::ECSCredentials` - Used for loading credentials from
110
+ # instances running in ECS.
97
111
  #
98
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
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 are
109
- # very aggressive. Construct and pass an instance of
110
- # `Aws::InstanceProfileCredentails` to enable retries and extended
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 Cross-Account Permissions to a Role and a User
357
- # Name][4] in the *Amazon Simple Queue Service Developer Guide*.
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 values: `0` to `43200`. Maximum: 12 hours.
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 Cross-Account Permissions to a Role and a User
642
- # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
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: `true`,
741
- # `false`. If you don't specify the `FifoQueue` attribute, Amazon SQS
742
- # creates a standard queue. You can provide this attribute only during
743
- # queue creation. You can't change it for an existing queue. When you
744
- # set this attribute, you must also provide the `MessageGroupId` for
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: `true`, `false`. For more information, see
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 Cross-Account Permissions to a Role and a User
822
- # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
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 Cross-Account Permissions to a Role and a User
988
- # Name][1] in the *Amazon Simple Queue Service Developer Guide*.
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. For more
1125
- # information, see [FIFO Queue Logic][8] in the *Amazon Simple Queue
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 Cross-Account Permissions to a Role and a User
1280
- # Name][2] in the *Amazon Simple Queue Service Developer Guide*.
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. The maximum number of queues that can
1317
- # be returned is 1,000. If you specify a value for the optional
1318
- # `QueueNamePrefix` parameter, only queues with a name that begins with
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 Cross-Account Permissions to a Role and a User
1323
- # Name][1] in the *Amazon Simple Queue Service Developer Guide*.
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 Cross-Account Permissions to a Role and a
1677
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
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 maximum string size is 256 KB.
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-attributes.html
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 Cross-Account Permissions to a Role and a
2052
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
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 Cross-Account Permissions to a Role and a User
2231
- # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
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 Cross-Account Permissions to a Role and a User
2273
- # Name][2] in the *Amazon Simple Queue Service Developer Guide*.
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.30.0'
2494
+ context[:gem_version] = '1.35.0'
2320
2495
  Seahorse::Client::Request.new(handlers, context)
2321
2496
  end
2322
2497
 
@@ -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-attributes.html
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 values: `0` to `43200`. Maximum: 12 hours.
158
+ # Values range: `0` to `43200`. Maximum: 12 hours.
159
159
  # @return [EmptyStructure]
160
160
  def change_visibility(options = {})
161
161
  options = options.merge(
@@ -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 maximum string size is 256 KB.
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-attributes.html
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
@@ -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: `true`,
138
- # `false`. If you don't specify the `FifoQueue` attribute, Amazon SQS
139
- # creates a standard queue. You can provide this attribute only during
140
- # queue creation. You can't change it for an existing queue. When you
141
- # set this attribute, you must also provide the `MessageGroupId` for
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: `true`, `false`. For more information, see
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 Cross-Account Permissions to a Role and a User
218
- # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
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
  #
@@ -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 values: `0` to `43200`. Maximum: 12 hours.
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: `true`,
389
- # `false`. If you don't specify the `FifoQueue` attribute, Amazon
390
- # SQS creates a standard queue. You can provide this attribute only
391
- # during queue creation. You can't change it for an existing queue.
392
- # When you set this attribute, you must also provide the
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: `true`, `false`. For more information, see
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 Cross-Account Permissions to a Role and a
471
- # User Name][3] in the *Amazon Simple Queue Service Developer Guide*.
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. For more
772
- # information, see [FIFO Queue Logic][8] in the *Amazon Simple Queue
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-attributes.html
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-attributes.html
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-attributes.html
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-attributes.html
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 maximum string size is 256 KB.
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-attributes.html
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.30.0
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-07-02 00:00:00.000000000 Z
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.99.0
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.99.0
32
+ version: 3.109.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement