aws-sdk-sqs 1.6.0 → 1.7.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
  SHA1:
3
- metadata.gz: 6a23252597f2e8d39995b89c8dc96dce87441a53
4
- data.tar.gz: 21e8fa6289559cd79d5a16cdbbcf62c7bfd8c801
3
+ metadata.gz: bf3f848b01bff04d0f62b5a6d7361ebc13561c66
4
+ data.tar.gz: '0329e5d580835310d23f096c15805d805e506fe9'
5
5
  SHA512:
6
- metadata.gz: 1d40692381d457840d8b738e732c9436282b838f6c91c555f9c9dbb1f52a9f3ce1bee88ac06391c393b23e79a5d00fad27d3f1b246489cbc3a0d5c391ccfd804
7
- data.tar.gz: 9d3506b8ae445170b5491046ef250c3c99df3e78c5b8dcb08c9060ad78309023d18ab3090f31d756d440d7c591136456cf370c9b46416f4d1e4790bafad025a1
6
+ metadata.gz: a66a412b27366de667b45626fe17175a89e36b8af83e2bd5ecae9cee1df9c35a95a7a1229baa5b700e237d802d1c9902705f5c07a3c520e36f5b3909e8b479f6
7
+ data.tar.gz: d965f5c96437d4cde096407597223c00959b57582c9697afeb1bfdd184c6a7d249c0b46e36c170d030562c097ae1b7c4c5a3287062d1f2b12857d17ec36104f0
@@ -44,6 +44,6 @@ require_relative 'aws-sdk-sqs/customizations'
44
44
  # @service
45
45
  module Aws::SQS
46
46
 
47
- GEM_VERSION = '1.6.0'
47
+ GEM_VERSION = '1.7.0'
48
48
 
49
49
  end
@@ -191,36 +191,45 @@ module Aws::SQS
191
191
  #
192
192
  # When you create a queue, you have full control access rights for the
193
193
  # queue. Only you, the owner of the queue, can grant or deny permissions
194
- # to the queue. For more information about these permissions, see
195
- # [Shared Queues][2] in the *Amazon Simple Queue Service Developer
196
- # Guide*.
194
+ # to the queue. For more information about these permissions, see [Allow
195
+ # Developers to Write Messages to a Shared Queue][2] in the *Amazon
196
+ # Simple Queue Service Developer Guide*.
197
197
  #
198
198
  # <note markdown="1"> `AddPermission` writes an Amazon-SQS-generated policy. If you want to
199
199
  # write your own policy, use ` SetQueueAttributes ` to upload your
200
200
  # policy. For more information about writing your own policy, see [Using
201
- # The Access Policy Language][3] in the *Amazon Simple Queue Service
202
- # Developer Guide*.
201
+ # Custom Policies with the Amazon SQS Access Policy Language][3] in the
202
+ # *Amazon Simple Queue Service Developer Guide*.
203
203
  #
204
- # Some actions take lists of parameters. These lists are specified using
204
+ # An Amazon SQS policy can have a maximum of 7 actions.
205
+ #
206
+ # </note>
207
+ #
208
+ # Some actions take lists of parameters. These lists are specified using
205
209
  # the `param.n` notation. Values of `n` are integers starting from 1.
206
210
  # For example, a parameter list with two elements looks like this:
207
211
  #
208
- # `&Attribute.1=this`
212
+ # `&Attribute.1=first`
213
+ #
214
+ # `&Attribute.2=second`
209
215
  #
210
- # `&Attribute.2=that`
216
+ # <note markdown="1"> Cross-account permissions don't apply to this action. For more
217
+ # information, see see [Grant Cross-Account Permissions to a Role and a
218
+ # User Name][4] in the *Amazon Simple Queue Service Developer Guide*.
211
219
  #
212
220
  # </note>
213
221
  #
214
222
  #
215
223
  #
216
224
  # [1]: http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P
217
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html
218
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AccessPolicyLanguage.html
225
+ # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
226
+ # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-creating-custom-policies.html
227
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
219
228
  #
220
229
  # @option params [required, String] :queue_url
221
230
  # The URL of the Amazon SQS queue to which permissions are added.
222
231
  #
223
- # Queue URLs are case-sensitive.
232
+ # Queue URLs and names are case-sensitive.
224
233
  #
225
234
  # @option params [required, String] :label
226
235
  # The unique identification of the permission you're setting (for
@@ -238,28 +247,15 @@ module Aws::SQS
238
247
  #
239
248
  #
240
249
  # [1]: http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P
241
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/AWSCredentials.html
250
+ # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-making-api-requests.html#sqs-api-request-authentication
242
251
  #
243
252
  # @option params [required, Array<String>] :actions
244
- # The action the client wants to allow for the specified principal. The
245
- # following values are valid:
246
- #
247
- # * `*`
253
+ # The action the client wants to allow for the specified principal.
254
+ # Valid values: the name of any action or `*`.
248
255
  #
249
- # * `ChangeMessageVisibility`
250
- #
251
- # * `DeleteMessage`
252
- #
253
- # * `GetQueueAttributes`
254
- #
255
- # * `GetQueueUrl`
256
- #
257
- # * `ReceiveMessage`
258
- #
259
- # * `SendMessage`
260
- #
261
- # For more information about these actions, see [Understanding
262
- # Permissions][1] in the *Amazon Simple Queue Service Developer Guide*.
256
+ # For more information about these actions, see [Overview of Managing
257
+ # Access Permissions to Your Amazon Simple Queue Service Resource][1] in
258
+ # the *Amazon Simple Queue Service Developer Guide*.
263
259
  #
264
260
  # Specifying `SendMessage`, `DeleteMessage`, or
265
261
  # `ChangeMessageVisibility` for `ActionName.n` also grants permissions
@@ -269,7 +265,7 @@ module Aws::SQS
269
265
  #
270
266
  #
271
267
  #
272
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html#PermissionTypes
268
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-overview-of-managing-access.html
273
269
  #
274
270
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
275
271
  #
@@ -292,18 +288,13 @@ module Aws::SQS
292
288
  end
293
289
 
294
290
  # Changes the visibility timeout of a specified message in a queue to a
295
- # new value. The maximum allowed timeout value is 12 hours. Thus, you
296
- # can't extend the timeout of a message in an existing queue to more
297
- # than a total visibility timeout of 12 hours. For more information, see
298
- # [Visibility Timeout][1] in the *Amazon Simple Queue Service Developer
299
- # Guide*.
291
+ # new value. The maximum allowed timeout value is 12 hours. For more
292
+ # information, see [Visibility Timeout][1] in the *Amazon Simple Queue
293
+ # Service Developer Guide*.
300
294
  #
301
295
  # For example, you have a message with a visibility timeout of 5
