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.
@@ -73,7 +73,7 @@ module Aws::SQS
73
73
  # An MD5 digest of the non-URL-encoded message attribute string. You can
74
74
  # use this attribute to verify that Amazon SQS received the message
75
75
  # correctly. Amazon SQS URL-decodes the message before creating the MD5
76
- # digest. For information on MD5, see [RFC1321][1].
76
+ # digest. For information about MD5, see [RFC1321][1].
77
77
  #
78
78
  #
79
79
  #
@@ -204,7 +204,7 @@ module Aws::SQS
204
204
  # @example Request syntax with placeholder values
205
205
  #
206
206
  # message = queue.receive_messages({
207
- # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication
207
+ # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
208
208
  # message_attribute_names: ["MessageAttributeName"],
209
209
  # max_number_of_messages: 1,
210
210
  # visibility_timeout: 1,
@@ -431,33 +431,24 @@ module Aws::SQS
431
431
  # @option options [required, String] :message_body
432
432
  # The message to send. The maximum string size is 256 KB.
433
433
  #
434
- # The following list shows the characters (in Unicode) that are allowed
435
- # in your message, according to the W3C XML specification:
434
+ # A message can include only XML, JSON, and unformatted text. The
435
+ # following Unicode characters are allowed:
436
436
  #
437
- # * `#x9`
437
+ # `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to `#xFFFD`
438
+ # \| `#x10000` to `#x10FFFF`
438
439
  #
439
- # * `#xA`
440
+ # Any characters not included in this list will be rejected. For more
441
+ # information, see the [W3C specification for characters][1].
440
442
  #
441
- # * `#xD`
442
443
  #
443
- # * `#x20` to `#xD7FF`
444
444
  #
445
- # * `#xE000` to `#xFFFD`
446
- #
447
- # * `#x10000` to `#x10FFFF`
448
- #
449
- # For more information, see [RFC1321][1]. If you send any characters
450
- # that aren't included in this list, your request is rejected.
451
- #
452
- #
453
- #
454
- # [1]: https://www.ietf.org/rfc/rfc1321.txt
445
+ # [1]: http://www.w3.org/TR/REC-xml/#charsets
455
446
  # @option options [Integer] :delay_seconds
456
- # The number of seconds to delay a specific message. Valid values: 0 to
457
- # 900. Maximum: 15 minutes. Messages with a positive `DelaySeconds`
458
- # value become available for processing after the delay period is
459
- # finished. If you don't specify a value, the default value for the
460
- # queue applies.
447
+ # The length of time, in seconds, for which to delay a specific message.
448
+ # Valid values: 0 to 900. Maximum: 15 minutes. Messages with a positive
449
+ # `DelaySeconds` value become available for processing after the delay
450
+ # period is finished. If you don't specify a value, the default value
451
+ # for the queue applies.
461
452
  #
462
453
  # <note markdown="1"> When you set `FifoQueue`, you can't set `DelaySeconds` per message.
463
454
  # You can set this parameter only on a queue level.
@@ -501,9 +492,6 @@ module Aws::SQS
501
492
  # identical content sent within the deduplication interval are treated
502
493
  # as duplicates and only one copy of the message is delivered.
503
494
  #
504
- # * You can also use `ContentBasedDeduplication` for messages with
505
- # identical content to be treated as duplicates.
506
- #
507
495
  # * If you send one message with `ContentBasedDeduplication` enabled and
508
496
  # then another message with a `MessageDeduplicationId` that is the
509
497
  # same as the one generated for the first `MessageDeduplicationId`,
@@ -559,6 +547,9 @@ module Aws::SQS
559
547
  # MessageGroupId Property][1] in the *Amazon Simple Queue Service
560
548
  # Developer Guide*.
561
549
  #
550
+ # `MessageGroupId` is required for FIFO queues. You can't use it for
551
+ # Standard queues.
552
+ #
562
553
  #
563
554
  #
564
555
  # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property
@@ -615,17 +606,17 @@ module Aws::SQS
615
606
  # The following lists the names, descriptions, and values of the special
616
607
  # request parameters that the `SetQueueAttributes` action uses:
617
608
  #
618
- # * `DelaySeconds` - The number of seconds for which the delivery of all
619
- # messages in the queue is delayed. Valid values: An integer from 0 to
620
- # 900 (15 minutes). The default is 0 (zero).
609
+ # * `DelaySeconds` - The length of time, in seconds, for which the
610
+ # delivery of all messages in the queue is delayed. Valid values: An
611
+ # integer from 0 to 900 (15 minutes). The default is 0 (zero).
621
612
  #
622
613
  # * `MaximumMessageSize` - The limit of how many bytes a message can
623
614
  # contain before Amazon SQS rejects it. Valid values: An integer from
624
615
  # 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). The default is
625
616
  # 262,144 (256 KiB).
626
617
  #
627
- # * `MessageRetentionPeriod` - The number of seconds for which Amazon
628
- # SQS retains a message. Valid values: An integer representing
618
+ # * `MessageRetentionPeriod` - The length of time, in seconds, for which
619
+ # Amazon SQS retains a message. Valid values: An integer representing
629
620
  # seconds, from 60 (1 minute) to 1,209,600 (14 days). The default is
