aws-sdk-sqs 1.27.1 → 1.32.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 930ec95f362fc5fa5b3332c482b8b0559e214c641df330439aa855164dd084d4
4
- data.tar.gz: 73396e0bbd88f8c4c5c206263e7fc23ed7e72872d87a41044d151dade1375692
3
+ metadata.gz: 700e1915dc31ea0a9b236df23b5827a443dfe54654f8270c26795f9d83a59f82
4
+ data.tar.gz: b7daa764974f73e9c60608ed21617c683124925f978e97c9faa6ce9e4bebd206
5
5
  SHA512:
6
- metadata.gz: ee299a2d6ccf91c4c732ec05a1cb51890801e3a0b36925d80b5b106fa1ed8257c15beb081ba1768c95f2b30ab043feb68a5a01bccddb57da6d7a955f2fca9d66
7
- data.tar.gz: 50a1077ce5cd35470137d997dcb5cbbd1bc5b3bb04c905db9b9fc9c791ed873f8526c59f40b938dbe99d82a89cd89b568b870e5cdd5e600bea3851ce04c399cf
6
+ metadata.gz: 1aaadbaee5e8386474c504feace8a742a018a1b42ea9ac03fb8c56f680d0333b2e0dab4c8c5031e2463b54cbaef83e05155024e52484d4ae2a95bd6668054785
7
+ data.tar.gz: 4ea0132c39036c71e6b2592d92e7fa55af932381ce40de0892c87752fb79356a759824277e0cc90ee7d8982046d89c3aaa98b526a176be8be117160f21f033be
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -44,9 +46,9 @@ require_relative 'aws-sdk-sqs/customizations'
44
46
  #
45
47
  # See {Errors} for more information.
46
48
  #
47
- # @service
49
+ # @!group service
48
50
  module Aws::SQS
49
51
 
50
- GEM_VERSION = '1.27.1'
52
+ GEM_VERSION = '1.32.0'
51
53
 
52
54
  end
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -87,13 +89,28 @@ module Aws::SQS
87
89
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
88
90
  # credentials.
89
91
  #
92
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
93
+ # shared file, such as `~/.aws/config`.
94
+ #
95
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
96
+ #
97
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
98
+ # assume a role after providing credentials via the web.
99
+ #
100
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
101
+ # access token generated from `aws login`.
102
+ #
103
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
104
+ # process that outputs to stdout.
105
+ #
90
106
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
91
107
  # from an EC2 IMDS on an EC2 instance.
92
108
  #
93
- # * `Aws::SharedCredentials` - Used for loading credentials from a
94
- # shared file, such as `~/.aws/config`.
109
+ # * `Aws::ECSCredentials` - Used for loading credentials from
110
+ # instances running in ECS.
95
111
  #
96
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
112
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
113
+ # from the Cognito Identity service.
97
114
  #
98
115
  # When `:credentials` are not configured directly, the following
99
116
  # locations will be searched for credentials:
@@ -103,10 +120,10 @@ module Aws::SQS
103
120
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
104
121
  # * `~/.aws/credentials`
105
122
  # * `~/.aws/config`
106
- # * EC2 IMDS instance profile - When used by default, the timeouts are
107
- # very aggressive. Construct and pass an instance of
108
- # `Aws::InstanceProfileCredentails` to enable retries and extended
109
- # timeouts.
123
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
124
+ # are very aggressive. Construct and pass an instance of
125
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
126
+ # enable retries and extended timeouts.
110
127
  #
111
128
  # @option options [required, String] :region
112
129
  # The AWS region to connect to. The configured `:region` is
@@ -346,9 +363,9 @@ module Aws::SQS
346
363
  # the `param.n` notation. Values of `n` are integers starting from 1.
347
364
  # For example, a parameter list with two elements looks like this:
348
365
  #
349
- # `&Attribute.1=first`
366
+ # `&AttributeName.1=first`
350
367
  #
351
- # `&Attribute.2=second`
368
+ # `&AttributeName.2=second`
352
369
  #
353
370
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
354
371
  # information, see [Grant Cross-Account Permissions to a Role and a User
@@ -500,7 +517,7 @@ module Aws::SQS
500
517
  #
501
518
  # @option params [required, Integer] :visibility_timeout
502
519
  # The new value for the message's visibility timeout (in seconds).
503
- # Values values: `0` to `43200`. Maximum: 12 hours.
520
+ # Values range: `0` to `43200`. Maximum: 12 hours.
504
521
  #
505
522
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
506
523
  #
@@ -535,9 +552,9 @@ module Aws::SQS
535
552
  # the `param.n` notation. Values of `n` are integers starting from 1.
536
553
  # For example, a parameter list with two elements looks like this:
537
554
  #
538
- # `&Attribute.1=first`
555
+ # `&AttributeName.1=first`
539
556
  #