302
- # minutes. After 3 minutes, you call `ChangeMessageVisiblity` with a
303
- # timeout of 10 minutes. At that time, the timeout for the message is
304
- # extended by 10 minutes beyond the time of the
305
- # `ChangeMessageVisibility` action. This results in a total visibility
306
- # timeout of 13 minutes. You can continue to call the
296
+ # minutes. After 3 minutes, you call `ChangeMessageVisibility` with a
297
+ # timeout of 10 minutes. You can continue to call
307
298
  # `ChangeMessageVisibility` to extend the visibility timeout to a
308
299
  # maximum of 12 hours. If you try to extend the visibility timeout
309
300
  # beyond 12 hours, your request is rejected.
@@ -342,7 +333,7 @@ module Aws::SQS
342
333
  # The URL of the Amazon SQS queue whose message's visibility is
343
334
  # changed.
344
335
  #
345
- # Queue URLs are case-sensitive.
336
+ # Queue URLs and names are case-sensitive.
346
337
  #
347
338
  # @option params [required, String] :receipt_handle
348
339
  # The receipt handle associated with the message whose visibility
@@ -382,21 +373,19 @@ module Aws::SQS
382
373
  # and unsuccessful actions, you should check for batch errors even when
383
374
  # the call returns an HTTP status code of `200`.
384
375
  #
385
- # <note markdown="1"> Some actions take lists of parameters. These lists are specified using
376
+ # Some actions take lists of parameters. These lists are specified using
386
377
  # the `param.n` notation. Values of `n` are integers starting from 1.
387
378
  # For example, a parameter list with two elements looks like this:
388
379
  #
389
- # `&Attribute.1=this`
390
- #
391
- # `&Attribute.2=that`
380
+ # `&Attribute.1=first`
392
381
  #
393
- # </note>
382
+ # `&Attribute.2=second`
394
383
  #
395
384
  # @option params [required, String] :queue_url
396
385
  # The URL of the Amazon SQS queue whose messages' visibility is
397
386
  # changed.
398
387
  #
399
- # Queue URLs are case-sensitive.
388
+ # Queue URLs and names are case-sensitive.
400
389
  #
401
390
  # @option params [required, Array<Types::ChangeMessageVisibilityBatchRequestEntry>] :entries
402
391
  # A list of receipt handles of the messages for which the visibility
@@ -449,7 +438,7 @@ module Aws::SQS
449
438
  # convert an existing standard queue into a FIFO queue. You must
450
439
  # either create a new FIFO queue for your application or delete your
451
440
  # existing standard queue and recreate it as a FIFO queue. For more
452
- # information, see [ Moving From a Standard Queue to a FIFO Queue][1]
441
+ # information, see [Moving From a Standard Queue to a FIFO Queue][1]
453
442
  # in the *Amazon Simple Queue Service Developer Guide*.
454
443
  #
455
444
  # </note>
@@ -475,13 +464,17 @@ module Aws::SQS
475
464
  # * If the queue name, attribute names, or attribute values don't match
476
465
  # an existing queue, `CreateQueue` returns an error.
477
466
  #
478
- # <note markdown="1"> Some actions take lists of parameters. These lists are specified using
467
+ # Some actions take lists of parameters. These lists are specified using
479
468
  # the `param.n` notation. Values of `n` are integers starting from 1.
480
469
  # For example, a parameter list with two elements looks like this:
481
470
  #
482
- # `&Attribute.1=this`
471
+ # `&Attribute.1=first`
472
+ #
473
+ # `&Attribute.2=second`
483
474
  #
484
- # `&Attribute.2=that`
475
+ # <note markdown="1"> Cross-account permissions don't apply to this action. For more
476
+ # information, see see [Grant Cross-Account Permissions to a Role and a
477
+ # User Name][3] in the *Amazon Simple Queue Service Developer Guide*.
485
478
  #
486
479
  # </note>
487
480
  #
@@ -489,6 +482,7 @@ module Aws::SQS
489
482
  #
490
483
  # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving
491
484
  # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
485
+ # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
492
486
  #
493
487
  # @option params [required, String] :queue_name
494
488
  # The name of the new queue. The following limits apply to this name:
@@ -500,7 +494,7 @@ module Aws::SQS
500
494
  #
501
495
  # * A FIFO queue name must end with the `.fifo` suffix.
502
496
  #
503
- # Queue names are case-sensitive.
497
+ # Queue URLs and names are case-sensitive.
504
498
  #
505
499
  # @option params [Hash<String,String>] :attributes
506
500
  # A map of attributes with their corresponding values.
@@ -510,17 +504,17 @@ module Aws::SQS
510
504
  #
511
505
  # * `DelaySeconds` - The length of time, in seconds, for which the
512
506
  # delivery of all messages in the queue is delayed. Valid values: An
513
- # integer from 0 to 900 seconds (15 minutes). The default is 0 (zero).
507
+ # integer from 0 to 900 seconds (15 minutes). Default: 0.
514
508
  #
515
509
  # * `MaximumMessageSize` - The limit of how many bytes a message can
516
510
  # contain before Amazon SQS rejects it. Valid values: An integer from
517
- # 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). The default is
518
- # 262,144 (256 KiB).
511
+ # 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). Default: 262,144
512
+ # (256 KiB).
519
513
  #
520
514
  # * `MessageRetentionPeriod` - The length of time, in seconds, for which
521
515
  # Amazon SQS retains a message. Valid values: An integer from 60
522
- # seconds (1 minute) to 1,209,600 seconds (14 days). The default is
523
- # 345,600 (4 days).
516
+ # seconds (1 minute) to 1,209,600 seconds (14 days). Default: 345,600
517
+ # (4 days).
524
518
  #
525
519
  # * `Policy` - The queue's policy. A valid AWS policy. For more
526
520
  # information about policy structure, see [Overview of AWS IAM
@@ -528,8 +522,7 @@ module Aws::SQS
528
522
  #
529
523
  # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
530
524
  # for which a ` ReceiveMessage ` action waits for a message to arrive.
531
- # Valid values: An integer from 0 to 20 (seconds). The default is 0
532
- # (zero).
525
+ # Valid values: An integer from 0 to 20 (seconds). Default: 0.
533
526
  #
534
527
  # * `RedrivePolicy` - The string that includes the parameters for the
535
528
  # dead-letter queue functionality of the source queue. For more
@@ -542,7 +535,9 @@ module Aws::SQS
542
535
  # value of `maxReceiveCount` is exceeded.
543
536
  #
544
537
  # * `maxReceiveCount` - The number of times a message is delivered to
545
- # the source queue before being moved to the dead-letter queue.
538
+ # the source queue before being moved to the dead-letter queue. When
539
+ # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
540
+ # a queue, Amazon SQS moves the message to the dead-letter-queue.
546
541
  #
547
542
  # <note markdown="1"> The dead-letter queue of a FIFO queue must also be a FIFO queue.
548
543
  # Similarly, the dead-letter queue of a standard queue must also be a
@@ -550,10 +545,11 @@ module Aws::SQS
550
545
  #
551
546
  # </note>
552
547
  #