630
621
  # 345,600 (4 days).
631
622
  #
@@ -633,9 +624,9 @@ module Aws::SQS
633
624
  # information about policy structure, see [Overview of AWS IAM
634
625
  # Policies][1] in the *Amazon IAM User Guide*.
635
626
  #
636
- # * `ReceiveMessageWaitTimeSeconds` - The number of seconds for which a
637
- # ` ReceiveMessage ` action waits for a message to arrive. Valid
638
- # values: an integer from 0 to 20 (seconds). The default is 0.
627
+ # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
628
+ # for which a ` ReceiveMessage ` action waits for a message to arrive.
629
+ # Valid values: an integer from 0 to 20 (seconds). The default is 0.
639
630
  #
640
631
  # * `RedrivePolicy` - The parameters for the dead letter queue
641
632
  # functionality of the source queue. For more information about the
@@ -653,11 +644,29 @@ module Aws::SQS
653
644
  # For more information about the visibility timeout, see [Visibility
654
645
  # Timeout][3] in the *Amazon SQS Developer Guide*.
655
646
  #
647
+ # The following attributes apply only to [server-side-encryption][4]\:
648
+ #
649
+ # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
650
+ # (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
651
+ # Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
652
+ # always `alias/aws/sqs`, the alias of a custom CMK can, for example,
653
+ # be `alias/aws/sqs`. For more examples, see [KeyId][6] in the *AWS
654
+ # Key Management Service API Reference*.
655
+ #
656
+ # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
657
+ # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
658
+ # messages before calling AWS KMS again. An integer representing
659
+ # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
660
+ # hours). The default is 300 (5 minutes). A shorter time period
661
+ # provides better security but results in more calls to KMS which
662
+ # incur charges after Free Tier. For more information, see [How Does
663
+ # the Data Key Reuse Period Work?][8].
664
+ #
656
665
  # The following attribute applies only to [FIFO (first-in-first-out)
657
- # queues][4]\:
666
+ # queues][9]\:
658
667
  #
659
668
  # * `ContentBasedDeduplication` - Enables content-based deduplication.
660
- # For more information, see [Exactly-Once Processing][5] in the
669
+ # For more information, see [Exactly-Once Processing][10] in the
661
670
  # *Amazon SQS Developer Guide*.
662
671
  #
663
672
  # * Every message must have a unique `MessageDeduplicationId`,
@@ -682,9 +691,6 @@ module Aws::SQS
682
691
  # treated as duplicates and only one copy of the message is
683
692
  # delivered.
684
693
  #
685
- # * You can also use `ContentBasedDeduplication` for messages with
686
- # identical content to be treated as duplicates.
687
- #
688
694
  # * If you send one message with `ContentBasedDeduplication` enabled
689
695
  # and then another message with a `MessageDeduplicationId` that is
690
696
  # the same as the one generated for the first
@@ -711,8 +717,13 @@ module Aws::SQS
711
717
  # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
712
718
  # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
713
719
  # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
714
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
715
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
720
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
721
+ # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
722
+ # [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
723
+ # [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
724
+ # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
725
+ # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
726
+ # [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
716
727
  # @return [EmptyStructure]
717
728
  def set_attributes(options = {})
718
729
  options = options.merge(queue_url: @url)
@@ -47,27 +47,28 @@ module Aws::SQS
47
47
  # The following lists the names, descriptions, and values of the special
48
48
  # request parameters that the `CreateQueue` action uses:
49
49
  #
50
- # * `DelaySeconds` - The number of seconds for which the delivery of all
51
- # messages in the queue is delayed. Valid values: An integer from 0 to
52
- # 900 seconds (15 minutes). The default is 0 (zero).
50
+ # * `DelaySeconds` - The length of time, in seconds, for which the
51
+ # delivery of all messages in the queue is delayed. Valid values: An
52
+ # integer from 0 to 900 seconds (15 minutes). The default is 0 (zero).
53
53
  #
54
54
  # * `MaximumMessageSize` - The limit of how many bytes a message can
55
55
  # contain before Amazon SQS rejects it. Valid values: An integer from
56
56
  # 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). The default is
57
57
  # 262,144 (256 KiB).
58
58
  #
59
- # * `MessageRetentionPeriod` - The number of seconds for which Amazon
60
- # SQS retains a message. Valid values: An integer from 60 seconds (1
61
- # minute) to 1,209,600 seconds (14 days). The default is 345,600 (4
62
- # days).
59
+ # * `MessageRetentionPeriod` - The length of time, in seconds, for which
60
+ # Amazon SQS retains a message. Valid values: An integer from 60
61
+ # seconds (1 minute) to 1,209,600 seconds (14 days). The default is
62
+ # 345,600 (4 days).
63
63
  #
64
64
  # * `Policy` - The queue's policy. A valid AWS policy. For more
65
65
  # information about policy structure, see [Overview of AWS IAM
66
66
  # Policies][1] in the *Amazon IAM User Guide*.
67
67
  #
