aws-sdk-sqs 1.56.0 → 1.57.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -108,6 +108,31 @@ module Aws::SQS
108
108
  include Aws::Structure
109
109
  end
110
110
 
111
+ # @!attribute [rw] task_handle
112
+ # An identifier associated with a message movement task.
113
+ # @return [String]
114
+ #
115
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/CancelMessageMoveTaskRequest AWS API Documentation
116
+ #
117
+ class CancelMessageMoveTaskRequest < Struct.new(
118
+ :task_handle)
119
+ SENSITIVE = []
120
+ include Aws::Structure
121
+ end
122
+
123
+ # @!attribute [rw] approximate_number_of_messages_moved
124
+ # The approximate number of messages already moved to the destination
125
+ # queue.
126
+ # @return [Integer]
127
+ #
128
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/CancelMessageMoveTaskResult AWS API Documentation
129
+ #
130
+ class CancelMessageMoveTaskResult < Struct.new(
131
+ :approximate_number_of_messages_moved)
132
+ SENSITIVE = []
133
+ include Aws::Structure
134
+ end
135
+
111
136
  # @!attribute [rw] queue_url
112
137
  # The URL of the Amazon SQS queue whose messages' visibility is
113
138
  # changed.
@@ -116,7 +141,7 @@ module Aws::SQS
116
141
  # @return [String]
117
142
  #
118
143
  # @!attribute [rw] entries
119
- # A list of receipt handles of the messages for which the visibility
144
+ # Lists the receipt handles of the messages for which the visibility
120
145
  # timeout must be changed.
121
146
  # @return [Array<Types::ChangeMessageVisibilityBatchRequestEntry>]
122
147
  #
@@ -129,20 +154,9 @@ module Aws::SQS
129
154
  include Aws::Structure
130
155
  end
131
156
 
132
- # Encloses a receipt handle and an entry id for each message in `
157
+ # Encloses a receipt handle and an entry ID for each message in `
133
158
  # ChangeMessageVisibilityBatch.`
134
159
  #
135
- # All of the following list parameters must be prefixed with
136
- # `ChangeMessageVisibilityBatchRequestEntry.n`, where `n` is an integer
137
- # value starting with `1`. For example, a parameter list for this action
138
- # might look like this:
139
- #
140
- # `&ChangeMessageVisibilityBatchRequestEntry.1.Id=change_visibility_msg_2`
141
- #
142
- # `&ChangeMessageVisibilityBatchRequestEntry.1.ReceiptHandle=your_receipt_handle`
143
- #
144
- # `&ChangeMessageVisibilityBatchRequestEntry.1.VisibilityTimeout=45`
145
- #
146
160
  # @!attribute [rw] id
147
161
  # An identifier for this particular receipt handle used to communicate
148
162
  # the result.
@@ -218,7 +232,7 @@ module Aws::SQS
218
232
  # @return [String]
219
233
  #
220
234
  # @!attribute [rw] receipt_handle
221
- # The receipt handle associated with the message whose visibility
235
+ # The receipt handle associated with the message, whose visibility
222
236
  # timeout is changed. This parameter is returned by the `
223
237
  # ReceiveMessage ` action.
224
238
  # @return [String]
@@ -269,23 +283,33 @@ module Aws::SQS
269
283
  # * `MessageRetentionPeriod` – The length of time, in seconds, for
270
284
  # which Amazon SQS retains a message. Valid values: An integer from
271
285
  # 60 seconds (1 minute) to 1,209,600 seconds (14 days). Default:
272
- # 345,600 (4 days).
286
+ # 345,600 (4 days). When you change a queue's attributes, the
287
+ # change can take up to 60 seconds for most of the attributes to
288
+ # propagate throughout the Amazon SQS system. Changes made to the
289
+ # `MessageRetentionPeriod` attribute can take up to 15 minutes and
290
+ # will impact existing messages in the queue potentially causing
291
+ # them to be expired and deleted if the `MessageRetentionPeriod` is
292
+ # reduced below the age of existing messages.
273
293
  #
274
294
  # * `Policy` – The queue's policy. A valid Amazon Web Services
