aws-sdk-sqs 1.0.0.rc4 → 1.0.0.rc5
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/aws-sdk-sqs.rb +1 -1
- data/lib/aws-sdk-sqs/client.rb +157 -116
- data/lib/aws-sdk-sqs/message.rb +1 -1
- data/lib/aws-sdk-sqs/queue.rb +51 -40
- data/lib/aws-sdk-sqs/resource.rb +46 -24
- data/lib/aws-sdk-sqs/types.rb +156 -100
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 9cfb3f86a80de5e76287f1b3fd9f3ab8baaf4169
|
4
|
+
data.tar.gz: b71eb818f568075f68d8852ef23c5d4c6efc691f
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: fc56069a608cb6f492cdf2085279827f54331fba5fe345ae588a54ec37af825291a65e5ffe8c1b2d101b085414282488484e35f9db3a0e5da267d6b2e8f66c7c
|
7
|
+
data.tar.gz: 9ff55b90f82b64e1886d1cba344998695c80ea8c31aded6a046acc858df2cf1a8654515da4eba1c6c5fee8021d07fbfa81bfbdbe7875fca95de9e06f22f7067e
|
data/lib/aws-sdk-sqs.rb
CHANGED
data/lib/aws-sdk-sqs/client.rb
CHANGED
@@ -339,7 +339,7 @@ module Aws::SQS
|
|
339
339
|
end
|
340
340
|
|
341
341
|
# Changes the visibility timeout of multiple messages. This is a batch
|
342
|
-
# version of ` ChangeMessageVisibility
|
342
|
+
# version of ` ChangeMessageVisibility.` The result of the action on
|
343
343
|
# each message is reported individually in the response. You can send up
|
344
344
|
# to 10 ` ChangeMessageVisibility ` requests with each
|
345
345
|
# `ChangeMessageVisibilityBatch` action.
|
@@ -405,9 +405,8 @@ module Aws::SQS
|
|
405
405
|
req.send_request(options)
|
406
406
|
end
|
407
407
|
|
408
|
-
# Creates a new standard or FIFO queue
|
409
|
-
#
|
410
|
-
# following caveats in mind:
|
408
|
+
# Creates a new standard or FIFO queue. You can pass one or more
|
409
|
+
# attributes in the request. Keep the following caveats in mind:
|
411
410
|
#
|
412
411
|
# * If you don't specify the `FifoQueue` attribute, Amazon SQS creates
|
413
412
|
# a standard queue.
|
@@ -475,27 +474,28 @@ module Aws::SQS
|
|
475
474
|
# The following lists the names, descriptions, and values of the special
|
476
475
|
# request parameters that the `CreateQueue` action uses:
|
477
476
|
#
|
478
|
-
# * `DelaySeconds` - The
|
479
|
-
# messages in the queue is delayed. Valid values: An
|
480
|
-
# 900 seconds (15 minutes). The default is 0 (zero).
|
477
|
+
# * `DelaySeconds` - The length of time, in seconds, for which the
|
478
|
+
# delivery of all messages in the queue is delayed. Valid values: An
|
479
|
+
# integer from 0 to 900 seconds (15 minutes). The default is 0 (zero).
|
481
480
|
#
|
482
481
|
# * `MaximumMessageSize` - The limit of how many bytes a message can
|
483
482
|
# contain before Amazon SQS rejects it. Valid values: An integer from
|
484
483
|
# 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). The default is
|
485
484
|
# 262,144 (256 KiB).
|
486
485
|
#
|
487
|
-
# * `MessageRetentionPeriod` - The
|
488
|
-
# SQS retains a message. Valid values: An integer from 60
|
489
|
-
# minute) to 1,209,600 seconds (14 days). The default is
|
490
|
-
# days).
|
486
|
+
# * `MessageRetentionPeriod` - The length of time, in seconds, for which
|
487
|
+
# Amazon SQS retains a message. Valid values: An integer from 60
|
488
|
+
# seconds (1 minute) to 1,209,600 seconds (14 days). The default is
|
489
|
+
# 345,600 (4 days).
|
491
490
|
#
|
492
491
|
# * `Policy` - The queue's policy. A valid AWS policy. For more
|
493
492
|
# information about policy structure, see [Overview of AWS IAM
|
494
493
|
# Policies][1] in the *Amazon IAM User Guide*.
|
495
494
|
#
|
496
|
-
# * `ReceiveMessageWaitTimeSeconds` - The
|
497
|
-
# ` ReceiveMessage ` action waits for a message to arrive.
|
498
|
-
# values: An integer from 0 to 20 (seconds). The default is 0
|
495
|
+
# * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
|
496
|
+
# for which a ` ReceiveMessage ` action waits for a message to arrive.
|
497
|
+
# Valid values: An integer from 0 to 20 (seconds). The default is 0
|
498
|
+
# (zero).
|
499
499
|
#
|
500
500
|
# * `RedrivePolicy` - The parameters for the dead letter queue
|
501
501
|
# functionality of the source queue. For more information about the
|
@@ -513,20 +513,39 @@ module Aws::SQS
|
|
513
513
|
# For more information about the visibility timeout, see [Visibility
|
514
514
|
# Timeout][3] in the *Amazon SQS Developer Guide*.
|
515
515
|
#
|
516
|
+
# The following attributes apply only to [server-side-encryption][4]\:
|
517
|
+
#
|
518
|
+
# * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
|
519
|
+
# (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
|
520
|
+
# Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
|
521
|
+
# always `alias/aws/sqs`, the alias of a custom CMK can, for example,
|
522
|
+
# be `alias/aws/sqs`. For more examples, see [KeyId][6] in the *AWS
|
523
|
+
# Key Management Service API Reference*.
|
524
|
+
#
|
525
|
+
# * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
|
526
|
+
# which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
|
527
|
+
# messages before calling AWS KMS again. An integer representing
|
528
|
+
# seconds, between 60 seconds (1 minute) and 86,400 seconds (24
|
529
|
+
# hours). The default is 300 (5 minutes). A shorter time period
|
530
|
+
# provides better security but results in more calls to KMS which
|
531
|
+
# incur charges after Free Tier. For more information, see [How Does
|
532
|
+
# the Data Key Reuse Period Work?][8].
|
533
|
+
#
|
516
534
|
# The following attributes apply only to [FIFO (first-in-first-out)
|
517
|
-
# queues][
|
535
|
+
# queues][9]\:
|
518
536
|
#
|
519
|
-
# * `FifoQueue` - Designates a queue as FIFO.
|
520
|
-
# attribute only during queue creation.
|
521
|
-
# existing queue. When you set this
|
522
|
-
# `MessageGroupId`
|
537
|
+
# * `FifoQueue` - Designates a queue as FIFO. Valid values: `true`,
|
538
|
+
# `false`. You can provide this attribute only during queue creation.
|
539
|
+
# You can't change it for an existing queue. When you set this
|
540
|
+
# attribute, you must also provide the `MessageGroupId` for your
|
541
|
+
# messages explicitly.
|
523
542
|
#
|
524
|
-
# For more information, see [FIFO Queue Logic][
|
543
|
+
# For more information, see [FIFO Queue Logic][10] in the *Amazon SQS
|
525
544
|
# Developer Guide*.
|
526
545
|
#
|
527
546
|
# * `ContentBasedDeduplication` - Enables content-based deduplication.
|
528
|
-
# For more information, see
|
529
|
-
# *Amazon SQS Developer Guide*.
|
547
|
+
# Valid values: `true`, `false`. For more information, see
|
548
|
+
# [Exactly-Once Processing][11] in the *Amazon SQS Developer Guide*.
|
530
549
|
#
|
531
550
|
# * Every message must have a unique `MessageDeduplicationId`,
|
532
551
|
#
|
@@ -550,9 +569,6 @@ module Aws::SQS
|
|
550
569
|
# treated as duplicates and only one copy of the message is
|
551
570
|
# delivered.
|
552
571
|
#
|
553
|
-
# * You can also use `ContentBasedDeduplication` for messages with
|
554
|
-
# identical content to be treated as duplicates.
|
555
|
-
#
|
556
572
|
# * If you send one message with `ContentBasedDeduplication` enabled
|
557
573
|
# and then another message with a `MessageDeduplicationId` that is
|
558
574
|
# the same as the one generated for the first
|
@@ -579,9 +595,14 @@ module Aws::SQS
|
|
579
595
|
# [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
580
596
|
# [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
|
581
597
|
# [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
|
582
|
-
# [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/
|
583
|
-
# [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/
|
584
|
-
# [6]: http://docs.aws.amazon.com/
|
598
|
+
# [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
|
599
|
+
# [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
|
600
|
+
# [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
|
601
|
+
# [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
|
602
|
+
# [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
|
603
|
+
# [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
604
|
+
# [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
|
605
|
+
# [11]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
585
606
|
#
|
586
607
|
# @return [Types::CreateQueueResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
587
608
|
#
|
@@ -625,7 +646,7 @@ module Aws::SQS
|
|
625
646
|
# but the message might not be deleted.
|
626
647
|
#
|
627
648
|
# For standard queues, it is possible to receive a message even after
|
628
|
-
# you
|
649
|
+
# you delete it. This might happen on rare occasions if one of the
|
629
650
|
# servers storing a copy of the message is unavailable when you send the
|
630
651
|
# request to delete the message. The copy remains on the server and
|
631
652
|
# might be returned to you on a subsequent receive request. You should
|
@@ -661,7 +682,7 @@ module Aws::SQS
|
|
661
682
|
end
|
662
683
|
|
663
684
|
# Deletes up to ten messages from the specified queue. This is a batch
|
664
|
-
# version of ` DeleteMessage
|
685
|
+
# version of ` DeleteMessage.` The result of the action on each message
|
665
686
|
# is reported individually in the response.
|
666
687
|
#
|
667
688
|
# Because the batch request can result in a combination of successful
|
@@ -761,6 +782,11 @@ module Aws::SQS
|
|
761
782
|
|
762
783
|
# Gets attributes for the specified queue.
|
763
784
|
#
|
785
|
+
# <note markdown="1"> To determine whether a queue is [FIFO][1], you can check whether
|
786
|
+
# `QueueName` ends with the `.fifo` suffix.
|
787
|
+
#
|
788
|
+
# </note>
|
789
|
+
#
|
764
790
|
# <note markdown="1"> Some actions take lists of parameters. These lists are specified using
|
765
791
|
# the `param.n` notation. Values of `n` are integers starting from 1.
|
766
792
|
# For example, a parameter list with two elements looks like this:
|
@@ -771,6 +797,10 @@ module Aws::SQS
|
|
771
797
|
#
|
772
798
|
# </note>
|
773
799
|
#
|
800
|
+
#
|
801
|
+
#
|
802
|
+
# [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
803
|
+
#
|
774
804
|
# @option params [required, String] :queue_url
|
775
805
|
# The URL of the Amazon SQS queue whose attribute information is
|
776
806
|
# retrieved.
|
@@ -814,15 +844,16 @@ module Aws::SQS
|
|
814
844
|
# * `MaximumMessageSize` - Returns the limit of how many bytes a message
|
815
845
|
# can contain before Amazon SQS rejects it.
|
816
846
|
#
|
817
|
-
# * `MessageRetentionPeriod` - Returns the
|
818
|
-
# Amazon SQS retains a message.
|
847
|
+
# * `MessageRetentionPeriod` - Returns the length of time, in seconds,
|
848
|
+
# for which Amazon SQS retains a message.
|
819
849
|
#
|
820
850
|
# * `Policy` - Returns the policy of the queue.
|
821
851
|
#
|
822
852
|
# * `QueueArn` - Returns the Amazon resource name (ARN) of the queue.
|
823
853
|
#
|
824
|
-
# * `ReceiveMessageWaitTimeSeconds` - Returns the
|
825
|
-
# which the `ReceiveMessage` action waits for a message
|
854
|
+
# * `ReceiveMessageWaitTimeSeconds` - Returns the length of time, in
|
855
|
+
# seconds, for which the `ReceiveMessage` action waits for a message
|
856
|
+
# to arrive.
|
826
857
|
#
|
827
858
|
# * `RedrivePolicy` - Returns the parameters for dead letter queue
|
828
859
|
# functionality of the source queue. For more information about the
|
@@ -833,16 +864,31 @@ module Aws::SQS
|
|
833
864
|
# For more information about the visibility timeout, see [Visibility
|
834
865
|
# Timeout][4] in the *Amazon SQS Developer Guide*.
|
835
866
|
#
|
867
|
+
# The following attributes apply only to [server-side-encryption][5]\:
|
868
|
+
#
|
869
|
+
# * `KmsMasterKeyId` - Returns the ID of an AWS-managed customer master
|
870
|
+
# key (CMK) for Amazon SQS or a custom CMK. For more information, see
|
871
|
+
# [Key Terms][6].
|
872
|
+
#
|
873
|
+
# * `KmsDataKeyReusePeriodSeconds` - Returns the length of time, in
|
874
|
+
# seconds, for which Amazon SQS can reuse a data key to encrypt or
|
875
|
+
# decrypt messages before calling AWS KMS again.
|
876
|
+
#
|
836
877
|
# The following attributes apply only to [FIFO (first-in-first-out)
|
837
|
-
# queues][
|
878
|
+
# queues][7]\:
|
838
879
|
#
|
839
880
|
# * `FifoQueue` - Returns whether the queue is FIFO. For more
|
840
|
-
# information, see [FIFO Queue Logic][
|
881
|
+
# information, see [FIFO Queue Logic][8] in the *Amazon SQS Developer
|
841
882
|
# Guide*.
|
842
883
|
#
|
884
|
+
# <note markdown="1"> To determine whether a queue is [FIFO][7], you can check whether
|
885
|
+
# `QueueName` ends with the `.fifo` suffix.
|
886
|
+
#
|
887
|
+
# </note>
|
888
|
+
#
|
843
889
|
# * `ContentBasedDeduplication` - Returns whether content-based
|
844
890
|
# deduplication is enabled for the queue. For more information, see
|
845
|
-
# [Exactly-Once Processing][
|
891
|
+
# [Exactly-Once Processing][9] in the *Amazon SQS Developer Guide*.
|
846
892
|
#
|
847
893
|
#
|
848
894
|
#
|
@@ -850,9 +896,11 @@ module Aws::SQS
|
|
850
896
|
# [2]: http://en.wikipedia.org/wiki/Unix_time
|
851
897
|
# [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
|
852
898
|
# [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
|
853
|
-
# [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/
|
854
|
-
# [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/
|
855
|
-
# [7]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
899
|
+
# [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
|
900
|
+
# [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
|
901
|
+
# [7]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
902
|
+
# [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
|
903
|
+
# [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
856
904
|
#
|
857
905
|
# @return [Types::GetQueueAttributesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
858
906
|
#
|
@@ -862,7 +910,7 @@ module Aws::SQS
|
|
862
910
|
#
|
863
911
|
# resp = client.get_queue_attributes({
|
864
912
|
# queue_url: "String", # required
|
865
|
-
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication
|
913
|
+
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
|
866
914
|
# })
|
867
915
|
#
|
868
916
|
# @example Response structure
|
@@ -1054,7 +1102,7 @@ module Aws::SQS
|
|
1054
1102
|
#
|
1055
1103
|
# * The message body.
|
1056
1104
|
#
|
1057
|
-
# * An MD5 digest of the message body. For information
|
1105
|
+
# * An MD5 digest of the message body. For information about MD5, see
|
1058
1106
|
# [RFC1321][2].
|
1059
1107
|
#
|
1060
1108
|
# * The `MessageId` you received when you sent the message to the queue.
|
@@ -1279,7 +1327,7 @@ module Aws::SQS
|
|
1279
1327
|
#
|
1280
1328
|
# resp = client.receive_message({
|
1281
1329
|
# queue_url: "String", # required
|
1282
|
-
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication
|
1330
|
+
# attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
|
1283
1331
|
# message_attribute_names: ["MessageAttributeName"],
|
1284
1332
|
# max_number_of_messages: 1,
|
1285
1333
|
# visibility_timeout: 1,
|
@@ -1347,27 +1395,18 @@ module Aws::SQS
|
|
1347
1395
|
|
1348
1396
|
# Delivers a message to the specified queue.
|
1349
1397
|
#
|
1350
|
-
#
|
1351
|
-
#
|
1352
|
-
#
|
1353
|
-
# * `#x9`
|
1354
|
-
#
|
1355
|
-
# * `#xA`
|
1398
|
+
# A message can include only XML, JSON, and unformatted text. The
|
1399
|
+
# following Unicode characters are allowed:
|
1356
1400
|
#
|
1357
|
-
#
|
1401
|
+
# `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
|
1402
|
+
# \| `#x10000` to `#x10FFFF`
|
1358
1403
|
#
|
1359
|
-
#
|
1404
|
+
# Any characters not included in this list will be rejected. For more
|
1405
|
+
# information, see the [W3C specification for characters][1].
|
1360
1406
|
#
|
1361
|
-
# * `#xE000` to `#xFFFD`
|
1362
1407
|
#
|
1363
|
-
# * `#x10000` to `#x10FFFF`
|
1364
1408
|
#
|
1365
|
-
#
|
1366
|
-
# that aren't included in this list, your request is rejected.
|
1367
|
-
#
|
1368
|
-
#
|
1369
|
-
#
|
1370
|
-
# [1]: https://www.ietf.org/rfc/rfc1321.txt
|
1409
|
+
# [1]: http://www.w3.org/TR/REC-xml/#charsets
|
1371
1410
|
#
|
1372
1411
|
# @option params [required, String] :queue_url
|
1373
1412
|
# The URL of the Amazon SQS queue to which a message is sent.
|
@@ -1377,34 +1416,25 @@ module Aws::SQS
|
|
1377
1416
|
# @option params [required, String] :message_body
|
1378
1417
|
# The message to send. The maximum string size is 256 KB.
|
1379
1418
|
#
|
1380
|
-
#
|
1381
|
-
#
|
1382
|
-
#
|
1383
|
-
# * `#x9`
|
1384
|
-
#
|
1385
|
-
# * `#xA`
|
1419
|
+
# A message can include only XML, JSON, and unformatted text. The
|
1420
|
+
# following Unicode characters are allowed:
|
1386
1421
|
#
|
1387
|
-
#
|
1422
|
+
# `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
|
1423
|
+
# \| `#x10000` to `#x10FFFF`
|
1388
1424
|
#
|
1389
|
-
#
|
1425
|
+
# Any characters not included in this list will be rejected. For more
|
1426
|
+
# information, see the [W3C specification for characters][1].
|
1390
1427
|
#
|
1391
|
-
# * `#xE000` to `#xFFFD`
|
1392
1428
|
#
|
1393
|
-
# * `#x10000` to `#x10FFFF`
|
1394
1429
|
#
|
1395
|
-
#
|
1396
|
-
# that aren't included in this list, your request is rejected.
|
1397
|
-
#
|
1398
|
-
#
|
1399
|
-
#
|
1400
|
-
# [1]: https://www.ietf.org/rfc/rfc1321.txt
|
1430
|
+
# [1]: http://www.w3.org/TR/REC-xml/#charsets
|
1401
1431
|
#
|
1402
1432
|
# @option params [Integer] :delay_seconds
|
1403
|
-
# The
|
1404
|
-
# 900. Maximum: 15 minutes. Messages with a positive
|
1405
|
-
# value become available for processing after the delay
|
1406
|
-
# finished. If you don't specify a value, the default value
|
1407
|
-
# queue applies.
|
1433
|
+
# The length of time, in seconds, for which to delay a specific message.
|
1434
|
+
# Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive
|
1435
|
+
# `DelaySeconds` value become available for processing after the delay
|
1436
|
+
# period is finished. If you don't specify a value, the default value
|
1437
|
+
# for the queue applies.
|
1408
1438
|
#
|
1409
1439
|
# <note markdown="1"> When you set `FifoQueue`, you can't set `DelaySeconds` per message.
|
1410
1440
|
# You can set this parameter only on a queue level.
|
@@ -1450,9 +1480,6 @@ module Aws::SQS
|
|
1450
1480
|
# identical content sent within the deduplication interval are treated
|
1451
1481
|
# as duplicates and only one copy of the message is delivered.
|
1452
1482
|
#
|
1453
|
-
# * You can also use `ContentBasedDeduplication` for messages with
|
1454
|
-
# identical content to be treated as duplicates.
|
1455
|
-
#
|
1456
1483
|
# * If you send one message with `ContentBasedDeduplication` enabled and
|
1457
1484
|
# then another message with a `MessageDeduplicationId` that is the
|
1458
1485
|
# same as the one generated for the first `MessageDeduplicationId`,
|
@@ -1509,6 +1536,9 @@ module Aws::SQS
|
|
1509
1536
|
# MessageGroupId Property][1] in the *Amazon Simple Queue Service
|
1510
1537
|
# Developer Guide*.
|
1511
1538
|
#
|
1539
|
+
# `MessageGroupId` is required for FIFO queues. You can't use it for
|
1540
|
+
# Standard queues.
|
1541
|
+
#
|
1512
1542
|
#
|
1513
1543
|
#
|
1514
1544
|
# [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property
|
@@ -1556,7 +1586,7 @@ module Aws::SQS
|
|
1556
1586
|
end
|
1557
1587
|
|
1558
1588
|
# Delivers up to ten messages to the specified queue. This is a batch
|
1559
|
-
# version of ` SendMessage
|
1589
|
+
# version of ` SendMessage.` For a FIFO queue, multiple messages within
|
1560
1590
|
# a single batch are enqueued in the order they are sent.
|
1561
1591
|
#
|
1562
1592
|
# The result of sending each message is reported individually in the
|
@@ -1568,23 +1598,14 @@ module Aws::SQS
|
|
1568
1598
|
# payload size (the sum of the individual lengths of all of the batched
|
1569
1599
|
# messages) are both 256 KB (262,144 bytes).
|
1570
1600
|
#
|
1571
|
-
#
|
1572
|
-
#
|
1601
|
+
# A message can include only XML, JSON, and unformatted text. The
|
1602
|
+
# following Unicode characters are allowed:
|
1573
1603
|
#
|
1574
|
-
#
|
1604
|
+
# `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
|
1605
|
+
# \| `#x10000` to `#x10FFFF`
|
1575
1606
|
#
|
1576
|
-
#
|
1577
|
-
#
|
1578
|
-
# * `#xD`
|
1579
|
-
#
|
1580
|
-
# * `#x20` to `#xD7FF`
|
1581
|
-
#
|
1582
|
-
# * `#xE000` to `#xFFFD`
|
1583
|
-
#
|
1584
|
-
# * `#x10000` to `#x10FFFF`
|
1585
|
-
#
|
1586
|
-
# For more information, see [RFC1321][1]. If you send any characters
|
1587
|
-
# that aren't included in this list, your request is rejected.
|
1607
|
+
# Any characters not included in this list will be rejected. For more
|
1608
|
+
# information, see the [W3C specification for characters][1].
|
1588
1609
|
#
|
1589
1610
|
# If you don't specify the `DelaySeconds` parameter for an entry,
|
1590
1611
|
# Amazon SQS uses the default value for the queue.
|
@@ -1601,7 +1622,7 @@ module Aws::SQS
|
|
1601
1622
|
#
|
1602
1623
|
#
|
1603
1624
|
#
|
1604
|
-
# [1]:
|
1625
|
+
# [1]: http://www.w3.org/TR/REC-xml/#charsets
|
1605
1626
|
#
|
1606
1627
|
# @option params [required, String] :queue_url
|
1607
1628
|
# The URL of the Amazon SQS queue to which batched messages are sent.
|
@@ -1686,17 +1707,17 @@ module Aws::SQS
|
|
1686
1707
|
# The following lists the names, descriptions, and values of the special
|
1687
1708
|
# request parameters that the `SetQueueAttributes` action uses:
|
1688
1709
|
#
|
1689
|
-
# * `DelaySeconds` - The
|
1690
|
-
# messages in the queue is delayed. Valid values: An
|
1691
|
-
# 900 (15 minutes). The default is 0 (zero).
|
1710
|
+
# * `DelaySeconds` - The length of time, in seconds, for which the
|
1711
|
+
# delivery of all messages in the queue is delayed. Valid values: An
|
1712
|
+
# integer from 0 to 900 (15 minutes). The default is 0 (zero).
|
1692
1713
|
#
|
1693
1714
|
# * `MaximumMessageSize` - The limit of how many bytes a message can
|
1694
1715
|
# contain before Amazon SQS rejects it. Valid values: An integer from
|
1695
1716
|
# 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). The default is
|
1696
1717
|
# 262,144 (256 KiB).
|
1697
1718
|
#
|
1698
|
-
# * `MessageRetentionPeriod` - The
|
1699
|
-
# SQS retains a message. Valid values: An integer representing
|
1719
|
+
# * `MessageRetentionPeriod` - The length of time, in seconds, for which
|
1720
|
+
# Amazon SQS retains a message. Valid values: An integer representing
|
1700
1721
|
# seconds, from 60 (1 minute) to 1,209,600 (14 days). The default is
|
1701
1722
|
# 345,600 (4 days).
|
1702
1723
|
#
|
@@ -1704,9 +1725,9 @@ module Aws::SQS
|
|
1704
1725
|
# information about policy structure, see [Overview of AWS IAM
|
1705
1726
|
# Policies][1] in the *Amazon IAM User Guide*.
|
1706
1727
|
#
|
1707
|
-
# * `ReceiveMessageWaitTimeSeconds` - The
|
1708
|
-
# ` ReceiveMessage ` action waits for a message to arrive.
|
1709
|
-
# values: an integer from 0 to 20 (seconds). The default is 0.
|
1728
|
+
# * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
|
1729
|
+
# for which a ` ReceiveMessage ` action waits for a message to arrive.
|
1730
|
+
# Valid values: an integer from 0 to 20 (seconds). The default is 0.
|
1710
1731
|
#
|
1711
1732
|
# * `RedrivePolicy` - The parameters for the dead letter queue
|
1712
1733
|
# functionality of the source queue. For more information about the
|
@@ -1724,11 +1745,29 @@ module Aws::SQS
|
|
1724
1745
|
# For more information about the visibility timeout, see [Visibility
|
1725
1746
|
# Timeout][3] in the *Amazon SQS Developer Guide*.
|
1726
1747
|
#
|
1748
|
+
# The following attributes apply only to [server-side-encryption][4]\:
|
1749
|
+
#
|
1750
|
+
# * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
|
1751
|
+
# (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
|
1752
|
+
# Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
|
1753
|
+
# always `alias/aws/sqs`, the alias of a custom CMK can, for example,
|
1754
|
+
# be `alias/aws/sqs`. For more examples, see [KeyId][6] in the *AWS
|
1755
|
+
# Key Management Service API Reference*.
|
1756
|
+
#
|
1757
|
+
# * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
|
1758
|
+
# which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
|
1759
|
+
# messages before calling AWS KMS again. An integer representing
|
1760
|
+
# seconds, between 60 seconds (1 minute) and 86,400 seconds (24
|
1761
|
+
# hours). The default is 300 (5 minutes). A shorter time period
|
1762
|
+
# provides better security but results in more calls to KMS which
|
1763
|
+
# incur charges after Free Tier. For more information, see [How Does
|
1764
|
+
# the Data Key Reuse Period Work?][8].
|
1765
|
+
#
|
1727
1766
|
# The following attribute applies only to [FIFO (first-in-first-out)
|
1728
|
-
# queues][
|
1767
|
+
# queues][9]\:
|
1729
1768
|
#
|
1730
1769
|
# * `ContentBasedDeduplication` - Enables content-based deduplication.
|
1731
|
-
# For more information, see [Exactly-Once Processing][
|
1770
|
+
# For more information, see [Exactly-Once Processing][10] in the
|
1732
1771
|
# *Amazon SQS Developer Guide*.
|
1733
1772
|
#
|
1734
1773
|
# * Every message must have a unique `MessageDeduplicationId`,
|
@@ -1753,9 +1792,6 @@ module Aws::SQS
|
|
1753
1792
|
# treated as duplicates and only one copy of the message is
|
1754
1793
|
# delivered.
|
1755
1794
|
#
|
1756
|
-
# * You can also use `ContentBasedDeduplication` for messages with
|
1757
|
-
# identical content to be treated as duplicates.
|
1758
|
-
#
|
1759
1795
|
# * If you send one message with `ContentBasedDeduplication` enabled
|
1760
1796
|
# and then another message with a `MessageDeduplicationId` that is
|
1761
1797
|
# the same as the one generated for the first
|
@@ -1782,8 +1818,13 @@ module Aws::SQS
|
|
1782
1818
|
# [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
|
1783
1819
|
# [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
|
1784
1820
|
# [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
|
1785
|
-
# [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/
|
1786
|
-
# [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/
|
1821
|
+
# [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
|
1822
|
+
# [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
|
1823
|
+
# [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
|
1824
|
+
# [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
|
1825
|
+
# [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
|
1826
|
+
# [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
|
1827
|
+
# [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
|
1787
1828
|
#
|
1788
1829
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
1789
1830
|
#
|
@@ -1818,7 +1859,7 @@ module Aws::SQS
|
|
1818
1859
|
params: params,
|
1819
1860
|
config: config)
|
1820
1861
|
context[:gem_name] = 'aws-sdk-sqs'
|
1821
|
-
context[:gem_version] = '1.0.0.
|
1862
|
+
context[:gem_version] = '1.0.0.rc5'
|
1822
1863
|
Seahorse::Client::Request.new(handlers, context)
|
1823
1864
|
end
|
1824
1865
|
|