aws-sdk-sqs 1.0.0.rc4 → 1.0.0.rc5
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 +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
|
|