275
295
  # policy. For more information about policy structure, see [Overview
276
- # of Amazon Web Services IAM Policies][1] in the *Amazon IAM User
277
- # Guide*.
296
+ # of Amazon Web Services IAM Policies][1] in the *IAM User Guide*.
278
297
  #
279
298
  # * `ReceiveMessageWaitTimeSeconds` – The length of time, in seconds,
280
299
  # for which a ` ReceiveMessage ` action waits for a message to
281
300
  # arrive. Valid values: An integer from 0 to 20 (seconds). Default:
282
301
  # 0.
283
302
  #
303
+ # * `VisibilityTimeout` – The visibility timeout for the queue, in
304
+ # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
305
+ # Default: 30. For more information about the visibility timeout,
306
+ # see [Visibility Timeout][2] in the *Amazon SQS Developer Guide*.
307
+ #
308
+ # The following attributes apply only to [dead-letter queues:][3]
309
+ #
284
310
  # * `RedrivePolicy` – The string that includes the parameters for the
285
311
  # dead-letter queue functionality of the source queue as a JSON
286
- # object. For more information about the redrive policy and
287
- # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2]
288
- # in the *Amazon SQS Developer Guide*.
312
+ # object. The parameters are as follows:
289
313
  #
290
314
  # * `deadLetterTargetArn` – The Amazon Resource Name (ARN) of the
291
315
  # dead-letter queue to which Amazon SQS moves messages after the
@@ -293,20 +317,42 @@ module Aws::SQS
293
317
  #
294
318
  # * `maxReceiveCount` – The number of times a message is delivered
295
319
  # to the source queue before being moved to the dead-letter queue.
296
- # When the `ReceiveCount` for a message exceeds the
320
+ # Default: 10. When the `ReceiveCount` for a message exceeds the
297
321
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to
298
322
  # the dead-letter-queue.
299
323
  #
300
- # <note markdown="1"> The dead-letter queue of a FIFO queue must also be a FIFO queue.
301
- # Similarly, the dead-letter queue of a standard queue must also be
302
- # a standard queue.
324
+ # * `RedriveAllowPolicy` The string that includes the parameters for
325
+ # the permissions for the dead-letter queue redrive permission and
326
+ # which source queues can specify dead-letter queues as a JSON
327
+ # object. The parameters are as follows:
303
328
  #
304
- # </note>
329
+ # * `redrivePermission` – The permission type that defines which
330
+ # source queues can specify the current queue as the dead-letter
331
+ # queue. Valid values are:
305
332
  #
306
- # * `VisibilityTimeout` – The visibility timeout for the queue, in
307
- # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
308
- # Default: 30. For more information about the visibility timeout,
309
- # see [Visibility Timeout][3] in the *Amazon SQS Developer Guide*.
333
+ # * `allowAll` – (Default) Any source queues in this Amazon Web
334
+ # Services account in the same Region can specify this queue as
335
+ # the dead-letter queue.
336
+ #
337
+ # * `denyAll` – No source queues can specify this queue as the
338
+ # dead-letter queue.
339
+ #
340
+ # * `byQueue` – Only queues specified by the `sourceQueueArns`
341
+ # parameter can specify this queue as the dead-letter queue.
342
+ #
343
+ # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
344
+ # source queues that can specify this queue as the dead-letter
345
+ # queue and redrive messages. You can specify this parameter only
346
+ # when the `redrivePermission` parameter is set to `byQueue`. You
347
+ # can specify up to 10 source queue ARNs. To allow more than 10
348
+ # source queues to specify dead-letter queues, set the
349
+ # `redrivePermission` parameter to `allowAll`.
350
+ #
351
+ # <note markdown="1"> The dead-letter queue of a FIFO queue must also be a FIFO queue.
352
+ # Similarly, the dead-letter queue of a standard queue must also be a
353
+ # standard queue.
354
+ #
355
+ # </note>
310
356
  #
311
357
  # The following attributes apply only to [server-side-encryption][4]:
312
358
  #
@@ -325,11 +371,11 @@ module Aws::SQS
325
371
  # hours). Default: 300 (5 minutes). A shorter time period provides