540
- # `&Attribute.2=second`
557
+ # `&AttributeName.2=second`
541
558
  #
542
559
  # @option params [required, String] :queue_url
543
560
  # The URL of the Amazon SQS queue whose messages' visibility is
@@ -587,7 +604,7 @@ module Aws::SQS
587
604
  end
588
605
 
589
606
  # Creates a new standard or FIFO queue. You can pass one or more
590
- # attributes in the request. Keep the following caveats in mind:
607
+ # attributes in the request. Keep the following in mind:
591
608
  #
592
609
  # * If you don't specify the `FifoQueue` attribute, Amazon SQS creates
593
610
  # a standard queue.
@@ -611,6 +628,11 @@ module Aws::SQS
611
628
  # adheres to the [limits related to queues][2] and is unique within the
612
629
  # scope of your queues.
613
630
  #
631
+ # <note markdown="1"> After you create a queue, you must wait at least one second after the
632
+ # queue is created to be able to use the queue.
633
+ #
634
+ # </note>
635
+ #
614
636
  # To get the queue URL, use the ` GetQueueUrl ` action. ` GetQueueUrl `
615
637
  # requires only the `QueueName` parameter. be aware of existing queue
616
638
  # names:
@@ -626,9 +648,9 @@ module Aws::SQS
626
648
  # the `param.n` notation. Values of `n` are integers starting from 1.
627
649
  # For example, a parameter list with two elements looks like this:
628
650
  #
629
- # `&Attribute.1=first`
651
+ # `&AttributeName.1=first`
630
652
  #
631
- # `&Attribute.2=second`
653
+ # `&AttributeName.2=second`
632
654
  #
633
655
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
634
656
  # information, see [Grant Cross-Account Permissions to a Role and a User
@@ -660,39 +682,39 @@ module Aws::SQS
660
682
  # The following lists the names, descriptions, and values of the special
661
683
  # request parameters that the `CreateQueue` action uses:
662
684
  #
663
- # * `DelaySeconds` - The length of time, in seconds, for which the
685
+ # * `DelaySeconds` The length of time, in seconds, for which the
664
686
  # delivery of all messages in the queue is delayed. Valid values: An
665
687
  # integer from 0 to 900 seconds (15 minutes). Default: 0.
666
688
  #
667
- # * `MaximumMessageSize` - The limit of how many bytes a message can
689
+ # * `MaximumMessageSize` The limit of how many bytes a message can
668
690
  # contain before Amazon SQS rejects it. Valid values: An integer from
669
691
  # 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). Default: 262,144
670
692
  # (256 KiB).
671
693
  #
672
- # * `MessageRetentionPeriod` - The length of time, in seconds, for which
694
+ # * `MessageRetentionPeriod` The length of time, in seconds, for which
673
695
  # Amazon SQS retains a message. Valid values: An integer from 60
674
696
  # seconds (1 minute) to 1,209,600 seconds (14 days). Default: 345,600
675
697
  # (4 days).
676
698
  #
677
- # * `Policy` - The queue's policy. A valid AWS policy. For more
699
+ # * `Policy` The queue's policy. A valid AWS policy. For more
678
700
  # information about policy structure, see [Overview of AWS IAM
679
701
  # Policies][1] in the *Amazon IAM User Guide*.
680
702
  #
681
- # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
703
+ # * `ReceiveMessageWaitTimeSeconds` The length of time, in seconds,
682
704
  # for which a ` ReceiveMessage ` action waits for a message to arrive.
683
705
  # Valid values: An integer from 0 to 20 (seconds). Default: 0.
684
706
  #
685
- # * `RedrivePolicy` - The string that includes the parameters for the
686
- # dead-letter queue functionality of the source queue. For more
687
- # information about the redrive policy and dead-letter queues, see
688
- # [Using Amazon SQS Dead-Letter Queues][2] in the *Amazon Simple Queue
689
- # Service Developer Guide*.
707
+ # * `RedrivePolicy` The string that includes the parameters for the
708
+ # dead-letter queue functionality of the source queue as a JSON
709
+ # object. For more information about the redrive policy and
710
+ # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2] in
711
+ # the *Amazon Simple Queue Service Developer Guide*.
690
712
  #
691
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
713
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
692
714
  # dead-letter queue to which Amazon SQS moves messages after the
693
715
  # value of `maxReceiveCount` is exceeded.
694
716
  #
695
- # * `maxReceiveCount` - The number of times a message is delivered to
717
+ # * `maxReceiveCount` The number of times a message is delivered to
696
718
  # the source queue before being moved to the dead-letter queue. When
697
719
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
698
720
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
@@ -703,7 +725,7 @@ module Aws::SQS
703
725
  #
704
726
  # </note>
705
727
  #
706
- # * `VisibilityTimeout` - The visibility timeout for the queue, in
728
+ # * `VisibilityTimeout` The visibility timeout for the queue, in
707
729
  # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