68
- # * `ReceiveMessageWaitTimeSeconds` - The number of seconds for which a
69
- # ` ReceiveMessage ` action waits for a message to arrive. Valid
70
- # values: An integer from 0 to 20 (seconds). The default is 0 (zero).
68
+ # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
69
+ # for which a ` ReceiveMessage ` action waits for a message to arrive.
70
+ # Valid values: An integer from 0 to 20 (seconds). The default is 0
71
+ # (zero).
71
72
  #
72
73
  # * `RedrivePolicy` - The parameters for the dead letter queue
73
74
  # functionality of the source queue. For more information about the
@@ -85,20 +86,39 @@ module Aws::SQS
85
86
  # For more information about the visibility timeout, see [Visibility
86
87
  # Timeout][3] in the *Amazon SQS Developer Guide*.
87
88
  #
89
+ # The following attributes apply only to [server-side-encryption][4]\:
90
+ #
91
+ # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
92
+ # (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
93
+ # Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
94
+ # always `alias/aws/sqs`, the alias of a custom CMK can, for example,
95
+ # be `alias/aws/sqs`. For more examples, see [KeyId][6] in the *AWS
96
+ # Key Management Service API Reference*.
97
+ #
98
+ # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
99
+ # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
100
+ # messages before calling AWS KMS again. An integer representing
101
+ # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
102
+ # hours). The default is 300 (5 minutes). A shorter time period
103
+ # provides better security but results in more calls to KMS which
104
+ # incur charges after Free Tier. For more information, see [How Does
105
+ # the Data Key Reuse Period Work?][8].
106
+ #
88
107
  # The following attributes apply only to [FIFO (first-in-first-out)
89
- # queues][4]\:
108
+ # queues][9]\:
90
109
  #
91
- # * `FifoQueue` - Designates a queue as FIFO. You can provide this
92
- # attribute only during queue creation. You can't change it for an
93
- # existing queue. When you set this attribute, you must provide a
94
- # `MessageGroupId` explicitly.
110
+ # * `FifoQueue` - Designates a queue as FIFO. Valid values: `true`,
111
+ # `false`. You can provide this attribute only during queue creation.
112
+ # You can't change it for an existing queue. When you set this
113
+ # attribute, you must also provide the `MessageGroupId` for your
114
+ # messages explicitly.
95
115
  #
96
- # For more information, see [FIFO Queue Logic][5] in the *Amazon SQS
116
+ # For more information, see [FIFO Queue Logic][10] in the *Amazon SQS
97
117
  # Developer Guide*.
98
118
  #
99
119
  # * `ContentBasedDeduplication` - Enables content-based deduplication.
100
- # For more information, see [Exactly-Once Processing][6] in the
101
- # *Amazon SQS Developer Guide*.
120
+ # Valid values: `true`, `false`. For more information, see
121
+ # [Exactly-Once Processing][11] in the *Amazon SQS Developer Guide*.
102
122
  #
103
123
  # * Every message must have a unique `MessageDeduplicationId`,
104
124
  #
@@ -122,9 +142,6 @@ module Aws::SQS
122
142
  # treated as duplicates and only one copy of the message is
123
143
  # delivered.
124
144
  #
125
- # * You can also use `ContentBasedDeduplication` for messages with
126
- # identical content to be treated as duplicates.
127
- #
128
145
  # * If you send one message with `ContentBasedDeduplication` enabled
129
146
  # and then another message with a `MessageDeduplicationId` that is
130
147
  # the same as the one generated for the first
@@ -151,9 +168,14 @@ module Aws::SQS
151
168
  # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
152
169
  # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
153
170
  # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
154
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
155
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
156
- # [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
171
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
172
+ # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
173
+ # [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
174
+ # [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
175
+ # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
176
+ # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
177
+ # [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
178
+ # [11]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
157
179
  # @return [Queue]
158
180
  def create_queue(options = {})
159
181
  resp = @client.create_queue(options)
@@ -150,7 +150,7 @@ module Aws::SQS
150
150
  end
151
151
 
152
152
  # Encloses a receipt handle and an entry id for each message in `
153
- # ChangeMessageVisibilityBatch `.
153
+ # ChangeMessageVisibilityBatch.`
154
154
  #
155
155
  # All of the following list parameters must be prefixed with
156
156
  # `ChangeMessageVisibilityBatchRequestEntry.n`, where `n` is an integer
@@ -218,7 +218,7 @@ module Aws::SQS
218
218
  include Aws::Structure
219
219
  end
220
220
 
221
- # Encloses the `Id` of an entry in ` ChangeMessageVisibilityBatch `.
221
+ # Encloses the `Id` of an entry in ` ChangeMessageVisibilityBatch.`
222
222
  #
223
223
  # @!attribute [rw] id
224
224
  # Represents a message whose visibility timeout has been changed
@@ -297,28 +297,29 @@ module Aws::SQS
297
297
  # The following lists the names, descriptions, and values of the
298
298
  # special request parameters that the `CreateQueue` action uses:
299
299
  #