326
372
  # better security but results in more calls to KMS which might incur
327
373
  # charges after Free Tier. For more information, see [How Does the
328
- # Data Key Reuse Period Work?][8].
374
+ # Data Key Reuse Period Work?][8]
329
375
  #
330
376
  # * `SqsManagedSseEnabled` – Enables server-side queue encryption
331
377
  # using SQS owned encryption keys. Only one server-side encryption
332
- # option is supported per queue (e.g. [SSE-KMS][9] or
378
+ # option is supported per queue (for example, [SSE-KMS][9] or
333
379
  # [SSE-SQS][10]).
334
380
  #
335
381
  # The following attributes apply only to [FIFO (first-in-first-out)
@@ -407,8 +453,8 @@ module Aws::SQS
407
453
  #
408
454
  #
409
455
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
410
- # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
411
- # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
456
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
457
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
412
458
  # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
413
459
  # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
414
460
  # [6]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
@@ -448,7 +494,7 @@ module Aws::SQS
448
494
  #
449
495
  # Cross-account permissions don't apply to this action. For more
450
496
  # information, see [Grant cross-account permissions to a role and a
451
- # user name][3] in the *Amazon SQS Developer Guide*.
497
+ # username][3] in the *Amazon SQS Developer Guide*.
452
498
  #
453
499
  # </note>
454
500
  #
@@ -490,7 +536,7 @@ module Aws::SQS
490
536
  # @return [String]
491
537
  #
492
538
  # @!attribute [rw] entries
493
- # A list of receipt handles for the messages to be deleted.
539
+ # Lists the receipt handles for the messages to be deleted.
494
540
  # @return [Array<Types::DeleteMessageBatchRequestEntry>]
495
541
  #
496
542
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/DeleteMessageBatchRequest AWS API Documentation
@@ -505,7 +551,7 @@ module Aws::SQS
505
551
  # Encloses a receipt handle and an identifier for it.
506
552
  #
507
553
  # @!attribute [rw] id
508
- # An identifier for this particular receipt handle. This is used to
554
+ # The identifier for this particular receipt handle. This is used to
509
555
  # communicate the result.
510
556
  #
511
557
  # <note markdown="1"> The `Id`s of a batch request need to be unique within a request.
@@ -614,7 +660,7 @@ module Aws::SQS
614
660
  # @!attribute [rw] attribute_names
615
661
  # A list of attributes for which to retrieve information.
616
662
  #
617
- # The `AttributeName.N` parameter is optional, but if you don't
663
+ # The `AttributeNames` parameter is optional, but if you don't
618
664
  # specify values for this parameter, the request returns empty
619
665
  # results.
620
666
  #
@@ -628,10 +674,10 @@ module Aws::SQS
628
674
  #
629
675
  # The `ApproximateNumberOfMessagesDelayed`,
630
676
  # `ApproximateNumberOfMessagesNotVisible`, and
631
- # `ApproximateNumberOfMessagesVisible` metrics may not achieve
632
- # consistency until at least 1 minute after the producers stop sending
633
- # messages. This period is required for the queue metadata to reach
634
- # eventual consistency.
677
+ # `ApproximateNumberOfMessages` metrics may not achieve consistency
678
+ # until at least 1 minute after the producers stop sending messages.
679
+ # This period is required for the queue metadata to reach eventual
680
+ # consistency.
635
681
  #
636
682
  # * `All` – Returns all values.
637
683
  #
@@ -663,7 +709,14 @@ module Aws::SQS
663
709
  # message can contain before Amazon SQS rejects it.
664
710
  #
665
711
  # * `MessageRetentionPeriod` – Returns the length of time, in seconds,
666
- # for which Amazon SQS retains a message.
712
+ # for which Amazon SQS retains a message. When you change a queue's
713
+ # attributes, the change can take up to 60 seconds for most of the
714
+ # attributes to propagate throughout the Amazon SQS system. Changes
715
+ # made to the `MessageRetentionPeriod` attribute can take up to 15
716
+ # minutes and will impact existing messages in the queue potentially
717
+ # causing them to be expired and deleted if the
718
+ # `MessageRetentionPeriod` is reduced below the age of existing
719
+ # messages.
667
720
  #