708
730
  # Default: 30. For more information about the visibility timeout, see
709
731
  # [Visibility Timeout][3] in the *Amazon Simple Queue Service
@@ -711,14 +733,14 @@ module Aws::SQS
711
733
  #
712
734
  # The following attributes apply only to [server-side-encryption][4]\:
713
735
  #
714
- # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
736
+ # * `KmsMasterKeyId` The ID of an AWS-managed customer master key
715
737
  # (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
716
738
  # Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
717
739
  # always `alias/aws/sqs`, the alias of a custom CMK can, for example,
718
740
  # be `alias/MyAlias `. For more examples, see [KeyId][6] in the *AWS
719
741
  # Key Management Service API Reference*.
720
742
  #
721
- # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
743
+ # * `KmsDataKeyReusePeriodSeconds` The length of time, in seconds, for
722
744
  # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
723
745
  # messages before calling AWS KMS again. An integer representing
724
746
  # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
@@ -730,7 +752,7 @@ module Aws::SQS
730
752
  # The following attributes apply only to [FIFO (first-in-first-out)
731
753
  # queues][9]\:
732
754
  #
733
- # * `FifoQueue` - Designates a queue as FIFO. Valid values: `true`,
755
+ # * `FifoQueue` Designates a queue as FIFO. Valid values: `true`,
734
756
  # `false`. If you don't specify the `FifoQueue` attribute, Amazon SQS
735
757
  # creates a standard queue. You can provide this attribute only during
736
758
  # queue creation. You can't change it for an existing queue. When you
@@ -740,7 +762,7 @@ module Aws::SQS
740
762
  # For more information, see [FIFO Queue Logic][10] in the *Amazon
741
763
  # Simple Queue Service Developer Guide*.
742
764
  #
743
- # * `ContentBasedDeduplication` - Enables content-based deduplication.
765
+ # * `ContentBasedDeduplication` Enables content-based deduplication.
744
766
  # Valid values: `true`, `false`. For more information, see
745
767
  # [Exactly-Once Processing][11] in the *Amazon Simple Queue Service
746
768
  # Developer Guide*.
@@ -914,9 +936,9 @@ module Aws::SQS
914
936
  # the `param.n` notation. Values of `n` are integers starting from 1.
915
937
  # For example, a parameter list with two elements looks like this:
916
938
  #
917
- # `&Attribute.1=first`
939
+ # `&AttributeName.1=first`
918
940
  #
919
- # `&Attribute.2=second`
941
+ # `&AttributeName.2=second`
920
942
  #
921
943
  # @option params [required, String] :queue_url
922
944
  # The URL of the Amazon SQS queue from which messages are deleted.
@@ -963,8 +985,7 @@ module Aws::SQS
963
985
  end
964
986
 
965
987
  # Deletes the queue specified by the `QueueUrl`, regardless of the
966
- # queue's contents. If the specified queue doesn't exist, Amazon SQS
967
- # returns a successful response.
988
+ # queue's contents.
968
989
  #
969
990
  # Be careful with the `DeleteQueue` action: When you delete a queue, any
970
991
  # messages in the queue are no longer available.
@@ -1016,14 +1037,6 @@ module Aws::SQS
1016
1037
  #
1017
1038
  # </note>
1018
1039
  #
1019
- # Some actions take lists of parameters. These lists are specified using
1020
- # the `param.n` notation. Values of `n` are integers starting from 1.
1021
- # For example, a parameter list with two elements looks like this:
1022
- #
1023
- # `&Attribute.1=first`
1024
- #
1025
- # `&Attribute.2=second`
1026
- #
1027
1040
  #
1028
1041
  #
1029
1042
  # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
@@ -1045,70 +1058,77 @@ module Aws::SQS
1045
1058
  #
1046
1059
  # The following attributes are supported:
1047
1060
  #
1048
- # * `All` - Returns all values.
1061
+ # The `ApproximateNumberOfMessagesDelayed`,
1062
+ # `ApproximateNumberOfMessagesNotVisible`, and
1063
+ # `ApproximateNumberOfMessagesVisible` metrics may not achieve
1064
+ # consistency until at least 1 minute after the producers stop sending
1065
+ # messages. This period is required for the queue metadata to reach
1066
+ # eventual consistency.
1067
+ #
1068
+ # * `All` – Returns all values.
1049
1069
  #
1050
- # * `ApproximateNumberOfMessages` - Returns the approximate number of
1070
+ # * `ApproximateNumberOfMessages` Returns the approximate number of
1051
1071
  # messages available for retrieval from the queue.
1052
1072
  #
1053
- # * `ApproximateNumberOfMessagesDelayed` - Returns the approximate
1073
+ # * `ApproximateNumberOfMessagesDelayed` Returns the approximate
1054
1074
  # number of messages in the queue that are delayed and not available