553
- # * `VisibilityTimeout` - The visibility timeout for the queue. Valid
554
- # values: An integer from 0 to 43,200 (12 hours). The default is 30.
555
- # For more information about the visibility timeout, see [Visibility
556
- # Timeout][3] in the *Amazon Simple Queue Service Developer Guide*.
548
+ # * `VisibilityTimeout` - The visibility timeout for the queue, in
549
+ # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
550
+ # Default: 30. For more information about the visibility timeout, see
551
+ # [Visibility Timeout][3] in the *Amazon Simple Queue Service
552
+ # Developer Guide*.
557
553
  #
558
554
  # The following attributes apply only to [server-side-encryption][4]\:
559
555
  #
@@ -568,10 +564,10 @@ module Aws::SQS
568
564
  # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
569
565
  # messages before calling AWS KMS again. An integer representing
570
566
  # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
571
- # hours). The default is 300 (5 minutes). A shorter time period
572
- # provides better security but results in more calls to KMS which
573
- # might incur charges after Free Tier. For more information, see [How
574
- # Does the Data Key Reuse Period Work?][8].
567
+ # hours). Default: 300 (5 minutes). A shorter time period provides
568
+ # better security but results in more calls to KMS which might incur
569
+ # charges after Free Tier. For more information, see [How Does the
570
+ # Data Key Reuse Period Work?][8].
575
571
  #
576
572
  # The following attributes apply only to [FIFO (first-in-first-out)
577
573
  # queues][9]\:
@@ -618,21 +614,6 @@ module Aws::SQS
618
614
  # `MessageDeduplicationId`, the two messages are treated as
619
615
  # duplicates and only one copy of the message is delivered.
620
616
  #
621
- # Any other valid special request parameters (such as the following) are
622
- # ignored:
623
- #
624
- # * `ApproximateNumberOfMessages`
625
- #
626
- # * `ApproximateNumberOfMessagesDelayed`
627
- #
628
- # * `ApproximateNumberOfMessagesNotVisible`
629
- #
630
- # * `CreatedTimestamp`
631
- #
632
- # * `LastModifiedTimestamp`
633
- #
634
- # * `QueueArn`
635
- #
636
617
  #
637
618
  #
638
619
  # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
@@ -673,27 +654,27 @@ module Aws::SQS
673
654
  req.send_request(options)
674
655
  end
675
656
 
676
- # Deletes the specified message from the specified queue. You specify
677
- # the message by using the message's *receipt handle* and not the
678
- # *MessageId* you receive when you send the message. Even if the message
679
- # is locked by another reader due to the visibility timeout setting, it
680
- # is still deleted from the queue. If you leave a message in the queue
681
- # for longer than the queue's configured retention period, Amazon SQS
682
- # automatically deletes the message.
683
- #
684
- # <note markdown="1"> The receipt handle is associated with a specific instance of receiving
685
- # the message. If you receive a message more than once, the receipt
686
- # handle you get each time you receive the message is different. If you
687
- # don't provide the most recently received receipt handle for the
688
- # message when you use the `DeleteMessage` action, the request succeeds,
689
- # but the message might not be deleted.
657
+ # Deletes the specified message from the specified queue. To select the
658
+ # message to delete, use the `ReceiptHandle` of the message (*not* the
659
+ # `MessageId` which you receive when you send the message). Amazon SQS
660
+ # can delete a message from a queue even if a visibility timeout setting
661
+ # causes the message to be locked by another consumer. Amazon SQS
662
+ # automatically deletes messages left in a queue longer than the
663
+ # retention period configured for the queue.
664
+ #
665
+ # <note markdown="1"> The `ReceiptHandle` is associated with a *specific instance* of
666
+ # receiving a message. If you receive a message more than once, the
667
+ # `ReceiptHandle` is different each time you receive a message. When you
668
+ # use the `DeleteMessage` action, you must provide the most recently
669
+ # received `ReceiptHandle` for the message (otherwise, the request
670
+ # succeeds, but the message might not be deleted).
690
671
  #
691
672
  # For standard queues, it is possible to receive a message even after
692
673
  # you delete it. This might happen on rare occasions if one of the
693
- # servers storing a copy of the message is unavailable when you send the
694
- # request to delete the message. The copy remains on the server and
695
- # might be returned to you on a subsequent receive request. You should
696
- # ensure that your application is idempotent, so that receiving a
674
+ # servers which stores a copy of the message is unavailable when you
675
+ # send the request to delete the message. The copy remains on the server
676
+ # and might be returned to you during a subsequent receive request. You
677
+ # should ensure that your application is idempotent, so that receiving a
697
678
  # message more than once does not cause issues.
698
679
  #
699
680
  # </note>
@@ -701,7 +682,7 @@ module Aws::SQS
701
682
  # @option params [required, String] :queue_url
702
683
  # The URL of the Amazon SQS queue from which messages are deleted.
703
684
  #
704
- # Queue URLs are case-sensitive.
685
+ # Queue URLs and names are case-sensitive.
705
686
  #
706
687
  # @option params [required, String] :receipt_handle
707
688
  # The receipt handle associated with the message to delete.
@@ -732,20 +713,18 @@ module Aws::SQS
732
713
  # and unsuccessful actions, you should check for batch errors even when
733
714
  # the call returns an HTTP status code of `200`.
734
715
  #
735
- # <note markdown="1"> Some actions take lists of parameters. These lists are specified using
716
+ # Some actions take lists of parameters. These lists are specified using
736
717
  # the `param.n` notation. Values of `n` are integers starting from 1.
737
718
  # For example, a parameter list with two elements looks like this:
738
719
  #
739
- # `&Attribute.1=this`
720
+ # `&Attribute.1=first`
740
721
  #
741
- # `&Attribute.2=that`
742
- #
743
- # </note>
722
+ # `&Attribute.2=second`
744
723
  #
745
724
  # @option params [required, String] :queue_url
746
725
  # The URL of the Amazon SQS queue from which messages are deleted.
747
726
  #
748
- # Queue URLs are case-sensitive.
727
+ # Queue URLs and names are case-sensitive.
749
728
  #
750
729
  # @option params [required, Array<Types::DeleteMessageBatchRequestEntry>] :entries
751
730
  # A list of receipt handles for the messages to be deleted.
@@ -801,10 +780,20 @@ module Aws::SQS
801
780
  # When you delete a queue, you must wait at least 60 seconds before
802
781
  # creating a queue with the same name.
803
782
  #
783
+ # <note markdown="1"> Cross-account permissions don't apply to this action. For more
784
+ # information, see see [Grant Cross-Account Permissions to a Role and a
785
+ # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
786
+ #
787
+ # </note>
788
+ #
789
+ #
790
+ #
791
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
792
+ #
804
793
  # @option params [required, String] :queue_url
805
794
  # The URL of the Amazon SQS queue to delete.
806
795
  #
807
- # Queue URLs are case-sensitive.
796
+ # Queue URLs and names are case-sensitive.
808
797
  #
809
798
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
810
799
  #