668
721
  # * `Policy` – Returns the policy of the queue.
669
722
  #
@@ -673,11 +726,15 @@ module Aws::SQS
673
726
  # seconds, for which the `ReceiveMessage` action waits for a message
674
727
  # to arrive.
675
728
  #
729
+ # * `VisibilityTimeout` – Returns the visibility timeout for the
730
+ # queue. For more information about the visibility timeout, see
731
+ # [Visibility Timeout][2] in the *Amazon SQS Developer Guide*.
732
+ #
733
+ # The following attributes apply only to [dead-letter queues:][3]
734
+ #
676
735
  # * `RedrivePolicy` – The string that includes the parameters for the
677
736
  # dead-letter queue functionality of the source queue as a JSON
678
- # object. For more information about the redrive policy and
679
- # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2]
680
- # in the *Amazon SQS Developer Guide*.
737
+ # object. The parameters are as follows:
681
738
  #
682
739
  # * `deadLetterTargetArn` – The Amazon Resource Name (ARN) of the
683
740
  # dead-letter queue to which Amazon SQS moves messages after the
@@ -685,13 +742,42 @@ module Aws::SQS
685
742
  #
686
743
  # * `maxReceiveCount` – The number of times a message is delivered
687
744
  # to the source queue before being moved to the dead-letter queue.
688
- # When the `ReceiveCount` for a message exceeds the
745
+ # Default: 10. When the `ReceiveCount` for a message exceeds the
689
746
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to
690
747
  # the dead-letter-queue.
691
748
  #
692
- # * `VisibilityTimeout` – Returns the visibility timeout for the
693
- # queue. For more information about the visibility timeout, see
694
- # [Visibility Timeout][3] in the *Amazon SQS Developer Guide*.
749
+ # * `RedriveAllowPolicy` – The string that includes the parameters for
750
+ # the permissions for the dead-letter queue redrive permission and
751
+ # which source queues can specify dead-letter queues as a JSON
752
+ # object. The parameters are as follows:
753
+ #
754
+ # * `redrivePermission` – The permission type that defines which
755
+ # source queues can specify the current queue as the dead-letter
756
+ # queue. Valid values are:
757
+ #
758
+ # * `allowAll` – (Default) Any source queues in this Amazon Web
759
+ # Services account in the same Region can specify this queue as
760
+ # the dead-letter queue.
761
+ #
762
+ # * `denyAll` – No source queues can specify this queue as the
763
+ # dead-letter queue.
764
+ #
765
+ # * `byQueue` – Only queues specified by the `sourceQueueArns`
766
+ # parameter can specify this queue as the dead-letter queue.
767
+ #
768
+ # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
769
+ # source queues that can specify this queue as the dead-letter
770
+ # queue and redrive messages. You can specify this parameter only
771
+ # when the `redrivePermission` parameter is set to `byQueue`. You
772
+ # can specify up to 10 source queue ARNs. To allow more than 10
773
+ # source queues to specify dead-letter queues, set the
774
+ # `redrivePermission` parameter to `allowAll`.
775
+ #
776
+ # <note markdown="1"> The dead-letter queue of a FIFO queue must also be a FIFO queue.
777
+ # Similarly, the dead-letter queue of a standard queue must also be a
778
+ # standard queue.
779
+ #
780
+ # </note>
695
781
  #
696
782
  # The following attributes apply only to [server-side-encryption][4]:
697
783
  #
@@ -706,8 +792,8 @@ module Aws::SQS
706
792
  #
707
793
  # * `SqsManagedSseEnabled` – Returns information about whether the
708
794
  # queue is using SSE-SQS encryption using SQS owned encryption keys.
709
- # Only one server-side encryption option is supported per queue
710
- # (e.g. [SSE-KMS][7] or [SSE-SQS][8]).
795
+ # Only one server-side encryption option is supported per queue (for
796
+ # example, [SSE-KMS][7] or [SSE-SQS][8]).
711
797
  #
712
798
  # The following attributes apply only to [FIFO (first-in-first-out)