1055
1075
  # for reading immediately. This can happen when the queue is
1056
1076
  # configured as a delay queue or when a message has been sent with a
1057
1077
  # delay parameter.
1058
1078
  #
1059
- # * `ApproximateNumberOfMessagesNotVisible` - Returns the approximate
1079
+ # * `ApproximateNumberOfMessagesNotVisible` Returns the approximate
1060
1080
  # number of messages that are in flight. Messages are considered to be
1061
1081
  # *in flight* if they have been sent to a client but have not yet been
1062
1082
  # deleted or have not yet reached the end of their visibility window.
1063
1083
  #
1064
- # * `CreatedTimestamp` - Returns the time when the queue was created in
1084
+ # * `CreatedTimestamp` Returns the time when the queue was created in
1065
1085
  # seconds ([epoch time][1]).
1066
1086
  #
1067
- # * `DelaySeconds` - Returns the default delay on the queue in seconds.
1087
+ # * `DelaySeconds` Returns the default delay on the queue in seconds.
1068
1088
  #
1069
- # * `LastModifiedTimestamp` - Returns the time when the queue was last
1089
+ # * `LastModifiedTimestamp` Returns the time when the queue was last
1070
1090
  # changed in seconds ([epoch time][1]).
1071
1091
  #
1072
- # * `MaximumMessageSize` - Returns the limit of how many bytes a message
1092
+ # * `MaximumMessageSize` Returns the limit of how many bytes a message
1073
1093
  # can contain before Amazon SQS rejects it.
1074
1094
  #
1075
- # * `MessageRetentionPeriod` - Returns the length of time, in seconds,
1095
+ # * `MessageRetentionPeriod` Returns the length of time, in seconds,
1076
1096
  # for which Amazon SQS retains a message.
1077
1097
  #
1078
- # * `Policy` - Returns the policy of the queue.
1098
+ # * `Policy` Returns the policy of the queue.
1079
1099
  #
1080
- # * `QueueArn` - Returns the Amazon resource name (ARN) of the queue.
1100
+ # * `QueueArn` Returns the Amazon resource name (ARN) of the queue.
1081
1101
  #
1082
- # * `ReceiveMessageWaitTimeSeconds` - Returns the length of time, in
1102
+ # * `ReceiveMessageWaitTimeSeconds` Returns the length of time, in
1083
1103
  # seconds, for which the `ReceiveMessage` action waits for a message
1084
1104
  # to arrive.
1085
1105
  #
1086
- # * `RedrivePolicy` - Returns the string that includes the parameters
1087
- # for dead-letter queue functionality of the source queue. For more
1088
- # information about the redrive policy and dead-letter queues, see
1089
- # [Using Amazon SQS Dead-Letter Queues][2] in the *Amazon Simple Queue
1090
- # Service Developer Guide*.
1106
+ # * `RedrivePolicy` The string that includes the parameters for the
1107
+ # dead-letter queue functionality of the source queue as a JSON
1108
+ # object. For more information about the redrive policy and
1109
+ # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2] in
1110
+ # the *Amazon Simple Queue Service Developer Guide*.
1091
1111
  #
1092
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
1112
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
1093
1113
  # dead-letter queue to which Amazon SQS moves messages after the
1094
1114
  # value of `maxReceiveCount` is exceeded.
1095
1115
  #
1096
- # * `maxReceiveCount` - The number of times a message is delivered to
1116
+ # * `maxReceiveCount` The number of times a message is delivered to
1097
1117
  # the source queue before being moved to the dead-letter queue. When
1098
1118
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
1099
1119
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
1100
1120
  #
1101
- # * `VisibilityTimeout` - Returns the visibility timeout for the queue.
1121
+ # * `VisibilityTimeout` Returns the visibility timeout for the queue.
1102
1122
  # For more information about the visibility timeout, see [Visibility
1103
1123
  # Timeout][3] in the *Amazon Simple Queue Service Developer Guide*.
1104
1124
  #
1105
1125
  # The following attributes apply only to [server-side-encryption][4]\:
1106
1126
  #
1107
- # * `KmsMasterKeyId` - Returns the ID of an AWS-managed customer master
1127
+ # * `KmsMasterKeyId` Returns the ID of an AWS-managed customer master
1108
1128
  # key (CMK) for Amazon SQS or a custom CMK. For more information, see
1109
1129
  # [Key Terms][5].
1110
1130
  #
1111
- # * `KmsDataKeyReusePeriodSeconds` - Returns the length of time, in
1131
+ # * `KmsDataKeyReusePeriodSeconds` Returns the length of time, in
1112
1132
  # seconds, for which Amazon SQS can reuse a data key to encrypt or
1113
1133
  # decrypt messages before calling AWS KMS again. For more information,