@@ -830,15 +819,13 @@ module Aws::SQS
830
819
  #
831
820
  # </note>
832
821
  #
833
- # <note markdown="1"> Some actions take lists of parameters. These lists are specified using
822
+ # Some actions take lists of parameters. These lists are specified using
834
823
  # the `param.n` notation. Values of `n` are integers starting from 1.
835
824
  # For example, a parameter list with two elements looks like this:
836
825
  #
837
- # `&Attribute.1=this`
838
- #
839
- # `&Attribute.2=that`
826
+ # `&Attribute.1=first`
840
827
  #
841
- # </note>
828
+ # `&Attribute.2=second`
842
829
  #
843
830
  #
844
831
  #
@@ -848,7 +835,7 @@ module Aws::SQS
848
835
  # The URL of the Amazon SQS queue whose attribute information is
849
836
  # retrieved.
850
837
  #
851
- # Queue URLs are case-sensitive.
838
+ # Queue URLs and names are case-sensitive.
852
839
  #
853
840
  # @option params [Array<String>] :attribute_names
854
841
  # A list of attributes for which to retrieve information.
@@ -864,25 +851,26 @@ module Aws::SQS
864
851
  # * `All` - Returns all values.
865
852
  #
866
853
  # * `ApproximateNumberOfMessages` - Returns the approximate number of
867
- # visible messages in a queue. For more information, see [Resources
868
- # Required to Process Messages][1] in the *Amazon Simple Queue Service
869
- # Developer Guide*.
854
+ # messages available for retrieval from the queue.
870
855
  #
871
856
  # * `ApproximateNumberOfMessagesDelayed` - Returns the approximate
872
- # number of messages that are waiting to be added to the queue.
857
+ # number of messages in the queue that are delayed and not available
858
+ # for reading immediately. This can happen when the queue is
859
+ # configured as a delay queue or when a message has been sent with a
860
+ # delay parameter.
873
861
  #
874
862
  # * `ApproximateNumberOfMessagesNotVisible` - Returns the approximate
875
- # number of messages that have not timed-out and aren't deleted. For
876
- # more information, see [Resources Required to Process Messages][1] in
877
- # the *Amazon Simple Queue Service Developer Guide*.
863
+ # number of messages that are in flight. Messages are considered to be
864
+ # *in flight* if they have been sent to a client but have not yet been
865
+ # deleted or have not yet reached the end of their visibility window.
878
866
  #
879
867
  # * `CreatedTimestamp` - Returns the time when the queue was created in
880
- # seconds ([epoch time][2]).
868
+ # seconds ([epoch time][1]).
881
869
  #
882
870
  # * `DelaySeconds` - Returns the default delay on the queue in seconds.
883
871
  #
884
872
  # * `LastModifiedTimestamp` - Returns the time when the queue was last
885
- # changed in seconds ([epoch time][2]).
873
+ # changed in seconds ([epoch time][1]).
886
874
  #
887
875
  # * `MaximumMessageSize` - Returns the limit of how many bytes a message
888
876
  # can contain before Amazon SQS rejects it.
@@ -901,7 +889,7 @@ module Aws::SQS
901
889
  # * `RedrivePolicy` - Returns the string that includes the parameters
902
890
  # for dead-letter queue functionality of the source queue. For more
903
891
  # information about the redrive policy and dead-letter queues, see
904
- # [Using Amazon SQS Dead-Letter Queues][3] in the *Amazon Simple Queue
892
+ # [Using Amazon SQS Dead-Letter Queues][2] in the *Amazon Simple Queue
905
893
  # Service Developer Guide*.
906
894
  #
907
895
  # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
@@ -909,52 +897,53 @@ module Aws::SQS
909
897
  # value of `maxReceiveCount` is exceeded.
910
898
  #
911
899
  # * `maxReceiveCount` - The number of times a message is delivered to
912
- # the source queue before being moved to the dead-letter queue.
900
+ # the source queue before being moved to the dead-letter queue. When
901
+ # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
902
+ # a queue, Amazon SQS moves the message to the dead-letter-queue.
913
903
  #
914
904
  # * `VisibilityTimeout` - Returns the visibility timeout for the queue.
915
905
  # For more information about the visibility timeout, see [Visibility
916
- # Timeout][4] in the *Amazon Simple Queue Service Developer Guide*.
906
+ # Timeout][3] in the *Amazon Simple Queue Service Developer Guide*.
917
907
  #
918
- # The following attributes apply only to [server-side-encryption][5]\:
908
+ # The following attributes apply only to [server-side-encryption][4]\:
919
909
  #
920
910
  # * `KmsMasterKeyId` - Returns the ID of an AWS-managed customer master
921
911
  # key (CMK) for Amazon SQS or a custom CMK. For more information, see
922
- # [Key Terms][6].
912
+ # [Key Terms][5].
923
913
  #
924
914
  # * `KmsDataKeyReusePeriodSeconds` - Returns the length of time, in
925
915
  # seconds, for which Amazon SQS can reuse a data key to encrypt or
926
916
  # decrypt messages before calling AWS KMS again. For more information,
927
- # see [How Does the Data Key Reuse Period Work?][7].
917
+ # see [How Does the Data Key Reuse Period Work?][6].
928
918
  #
929
919
  # The following attributes apply only to [FIFO (first-in-first-out)
930
- # queues][8]\:
920
+ # queues][7]\:
931
921
  #
932
922
  # * `FifoQueue` - Returns whether the queue is FIFO. For more
933
- # information, see [FIFO Queue Logic][9] in the *Amazon Simple Queue
923
+ # information, see [FIFO Queue Logic][8] in the *Amazon Simple Queue
934
924
  # Service Developer Guide*.
935
925
  #
936
- # <note markdown="1"> To determine whether a queue is [FIFO][8], you can check whether
926
+ # <note markdown="1"> To determine whether a queue is [FIFO][7], you can check whether
937
927
  # `QueueName` ends with the `.fifo` suffix.
938
928
  #
939
929
  # </note>
940
930
  #
941
931
  # * `ContentBasedDeduplication` - Returns whether content-based
942
932
  # deduplication is enabled for the queue. For more information, see
943
- # [Exactly-Once Processing][10] in the *Amazon Simple Queue Service
933
+ # [Exactly-Once Processing][9] in the *Amazon Simple Queue Service
944
934
  # Developer Guide*.
945
935
  #
946
936
  #
947
937
  #
948
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-resources-required-process-messages.html
949
- # [2]: http://en.wikipedia.org/wiki/Unix_time
950
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
951
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
952
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
953
- # [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
954
- # [7]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
955
- # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
956
- # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
957
- # [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
938
+ # [1]: http://en.wikipedia.org/wiki/Unix_time
939
+ # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
940
+ # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
941
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
942
+ # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
943
+ # [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
944
+ # [7]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
945
+ # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
946
+ # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
958
947
  #
959
948
  # @return [Types::GetQueueAttributesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
960
949
  #