300
- # * `DelaySeconds` - The number of seconds for which the delivery of
301
- # all messages in the queue is delayed. Valid values: An integer
302
- # from 0 to 900 seconds (15 minutes). The default is 0 (zero).
300
+ # * `DelaySeconds` - The length of time, in seconds, for which the
301
+ # delivery of all messages in the queue is delayed. Valid values: An
302
+ # integer from 0 to 900 seconds (15 minutes). The default is 0
303
+ # (zero).
303
304
  #
304
305
  # * `MaximumMessageSize` - The limit of how many bytes a message can
305
306
  # contain before Amazon SQS rejects it. Valid values: An integer
306
307
  # from 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). The default
307
308
  # is 262,144 (256 KiB).
308
309
  #
309
- # * `MessageRetentionPeriod` - The number of seconds for which Amazon
310
- # SQS retains a message. Valid values: An integer from 60 seconds (1
311
- # minute) to 1,209,600 seconds (14 days). The default is 345,600 (4
312
- # days).
310
+ # * `MessageRetentionPeriod` - The length of time, in seconds, for
311
+ # which Amazon SQS retains a message. Valid values: An integer from
312
+ # 60 seconds (1 minute) to 1,209,600 seconds (14 days). The default
313
+ # is 345,600 (4 days).
313
314
  #
314
315
  # * `Policy` - The queue's policy. A valid AWS policy. For more
315
316
  # information about policy structure, see [Overview of AWS IAM
316
317
  # Policies][1] in the *Amazon IAM User Guide*.
317
318
  #
318
- # * `ReceiveMessageWaitTimeSeconds` - The number of seconds for which
319
- # a ` ReceiveMessage ` action waits for a message to arrive. Valid
320
- # values: An integer from 0 to 20 (seconds). The default is 0
321
- # (zero).
319
+ # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
320
+ # for which a ` ReceiveMessage ` action waits for a message to
321
+ # arrive. Valid values: An integer from 0 to 20 (seconds). The
322
+ # default is 0 (zero).
322
323
  #
323
324
  # * `RedrivePolicy` - The parameters for the dead letter queue
324
325
  # functionality of the source queue. For more information about the
@@ -336,20 +337,39 @@ module Aws::SQS
336
337
  # For more information about the visibility timeout, see [Visibility
337
338
  # Timeout][3] in the *Amazon SQS Developer Guide*.
338
339
  #
340
+ # The following attributes apply only to [server-side-encryption][4]\:
341
+ #
342
+ # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
343
+ # (CMK) for Amazon SQS or a custom CMK. For more information, see
344
+ # [Key Terms][5]. While the alias of the AWS-managed CMK for Amazon
345
+ # SQS is always `alias/aws/sqs`, the alias of a custom CMK can, for
346
+ # example, be `alias/aws/sqs`. For more examples, see [KeyId][6] in
347
+ # the *AWS Key Management Service API Reference*.
348
+ #
349
+ # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds,
350
+ # for which Amazon SQS can reuse a [data key][7] to encrypt or
351
+ # decrypt messages before calling AWS KMS again. An integer
352
+ # representing seconds, between 60 seconds (1 minute) and 86,400
353
+ # seconds (24 hours). The default is 300 (5 minutes). A shorter time
354
+ # period provides better security but results in more calls to KMS
355
+ # which incur charges after Free Tier. For more information, see
356
+ # [How Does the Data Key Reuse Period Work?][8].
357
+ #
339
358
  # The following attributes apply only to [FIFO (first-in-first-out)
340
- # queues][4]\:
359
+ # queues][9]\:
341
360
  #
342
- # * `FifoQueue` - Designates a queue as FIFO. You can provide this
343
- # attribute only during queue creation. You can't change it for an
344
- # existing queue. When you set this attribute, you must provide a
345
- # `MessageGroupId` explicitly.
361
+ # * `FifoQueue` - Designates a queue as FIFO. Valid values: `true`,
362
+ # `false`. You can provide this attribute only during queue
363
+ # creation. You can't change it for an existing queue. When you set
364
+ # this attribute, you must also provide the `MessageGroupId` for
365
+ # your messages explicitly.
346
366
  #
347
- # For more information, see [FIFO Queue Logic][5] in the *Amazon SQS
348
- # Developer Guide*.
367
+ # For more information, see [FIFO Queue Logic][10] in the *Amazon
368
+ # SQS Developer Guide*.
349
369
  #
350
370
  # * `ContentBasedDeduplication` - Enables content-based deduplication.
351
- # For more information, see [Exactly-Once Processing][6] in the
352
- # *Amazon SQS Developer Guide*.
371
+ # Valid values: `true`, `false`. For more information, see
372
+ # [Exactly-Once Processing][11] in the *Amazon SQS Developer Guide*.
353
373
  #
354
374
  # * Every message must have a unique `MessageDeduplicationId`,
355
375
  #
@@ -373,9 +393,6 @@ module Aws::SQS
373
393
  # treated as duplicates and only one copy of the message is
374
394
  # delivered.
375
395
  #
376
- # * You can also use `ContentBasedDeduplication` for messages with
377
- # identical content to be treated as duplicates.
378
- #
379
396
  # * If you send one message with `ContentBasedDeduplication` enabled