1114
1134
  # see [How Does the Data Key Reuse Period Work?][6].
@@ -1116,7 +1136,7 @@ module Aws::SQS
1116
1136
  # The following attributes apply only to [FIFO (first-in-first-out)
1117
1137
  # queues][7]\:
1118
1138
  #
1119
- # * `FifoQueue` - Returns whether the queue is FIFO. For more
1139
+ # * `FifoQueue` Returns whether the queue is FIFO. For more
1120
1140
  # information, see [FIFO Queue Logic][8] in the *Amazon Simple Queue
1121
1141
  # Service Developer Guide*.
1122
1142
  #
@@ -1125,7 +1145,7 @@ module Aws::SQS
1125
1145
  #
1126
1146
  # </note>
1127
1147
  #
1128
- # * `ContentBasedDeduplication` - Returns whether content-based
1148
+ # * `ContentBasedDeduplication` Returns whether content-based
1129
1149
  # deduplication is enabled for the queue. For more information, see
1130
1150
  # [Exactly-Once Processing][9] in the *Amazon Simple Queue Service
1131
1151
  # Developer Guide*.
@@ -1217,6 +1237,15 @@ module Aws::SQS
1217
1237
  # Returns a list of your queues that have the `RedrivePolicy` queue
1218
1238
  # attribute configured with a dead-letter queue.
1219
1239
  #
1240
+ # The `ListDeadLetterSourceQueues` methods supports pagination. Set
1241
+ # parameter `MaxResults` in the request to specify the maximum number of
1242
+ # results to be returned in the response. If you do not set
1243
+ # `MaxResults`, the response includes a maximum of 1,000 results. If you
1244
+ # set `MaxResults` and there are additional results to display, the
1245
+ # response includes a value for `NextToken`. Use `NextToken` as a
1246
+ # parameter in your next request to `ListDeadLetterSourceQueues` to
1247
+ # receive the next page of results.
1248
+ #
1220
1249
  # For more information about using dead-letter queues, see [Using Amazon
1221
1250
  # SQS Dead-Letter Queues][1] in the *Amazon Simple Queue Service
1222
1251
  # Developer Guide*.
@@ -1230,20 +1259,34 @@ module Aws::SQS
1230
1259
  #
1231
1260
  # Queue URLs and names are case-sensitive.
1232
1261
  #
1262
+ # @option params [String] :next_token
1263
+ # Pagination token to request the next set of results.
1264
+ #
1265
+ # @option params [Integer] :max_results
1266
+ # Maximum number of results to include in the response. Value range is 1
1267
+ # to 1000. You must set `MaxResults` to receive a value for `NextToken`
1268
+ # in the response.
1269
+ #
1233
1270
  # @return [Types::ListDeadLetterSourceQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1234
1271
  #
1235
1272
  # * {Types::ListDeadLetterSourceQueuesResult#queue_urls #queue_urls} => Array&lt;String&gt;
1273
+ # * {Types::ListDeadLetterSourceQueuesResult#next_token #next_token} => String
1274
+ #
1275
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1236
1276
  #
1237
1277
  # @example Request syntax with placeholder values
1238
1278
  #
1239
1279
  # resp = client.list_dead_letter_source_queues({
1240
1280
  # queue_url: "String", # required
1281
+ # next_token: "Token",
1282
+ # max_results: 1,
1241
1283
  # })
1242
1284
  #
1243
1285
  # @example Response structure
1244
1286
  #
1245
1287
  # resp.queue_urls #=> Array
1246
1288
  # resp.queue_urls[0] #=> String
1289
+ # resp.next_token #=> String
1247
1290
  #
1248
1291
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListDeadLetterSourceQueues AWS API Documentation
1249
1292
  #
@@ -1296,10 +1339,18 @@ module Aws::SQS
1296
1339
  req.send_request(options)
1297
1340
  end
1298
1341
 
1299
- # Returns a list of your queues. The maximum number of queues that can
1300
- # be returned is 1,000. If you specify a value for the optional
1301
- # `QueueNamePrefix` parameter, only queues with a name that begins with
1302
- # the specified value are returned.
1342
+ # Returns a list of your queues in the current region. The response
1343
+ # includes a maximum of 1,000 results. If you specify a value for the
1344
+ # optional `QueueNamePrefix` parameter, only queues with a name that
1345
+ # begins with the specified value are returned.
1346
+ #
1347
+ # The `listQueues` methods supports pagination. Set parameter
1348
+ # `MaxResults` in the request to specify the maximum number of results
1349
+ # to be returned in the response. If you do not set `MaxResults`, the
1350
+ # response includes a maximum of 1,000 results. If you set `MaxResults`
1351
+ # and there are additional results to display, the response includes a
1352
+ # value for `NextToken`. Use `NextToken` as a parameter in your next
1353
+ # request to `listQueues` to receive the next page of results.
1303
1354
  #