713
799
  # queues][9]:
@@ -754,8 +840,8 @@ module Aws::SQS
754
840
  #
755
841
  #
756
842
  # [1]: http://en.wikipedia.org/wiki/Unix_time
757
- # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
758
- # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
843
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
844
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
759
845
  # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
760
846
  # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
761
847
  # [6]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
@@ -905,6 +991,106 @@ module Aws::SQS
905
991
  include Aws::Structure
906
992
  end
907
993
 
994
+ # @!attribute [rw] source_arn
995
+ # The ARN of the queue whose message movement tasks are to be listed.
996
+ # @return [String]
997
+ #
998
+ # @!attribute [rw] max_results
999
+ # The maximum number of results to include in the response. The
1000
+ # default is 1, which provides the most recent message movement task.
1001
+ # The upper limit is 10.
1002
+ # @return [Integer]
1003
+ #
1004
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListMessageMoveTasksRequest AWS API Documentation
1005
+ #
1006
+ class ListMessageMoveTasksRequest < Struct.new(
1007
+ :source_arn,
1008
+ :max_results)
1009
+ SENSITIVE = []
1010
+ include Aws::Structure
1011
+ end
1012
+
1013
+ # @!attribute [rw] results
1014
+ # A list of message movement tasks and their attributes.
1015
+ # @return [Array<Types::ListMessageMoveTasksResultEntry>]
1016
+ #
1017
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListMessageMoveTasksResult AWS API Documentation
1018
+ #
1019
+ class ListMessageMoveTasksResult < Struct.new(
1020
+ :results)
1021
+ SENSITIVE = []
1022
+ include Aws::Structure
1023
+ end
1024
+
1025
+ # Contains the details of a message movement task.
1026
+ #
1027
+ # @!attribute [rw] task_handle
1028
+ # An identifier associated with a message movement task. When this
1029
+ # field is returned in the response of the `ListMessageMoveTasks`
1030
+ # action, it is only populated for tasks that are in RUNNING status.
1031
+ # @return [String]
1032
+ #
1033
+ # @!attribute [rw] status
1034
+ # The status of the message movement task. Possible values are:
1035
+ # RUNNING, COMPLETED, CANCELLING, CANCELLED, and FAILED.
1036
+ # @return [String]
1037
+ #
1038
+ # @!attribute [rw] source_arn
1039
+ # The ARN of the queue that contains the messages to be moved to
1040
+ # another queue.
1041
+ # @return [String]
1042
+ #
1043
+ # @!attribute [rw] destination_arn
1044
+ # The ARN of the destination queue if it has been specified in the
1045
+ # `StartMessageMoveTask` request. If a `DestinationArn` has not been
1046
+ # specified in the `StartMessageMoveTask` request, this field value
1047
+ # will be NULL.
1048
+ # @return [String]
1049
+ #
1050
+ # @!attribute [rw] max_number_of_messages_per_second
1051
+ # The number of messages to be moved per second (the message movement
1052
+ # rate), if it has been specified in the `StartMessageMoveTask`
1053
+ # request. If a `MaxNumberOfMessagesPerSecond` has not been specified
1054
+ # in the `StartMessageMoveTask` request, this field value will be
1055
+ # NULL.
1056
+ # @return [Integer]
1057
+ #
1058
+ # @!attribute [rw] approximate_number_of_messages_moved
1059
+ # The approximate number of messages already moved to the destination
1060
+ # queue.
1061
+ # @return [Integer]
1062
+ #
1063
+ # @!attribute [rw] approximate_number_of_messages_to_move
1064
+ # The number of messages to be moved from the source queue. This
1065
+ # number is obtained at the time of starting the message movement
1066
+ # task.
1067
+ # @return [Integer]
1068
+ #
1069
+ # @!attribute [rw] failure_reason
1070
+ # The task failure reason (only included if the task status is
1071
+ # FAILED).
1072
+ # @return [String]
1073
+ #
1074
+ # @!attribute [rw] started_timestamp
1075
+ # The timestamp of starting the message movement task.
1076
+ # @return [Integer]
1077
+ #
1078
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListMessageMoveTasksResultEntry AWS API Documentation
1079
+ #
1080
+ class ListMessageMoveTasksResultEntry < Struct.new(
1081
+ :task_handle,
1082
+ :status,
1083
+ :source_arn,
1084
+ :destination_arn,
1085
+ :max_number_of_messages_per_second,
1086
+ :approximate_number_of_messages_moved,
1087
+ :approximate_number_of_messages_to_move,
1088
+ :failure_reason,
1089
+ :started_timestamp)
1090
+ SENSITIVE = []
1091
+ include Aws::Structure
1092
+ end
1093
+
908
1094
  # @!attribute [rw] queue_url