@@ -981,26 +970,25 @@ module Aws::SQS
981
970
  req.send_request(options)
982
971
  end
983
972
 
984
- # Returns the URL of an existing queue. This action provides a simple
985
- # way to retrieve the URL of an Amazon SQS queue.
973
+ # Returns the URL of an existing Amazon SQS queue.
986
974
  #
987
975
  # To access a queue that belongs to another AWS account, use the
988
976
  # `QueueOwnerAWSAccountId` parameter to specify the account ID of the
989
977
  # queue's owner. The queue's owner must grant you permission to access
990
978
  # the queue. For more information about shared queue access, see `
991
- # AddPermission ` or see [Shared Queues][1] in the *Amazon Simple Queue
992
- # Service Developer Guide*.
979
+ # AddPermission ` or see [Allow Developers to Write Messages to a Shared
980
+ # Queue][1] in the *Amazon Simple Queue Service Developer Guide*.
993
981
  #
994
982
  #
995
983
  #
996
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/acp-overview.html
984
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
997
985
  #
998
986
  # @option params [required, String] :queue_name
999
987
  # The name of the queue whose URL must be fetched. Maximum 80
1000
988
  # characters. Valid values: alphanumeric characters, hyphens (`-`), and
1001
989
  # underscores (`_`).
1002
990
  #
1003
- # Queue names are case-sensitive.
991
+ # Queue URLs and names are case-sensitive.
1004
992
  #
1005
993
  # @option params [String] :queue_owner_aws_account_id
1006
994
  # The AWS account ID of the account that created the queue.
@@ -1043,7 +1031,7 @@ module Aws::SQS
1043
1031
  # @option params [required, String] :queue_url
1044
1032
  # The URL of a dead-letter queue.
1045
1033
  #
1046
- # Queue URLs are case-sensitive.
1034
+ # Queue URLs and names are case-sensitive.
1047
1035
  #
1048
1036
  # @return [Types::ListDeadLetterSourceQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1049
1037
  #
@@ -1070,8 +1058,8 @@ module Aws::SQS
1070
1058
  end
1071
1059
 
1072
1060
  # List all cost allocation tags added to the specified Amazon SQS queue.
1073
- # For an overview, see [Tagging Amazon SQS Queues][1] in the *Amazon
1074
- # Simple Queue Service Developer Guide*.
1061
+ # For an overview, see [Tagging Your Amazon SQS Queues][1] in the
1062
+ # *Amazon Simple Queue Service Developer Guide*.
1075
1063
  #
1076
1064
  # When you use queue tags, keep the following guidelines in mind:
1077
1065
  #
@@ -1085,18 +1073,25 @@ module Aws::SQS
1085
1073
  # * A new tag with a key identical to that of an existing tag overwrites
1086
1074
  # the existing tag.
1087
1075
  #
1088
- # * Tagging API actions are limited to 5 TPS per AWS account. If your
1076
+ # * Tagging actions are limited to 5 TPS per AWS account. If your
1089
1077
  # application requires a higher throughput, file a [technical support
1090
1078
  # request][2].
1091
1079
  #
1092
1080
  # For a full list of tag restrictions, see [Limits Related to Queues][3]
1093
1081
  # in the *Amazon Simple Queue Service Developer Guide*.
1094
1082
  #
1083
+ # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1084
+ # information, see see [Grant Cross-Account Permissions to a Role and a
1085
+ # User Name][4] in the *Amazon Simple Queue Service Developer Guide*.
1086
+ #
1087
+ # </note>
1088
+ #
1095
1089
  #
1096
1090
  #
1097
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-tagging-queues.html
1091
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
1098
1092
  # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=technical
1099
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
1093
+ # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
1094
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1100
1095
  #
1101
1096
  # @option params [required, String] :queue_url
1102
1097
  # The URL of the queue.
@@ -1130,11 +1125,21 @@ module Aws::SQS
1130
1125
  # `QueueNamePrefix` parameter, only queues with a name that begins with
1131
1126
  # the specified value are returned.
1132
1127
  #
1128
+ # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1129
+ # information, see see [Grant Cross-Account Permissions to a Role and a
1130
+ # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1131
+ #
1132
+ # </note>
1133
+ #
1134
+ #
1135
+ #
1136
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1137
+ #
1133
1138
  # @option params [String] :queue_name_prefix
1134
1139
  # A string to use for filtering the list results. Only those queues
1135
1140
  # whose name begins with the specified string are returned.
1136
1141
  #
1137
- # Queue names are case-sensitive.
1142
+ # Queue URLs and names are case-sensitive.
1138
1143
  #
1139
1144
  # @return [Types::ListQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1140
1145
  #
@@ -1162,21 +1167,23 @@ module Aws::SQS
1162
1167
 
1163
1168
  # Deletes the messages in a queue specified by the `QueueURL` parameter.
1164
1169
  #
1165
- # When you use the `PurgeQueue` action, you can't retrieve a message
1170
+ # When you use the `PurgeQueue` action, you can't retrieve any messages
1166
1171
  # deleted from a queue.
1167
1172
  #
1168
- # When you purge a queue, the message deletion process takes up to 60
1169
- # seconds. All messages sent to the queue before calling the
1170
- # `PurgeQueue` action are deleted. Messages sent to the queue while it
1171
- # is being purged might be deleted. While the queue is being purged,
1172
- # messages sent to the queue before `PurgeQueue` is called might be
1173
- # received, but are deleted within the next minute.
1173
+ # The message deletion process takes up to 60 seconds. We recommend
1174
+ # waiting for 60 seconds regardless of your queue's size.
1175
+ #
1176
+ # Messages sent to the queue *before* you call `PurgeQueue` might be
1177
+ # received but are deleted within the next minute.
1178
+ #
1179
+ # Messages sent to the queue *after* you call `PurgeQueue` might be
1180
+ # deleted while the queue is being purged.
1174
1181
  #
1175
1182
  # @option params [required, String] :queue_url
1176
1183
  # The URL of the queue from which the `PurgeQueue` action deletes
1177
1184
  # messages.
1178
1185
  #
1179
- # Queue URLs are case-sensitive.
1186
+ # Queue URLs and names are case-sensitive.
1180
1187
  #
1181
1188
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1182
1189
  #
@@ -1256,11 +1263,11 @@ module Aws::SQS
1256
1263
  # @option params [required, String] :queue_url
1257
1264
  # The URL of the Amazon SQS queue from which messages are received.
1258
1265
  #
1259
- # Queue URLs are case-sensitive.
1266
+ # Queue URLs and names are case-sensitive.
1260
1267
  #
1261
1268
  # @option params [Array<String>] :attribute_names
1262
- # A list of attributes that need to be returned along with each message.
1263
- # These attributes include:
1269
+ # A list of s that need to be returned along with each message. These
1270
+ # attributes include:
1264
1271
  #
1265
1272
  # * `All` - Returns all values.
1266
1273
  #