1304
1355
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1305
1356
  # information, see [Grant Cross-Account Permissions to a Role and a User
@@ -1317,20 +1368,34 @@ module Aws::SQS
1317
1368
  #
1318
1369
  # Queue URLs and names are case-sensitive.
1319
1370
  #
1371
+ # @option params [String] :next_token
1372
+ # Pagination token to request the next set of results.
1373
+ #
1374
+ # @option params [Integer] :max_results
1375
+ # Maximum number of results to include in the response. Value range is 1
1376
+ # to 1000. You must set `MaxResults` to receive a value for `NextToken`
1377
+ # in the response.
1378
+ #
1320
1379
  # @return [Types::ListQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1321
1380
  #
1322
1381
  # * {Types::ListQueuesResult#queue_urls #queue_urls} => Array&lt;String&gt;
1382
+ # * {Types::ListQueuesResult#next_token #next_token} => String
1383
+ #
1384
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1323
1385
  #
1324
1386
  # @example Request syntax with placeholder values
1325
1387
  #
1326
1388
  # resp = client.list_queues({
1327
1389
  # queue_name_prefix: "String",
1390
+ # next_token: "Token",
1391
+ # max_results: 1,
1328
1392
  # })
1329
1393
  #
1330
1394
  # @example Response structure
1331
1395
  #
1332
1396
  # resp.queue_urls #=> Array
1333
1397
  # resp.queue_urls[0] #=> String
1398
+ # resp.next_token #=> String
1334
1399
  #
1335
1400
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueues AWS API Documentation
1336
1401
  #
@@ -1445,15 +1510,15 @@ module Aws::SQS
1445
1510
  # A list of attributes that need to be returned along with each message.
1446
1511
  # These attributes include:
1447
1512
  #
1448
- # * `All` - Returns all values.
1513
+ # * `All` Returns all values.
1449
1514
  #
1450
- # * `ApproximateFirstReceiveTimestamp` - Returns the time the message
1515
+ # * `ApproximateFirstReceiveTimestamp` Returns the time the message
1451
1516
  # was first received from the queue ([epoch time][1] in milliseconds).
1452
1517
  #
1453
- # * `ApproximateReceiveCount` - Returns the number of times a message
1454
- # has been received from the queue but not deleted.
1518
+ # * `ApproximateReceiveCount` Returns the number of times a message
1519
+ # has been received across all queues but not deleted.
1455
1520
  #
1456
- # * `AWSTraceHeader` - Returns the AWS X-Ray trace header string.
1521
+ # * `AWSTraceHeader` Returns the AWS X-Ray trace header string.
1457
1522
  #
1458
1523
  # * `SenderId`
1459
1524
  #
@@ -1463,17 +1528,17 @@ module Aws::SQS
1463
1528
  # * For an IAM role, returns the IAM role ID, for example
1464
1529
  # `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
1465
1530
  #
1466
- # * `SentTimestamp` - Returns the time the message was sent to the queue
1531
+ # * `SentTimestamp` Returns the time the message was sent to the queue
1467
1532
  # ([epoch time][1] in milliseconds).
1468
1533
  #
1469
- # * `MessageDeduplicationId` - Returns the value provided by the
1534
+ # * `MessageDeduplicationId` Returns the value provided by the
1470
1535
  # producer that calls the ` SendMessage ` action.
1471
1536
  #
1472
- # * `MessageGroupId` - Returns the value provided by the producer that
1537
+ # * `MessageGroupId` Returns the value provided by the producer that
1473
1538
  # calls the ` SendMessage ` action. Messages with the same
1474
1539
  # `MessageGroupId` are returned in sequence.
1475
1540
  #
1476
- # * `SequenceNumber` - Returns the value provided by Amazon SQS.
1541
+ # * `SequenceNumber` Returns the value provided by Amazon SQS.
1477
1542
  #
1478
1543
  #
1479
1544
  #
@@ -1518,14 +1583,25 @@ module Aws::SQS
1518
1583
  # available and the wait time expires, the call returns successfully
1519
1584
  # with an empty list of messages.
1520
1585
  #
1586
+ # To avoid HTTP errors, ensure that the HTTP response timeout for
1587
+ # `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
1588
+ # parameter. For example, with the Java SDK, you can set HTTP transport
1589
+ # settings using the [ NettyNioAsyncHttpClient][1] for asynchronous
1590
+ # clients, or the [ ApacheHttpClient][2] for synchronous clients.
1591
+ #
1592
+ #
1593
+ #
1594
+ # [1]: https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.html
1595
+ # [2]: https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/apache/ApacheHttpClient.html
1596
+ #
1521
1597
  # @option params [String] :receive_request_attempt_id
1522
1598
  # This parameter applies only to FIFO (first-in-first-out) queues.
1523
1599
  #