909
1095
  # The URL of the queue.
910
1096
  # @return [String]
@@ -960,7 +1146,7 @@ module Aws::SQS
960
1146
  #
961
1147
  # @!attribute [rw] queue_urls
962
1148
  # A list of queue URLs, up to 1,000 entries, or the value of
963
- # MaxResults that you sent in the request.
1149
+ # `MaxResults` that you sent in the request.
964
1150
  # @return [Array<String>]
965
1151
  #
966
1152
  # @!attribute [rw] next_token
@@ -1070,7 +1256,7 @@ module Aws::SQS
1070
1256
  #
1071
1257
  # `Name`, `type`, `value` and the message body must not be empty or
1072
1258
  # null. All parts of the message attribute, including `Name`, `Type`,
1073
- # and `Value`, are part of the message size restriction (256 KB or
1259
+ # and `Value`, are part of the message size restriction (256 KiB or
1074
1260
  # 262,144 bytes).
1075
1261
  #
1076
1262
  # @!attribute [rw] string_value
@@ -1181,7 +1367,7 @@ module Aws::SQS
1181
1367
  end
1182
1368
 
1183
1369
  # The specified action violates a limit. For example, `ReceiveMessage`
1184
- # returns this error if the maximum number of inflight messages is
1370
+ # returns this error if the maximum number of in flight messages is
1185
1371
  # reached and `AddPermission` returns this error if the maximum number
1186
1372
  # of permissions for the queue is reached.
1187
1373
  #
@@ -1262,7 +1448,7 @@ module Aws::SQS
1262
1448
  #
1263
1449
  # * `SenderId`
1264
1450
  #
1265
- # * For an IAM user, returns the IAM user ID, for example
1451
+ # * For a user, returns the user ID, for example
1266
1452
  # `ABCDEFGHI1JKLMNOPQ23R`.
1267
1453
  #
1268
1454
  # * For an IAM role, returns the IAM role ID, for example
@@ -1273,7 +1459,8 @@ module Aws::SQS
1273
1459
  #
1274
1460
  # * `SqsManagedSseEnabled` – Enables server-side queue encryption
1275
1461
  # using SQS owned encryption keys. Only one server-side encryption
1276
- # option is supported per queue (e.g. [SSE-KMS][2] or [SSE-SQS][3]).
1462
+ # option is supported per queue (for example, [SSE-KMS][2] or
1463
+ # [SSE-SQS][3]).
1277
1464
  #
1278
1465
  # * `MessageDeduplicationId` – Returns the value provided by the
1279
1466
  # producer that calls the ` SendMessage ` action.
@@ -1462,6 +1649,12 @@ module Aws::SQS
1462
1649
  include Aws::Structure
1463
1650
  end
1464
1651
 
1652
+ # One or more specified resources don't exist.
1653
+ #
1654
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ResourceNotFoundException AWS API Documentation
1655
+ #
1656
+ class ResourceNotFoundException < Aws::EmptyStructure; end
1657
+
1465
1658
  # @!attribute [rw] queue_url
1466
1659
  # The URL of the Amazon SQS queue to which batched messages are sent.
1467
1660
  #
@@ -1750,7 +1943,7 @@ module Aws::SQS
1750
1943
  #
1751
1944
  # @!attribute [rw] message_body
1752
1945
  # The message to send. The minimum size is one character. The maximum
1753
- # size is 256 KB.
1946
+ # size is 256 KiB.
1754
1947
  #
1755
1948
  # A message can include only XML, JSON, and unformatted text. The