380
397
  # and then another message with a `MessageDeduplicationId` that is
381
398
  # the same as the one generated for the first
@@ -402,9 +419,14 @@ module Aws::SQS
402
419
  # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
403
420
  # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
404
421
  # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
405
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
406
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
407
- # [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
422
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
423
+ # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
424
+ # [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
425
+ # [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
426
+ # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
427
+ # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
428
+ # [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
429
+ # [11]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
408
430
  # @return [Hash<String,String>]
409
431
  #
410
432
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/CreateQueueRequest AWS API Documentation
@@ -510,7 +532,7 @@ module Aws::SQS
510
532
  include Aws::Structure
511
533
  end
512
534
 
513
- # Encloses the `Id` of an entry in ` DeleteMessageBatch `.
535
+ # Encloses the `Id` of an entry in ` DeleteMessageBatch.`
514
536
  #
515
537
  # @!attribute [rw] id
516
538
  # Represents a successfully deleted message.
@@ -574,7 +596,7 @@ module Aws::SQS
574
596
  #
575
597
  # {
576
598
  # queue_url: "String", # required
577
- # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication
599
+ # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
578
600
  # }
579
601
  #
580
602
  # @!attribute [rw] queue_url
@@ -622,16 +644,16 @@ module Aws::SQS
622
644
  # * `MaximumMessageSize` - Returns the limit of how many bytes a
623
645
  # message can contain before Amazon SQS rejects it.
624
646
  #
625
- # * `MessageRetentionPeriod` - Returns the number of seconds for which
626
- # Amazon SQS retains a message.
647
+ # * `MessageRetentionPeriod` - Returns the length of time, in seconds,
648
+ # for which Amazon SQS retains a message.
627
649
  #
628
650
  # * `Policy` - Returns the policy of the queue.
629
651
  #
630
652
  # * `QueueArn` - Returns the Amazon resource name (ARN) of the queue.
631
653
  #
632
- # * `ReceiveMessageWaitTimeSeconds` - Returns the number of seconds
633
- # for which the `ReceiveMessage` action waits for a message to
634
- # arrive.
654
+ # * `ReceiveMessageWaitTimeSeconds` - Returns the length of time, in
655
+ # seconds, for which the `ReceiveMessage` action waits for a message
656
+ # to arrive.
635
657
  #
636
658
  # * `RedrivePolicy` - Returns the parameters for dead letter queue
637
659
  # functionality of the source queue. For more information about the
@@ -642,16 +664,31 @@ module Aws::SQS
642
664
  # queue. For more information about the visibility timeout, see
643
665
  # [Visibility Timeout][4] in the *Amazon SQS Developer Guide*.
644
666
  #
667
+ # The following attributes apply only to [server-side-encryption][5]\:
668
+ #
669
+ # * `KmsMasterKeyId` - Returns the ID of an AWS-managed customer
670
+ # master key (CMK) for Amazon SQS or a custom CMK. For more
671
+ # information, see [Key Terms][6].
672
+ #
673
+ # * `KmsDataKeyReusePeriodSeconds` - Returns the length of time, in
674
+ # seconds, for which Amazon SQS can reuse a data key to encrypt or
675
+ # decrypt messages before calling AWS KMS again.
676
+ #
645
677
  # The following attributes apply only to [FIFO (first-in-first-out)
646
- # queues][5]\:
678
+ # queues][7]\:
647
679
  #
648
680
  # * `FifoQueue` - Returns whether the queue is FIFO. For more
649
- # information, see [FIFO Queue Logic][6] in the *Amazon SQS
681
+ # information, see [FIFO Queue Logic][8] in the *Amazon SQS
650
682
  # Developer Guide*.
651
683
  #
684
+ # <note markdown="1"> To determine whether a queue is [FIFO][7], you can check whether
685
+ # `QueueName` ends with the `.fifo` suffix.
686
+ #
687
+ # </note>
688
+ #
652
689
  # * `ContentBasedDeduplication` - Returns whether content-based
653
690
  # deduplication is enabled for the queue. For more information, see
654
- # [Exactly-Once Processing][7] in the *Amazon SQS Developer Guide*.
691
+ # [Exactly-Once Processing][9] in the *Amazon SQS Developer Guide*.
655
692
  #
656
693
  #
657
694
  #
@@ -659,9 +696,11 @@ module Aws::SQS
659
696
  # [2]: http://en.wikipedia.org/wiki/Unix_time
660
697
  # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
661
698
  # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
662
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
663
- # [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
664
- # [7]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
699
+ # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
700
+ # [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
701
+ # [7]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
702
+ # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
703
+ # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
665
704
  # @return [Array<String>]
666
705
  #
667
706
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/GetQueueAttributesRequest AWS API Documentation
@@ -836,7 +875,8 @@ module Aws::SQS
836
875
  # An MD5 digest of the non-URL-encoded message attribute string. You
837
876
  # can use this attribute to verify that Amazon SQS received the
838
877
  # message correctly. Amazon SQS URL-decodes the message before