1524
1600
  # The token used for deduplication of `ReceiveMessage` calls. If a
1525
1601
  # networking issue occurs after a `ReceiveMessage` action, and instead
1526
- # of a response you receive a generic error, you can retry the same
1527
- # action with an identical `ReceiveRequestAttemptId` to retrieve the
1528
- # same set of messages, even if their visibility timeout has not yet
1602
+ # of a response you receive a generic error, it is possible to retry the
1603
+ # same action with an identical `ReceiveRequestAttemptId` to retrieve
1604
+ # the same set of messages, even if their visibility timeout has not yet
1529
1605
  # expired.
1530
1606
  #
1531
1607
  # * You can use `ReceiveRequestAttemptId` only for 5 minutes after a
@@ -1538,7 +1614,7 @@ module Aws::SQS
1538
1614
  # `ReceiveRequestAttemptId`, Amazon SQS generates a
1539
1615
  # `ReceiveRequestAttemptId`.
1540
1616
  #
1541
- # * You can retry the `ReceiveMessage` action with the same
1617
+ # * It is possible to retry the `ReceiveMessage` action with the same
1542
1618
  # `ReceiveRequestAttemptId` if none of the messages have been modified
1543
1619
  # (deleted or had their visibility changes).
1544
1620
  #
@@ -1569,7 +1645,7 @@ module Aws::SQS
1569
1645
  # visibility timeout expires. As a result, delays might occur but the
1570
1646
  # messages in the queue remain in a strict order.
1571
1647
  #
1572
- # The length of `ReceiveRequestAttemptId` is 128 characters.
1648
+ # The maximum length of `ReceiveRequestAttemptId` is 128 characters.
1573
1649
  # `ReceiveRequestAttemptId` can contain alphanumeric characters (`a-z`,
1574
1650
  # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
1575
1651
  # ``).
@@ -1694,7 +1770,8 @@ module Aws::SQS
1694
1770
  # Queue URLs and names are case-sensitive.
1695
1771
  #
1696
1772
  # @option params [required, String] :message_body
1697
- # The message to send. The maximum string size is 256 KB.
1773
+ # The message to send. The minimum size is one character. The maximum
1774
+ # size is 256 KB.
1698
1775
  #
1699
1776
  # A message can include only XML, JSON, and unformatted text. The
1700
1777
  # following Unicode characters are allowed:
@@ -1728,7 +1805,7 @@ module Aws::SQS
1728
1805
  #
1729
1806
  #
1730
1807
  #
1731
- # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html
1808
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
1732
1809
  #
1733
1810
  # @option params [Hash<String,Types::MessageSystemAttributeValue>] :message_system_attributes
1734
1811
  # The message system attribute to send. Each message system attribute
@@ -1736,7 +1813,7 @@ module Aws::SQS
1736
1813
  #
1737
1814
  # * Currently, the only supported message system attribute is
1738
1815
  # `AWSTraceHeader`. Its type must be `String` and its value must be a
1739
- # correctly formatted AWS X-Ray trace string.
1816
+ # correctly formatted AWS X-Ray trace header string.
1740
1817
  #
1741
1818
  # * The size of a message system attribute doesn't count towards the
1742
1819
  # total size of a message.
@@ -1789,7 +1866,7 @@ module Aws::SQS
1789
1866
  #
1790
1867
  # </note>
1791
1868
  #
1792
- # The length of `MessageDeduplicationId` is 128 characters.
1869
+ # The maximum length of `MessageDeduplicationId` is 128 characters.
1793
1870
  # `MessageDeduplicationId` can contain alphanumeric characters (`a-z`,
1794
1871
  # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
1795
1872
  # ``).
@@ -1919,9 +1996,9 @@ module Aws::SQS
1919
1996
  # the `param.n` notation. Values of `n` are integers starting from 1.
1920
1997
  # For example, a parameter list with two elements looks like this:
1921
1998
  #
1922
- # `&Attribute.1=first`
1999
+ # `&AttributeName.1=first`
1923
2000
  #
1924
- # `&Attribute.2=second`
2001
+ # `&AttributeName.2=second`
1925
2002
  #
1926
2003
  #
1927
2004
  #
@@ -2032,39 +2109,39 @@ module Aws::SQS
2032
2109
  # The following lists the names, descriptions, and values of the special
2033
2110
  # request parameters that the `SetQueueAttributes` action uses:
2034
2111
  #
2035
- # * `DelaySeconds` - The length of time, in seconds, for which the
2112
+ # * `DelaySeconds` The length of time, in seconds, for which the
2036
2113
  # delivery of all messages in the queue is delayed. Valid values: An
2037
2114
  # integer from 0 to 900 (15 minutes). Default: 0.
2038
2115
  #
2039
- # * `MaximumMessageSize` - The limit of how many bytes a message can
2116
+ # * `MaximumMessageSize` The limit of how many bytes a message can
2040
2117
  # contain before Amazon SQS rejects it. Valid values: An integer from