1756
1949
  # following Unicode characters are allowed:
@@ -2005,7 +2198,13 @@ module Aws::SQS
2005
2198
  # * `MessageRetentionPeriod` – The length of time, in seconds, for
2006
2199
  # which Amazon SQS retains a message. Valid values: An integer
2007
2200
  # representing seconds, from 60 (1 minute) to 1,209,600 (14 days).
2008
- # Default: 345,600 (4 days).
2201
+ # Default: 345,600 (4 days). When you change a queue's attributes,
2202
+ # the change can take up to 60 seconds for most of the attributes to
2203
+ # propagate throughout the Amazon SQS system. Changes made to the
2204
+ # `MessageRetentionPeriod` attribute can take up to 15 minutes and
2205
+ # will impact existing messages in the queue potentially causing
2206
+ # them to be expired and deleted if the `MessageRetentionPeriod` is
2207
+ # reduced below the age of existing messages.
2009
2208
  #
2010
2209
  # * `Policy` – The queue's policy. A valid Amazon Web Services
2011
2210
  # policy. For more information about policy structure, see [Overview
@@ -2017,11 +2216,16 @@ module Aws::SQS
2017
2216
  # arrive. Valid values: An integer from 0 to 20 (seconds). Default:
2018
2217
  # 0.
2019
2218
  #
2219
+ # * `VisibilityTimeout` – The visibility timeout for the queue, in
2220
+ # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
2221
+ # Default: 30. For more information about the visibility timeout,
2222
+ # see [Visibility Timeout][2] in the *Amazon SQS Developer Guide*.
2223
+ #
2224
+ # The following attributes apply only to [dead-letter queues:][3]
2225
+ #
2020
2226
  # * `RedrivePolicy` – The string that includes the parameters for the
2021
2227
  # dead-letter queue functionality of the source queue as a JSON
2022
- # object. For more information about the redrive policy and
2023
- # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2]
2024
- # in the *Amazon SQS Developer Guide*.
2228
+ # object. The parameters are as follows:
2025
2229
  #
2026
2230
  # * `deadLetterTargetArn` – The Amazon Resource Name (ARN) of the
2027
2231
  # dead-letter queue to which Amazon SQS moves messages after the
@@ -2029,20 +2233,42 @@ module Aws::SQS
2029
2233
  #
2030
2234
  # * `maxReceiveCount` – The number of times a message is delivered
2031
2235
  # to the source queue before being moved to the dead-letter queue.
2032
- # When the `ReceiveCount` for a message exceeds the
2236
+ # Default: 10. When the `ReceiveCount` for a message exceeds the
2033
2237
  # `maxReceiveCount` for a queue, Amazon SQS moves the message to
2034
2238
  # the dead-letter-queue.
2035
2239
  #
2036
- # <note markdown="1"> The dead-letter queue of a FIFO queue must also be a FIFO queue.
2037
- # Similarly, the dead-letter queue of a standard queue must also be
2038
- # a standard queue.
2240
+ # * `RedriveAllowPolicy` The string that includes the parameters for
2241
+ # the permissions for the dead-letter queue redrive permission and
2242
+ # which source queues can specify dead-letter queues as a JSON
2243
+ # object. The parameters are as follows:
2039
2244
  #
2040
- # </note>
2245
+ # * `redrivePermission` – The permission type that defines which
2246
+ # source queues can specify the current queue as the dead-letter
2247
+ # queue. Valid values are:
2041
2248
  #
