aws-sdk-sqs 1.67.0 → 1.89.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -54,7 +54,7 @@ module Aws::SQS
54
54
  #
55
55
  # @return [self]
56
56
  def load
57
- resp = Aws::Plugins::UserAgent.feature('resource') do
57
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
58
58
  @client.get_queue_attributes(
59
59
  queue_url: @url,
60
60
  attribute_names: ["All"]
@@ -125,7 +125,7 @@ module Aws::SQS
125
125
  # @return [EmptyStructure]
126
126
  def add_permission(options = {})
127
127
  options = options.merge(queue_url: @url)
128
- resp = Aws::Plugins::UserAgent.feature('resource') do
128
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
129
129
  @client.add_permission(options)
130
130
  end
131
131
  resp.data
@@ -149,7 +149,7 @@ module Aws::SQS
149
149
  # @return [Types::ChangeMessageVisibilityBatchResult]
150
150
  def change_message_visibility_batch(options = {})
151
151
  options = options.merge(queue_url: @url)
152
- resp = Aws::Plugins::UserAgent.feature('resource') do
152
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
153
153
  @client.change_message_visibility_batch(options)
154
154
  end
155
155
  resp.data
@@ -162,7 +162,7 @@ module Aws::SQS
162
162
  # @return [EmptyStructure]
163
163
  def delete(options = {})
164
164
  options = options.merge(queue_url: @url)
165
- resp = Aws::Plugins::UserAgent.feature('resource') do
165
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
166
166
  @client.delete_queue(options)
167
167
  end
168
168
  resp.data
@@ -184,7 +184,7 @@ module Aws::SQS
184
184
  # @return [Types::DeleteMessageBatchResult]
185
185
  def delete_messages(options = {})
186
186
  options = options.merge(queue_url: @url)
187
- resp = Aws::Plugins::UserAgent.feature('resource') do
187
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
188
188
  @client.delete_message_batch(options)
189
189
  end
190
190
  resp.data
@@ -197,7 +197,7 @@ module Aws::SQS
197
197
  # @return [EmptyStructure]
198
198
  def purge(options = {})
199
199
  options = options.merge(queue_url: @url)
200
- resp = Aws::Plugins::UserAgent.feature('resource') do
200
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
201
201
  @client.purge_queue(options)
202
202
  end
203
203
  resp.data
@@ -207,6 +207,7 @@ module Aws::SQS
207
207
  #
208
208
  # message = queue.receive_messages({
209
209
  # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit, RedriveAllowPolicy, SqsManagedSseEnabled
210
+ # message_system_attribute_names: ["All"], # accepts All, SenderId, SentTimestamp, ApproximateReceiveCount, ApproximateFirstReceiveTimestamp, SequenceNumber, MessageDeduplicationId, MessageGroupId, AWSTraceHeader, DeadLetterQueueSourceArn
210
211
  # message_attribute_names: ["MessageAttributeName"],
211
212
  # max_number_of_messages: 1,
212
213
  # visibility_timeout: 1,
@@ -215,6 +216,10 @@ module Aws::SQS
215
216
  # })
216
217
  # @param [Hash] options ({})
217
218
  # @option options [Array<String>] :attribute_names
219
+ # This parameter has been deprecated but will be supported for backward
220
+ # compatibility. To provide attribute names, you are encouraged to use
221
+ # `MessageSystemAttributeNames`.
222
+ #
218
223
  # A list of attributes that need to be returned along with each message.
219
224
  # These attributes include:
220
225
  #
@@ -235,7 +240,48 @@ module Aws::SQS
235
240
  #
236
241
  # * For an IAM role, returns the IAM role ID, for example
237
242
  # `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
243
+ # * `SentTimestamp` – Returns the time the message was sent to the queue
244
+ # ([epoch time][1] in milliseconds).
245
+ #
246
+ # * `SqsManagedSseEnabled` – Enables server-side queue encryption using
247
+ # SQS owned encryption keys. Only one server-side encryption option is
248
+ # supported per queue (for example, [SSE-KMS][2] or [SSE-SQS][3]).
249
+ #
250
+ # * `MessageDeduplicationId` – Returns the value provided by the
251
+ # producer that calls the ` SendMessage ` action.
252
+ #
253
+ # * `MessageGroupId` – Returns the value provided by the producer that
254
+ # calls the ` SendMessage ` action. Messages with the same
255
+ # `MessageGroupId` are returned in sequence.
256
+ #
257
+ # * `SequenceNumber` – Returns the value provided by Amazon SQS.
258
+ #
259
+ #
260
+ #
261
+ # [1]: http://en.wikipedia.org/wiki/Unix_time
262
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-configure-sse-existing-queue.html
263
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-configure-sqs-sse-queue.html
264
+ # @option options [Array<String>] :message_system_attribute_names
265
+ # A list of attributes that need to be returned along with each message.
266
+ # These attributes include:
267
+ #
268
+ # * `All` – Returns all values.
269
+ #
270
+ # * `ApproximateFirstReceiveTimestamp` – Returns the time the message
271
+ # was first received from the queue ([epoch time][1] in milliseconds).
238
272
  #
273
+ # * `ApproximateReceiveCount` – Returns the number of times a message
274
+ # has been received across all queues but not deleted.
275
+ #
276
+ # * `AWSTraceHeader` – Returns the X-Ray trace header string.
277
+ #
278
+ # * `SenderId`
279
+ #
280
+ # * For a user, returns the user ID, for example
281
+ # `ABCDEFGHI1JKLMNOPQ23R`.
282
+ #
283
+ # * For an IAM role, returns the IAM role ID, for example
284
+ # `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
239
285
  # * `SentTimestamp` – Returns the time the message was sent to the queue
240
286
  # ([epoch time][1] in milliseconds).
241
287
  #
@@ -290,8 +336,8 @@ module Aws::SQS
290
336
  # The duration (in seconds) for which the call waits for a message to
291
337
  # arrive in the queue before returning. If a message is available, the
292
338
  # call returns sooner than `WaitTimeSeconds`. If no messages are
293
- # available and the wait time expires, the call returns successfully
294
- # with an empty list of messages.
339
+ # available and the wait time expires, the call does not return a
340
+ # message list.
295
341
  #
296
342
  # To avoid HTTP errors, ensure that the HTTP response timeout for
297
343
  # `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -319,10 +365,6 @@ module Aws::SQS
319
365
  # * When you set `FifoQueue`, a caller of the `ReceiveMessage` action
320
366
  # can provide a `ReceiveRequestAttemptId` explicitly.
321
367
  #
322
- # * If a caller of the `ReceiveMessage` action doesn't provide a
323
- # `ReceiveRequestAttemptId`, Amazon SQS generates a
324
- # `ReceiveRequestAttemptId`.
325
- #
326
368
  # * It is possible to retry the `ReceiveMessage` action with the same
327
369
  # `ReceiveRequestAttemptId` if none of the messages have been modified
328
370
  # (deleted or had their visibility changes).
@@ -356,7 +398,7 @@ module Aws::SQS
356
398
  #
357
399
  # The maximum length of `ReceiveRequestAttemptId` is 128 characters.
358
400
  # `ReceiveRequestAttemptId` can contain alphanumeric characters (`a-z`,
359
- # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
401
+ # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
360
402
  # ``).
361
403
  #
362
404
  # For best practices of using `ReceiveRequestAttemptId`, see [Using the
@@ -371,7 +413,7 @@ module Aws::SQS
371
413
  def receive_messages(options = {})
372
414
  batch = []
373
415
  options = options.merge(queue_url: @url)
374
- resp = Aws::Plugins::UserAgent.feature('resource') do
416
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
375
417
  @client.receive_message(options)
376
418
  end
377
419
  resp.data.messages.each do |m|
@@ -397,7 +439,7 @@ module Aws::SQS
397
439
  # @return [EmptyStructure]
398
440
  def remove_permission(options = {})
399
441
  options = options.merge(queue_url: @url)
400
- resp = Aws::Plugins::UserAgent.feature('resource') do
442
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
401
443
  @client.remove_permission(options)
402
444
  end
403
445
  resp.data
@@ -435,13 +477,17 @@ module Aws::SQS
435
477
  # size is 256 KiB.
436
478
  #
437
479
  # A message can include only XML, JSON, and unformatted text. The
438
- # following Unicode characters are allowed:
480
+ # following Unicode characters are allowed. For more information, see
481
+ # the [W3C specification for characters][1].
439
482
  #
440
483
  # `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
441
484
  # \| `#x10000` to `#x10FFFF`
442
485
  #
443
- # Any characters not included in this list will be rejected. For more
444
- # information, see the [W3C specification for characters][1].
486
+ # Amazon SQS does not throw an exception or completely reject the
487
+ # message if it contains invalid characters. Instead, it replaces those
488
+ # invalid characters with `U+FFFD` before storing the message in the
489
+ # queue, as long as the message body contains at least one valid
490
+ # character.
445
491
  #
446
492
  #
447
493
  #
@@ -500,7 +546,6 @@ module Aws::SQS
500
546
  #
501
547
  # * If the queue has `ContentBasedDeduplication` set, your
502
548
  # `MessageDeduplicationId` overrides the generated one.
503
- #
504
549
  # * When `ContentBasedDeduplication` is in effect, messages with
505
550
  # identical content sent within the deduplication interval are treated
506
551
  # as duplicates and only one copy of the message is delivered.
@@ -525,7 +570,7 @@ module Aws::SQS
525
570
  #
526
571
  # The maximum length of `MessageDeduplicationId` is 128 characters.
527
572
  # `MessageDeduplicationId` can contain alphanumeric characters (`a-z`,
528
- # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
573
+ # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
529
574
  # ``).
530
575
  #
531
576
  # For best practices of using `MessageDeduplicationId`, see [Using the
@@ -555,9 +600,9 @@ module Aws::SQS
555
600
  # `MessageGroupId` values. For each `MessageGroupId`, the messages are
556
601
  # sorted by time sent. The caller can't specify a `MessageGroupId`.
557
602
  #
558
- # The length of `MessageGroupId` is 128 characters. Valid values:
559
- # alphanumeric characters and punctuation ``
560
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
603
+ # The maximum length of `MessageGroupId` is 128 characters. Valid
604
+ # values: alphanumeric characters and punctuation ``
605
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
561
606
  #
562
607
  # For best practices of using `MessageGroupId`, see [Using the
563
608
  # MessageGroupId Property][1] in the *Amazon SQS Developer Guide*.
@@ -571,7 +616,7 @@ module Aws::SQS
571
616
  # @return [Types::SendMessageResult]
572
617
  def send_message(options = {})
573
618
  options = options.merge(queue_url: @url)
574
- resp = Aws::Plugins::UserAgent.feature('resource') do
619
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
575
620
  @client.send_message(options)
576
621
  end
577
622
  resp.data
@@ -614,7 +659,7 @@ module Aws::SQS
614
659
  # @return [Types::SendMessageBatchResult]
615
660
  def send_messages(options = {})
616
661
  options = options.merge(queue_url: @url)
617
- resp = Aws::Plugins::UserAgent.feature('resource') do
662
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
618
663
  @client.send_message_batch(options)
619
664
  end
620
665
  resp.data
@@ -683,7 +728,6 @@ module Aws::SQS
683
728
  # Default: 10. When the `ReceiveCount` for a message exceeds the
684
729
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to the
685
730
  # dead-letter-queue.
686
- #
687
731
  # * `RedriveAllowPolicy` – The string that includes the parameters for
688
732
  # the permissions for the dead-letter queue redrive permission and
689
733
  # which source queues can specify dead-letter queues as a JSON object.
@@ -702,7 +746,6 @@ module Aws::SQS
702
746
  #
703
747
  # * `byQueue` – Only queues specified by the `sourceQueueArns`
704
748
  # parameter can specify this queue as the dead-letter queue.
705
- #
706
749
  # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the source
707
750
  # queues that can specify this queue as the dead-letter queue and
708
751
  # redrive messages. You can specify this parameter only when the
@@ -762,7 +805,6 @@ module Aws::SQS
762
805
  #
763
806
  # * If the queue has `ContentBasedDeduplication` set, your
764
807
  # `MessageDeduplicationId` overrides the generated one.
765
- #
766
808
  # * When `ContentBasedDeduplication` is in effect, messages with
767
809
  # identical content sent within the deduplication interval are
768
810
  # treated as duplicates and only one copy of the message is
@@ -819,7 +861,7 @@ module Aws::SQS
819
861
  # @return [EmptyStructure]
820
862
  def set_attributes(options = {})
821
863
  options = options.merge(queue_url: @url)
822
- resp = Aws::Plugins::UserAgent.feature('resource') do
864
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
823
865
  @client.set_queue_attributes(options)
824
866
  end
825
867
  resp.data
@@ -835,7 +877,7 @@ module Aws::SQS
835
877
  def dead_letter_source_queues(options = {})
836
878
  batches = Enumerator.new do |y|
837
879
  options = options.merge(queue_url: @url)
838
- resp = Aws::Plugins::UserAgent.feature('resource') do
880
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
839
881
  @client.list_dead_letter_source_queues(options)
840
882
  end
841
883
  resp.each_page do |page|
@@ -112,7 +112,6 @@ module Aws::SQS
112
112
  # Default: 10. When the `ReceiveCount` for a message exceeds the
113
113
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to the
114
114
  # dead-letter-queue.
115
- #
116
115
  # * `RedriveAllowPolicy` – The string that includes the parameters for
117
116
  # the permissions for the dead-letter queue redrive permission and
118
117
  # which source queues can specify dead-letter queues as a JSON object.
@@ -131,7 +130,6 @@ module Aws::SQS
131
130
  #
132
131
  # * `byQueue` – Only queues specified by the `sourceQueueArns`
133
132
  # parameter can specify this queue as the dead-letter queue.
134
- #
135
133
  # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the source
136
134
  # queues that can specify this queue as the dead-letter queue and
137
135
  # redrive messages. You can specify this parameter only when the
@@ -203,7 +201,6 @@ module Aws::SQS
203
201
  #
204
202
  # * If the queue has `ContentBasedDeduplication` set, your
205
203
  # `MessageDeduplicationId` overrides the generated one.
206
- #
207
204
  # * When `ContentBasedDeduplication` is in effect, messages with
208
205
  # identical content sent within the deduplication interval are
209
206
  # treated as duplicates and only one copy of the message is
@@ -294,7 +291,7 @@ module Aws::SQS
294
291
  # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
295
292
  # @return [Queue]
296
293
  def create_queue(options = {})
297
- resp = Aws::Plugins::UserAgent.feature('resource') do
294
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
298
295
  @client.create_queue(options)
299
296
  end
300
297
  Queue.new(
@@ -321,7 +318,7 @@ module Aws::SQS
321
318
  # queue.
322
319
  # @return [Queue]
323
320
  def get_queue_by_name(options = {})
324
- resp = Aws::Plugins::UserAgent.feature('resource') do
321
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
325
322
  @client.get_queue_url(options)
326
323
  end
327
324
  Queue.new(
@@ -355,7 +352,7 @@ module Aws::SQS
355
352
  # @return [Queue::Collection]
356
353
  def queues(options = {})
357
354
  batches = Enumerator.new do |y|
358
- resp = Aws::Plugins::UserAgent.feature('resource') do
355
+ resp = Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
359
356
  @client.list_queues(options)
360
357
  end
361
358
  resp.each_page do |page|
@@ -334,7 +334,6 @@ module Aws::SQS
334
334
  # Default: 10. When the `ReceiveCount` for a message exceeds the
335
335
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to
336
336
  # the dead-letter-queue.
337
- #
338
337
  # * `RedriveAllowPolicy` – The string that includes the parameters for
339
338
  # the permissions for the dead-letter queue redrive permission and
340
339
  # which source queues can specify dead-letter queues as a JSON
@@ -353,7 +352,6 @@ module Aws::SQS
353
352
  #
354
353
  # * `byQueue` – Only queues specified by the `sourceQueueArns`
355
354
  # parameter can specify this queue as the dead-letter queue.
356
- #
357
355
  # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
358
356
  # source queues that can specify this queue as the dead-letter
359
357
  # queue and redrive messages. You can specify this parameter only
@@ -426,7 +424,6 @@ module Aws::SQS
426
424
  #
427
425
  # * If the queue has `ContentBasedDeduplication` set, your
428
426
  # `MessageDeduplicationId` overrides the generated one.
429
- #
430
427
  # * When `ContentBasedDeduplication` is in effect, messages with
431
428
  # identical content sent within the deduplication interval are
432
429
  # treated as duplicates and only one copy of the message is
@@ -766,7 +763,6 @@ module Aws::SQS
766
763
  # Default: 10. When the `ReceiveCount` for a message exceeds the
767
764
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to
768
765
  # the dead-letter-queue.
769
- #
770
766
  # * `RedriveAllowPolicy` – The string that includes the parameters for
771
767
  # the permissions for the dead-letter queue redrive permission and
772
768
  # which source queues can specify dead-letter queues as a JSON
@@ -785,7 +781,6 @@ module Aws::SQS
785
781
  #
786
782
  # * `byQueue` – Only queues specified by the `sourceQueueArns`
787
783
  # parameter can specify this queue as the dead-letter queue.
788
- #
789
784
  # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
790
785
  # source queues that can specify this queue as the dead-letter
791
786
  # queue and redrive messages. You can specify this parameter only
@@ -1245,8 +1240,9 @@ module Aws::SQS
1245
1240
  #
1246
1241
  # @!attribute [rw] approximate_number_of_messages_to_move
1247
1242
  # The number of messages to be moved from the source queue. This
1248
- # number is obtained at the time of starting the message movement
1249
- # task.
1243
+ # number is obtained at the time of starting the message movement task
1244
+ # and is only included after the message movement task is selected to
1245
+ # start.
1250
1246
  # @return [Integer]
1251
1247
  #
1252
1248
  # @!attribute [rw] failure_reason
@@ -1657,6 +1653,10 @@ module Aws::SQS
1657
1653
  # @return [String]
1658
1654
  #
1659
1655
  # @!attribute [rw] attribute_names
1656
+ # This parameter has been deprecated but will be supported for
1657
+ # backward compatibility. To provide attribute names, you are
1658
+ # encouraged to use `MessageSystemAttributeNames`.
1659
+ #
1660
1660
  # A list of attributes that need to be returned along with each
1661
1661
  # message. These attributes include:
1662
1662
  #
@@ -1678,7 +1678,52 @@ module Aws::SQS
1678
1678
  #
1679
1679
  # * For an IAM role, returns the IAM role ID, for example
1680
1680
  # `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
1681
+ # * `SentTimestamp` – Returns the time the message was sent to the
1682
+ # queue ([epoch time][1] in milliseconds).
1683
+ #
1684
+ # * `SqsManagedSseEnabled` – Enables server-side queue encryption
1685
+ # using SQS owned encryption keys. Only one server-side encryption
1686
+ # option is supported per queue (for example, [SSE-KMS][2] or
1687
+ # [SSE-SQS][3]).
1688
+ #
1689
+ # * `MessageDeduplicationId` – Returns the value provided by the
1690
+ # producer that calls the ` SendMessage ` action.
1691
+ #
1692
+ # * `MessageGroupId` – Returns the value provided by the producer that
1693
+ # calls the ` SendMessage ` action. Messages with the same
1694
+ # `MessageGroupId` are returned in sequence.
1695
+ #
1696
+ # * `SequenceNumber` – Returns the value provided by Amazon SQS.
1697
+ #
1681
1698
  #
1699
+ #
1700
+ # [1]: http://en.wikipedia.org/wiki/Unix_time
1701
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-configure-sse-existing-queue.html
1702
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-configure-sqs-sse-queue.html
1703
+ # @return [Array<String>]
1704
+ #
1705
+ # @!attribute [rw] message_system_attribute_names
1706
+ # A list of attributes that need to be returned along with each
1707
+ # message. These attributes include:
1708
+ #
1709
+ # * `All` – Returns all values.
1710
+ #
1711
+ # * `ApproximateFirstReceiveTimestamp` – Returns the time the message
1712
+ # was first received from the queue ([epoch time][1] in
1713
+ # milliseconds).
1714
+ #
1715
+ # * `ApproximateReceiveCount` – Returns the number of times a message
1716
+ # has been received across all queues but not deleted.
1717
+ #
1718
+ # * `AWSTraceHeader` – Returns the X-Ray trace header string.
1719
+ #
1720
+ # * `SenderId`
1721
+ #
1722
+ # * For a user, returns the user ID, for example
1723
+ # `ABCDEFGHI1JKLMNOPQ23R`.
1724
+ #
1725
+ # * For an IAM role, returns the IAM role ID, for example
1726
+ # `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
1682
1727
  # * `SentTimestamp` – Returns the time the message was sent to the
1683
1728
  # queue ([epoch time][1] in milliseconds).
1684
1729
  #
@@ -1742,8 +1787,8 @@ module Aws::SQS
1742
1787
  # The duration (in seconds) for which the call waits for a message to
1743
1788
  # arrive in the queue before returning. If a message is available, the
1744
1789
  # call returns sooner than `WaitTimeSeconds`. If no messages are
1745
- # available and the wait time expires, the call returns successfully
1746
- # with an empty list of messages.
1790
+ # available and the wait time expires, the call does not return a
1791
+ # message list.
1747
1792
  #
1748
1793
  # To avoid HTTP errors, ensure that the HTTP response timeout for
1749
1794
  # `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
@@ -1774,10 +1819,6 @@ module Aws::SQS
1774
1819
  # * When you set `FifoQueue`, a caller of the `ReceiveMessage` action
1775
1820
  # can provide a `ReceiveRequestAttemptId` explicitly.
1776
1821
  #
1777
- # * If a caller of the `ReceiveMessage` action doesn't provide a
1778
- # `ReceiveRequestAttemptId`, Amazon SQS generates a
1779
- # `ReceiveRequestAttemptId`.
1780
- #
1781
1822
  # * It is possible to retry the `ReceiveMessage` action with the same
1782
1823
  # `ReceiveRequestAttemptId` if none of the messages have been
1783
1824
  # modified (deleted or had their visibility changes).
@@ -1814,7 +1855,7 @@ module Aws::SQS
1814
1855
  # The maximum length of `ReceiveRequestAttemptId` is 128 characters.
1815
1856
  # `ReceiveRequestAttemptId` can contain alphanumeric characters
1816
1857
  # (`a-z`, `A-Z`, `0-9`) and punctuation (``
1817
- # !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~ ``).
1858
+ # !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~ ``).
1818
1859
  #
1819
1860
  # For best practices of using `ReceiveRequestAttemptId`, see [Using
1820
1861
  # the ReceiveRequestAttemptId Request Parameter][2] in the *Amazon SQS
@@ -1831,6 +1872,7 @@ module Aws::SQS
1831
1872
  class ReceiveMessageRequest < Struct.new(
1832
1873
  :queue_url,
1833
1874
  :attribute_names,
1875
+ :message_system_attribute_names,
1834
1876
  :message_attribute_names,
1835
1877
  :max_number_of_messages,
1836
1878
  :visibility_timeout,
@@ -2013,7 +2055,6 @@ module Aws::SQS
2013
2055
  #
2014
2056
  # * If the queue has `ContentBasedDeduplication` set, your
2015
2057
  # `MessageDeduplicationId` overrides the generated one.
2016
- #
2017
2058
  # * When `ContentBasedDeduplication` is in effect, messages with
2018
2059
  # identical content sent within the deduplication interval are
2019
2060
  # treated as duplicates and only one copy of the message is
@@ -2040,7 +2081,7 @@ module Aws::SQS
2040
2081
  #
2041
2082
  # The length of `MessageDeduplicationId` is 128 characters.
2042
2083
  # `MessageDeduplicationId` can contain alphanumeric characters (`a-z`,
2043
- # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
2084
+ # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
2044
2085
  # ``).
2045
2086
  #
2046
2087
  # For best practices of using `MessageDeduplicationId`, see [Using the
@@ -2075,7 +2116,7 @@ module Aws::SQS
2075
2116
  #
2076
2117
  # The length of `MessageGroupId` is 128 characters. Valid values:
2077
2118
  # alphanumeric characters and punctuation ``
2078
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
2119
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
2079
2120
  #
2080
2121
  # For best practices of using `MessageGroupId`, see [Using the
2081
2122
  # MessageGroupId Property][1] in the *Amazon SQS Developer Guide*.
@@ -2204,13 +2245,17 @@ module Aws::SQS
2204
2245
  # size is 256 KiB.
2205
2246
  #
2206
2247
  # A message can include only XML, JSON, and unformatted text. The
2207
- # following Unicode characters are allowed:
2248
+ # following Unicode characters are allowed. For more information, see
2249
+ # the [W3C specification for characters][1].
2208
2250
  #
2209
2251
  # `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to
2210
2252
  # `#xFFFD` \| `#x10000` to `#x10FFFF`
2211
2253
  #
2212
- # Any characters not included in this list will be rejected. For more
2213
- # information, see the [W3C specification for characters][1].
2254
+ # Amazon SQS does not throw an exception or completely reject the
2255
+ # message if it contains invalid characters. Instead, it replaces
2256
+ # those invalid characters with `U+FFFD` before storing the message in
2257
+ # the queue, as long as the message body contains at least one valid
2258
+ # character.
2214
2259
  #
2215
2260
  #
2216
2261
  #
@@ -2278,7 +2323,6 @@ module Aws::SQS
2278
2323
  #
2279
2324
  # * If the queue has `ContentBasedDeduplication` set, your
2280
2325
  # `MessageDeduplicationId` overrides the generated one.
2281
- #
2282
2326
  # * When `ContentBasedDeduplication` is in effect, messages with
2283
2327
  # identical content sent within the deduplication interval are
2284
2328
  # treated as duplicates and only one copy of the message is
@@ -2305,7 +2349,7 @@ module Aws::SQS
2305
2349
  #
2306
2350
  # The maximum length of `MessageDeduplicationId` is 128 characters.
2307
2351
  # `MessageDeduplicationId` can contain alphanumeric characters (`a-z`,
2308
- # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
2352
+ # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`{|}~
2309
2353
  # ``).
2310
2354
  #
2311
2355
  # For best practices of using `MessageDeduplicationId`, see [Using the
@@ -2338,9 +2382,9 @@ module Aws::SQS
2338
2382
  # are sorted by time sent. The caller can't specify a
2339
2383
  # `MessageGroupId`.
2340
2384
  #
2341
- # The length of `MessageGroupId` is 128 characters. Valid values:
2342
- # alphanumeric characters and punctuation ``
2343
- # (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
2385
+ # The maximum length of `MessageGroupId` is 128 characters. Valid
2386
+ # values: alphanumeric characters and punctuation ``
2387
+ # (!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~) ``.
2344
2388
  #
2345
2389
  # For best practices of using `MessageGroupId`, see [Using the
2346
2390
  # MessageGroupId Property][1] in the *Amazon SQS Developer Guide*.
@@ -2494,7 +2538,6 @@ module Aws::SQS
2494
2538
  # Default: 10. When the `ReceiveCount` for a message exceeds the
2495
2539
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to
2496
2540
  # the dead-letter-queue.
2497
- #
2498
2541
  # * `RedriveAllowPolicy` – The string that includes the parameters for
2499
2542
  # the permissions for the dead-letter queue redrive permission and
2500
2543
  # which source queues can specify dead-letter queues as a JSON
@@ -2513,7 +2556,6 @@ module Aws::SQS
2513
2556
  #
2514
2557
  # * `byQueue` – Only queues specified by the `sourceQueueArns`
2515
2558
  # parameter can specify this queue as the dead-letter queue.
2516
- #
2517
2559
  # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
2518
2560
  # source queues that can specify this queue as the dead-letter
2519
2561
  # queue and redrive messages. You can specify this parameter only
@@ -2575,7 +2617,6 @@ module Aws::SQS
2575
2617
  #
2576
2618
  # * If the queue has `ContentBasedDeduplication` set, your
2577
2619
  # `MessageDeduplicationId` overrides the generated one.
2578
- #
2579
2620
  # * When `ContentBasedDeduplication` is in effect, messages with
2580
2621
  # identical content sent within the deduplication interval are
2581
2622
  # treated as duplicates and only one copy of the message is
@@ -2750,3 +2791,4 @@ module Aws::SQS
2750
2791
 
2751
2792
  end
2752
2793
  end
2794
+
data/lib/aws-sdk-sqs.rb CHANGED
@@ -11,18 +11,7 @@
11
11
  require 'aws-sdk-core'
12
12
  require 'aws-sigv4'
13
13
 
14
- require_relative 'aws-sdk-sqs/types'
15
- require_relative 'aws-sdk-sqs/client_api'
16
- require_relative 'aws-sdk-sqs/plugins/endpoints.rb'
17
- require_relative 'aws-sdk-sqs/client'
18
- require_relative 'aws-sdk-sqs/errors'
19
- require_relative 'aws-sdk-sqs/resource'
20
- require_relative 'aws-sdk-sqs/endpoint_parameters'
21
- require_relative 'aws-sdk-sqs/endpoint_provider'
22
- require_relative 'aws-sdk-sqs/endpoints'
23
- require_relative 'aws-sdk-sqs/message'
24
- require_relative 'aws-sdk-sqs/queue'
25
- require_relative 'aws-sdk-sqs/customizations'
14
+ Aws::Plugins::GlobalConfiguration.add_identifier(:sqs)
26
15
 
27
16
  # This module provides support for Amazon Simple Queue Service. This module is available in the
28
17
  # `aws-sdk-sqs` gem.
@@ -53,7 +42,22 @@ require_relative 'aws-sdk-sqs/customizations'
53
42
  #
54
43
  # @!group service
55
44
  module Aws::SQS
45
+ autoload :Types, 'aws-sdk-sqs/types'
46
+ autoload :ClientApi, 'aws-sdk-sqs/client_api'
47
+ module Plugins
48
+ autoload :Endpoints, 'aws-sdk-sqs/plugins/endpoints.rb'
49
+ end
50
+ autoload :Client, 'aws-sdk-sqs/client'
51
+ autoload :Errors, 'aws-sdk-sqs/errors'
52
+ autoload :Resource, 'aws-sdk-sqs/resource'
53
+ autoload :EndpointParameters, 'aws-sdk-sqs/endpoint_parameters'
54
+ autoload :EndpointProvider, 'aws-sdk-sqs/endpoint_provider'
55
+ autoload :Endpoints, 'aws-sdk-sqs/endpoints'
56
+ autoload :Message, 'aws-sdk-sqs/message'
57
+ autoload :Queue, 'aws-sdk-sqs/queue'
56
58
 
57
- GEM_VERSION = '1.67.0'
59
+ GEM_VERSION = '1.89.0'
58
60
 
59
61
  end
62
+
63
+ require_relative 'aws-sdk-sqs/customizations'