839
- # creating the MD5 digest. For information on MD5, see [RFC1321][1].
878
+ # creating the MD5 digest. For information about MD5, see
879
+ # [RFC1321][1].
840
880
  #
841
881
  #
842
882
  #
@@ -868,7 +908,7 @@ module Aws::SQS
868
908
 
869
909
  # The user-specified message attribute value. For string data types, the
870
910
  # `Value` attribute has the same restrictions on the content as the
871
- # message body. For more information, see ` SendMessage `.
911
+ # message body. For more information, see ` SendMessage.`
872
912
  #
873
913
  # `Name`, `type`, `value` and the message body must not be empty or
874
914
  # null. All parts of the message attribute, including `Name`, `Type`,
@@ -959,7 +999,7 @@ module Aws::SQS
959
999
  #
960
1000
  # {
961
1001
  # queue_url: "String", # required
962
- # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication
1002
+ # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
963
1003
  # message_attribute_names: ["MessageAttributeName"],
964
1004
  # max_number_of_messages: 1,
965
1005
  # visibility_timeout: 1,
@@ -1287,11 +1327,11 @@ module Aws::SQS
1287
1327
  # @return [String]
1288
1328
  #
1289
1329
  # @!attribute [rw] delay_seconds
1290
- # The number of seconds for which a specific message is delayed. Valid
1291
- # values: 0 to 900. Maximum: 15 minutes. Messages with a positive
1292
- # `DelaySeconds` value become available for processing after the delay
1293
- # period is finished. If you don't specify a value, the default value
1294
- # for the queue is applied.
1330
+ # The length of time, in seconds, for which a specific message is
1331
+ # delayed. Valid values: 0 to 900. Maximum: 15 minutes. Messages with
1332
+ # a positive `DelaySeconds` value become available for processing
1333
+ # after the delay period is finished. If you don't specify a value,
1334
+ # the default value for the queue is applied.
1295
1335
  #
1296
1336
  # <note markdown="1"> When you set `FifoQueue`, you can't set `DelaySeconds` per message.
1297
1337
  # You can set this parameter only on a queue level.
@@ -1341,9 +1381,6 @@ module Aws::SQS
1341
1381
  # treated as duplicates and only one copy of the message is
1342
1382
  # delivered.
1343
1383
  #
1344
- # * You can also use `ContentBasedDeduplication` for messages with
1345
- # identical content to be treated as duplicates.
1346
- #
1347
1384
  # * If you send one message with `ContentBasedDeduplication` enabled
1348
1385
  # and then another message with a `MessageDeduplicationId` that is
1349
1386
  # the same as the one generated for the first
@@ -1403,6 +1440,9 @@ module Aws::SQS
1403
1440
  # MessageGroupId Property][1] in the *Amazon Simple Queue Service
1404
1441
  # Developer Guide*.
1405
1442
  #
1443
+ # `MessageGroupId` is required for FIFO queues. You can't use it for
1444
+ # Standard queues.
1445
+ #
1406
1446
  #
1407
1447
  #
1408
1448
  # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property
@@ -1442,7 +1482,7 @@ module Aws::SQS
1442
1482
  end
1443
1483
 
1444
1484
  # Encloses a `MessageId` for a successfully-enqueued message in a `
1445
- # SendMessageBatch `.
1485
+ # SendMessageBatch.`
1446
1486
  #
1447
1487
  # @!attribute [rw] id
1448
1488
  # An identifier for the message in this batch.
@@ -1456,7 +1496,8 @@ module Aws::SQS
1456
1496
  # An MD5 digest of the non-URL-encoded message attribute string. You
1457
1497
  # can use this attribute to verify that Amazon SQS received the
1458
1498
  # message correctly. Amazon SQS URL-decodes the message before
1459
- # creating the MD5 digest. For information on MD5, see [RFC1321][1].
1499
+ # creating the MD5 digest. For information about MD5, see
1500
+ # [RFC1321][1].
1460
1501
  #
1461
1502
  #
1462
1503
  #
@@ -1467,7 +1508,8 @@ module Aws::SQS
1467
1508
  # An MD5 digest of the non-URL-encoded message attribute string. You
1468
1509
  # can use this attribute to verify that Amazon SQS received the
1469
1510
  # message correctly. Amazon SQS URL-decodes the message before
1470
- # creating the MD5 digest. For information on MD5, see [RFC1321][1].
1511
+ # creating the MD5 digest. For information about MD5, see
1512
+ # [RFC1321][1].
1471
1513
  #
1472
1514
  #
1473
1515
  #
@@ -1477,7 +1519,7 @@ module Aws::SQS
1477
1519
  # @!attribute [rw] sequence_number
1478
1520
  # This parameter applies only to FIFO (first-in-first-out) queues.
1479
1521
  #
1480
- # A large, non-consecutive number that Amazon SQS assigns to each
1522
+ # The large, non-consecutive number that Amazon SQS assigns to each
1481
1523
  # message.
1482
1524
  #
1483
1525
  # The length of `SequenceNumber` is 128 bits. As `SequenceNumber`
@@ -1524,35 +1566,26 @@ module Aws::SQS
1524
1566
  # @!attribute [rw] message_body