@@ -1281,48 +1288,15 @@ module Aws::SQS
1281
1288
  # * `SentTimestamp` - Returns the time the message was sent to the queue
1282
1289
  # ([epoch time][1] in milliseconds).
1283
1290
  #
1284
- # * `MessageDeduplicationId` - Returns the value provided by the sender
1285
- # that calls the ` SendMessage ` action.
1291
+ # * `MessageDeduplicationId` - Returns the value provided by the
1292
+ # producer that calls the ` SendMessage ` action.
1286
1293
  #
1287
- # * `MessageGroupId` - Returns the value provided by the sender that
1294
+ # * `MessageGroupId` - Returns the value provided by the producer that
1288
1295
  # calls the ` SendMessage ` action. Messages with the same
1289
1296
  # `MessageGroupId` are returned in sequence.
1290
1297
  #
1291
1298
  # * `SequenceNumber` - Returns the value provided by Amazon SQS.
1292
1299
  #
1293
- # Any other valid special request parameters (such as the following) are
1294
- # ignored:
1295
- #
1296
- # * `ApproximateNumberOfMessages`
1297
- #
1298
- # * `ApproximateNumberOfMessagesDelayed`
1299
- #
1300
- # * `ApproximateNumberOfMessagesNotVisible`
1301
- #
1302
- # * `CreatedTimestamp`
1303
- #
1304
- # * `ContentBasedDeduplication`
1305
- #
1306
- # * `DelaySeconds`
1307
- #
1308
- # * `FifoQueue`
1309
- #
1310
- # * `LastModifiedTimestamp`
1311
- #
1312
- # * `MaximumMessageSize`
1313
- #
1314
- # * `MessageRetentionPeriod`
1315
- #
1316
- # * `Policy`
1317
- #
1318
- # * `QueueArn`,
1319
- #
1320
- # * `ReceiveMessageWaitTimeSeconds`
1321
- #
1322
- # * `RedrivePolicy`
1323
- #
1324
- # * `VisibilityTimeout`
1325
- #
1326
1300
  #
1327
1301
  #
1328
1302
  # [1]: http://en.wikipedia.org/wiki/Unix_time
@@ -1352,7 +1326,7 @@ module Aws::SQS
1352
1326
  # @option params [Integer] :max_number_of_messages
1353
1327
  # The maximum number of messages to return. Amazon SQS never returns
1354
1328
  # more messages than this value (however, fewer messages might be
1355
- # returned). Valid values are 1 to 10. Default is 1.
1329
+ # returned). Valid values: 1 to 10. Default: 1.
1356
1330
  #
1357
1331
  # @option params [Integer] :visibility_timeout
1358
1332
  # The duration (in seconds) that the received messages are hidden from
@@ -1396,13 +1370,12 @@ module Aws::SQS
1396
1370
  # resets the visibility timeout. For more information, see [Visibility
1397
1371
  # Timeout][1] in the *Amazon Simple Queue Service Developer Guide*.
1398
1372
  #
1399
- # If a caller of the `ReceiveMessage` action is still processing
1400
- # messages when the visibility timeout expires and messages become
1401
- # visible, another worker reading from the same queue can receive the
1402
- # same messages and therefore process duplicates. Also, if a reader
1403
- # whose message processing time is longer than the visibility timeout
1404
- # tries to delete the processed messages, the action fails with an
1405
- # error.
1373
+ # If a caller of the `ReceiveMessage` action still processes messages
1374
+ # when the visibility timeout expires and messages become visible,
1375
+ # another worker consuming from the same queue can receive the same
1376
+ # messages and therefore process duplicates. Also, if a consumer whose
1377
+ # message processing time is longer than the visibility timeout tries
1378
+ # to delete the processed messages, the action fails with an error.
1406
1379
  #
1407
1380
  # To mitigate this effect, ensure that your application observes a
1408
1381
  # safe threshold before the visibility timeout expires and extend the
@@ -1430,7 +1403,7 @@ module Aws::SQS
1430
1403
  #
1431
1404
  #
1432
1405
  # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1433
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-receiverequestattemptid-request-parameter
1406
+ # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-receiverequestattemptid-request-parameter.html
1434
1407
  #
1435
1408
  # @return [Types::ReceiveMessageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1436
1409
  #
@@ -1477,12 +1450,24 @@ module Aws::SQS
1477
1450
  end
1478
1451
 
1479
1452
  # Revokes any permissions in the queue policy that matches the specified
1480
- # `Label` parameter. Only the owner of the queue can remove permissions.
1453
+ # `Label` parameter.
1454
+ #
1455
+ # <note markdown="1"> Only the owner of a queue can remove permissions from it.
1456
+ #
1457
+ # Cross-account permissions don't apply to this action. For more
1458
+ # information, see see [Grant Cross-Account Permissions to a Role and a
1459
+ # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1460
+ #
1461
+ # </note>
1462
+ #
1463
+ #
1464
+ #
1465
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1481
1466
  #
1482
1467
  # @option params [required, String] :queue_url
1483
1468
  # The URL of the Amazon SQS queue from which permissions are removed.
1484
1469
  #
1485
- # Queue URLs are case-sensitive.
1470
+ # Queue URLs and names are case-sensitive.
1486
1471
  #
1487
1472
  # @option params [required, String] :label
1488
1473
  # The identification of the permission to remove. This is the label
@@ -1524,7 +1509,7 @@ module Aws::SQS
1524
1509
  # @option params [required, String] :queue_url
1525
1510
  # The URL of the Amazon SQS queue to which a message is sent.
1526
1511
  #
1527
- # Queue URLs are case-sensitive.
1512
+ # Queue URLs and names are case-sensitive.
1528
1513
  #
1529
1514
  # @option params [required, String] :message_body
1530
1515
  # The message to send. The maximum string size is 256 KB.
@@ -1556,12 +1541,12 @@ module Aws::SQS
1556
1541
  #
1557
1542
  # @option params [Hash<String,Types::MessageAttributeValue>] :message_attributes
1558
1543
  # Each message attribute consists of a `Name`, `Type`, and `Value`. For
1559
- # more information, see [Message Attribute Items and Validation][1] in
1560
- # the *Amazon Simple Queue Service Developer Guide*.
1544
+ # more information, see [Amazon SQS Message Attributes][1] in the
1545
+ # *Amazon Simple Queue Service Developer Guide*.
1561
1546
  #
1562
1547
  #
1563
1548
  #
1564
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html#message-attributes-items-validation
1549
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html
1565
1550
  #
1566
1551
  # @option params [String] :message_deduplication_id
1567
1552
  # This parameter applies only to FIFO (first-in-first-out) queues.
@@ -1599,13 +1584,16 @@ module Aws::SQS
1599
1584
  # the two messages are treated as duplicates and only one copy of the
1600
1585
  # message is delivered.
1601
1586
  #
1602
- # <note markdown="1"> The `MessageDeduplicationId` is available to the recipient of the
1587
+ # <note markdown="1"> The `MessageDeduplicationId` is available to the consumer of the
1603
1588
  # message (this can be useful for troubleshooting delivery issues).