2041
2118
  # 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). Default: 262,144
2042
2119
  # (256 KiB).
2043
2120
  #
2044
- # * `MessageRetentionPeriod` - The length of time, in seconds, for which
2121
+ # * `MessageRetentionPeriod` The length of time, in seconds, for which
2045
2122
  # Amazon SQS retains a message. Valid values: An integer representing
2046
2123
  # seconds, from 60 (1 minute) to 1,209,600 (14 days). Default: 345,600
2047
2124
  # (4 days).
2048
2125
  #
2049
- # * `Policy` - The queue's policy. A valid AWS policy. For more
2126
+ # * `Policy` The queue's policy. A valid AWS policy. For more
2050
2127
  # information about policy structure, see [Overview of AWS IAM
2051
2128
  # Policies][1] in the *Amazon IAM User Guide*.
2052
2129
  #
2053
- # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
2130
+ # * `ReceiveMessageWaitTimeSeconds` The length of time, in seconds,
2054
2131
  # for which a ` ReceiveMessage ` action waits for a message to arrive.
2055
- # Valid values: an integer from 0 to 20 (seconds). Default: 0.
2132
+ # Valid values: An integer from 0 to 20 (seconds). Default: 0.
2056
2133
  #
2057
- # * `RedrivePolicy` - The string that includes the parameters for the
2058
- # dead-letter queue functionality of the source queue. For more
2059
- # information about the redrive policy and dead-letter queues, see
2060
- # [Using Amazon SQS Dead-Letter Queues][2] in the *Amazon Simple Queue
2061
- # Service Developer Guide*.
2134
+ # * `RedrivePolicy` The string that includes the parameters for the
2135
+ # dead-letter queue functionality of the source queue as a JSON
2136
+ # object. For more information about the redrive policy and
2137
+ # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2] in
2138
+ # the *Amazon Simple Queue Service Developer Guide*.
2062
2139
  #
2063
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
2140
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
2064
2141
  # dead-letter queue to which Amazon SQS moves messages after the
2065
2142
  # value of `maxReceiveCount` is exceeded.
2066
2143
  #
2067
- # * `maxReceiveCount` - The number of times a message is delivered to
2144
+ # * `maxReceiveCount` The number of times a message is delivered to
2068
2145
  # the source queue before being moved to the dead-letter queue. When
2069
2146
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
2070
2147
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
@@ -2075,22 +2152,22 @@ module Aws::SQS
2075
2152
  #
2076
2153
  # </note>
2077
2154
  #
2078
- # * `VisibilityTimeout` - The visibility timeout for the queue, in
2079
- # seconds. Valid values: an integer from 0 to 43,200 (12 hours).
2155
+ # * `VisibilityTimeout` The visibility timeout for the queue, in
2156
+ # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
2080
2157
  # Default: 30. For more information about the visibility timeout, see
2081
2158
  # [Visibility Timeout][3] in the *Amazon Simple Queue Service
2082
2159
  # Developer Guide*.
2083
2160
  #
2084
2161
  # The following attributes apply only to [server-side-encryption][4]\:
2085
2162
  #
2086
- # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
2163
+ # * `KmsMasterKeyId` The ID of an AWS-managed customer master key
2087
2164
  # (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
2088
2165
  # Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
2089
2166
  # always `alias/aws/sqs`, the alias of a custom CMK can, for example,
2090
2167
  # be `alias/MyAlias `. For more examples, see [KeyId][6] in the *AWS
2091
2168
  # Key Management Service API Reference*.
2092
2169
  #
2093
- # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
2170
+ # * `KmsDataKeyReusePeriodSeconds` The length of time, in seconds, for
2094
2171
  # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
2095
2172
  # messages before calling AWS KMS again. An integer representing
2096
2173
  # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
@@ -2102,7 +2179,7 @@ module Aws::SQS
2102
2179
  # The following attribute applies only to [FIFO (first-in-first-out)
2103
2180
  # queues][9]\:
2104
2181
  #
2105
- # * `ContentBasedDeduplication` - Enables content-based deduplication.
2182
+ # * `ContentBasedDeduplication` Enables content-based deduplication.
2106
2183
  # For more information, see [Exactly-Once Processing][10] in the
2107
2184
  # *Amazon Simple Queue Service Developer Guide*.
2108
2185
  #
@@ -2276,7 +2353,7 @@ module Aws::SQS
2276
2353
  params: params,
2277
2354
  config: config)
2278
2355
  context[:gem_name] = 'aws-sdk-sqs'
2279
- context[:gem_version] = '1.27.1'
2356
+ context[:gem_version] = '1.32.0'
2280
2357
  Seahorse::Client::Request.new(handlers, context)
2281
2358
  end
2282
2359