1525
1567
  # The message to send. The maximum string size is 256 KB.
1526
1568
  #
1527
- # The following list shows the characters (in Unicode) that are
1528
- # allowed in your message, according to the W3C XML specification:
1529
- #
1530
- # * `#x9`
1531
- #
1532
- # * `#xA`
1533
- #
1534
- # * `#xD`
1535
- #
1536
- # * `#x20` to `#xD7FF`
1537
- #
1538
- # * `#xE000` to `#xFFFD`
1569
+ # A message can include only XML, JSON, and unformatted text. The
1570
+ # following Unicode characters are allowed:
1539
1571
  #
1540
- # * `#x10000` to `#x10FFFF`
1572
+ # `#x9` \| `#xA` \| `#xD` \| `#x20` to `#xD7FF` \| `#xE000` to
1573
+ # `#xFFFD` \| `#x10000` to `#x10FFFF`
1541
1574
  #
1542
- # For more information, see [RFC1321][1]. If you send any characters
1543
- # that aren't included in this list, your request is rejected.
1575
+ # Any characters not included in this list will be rejected. For more
1576
+ # information, see the [W3C specification for characters][1].
1544
1577
  #
1545
1578
  #
1546
1579
  #
1547
- # [1]: https://www.ietf.org/rfc/rfc1321.txt
1580
+ # [1]: http://www.w3.org/TR/REC-xml/#charsets
1548
1581
  # @return [String]
1549
1582
  #
1550
1583
  # @!attribute [rw] delay_seconds
1551
- # The number of seconds to delay a specific message. Valid values: 0
1552
- # to 900. Maximum: 15 minutes. Messages with a positive `DelaySeconds`
1553
- # value become available for processing after the delay period is
1554
- # finished. If you don't specify a value, the default value for the
1555
- # queue applies.
1584
+ # The length of time, in seconds, for which to delay a specific
1585
+ # message. Valid values: 0 to 900. Maximum: 15 minutes. Messages with
1586
+ # a positive `DelaySeconds` value become available for processing
1587
+ # after the delay period is finished. If you don't specify a value,
1588
+ # the default value for the queue applies.
1556
1589
  #
1557
1590
  # <note markdown="1"> When you set `FifoQueue`, you can't set `DelaySeconds` per message.
1558
1591
  # You can set this parameter only on a queue level.
@@ -1602,9 +1635,6 @@ module Aws::SQS
1602
1635
  # treated as duplicates and only one copy of the message is
1603
1636
  # delivered.
1604
1637
  #
1605
- # * You can also use `ContentBasedDeduplication` for messages with
1606
- # identical content to be treated as duplicates.
1607
- #
1608
1638
  # * If you send one message with `ContentBasedDeduplication` enabled
1609
1639
  # and then another message with a `MessageDeduplicationId` that is
1610
1640
  # the same as the one generated for the first
@@ -1664,6 +1694,9 @@ module Aws::SQS
1664
1694
  # MessageGroupId Property][1] in the *Amazon Simple Queue Service
1665
1695
  # Developer Guide*.
1666
1696
  #
1697
+ # `MessageGroupId` is required for FIFO queues. You can't use it for
1698
+ # Standard queues.
1699
+ #
1667
1700
  #
1668
1701
  #
1669
1702
  # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queue-recommendations.html#using-messagegroupid-property
@@ -1687,7 +1720,8 @@ module Aws::SQS
1687
1720
  # An MD5 digest of the non-URL-encoded message attribute string. You
1688
1721
  # can use this attribute to verify that Amazon SQS received the
1689
1722
  # message correctly. Amazon SQS URL-decodes the message before
1690
- # creating the MD5 digest. For information on MD5, see [RFC1321][1].
1723
+ # creating the MD5 digest. For information about MD5, see
1724
+ # [RFC1321][1].
1691
1725
  #
1692
1726
  #
1693
1727
  #
@@ -1698,7 +1732,8 @@ module Aws::SQS
1698
1732
  # An MD5 digest of the non-URL-encoded message attribute string. You
1699
1733
  # can use this attribute to verify that Amazon SQS received the
1700
1734
  # message correctly. Amazon SQS URL-decodes the message before
1701
- # creating the MD5 digest. For information on MD5, see [RFC1321][1].
1735
+ # creating the MD5 digest. For information about MD5, see
1736
+ # [RFC1321][1].
1702
1737
  #
1703
1738
  #
1704
1739
  #
@@ -1718,7 +1753,7 @@ module Aws::SQS
1718
1753
  # @!attribute [rw] sequence_number
1719
1754
  # This parameter applies only to FIFO (first-in-first-out) queues.
1720
1755
  #
1721
- # A large, non-consecutive number that Amazon SQS assigns to each
1756
+ # The large, non-consecutive number that Amazon SQS assigns to each
1722
1757
  # message.
1723
1758
  #
1724
1759
  # The length of `SequenceNumber` is 128 bits. `SequenceNumber`
@@ -1758,27 +1793,28 @@ module Aws::SQS
1758
1793
  # special request parameters that the `SetQueueAttributes` action
1759
1794
  # uses:
1760
1795
  #