2042
- # * `VisibilityTimeout` – The visibility timeout for the queue, in
2043
- # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
2044
- # Default: 30. For more information about the visibility timeout,
2045
- # see [Visibility Timeout][3] in the *Amazon SQS Developer Guide*.
2249
+ # * `allowAll` – (Default) Any source queues in this Amazon Web
2250
+ # Services account in the same Region can specify this queue as
2251
+ # the dead-letter queue.
2252
+ #
2253
+ # * `denyAll` – No source queues can specify this queue as the
2254
+ # dead-letter queue.
2255
+ #
2256
+ # * `byQueue` – Only queues specified by the `sourceQueueArns`
2257
+ # parameter can specify this queue as the dead-letter queue.
2258
+ #
2259
+ # * `sourceQueueArns` – The Amazon Resource Names (ARN)s of the
2260
+ # source queues that can specify this queue as the dead-letter
2261
+ # queue and redrive messages. You can specify this parameter only
2262
+ # when the `redrivePermission` parameter is set to `byQueue`. You
2263
+ # can specify up to 10 source queue ARNs. To allow more than 10
2264
+ # source queues to specify dead-letter queues, set the
2265
+ # `redrivePermission` parameter to `allowAll`.
2266
+ #
2267
+ # <note markdown="1"> The dead-letter queue of a FIFO queue must also be a FIFO queue.
2268
+ # Similarly, the dead-letter queue of a standard queue must also be a
2269
+ # standard queue.
2270
+ #
2271
+ # </note>
2046
2272
  #
2047
2273
  # The following attributes apply only to [server-side-encryption][4]:
2048
2274
  #
@@ -2065,7 +2291,7 @@ module Aws::SQS
2065
2291
  #
2066
2292
  # * `SqsManagedSseEnabled` – Enables server-side queue encryption
2067
2293
  # using SQS owned encryption keys. Only one server-side encryption
2068
- # option is supported per queue (e.g. [SSE-KMS][9] or
2294
+ # option is supported per queue (for example, [SSE-KMS][9] or
2069
2295
  # [SSE-SQS][10]).
2070
2296
  #
2071
2297
  # The following attribute applies only to [FIFO (first-in-first-out)
@@ -2132,8 +2358,8 @@ module Aws::SQS
2132
2358
  #
2133
2359
  #
2134
2360
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
2135
- # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
2136
- # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
2361
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
2362
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
2137
2363
  # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
2138
2364
  # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
2139
2365
  # [6]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
@@ -2156,6 +2382,52 @@ module Aws::SQS
2156
2382
  include Aws::Structure
2157
2383
  end
2158
2384
 
2385
+ # @!attribute [rw] source_arn
2386
+ # The ARN of the queue that contains the messages to be moved to
2387
+ # another queue. Currently, only dead-letter queue (DLQ) ARNs are
2388
+ # accepted.
2389
+ # @return [String]
2390
+ #
2391
+ # @!attribute [rw] destination_arn
2392
+ # The ARN of the queue that receives the moved messages. You can use
2393
+ # this field to specify the destination queue where you would like to
2394
+ # redrive messages. If this field is left blank, the messages will be
2395
+ # redriven back to their respective original source queues.
2396
+ # @return [String]
2397
+ #
2398
+ # @!attribute [rw] max_number_of_messages_per_second
2399
+ # The number of messages to be moved per second (the message movement
2400
+ # rate). You can use this field to define a fixed message movement
2401
+ # rate. The maximum value for messages per second is 500. If this
2402
+ # field is left blank, the system will optimize the rate based on the
2403
+ # queue message backlog size, which may vary throughout the duration
2404
+ # of the message movement task.
2405
+ # @return [Integer]
2406
+ #
2407
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/StartMessageMoveTaskRequest AWS API Documentation
2408
+ #
2409
+ class StartMessageMoveTaskRequest < Struct.new(
2410
+ :source_arn,
2411
+ :destination_arn,
2412
+ :max_number_of_messages_per_second)
2413
+ SENSITIVE = []
2414
+ include Aws::Structure
2415
+ end
2416
+
2417
+ # @!attribute [rw] task_handle
2418
+ # An identifier associated with a message movement task. You can use
2419
+ # this identifier to cancel a specified message movement task using
2420
+ # the `CancelMessageMoveTask` action.
2421
+ # @return [String]
2422
+ #
2423
+ # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/StartMessageMoveTaskResult AWS API Documentation
2424
+ #
2425
+ class StartMessageMoveTaskResult < Struct.new(
2426
+ :task_handle)
2427
+ SENSITIVE = []
2428
+ include Aws::Structure
2429
+ end
2430
+
2159
2431
  # @!attribute [rw] queue_url
2160
2432
  # The URL of the queue.
2161
2433
  # @return [String]