1604
1589
  #
1605
1590
  # If a message is sent successfully but the acknowledgement is lost and
1606
1591
  # the message is resent with the same `MessageDeduplicationId` after the
1607
1592
  # deduplication interval, Amazon SQS can't detect duplicate messages.
1608
1593
  #
1594
+ # Amazon SQS continues to keep track of the message deduplication ID
1595
+ # even after the message is received and deleted.
1596
+ #
1609
1597
  # </note>
1610
1598
  #
1611
1599
  # The length of `MessageDeduplicationId` is 128 characters.
@@ -1620,7 +1608,7 @@ module Aws::SQS
1620
1608
  #
1621
1609
  #
1622
1610
  # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1623
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagededuplicationid-property
1611
+ # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagededuplicationid-property.html
1624
1612
  #
1625
1613
  # @option params [String] :message_group_id
1626
1614
  # This parameter applies only to FIFO (first-in-first-out) queues.
@@ -1630,7 +1618,7 @@ module Aws::SQS
1630
1618
  # a FIFO manner (however, messages in different message groups might be
1631
1619
  # processed out of order). To interleave multiple ordered streams within
1632
1620
  # a single queue, use `MessageGroupId` values (for example, session data
1633
- # for multiple users). In this scenario, multiple readers can process
1621
+ # for multiple users). In this scenario, multiple consumers can process
1634
1622
  # the queue, but the session data of each user is processed in a FIFO
1635
1623
  # fashion.
1636
1624
  #
@@ -1641,7 +1629,7 @@ module Aws::SQS
1641
1629
  # `MessageGroupId` values. For each `MessageGroupId`, the messages are
1642
1630
  # sorted by time sent. The caller can't specify a `MessageGroupId`.
1643
1631
  #
1644
- # The length of `MessageGroupId` is 128 characters. Valid values are
1632
+ # The length of `MessageGroupId` is 128 characters. Valid values:
1645
1633
  # alphanumeric characters and punctuation ``
1646
1634
  # (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
1647
1635
  #
@@ -1654,7 +1642,7 @@ module Aws::SQS
1654
1642
  #
1655
1643
  #
1656
1644
  #
1657
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property
1645
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html
1658
1646
  #
1659
1647
  # @return [Types::SendMessageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1660
1648
  #
@@ -1723,15 +1711,13 @@ module Aws::SQS
1723
1711
  # If you don't specify the `DelaySeconds` parameter for an entry,
1724
1712
  # Amazon SQS uses the default value for the queue.
1725
1713
  #
1726
- # <note markdown="1"> Some actions take lists of parameters. These lists are specified using
1714
+ # Some actions take lists of parameters. These lists are specified using
1727
1715
  # the `param.n` notation. Values of `n` are integers starting from 1.
1728
1716
  # For example, a parameter list with two elements looks like this:
1729
1717
  #
1730
- # `&Attribute.1=this`
1718
+ # `&Attribute.1=first`
1731
1719
  #
1732
- # `&Attribute.2=that`
1733
- #
1734
- # </note>
1720
+ # `&Attribute.2=second`
1735
1721
  #
1736
1722
  #
1737
1723
  #
@@ -1740,7 +1726,7 @@ module Aws::SQS
1740
1726
  # @option params [required, String] :queue_url
1741
1727
  # The URL of the Amazon SQS queue to which batched messages are sent.
1742
1728
  #
1743
- # Queue URLs are case-sensitive.
1729
+ # Queue URLs and names are case-sensitive.
1744
1730
  #
1745
1731
  # @option params [required, Array<Types::SendMessageBatchRequestEntry>] :entries
1746
1732
  # A list of ` SendMessageBatchRequestEntry ` items.
@@ -1807,12 +1793,20 @@ module Aws::SQS
1807
1793
  # calls this action, we recommend that you structure your code so that
1808
1794
  # it can handle new attributes gracefully.
1809
1795
  #
1796
+ # Cross-account permissions don't apply to this action. For more
1797
+ # information, see see [Grant Cross-Account Permissions to a Role and a
1798
+ # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1799
+ #
1810
1800
  # </note>
1811
1801
  #
1802
+ #
1803
+ #
1804
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1805
+ #
1812
1806
  # @option params [required, String] :queue_url
1813
1807
  # The URL of the Amazon SQS queue whose attributes are set.
1814
1808
  #
1815
- # Queue URLs are case-sensitive.
1809
+ # Queue URLs and names are case-sensitive.
1816
1810
  #
1817
1811
  # @option params [required, Hash<String,String>] :attributes
1818
1812
  # A map of attributes to set.
@@ -1822,17 +1816,17 @@ module Aws::SQS
1822
1816
  #
1823
1817
  # * `DelaySeconds` - The length of time, in seconds, for which the
1824
1818
  # delivery of all messages in the queue is delayed. Valid values: An
1825
- # integer from 0 to 900 (15 minutes). The default is 0 (zero).
1819
+ # integer from 0 to 900 (15 minutes). Default: 0.
1826
1820
  #
1827
1821
  # * `MaximumMessageSize` - The limit of how many bytes a message can
1828
1822
  # contain before Amazon SQS rejects it. Valid values: An integer from
1829
- # 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). The default is
1830
- # 262,144 (256 KiB).
1823
+ # 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). Default: 262,144
1824
+ # (256 KiB).
1831
1825
  #
1832
1826
  # * `MessageRetentionPeriod` - The length of time, in seconds, for which
1833
1827
  # Amazon SQS retains a message. Valid values: An integer representing
1834
- # seconds, from 60 (1 minute) to 1,209,600 (14 days). The default is
1835
- # 345,600 (4 days).
1828
+ # seconds, from 60 (1 minute) to 1,209,600 (14 days). Default: 345,600
1829
+ # (4 days).
1836
1830
  #
1837
1831
  # * `Policy` - The queue's policy. A valid AWS policy. For more
1838
1832
  # information about policy structure, see [Overview of AWS IAM
@@ -1840,7 +1834,7 @@ module Aws::SQS
1840
1834
  #
1841
1835
  # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
1842
1836
  # for which a ` ReceiveMessage ` action waits for a message to arrive.
1843
- # Valid values: an integer from 0 to 20 (seconds). The default is 0.
1837
+ # Valid values: an integer from 0 to 20 (seconds). Default: 0.
1844
1838
  #
1845
1839
  # * `RedrivePolicy` - The string that includes the parameters for the
1846
1840
  # dead-letter queue functionality of the source queue. For more
@@ -1853,7 +1847,9 @@ module Aws::SQS
1853
1847
  # value of `maxReceiveCount` is exceeded.
1854
1848
  #
1855
1849
  # * `maxReceiveCount` - The number of times a message is delivered to
1856
- # the source queue before being moved to the dead-letter queue.
1850
+ # the source queue before being moved to the dead-letter queue. When
1851
+ # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
1852
+ # a queue, Amazon SQS moves the message to the dead-letter-queue.
1857
1853
  #