1761
- # * `DelaySeconds` - The number of seconds for which the delivery of
1762
- # all messages in the queue is delayed. Valid values: An integer
1763
- # from 0 to 900 (15 minutes). The default is 0 (zero).
1796
+ # * `DelaySeconds` - The length of time, in seconds, for which the
1797
+ # delivery of all messages in the queue is delayed. Valid values: An
1798
+ # integer from 0 to 900 (15 minutes). The default is 0 (zero).
1764
1799
  #
1765
1800
  # * `MaximumMessageSize` - The limit of how many bytes a message can
1766
1801
  # contain before Amazon SQS rejects it. Valid values: An integer
1767
1802
  # from 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). The
1768
1803
  # default is 262,144 (256 KiB).
1769
1804
  #
1770
- # * `MessageRetentionPeriod` - The number of seconds for which Amazon
1771
- # SQS retains a message. Valid values: An integer representing
1772
- # seconds, from 60 (1 minute) to 1,209,600 (14 days). The default is
1773
- # 345,600 (4 days).
1805
+ # * `MessageRetentionPeriod` - The length of time, in seconds, for
1806
+ # which Amazon SQS retains a message. Valid values: An integer
1807
+ # representing seconds, from 60 (1 minute) to 1,209,600 (14 days).
1808
+ # The default is 345,600 (4 days).
1774
1809
  #
1775
1810
  # * `Policy` - The queue's policy. A valid AWS policy. For more
1776
1811
  # information about policy structure, see [Overview of AWS IAM
1777
1812
  # Policies][1] in the *Amazon IAM User Guide*.
1778
1813
  #
1779
- # * `ReceiveMessageWaitTimeSeconds` - The number of seconds for which
1780
- # a ` ReceiveMessage ` action waits for a message to arrive. Valid
1781
- # values: an integer from 0 to 20 (seconds). The default is 0.
1814
+ # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
1815
+ # for which a ` ReceiveMessage ` action waits for a message to
1816
+ # arrive. Valid values: an integer from 0 to 20 (seconds). The
1817
+ # default is 0.
1782
1818
  #
1783
1819
  # * `RedrivePolicy` - The parameters for the dead letter queue
1784
1820
  # functionality of the source queue. For more information about the
@@ -1796,11 +1832,29 @@ module Aws::SQS
1796
1832
  # For more information about the visibility timeout, see [Visibility
1797
1833
  # Timeout][3] in the *Amazon SQS Developer Guide*.
1798
1834
  #
1835
+ # The following attributes apply only to [server-side-encryption][4]\:
1836
+ #
1837
+ # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
1838
+ # (CMK) for Amazon SQS or a custom CMK. For more information, see
1839
+ # [Key Terms][5]. While the alias of the AWS-managed CMK for Amazon
1840
+ # SQS is always `alias/aws/sqs`, the alias of a custom CMK can, for
1841
+ # example, be `alias/aws/sqs`. For more examples, see [KeyId][6] in
1842
+ # the *AWS Key Management Service API Reference*.
1843
+ #
1844
+ # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds,
1845
+ # for which Amazon SQS can reuse a [data key][7] to encrypt or
1846
+ # decrypt messages before calling AWS KMS again. An integer
1847
+ # representing seconds, between 60 seconds (1 minute) and 86,400
1848
+ # seconds (24 hours). The default is 300 (5 minutes). A shorter time
1849
+ # period provides better security but results in more calls to KMS
1850
+ # which incur charges after Free Tier. For more information, see
1851
+ # [How Does the Data Key Reuse Period Work?][8].
1852
+ #
1799
1853
  # The following attribute applies only to [FIFO (first-in-first-out)
1800
- # queues][4]\:
1854
+ # queues][9]\:
1801
1855
  #
1802
1856
  # * `ContentBasedDeduplication` - Enables content-based deduplication.
1803
- # For more information, see [Exactly-Once Processing][5] in the
1857
+ # For more information, see [Exactly-Once Processing][10] in the
1804
1858
  # *Amazon SQS Developer Guide*.
1805
1859
  #
1806
1860
  # * Every message must have a unique `MessageDeduplicationId`,
@@ -1825,9 +1879,6 @@ module Aws::SQS
1825
1879
  # treated as duplicates and only one copy of the message is
1826
1880
  # delivered.
1827
1881
  #
1828
- # * You can also use `ContentBasedDeduplication` for messages with
1829
- # identical content to be treated as duplicates.
1830
- #
1831
1882
  # * If you send one message with `ContentBasedDeduplication` enabled
1832
1883
  # and then another message with a `MessageDeduplicationId` that is
1833
1884
  # the same as the one generated for the first
@@ -1854,8 +1905,13 @@ module Aws::SQS
1854
1905
  # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
1855
1906
  # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
1856
1907
  # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1857
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
1858
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1908
+ # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
1909
+ # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
1910
+ # [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
1911
+ # [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
1912
+ # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
1913
+ # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
1914
+ # [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1859
1915
  # @return [Hash<String,String>]
1860
1916
  #
1861
1917
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/SetQueueAttributesRequest AWS API Documentation