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 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