1858
1854
  # <note markdown="1"> The dead-letter queue of a FIFO queue must also be a FIFO queue.
1859
1855
  # Similarly, the dead-letter queue of a standard queue must also be a
@@ -1861,10 +1857,11 @@ module Aws::SQS
1861
1857
  #
1862
1858
  # </note>
1863
1859
  #
1864
- # * `VisibilityTimeout` - The visibility timeout for the queue. Valid
1865
- # values: an integer from 0 to 43,200 (12 hours). The default is 30.
1866
- # For more information about the visibility timeout, see [Visibility
1867
- # Timeout][3] in the *Amazon Simple Queue Service Developer Guide*.
1860
+ # * `VisibilityTimeout` - The visibility timeout for the queue, in
1861
+ # seconds. Valid values: an integer from 0 to 43,200 (12 hours).
1862
+ # Default: 30. For more information about the visibility timeout, see
1863
+ # [Visibility Timeout][3] in the *Amazon Simple Queue Service
1864
+ # Developer Guide*.
1868
1865
  #
1869
1866
  # The following attributes apply only to [server-side-encryption][4]\:
1870
1867
  #
@@ -1879,10 +1876,10 @@ module Aws::SQS
1879
1876
  # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
1880
1877
  # messages before calling AWS KMS again. An integer representing
1881
1878
  # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
1882
- # hours). The default is 300 (5 minutes). A shorter time period
1883
- # provides better security but results in more calls to KMS which
1884
- # might incur charges after Free Tier. For more information, see [How
1885
- # Does the Data Key Reuse Period Work?][8].
1879
+ # hours). Default: 300 (5 minutes). A shorter time period provides
1880
+ # better security but results in more calls to KMS which might incur
1881
+ # charges after Free Tier. For more information, see [How Does the
1882
+ # Data Key Reuse Period Work?][8].
1886
1883
  #
1887
1884
  # The following attribute applies only to [FIFO (first-in-first-out)
1888
1885
  # queues][9]\:
@@ -1919,21 +1916,6 @@ module Aws::SQS
1919
1916
  # `MessageDeduplicationId`, the two messages are treated as
1920
1917
  # duplicates and only one copy of the message is delivered.
1921
1918
  #
1922
- # Any other valid special request parameters (such as the following) are
1923
- # ignored:
1924
- #
1925
- # * `ApproximateNumberOfMessages`
1926
- #
1927
- # * `ApproximateNumberOfMessagesDelayed`
1928
- #
1929
- # * `ApproximateNumberOfMessagesNotVisible`
1930
- #
1931
- # * `CreatedTimestamp`
1932
- #
1933
- # * `LastModifiedTimestamp`
1934
- #
1935
- # * `QueueArn`
1936
- #
1937
1919
  #
1938
1920
  #
1939
1921
  # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
@@ -1968,8 +1950,8 @@ module Aws::SQS
1968
1950
  end
1969
1951
 
1970
1952
  # Add cost allocation tags to the specified Amazon SQS queue. For an
1971
- # overview, see [Tagging Amazon SQS Queues][1] in the *Amazon Simple
1972
- # Queue Service Developer Guide*.
1953
+ # overview, see [Tagging Your Amazon SQS Queues][1] in the *Amazon
1954
+ # Simple Queue Service Developer Guide*.
1973
1955
  #
1974
1956
  # When you use queue tags, keep the following guidelines in mind:
1975
1957
  #
@@ -1983,18 +1965,25 @@ module Aws::SQS
1983
1965
  # * A new tag with a key identical to that of an existing tag overwrites
1984
1966
  # the existing tag.
1985
1967
  #
1986
- # * Tagging API actions are limited to 5 TPS per AWS account. If your
1968
+ # * Tagging actions are limited to 5 TPS per AWS account. If your
1987
1969
  # application requires a higher throughput, file a [technical support
1988
1970
  # request][2].
1989
1971
  #
1990
1972
  # For a full list of tag restrictions, see [Limits Related to Queues][3]
1991
1973
  # in the *Amazon Simple Queue Service Developer Guide*.
1992
1974
  #
1975
+ # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1976
+ # information, see see [Grant Cross-Account Permissions to a Role and a
1977
+ # User Name][4] in the *Amazon Simple Queue Service Developer Guide*.
1993
1978
  #
1979
+ # </note>
1994
1980
  #
1995
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-tagging-queues.html
1981
+ #
1982
+ #
1983
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
1996
1984
  # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=technical
1997
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
1985
+ # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
1986
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1998
1987
  #
1999
1988
  # @option params [required, String] :queue_url
2000
1989
  # The URL of the queue.
@@ -2023,8 +2012,8 @@ module Aws::SQS
2023
2012
  end
2024
2013
 
2025
2014
  # Remove cost allocation tags from the specified Amazon SQS queue. For
2026
- # an overview, see [Tagging Amazon SQS Queues][1] in the *Amazon Simple
2027
- # Queue Service Developer Guide*.
2015
+ # an overview, see [Tagging Your Amazon SQS Queues][1] in the *Amazon
2016
+ # Simple Queue Service Developer Guide*.
2028
2017
  #
2029
2018
  # When you use queue tags, keep the following guidelines in mind:
2030
2019
  #
@@ -2038,18 +2027,25 @@ module Aws::SQS
2038
2027
  # * A new tag with a key identical to that of an existing tag overwrites
2039
2028
  # the existing tag.
2040
2029
  #
2041
- # * Tagging API actions are limited to 5 TPS per AWS account. If your
2030
+ # * Tagging actions are limited to 5 TPS per AWS account. If your
2042
2031
  # application requires a higher throughput, file a [technical support
2043
2032
  # request][2].
2044
2033
  #
2045
2034
  # For a full list of tag restrictions, see [Limits Related to Queues][3]
2046
2035
  # in the *Amazon Simple Queue Service Developer Guide*.
2047
2036
  #
2037
+ # <note markdown="1"> Cross-account permissions don't apply to this action. For more
2038
+ # information, see see [Grant Cross-Account Permissions to a Role and a
2039
+ # User Name][4] in the *Amazon Simple Queue Service Developer Guide*.
2040
+ #
2041
+ # </note>
2042
+ #
2048
2043
  #
2049
2044
  #
2050
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-tagging-queues.html
2045
+ # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
2051
2046
  # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=technical
2052
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
2047
+ # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
2048
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
2053
2049
  #
2054
2050
  # @option params [required, String] :queue_url
2055
2051
  # The URL of the queue.
@@ -2088,7 +2084,7 @@ module Aws::SQS
2088
2084
  params: params,
2089
2085
  config: config)
2090
2086
  context[:gem_name] = 'aws-sdk-sqs'
2091
- context[:gem_version] = '1.6.0'
2087
+ context[:gem_version] = '1.7.0'
2092
2088
  Seahorse::Client::Request.new(handlers, context)
2093
2089
  end
2094
2090