aws-sdk-sqs 1.27.1 → 1.38.0

Sign up to get free protection for your applications and to get access to all the features.
data/VERSION ADDED
@@ -0,0 +1 @@
1
+ 1.38.0
data/lib/aws-sdk-sqs.rb CHANGED
@@ -1,10 +1,13 @@
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:
4
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
5
7
  #
6
8
  # WARNING ABOUT GENERATED CODE
7
9
 
10
+
8
11
  require 'aws-sdk-core'
9
12
  require 'aws-sigv4'
10
13
 
@@ -44,9 +47,9 @@ require_relative 'aws-sdk-sqs/customizations'
44
47
  #
45
48
  # See {Errors} for more information.
46
49
  #
47
- # @service
50
+ # @!group service
48
51
  module Aws::SQS
49
52
 
50
- GEM_VERSION = '1.27.1'
53
+ GEM_VERSION = '1.38.0'
51
54
 
52
55
  end
@@ -1,7 +1,9 @@
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:
4
- # https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
5
7
  #
6
8
  # WARNING ABOUT GENERATED CODE
7
9
 
@@ -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,13 +363,13 @@ 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
- # information, see [Grant Cross-Account Permissions to a Role and a User
355
- # Name][4] in the *Amazon Simple Queue Service Developer Guide*.
371
+ # information, see [Grant cross-account permissions to a role and a user
372
+ # name][4] in the *Amazon Simple Queue Service Developer Guide*.
356
373
  #
357
374
  # </note>
358
375
  #
@@ -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,13 +648,13 @@ 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
- # information, see [Grant Cross-Account Permissions to a Role and a User
635
- # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
656
+ # information, see [Grant cross-account permissions to a role and a user
657
+ # name][3] in the *Amazon Simple Queue Service Developer Guide*.
636
658
  #
637
659
  # </note>
638
660
  #
@@ -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,22 +752,22 @@ 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`,
734
- # `false`. If you don't specify the `FifoQueue` attribute, Amazon SQS
735
- # creates a standard queue. You can provide this attribute only during
736
- # queue creation. You can't change it for an existing queue. When you
737
- # set this attribute, you must also provide the `MessageGroupId` for
738
- # your messages explicitly.
755
+ # * `FifoQueue` Designates a queue as FIFO. Valid values are `true`
756
+ # and `false`. If you don't specify the `FifoQueue` attribute, Amazon
757
+ # SQS creates a standard queue. You can provide this attribute only
758
+ # during queue creation. You can't change it for an existing queue.
759
+ # When you set this attribute, you must also provide the
760
+ # `MessageGroupId` for your messages explicitly.
739
761
  #
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.
744
- # Valid values: `true`, `false`. For more information, see
765
+ # * `ContentBasedDeduplication` Enables content-based deduplication.
766
+ # Valid values are `true` and `false`. For more information, see
745
767
  # [Exactly-Once Processing][11] in the *Amazon Simple Queue Service
746
- # Developer Guide*.
768
+ # Developer Guide*. Note the following:
747
769
  #
748
- # * Every message must have a unique `MessageDeduplicationId`,
770
+ # * Every message must have a unique `MessageDeduplicationId`.
749
771
  #
750
772
  # * You may provide a `MessageDeduplicationId` explicitly.
751
773
  #
@@ -773,6 +795,50 @@ module Aws::SQS
773
795
  # `MessageDeduplicationId`, the two messages are treated as
774
796
  # duplicates and only one copy of the message is delivered.
775
797
  #
798
+ # **Preview: High throughput for FIFO queues**
799
+ #
800
+ # **High throughput for Amazon SQS FIFO queues is in preview release and
801
+ # is subject to change.** This feature provides a high number of
802
+ # transactions per second (TPS) for messages in FIFO queues. For
803
+ # information on throughput quotas, see [Quotas related to messages][12]
804
+ # in the *Amazon Simple Queue Service Developer Guide*.
805
+ #
806
+ # This preview includes two new attributes:
807
+ #
808
+ # * `DeduplicationScope` – Specifies whether message deduplication
809
+ # occurs at the message group or queue level. Valid values are
810
+ # `messageGroup` and `queue`.
811
+ #
812
+ # * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
813
+ # quota applies to the entire queue or per message group. Valid values
814
+ # are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
815
+ # value is allowed only when the value for `DeduplicationScope` is
816
+ # `messageGroup`.
817
+ #
818
+ # To enable high throughput for FIFO queues, do the following:
819
+ #
820
+ # * Set `DeduplicationScope` to `messageGroup`.
821
+ #
822
+ # * Set `FifoThroughputLimit` to `perMessageGroupId`.
823
+ #
824
+ # If you set these attributes to anything other than the values shown
825
+ # for enabling high throughput, standard throughput is in effect and
826
+ # deduplication occurs as specified.
827
+ #
828
+ # This preview is available in the following AWS Regions:
829
+ #
830
+ # * US East (Ohio); us-east-2
831
+ #
832
+ # * US East (N. Virginia); us-east-1
833
+ #
834
+ # * US West (Oregon); us-west-2
835
+ #
836
+ # * Europe (Ireland); eu-west-1
837
+ #
838
+ # For more information about high throughput for FIFO queues, see
839
+ # [Preview: High throughput for FIFO queues][13] in the *Amazon Simple
840
+ # Queue Service Developer Guide*.
841
+ #
776
842
  #
777
843
  #
778
844
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
@@ -786,6 +852,8 @@ module Aws::SQS
786
852
  # [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
787
853
  # [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
788
854
  # [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
855
+ # [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
856
+ # [13]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
789
857
  #
790
858
  # @option params [Hash<String,String>] :tags
791
859
  # Add cost allocation tags to the specified Amazon SQS queue. For an
@@ -811,8 +879,8 @@ module Aws::SQS
811
879
  # `sqs:CreateQueue` and `sqs:TagQueue` permissions.
812
880
  #
813
881
  # Cross-account permissions don't apply to this action. For more
814
- # information, see [Grant Cross-Account Permissions to a Role and a User
815
- # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
882
+ # information, see [Grant cross-account permissions to a role and a user
883
+ # name][3] in the *Amazon Simple Queue Service Developer Guide*.
816
884
  #
817
885
  # </note>
818
886
  #
@@ -914,9 +982,9 @@ module Aws::SQS
914
982
  # the `param.n` notation. Values of `n` are integers starting from 1.
915
983
  # For example, a parameter list with two elements looks like this:
916
984
  #
917
- # `&Attribute.1=first`
985
+ # `&AttributeName.1=first`
918
986
  #
919
- # `&Attribute.2=second`
987
+ # `&AttributeName.2=second`
920
988
  #
921
989
  # @option params [required, String] :queue_url
922
990
  # The URL of the Amazon SQS queue from which messages are deleted.
@@ -963,8 +1031,7 @@ module Aws::SQS
963
1031
  end
964
1032
 
965
1033
  # 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.
1034
+ # queue's contents.
968
1035
  #
969
1036
  # Be careful with the `DeleteQueue` action: When you delete a queue, any
970
1037
  # messages in the queue are no longer available.
@@ -978,8 +1045,8 @@ module Aws::SQS
978
1045
  # creating a queue with the same name.
979
1046
  #
980
1047
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
981
- # information, see [Grant Cross-Account Permissions to a Role and a User
982
- # Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1048
+ # information, see [Grant cross-account permissions to a role and a user
1049
+ # name][1] in the *Amazon Simple Queue Service Developer Guide*.
983
1050
  #
984
1051
  # </note>
985
1052
  #
@@ -1016,14 +1083,6 @@ module Aws::SQS
1016
1083
  #
1017
1084
  # </note>
1018
1085
  #
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
1086
  #
1028
1087
  #
1029
1088
  # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
@@ -1045,70 +1104,77 @@ module Aws::SQS
1045
1104
  #
1046
1105
  # The following attributes are supported:
1047
1106
  #
1048
- # * `All` - Returns all values.
1107
+ # The `ApproximateNumberOfMessagesDelayed`,
1108
+ # `ApproximateNumberOfMessagesNotVisible`, and
1109
+ # `ApproximateNumberOfMessagesVisible` metrics may not achieve
1110
+ # consistency until at least 1 minute after the producers stop sending
1111
+ # messages. This period is required for the queue metadata to reach
1112
+ # eventual consistency.
1113
+ #
1114
+ # * `All` – Returns all values.
1049
1115
  #
1050
- # * `ApproximateNumberOfMessages` - Returns the approximate number of
1116
+ # * `ApproximateNumberOfMessages` Returns the approximate number of
1051
1117
  # messages available for retrieval from the queue.
1052
1118
  #
1053
- # * `ApproximateNumberOfMessagesDelayed` - Returns the approximate
1119
+ # * `ApproximateNumberOfMessagesDelayed` Returns the approximate
1054
1120
  # number of messages in the queue that are delayed and not available
1055
1121
  # for reading immediately. This can happen when the queue is
1056
1122
  # configured as a delay queue or when a message has been sent with a
1057
1123
  # delay parameter.
1058
1124
  #
1059
- # * `ApproximateNumberOfMessagesNotVisible` - Returns the approximate
1125
+ # * `ApproximateNumberOfMessagesNotVisible` Returns the approximate
1060
1126
  # number of messages that are in flight. Messages are considered to be
1061
1127
  # *in flight* if they have been sent to a client but have not yet been
1062
1128
  # deleted or have not yet reached the end of their visibility window.
1063
1129
  #
1064
- # * `CreatedTimestamp` - Returns the time when the queue was created in
1130
+ # * `CreatedTimestamp` Returns the time when the queue was created in
1065
1131
  # seconds ([epoch time][1]).
1066
1132
  #
1067
- # * `DelaySeconds` - Returns the default delay on the queue in seconds.
1133
+ # * `DelaySeconds` Returns the default delay on the queue in seconds.
1068
1134
  #
1069
- # * `LastModifiedTimestamp` - Returns the time when the queue was last
1135
+ # * `LastModifiedTimestamp` Returns the time when the queue was last
1070
1136
  # changed in seconds ([epoch time][1]).
1071
1137
  #
1072
- # * `MaximumMessageSize` - Returns the limit of how many bytes a message
1138
+ # * `MaximumMessageSize` Returns the limit of how many bytes a message
1073
1139
  # can contain before Amazon SQS rejects it.
1074
1140
  #
1075
- # * `MessageRetentionPeriod` - Returns the length of time, in seconds,
1141
+ # * `MessageRetentionPeriod` Returns the length of time, in seconds,
1076
1142
  # for which Amazon SQS retains a message.
1077
1143
  #
1078
- # * `Policy` - Returns the policy of the queue.
1144
+ # * `Policy` Returns the policy of the queue.
1079
1145
  #
1080
- # * `QueueArn` - Returns the Amazon resource name (ARN) of the queue.
1146
+ # * `QueueArn` Returns the Amazon resource name (ARN) of the queue.
1081
1147
  #
1082
- # * `ReceiveMessageWaitTimeSeconds` - Returns the length of time, in
1148
+ # * `ReceiveMessageWaitTimeSeconds` Returns the length of time, in
1083
1149
  # seconds, for which the `ReceiveMessage` action waits for a message
1084
1150
  # to arrive.
1085
1151
  #
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*.
1152
+ # * `RedrivePolicy` The string that includes the parameters for the
1153
+ # dead-letter queue functionality of the source queue as a JSON
1154
+ # object. For more information about the redrive policy and
1155
+ # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2] in
1156
+ # the *Amazon Simple Queue Service Developer Guide*.
1091
1157
  #
1092
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
1158
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
1093
1159
  # dead-letter queue to which Amazon SQS moves messages after the
1094
1160
  # value of `maxReceiveCount` is exceeded.
1095
1161
  #
1096
- # * `maxReceiveCount` - The number of times a message is delivered to
1162
+ # * `maxReceiveCount` The number of times a message is delivered to
1097
1163
  # the source queue before being moved to the dead-letter queue. When
1098
1164
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
1099
1165
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
1100
1166
  #
1101
- # * `VisibilityTimeout` - Returns the visibility timeout for the queue.
1167
+ # * `VisibilityTimeout` Returns the visibility timeout for the queue.
1102
1168
  # For more information about the visibility timeout, see [Visibility
1103
1169
  # Timeout][3] in the *Amazon Simple Queue Service Developer Guide*.
1104
1170
  #
1105
1171
  # The following attributes apply only to [server-side-encryption][4]\:
1106
1172
  #
1107
- # * `KmsMasterKeyId` - Returns the ID of an AWS-managed customer master
1173
+ # * `KmsMasterKeyId` Returns the ID of an AWS-managed customer master
1108
1174
  # key (CMK) for Amazon SQS or a custom CMK. For more information, see
1109
1175
  # [Key Terms][5].
1110
1176
  #
1111
- # * `KmsDataKeyReusePeriodSeconds` - Returns the length of time, in
1177
+ # * `KmsDataKeyReusePeriodSeconds` Returns the length of time, in
1112
1178
  # seconds, for which Amazon SQS can reuse a data key to encrypt or
1113
1179
  # decrypt messages before calling AWS KMS again. For more information,
1114
1180
  # see [How Does the Data Key Reuse Period Work?][6].
@@ -1116,20 +1182,64 @@ module Aws::SQS
1116
1182
  # The following attributes apply only to [FIFO (first-in-first-out)
1117
1183
  # queues][7]\:
1118
1184
  #
1119
- # * `FifoQueue` - Returns whether the queue is FIFO. For more
1120
- # information, see [FIFO Queue Logic][8] in the *Amazon Simple Queue
1121
- # Service Developer Guide*.
1185
+ # * `FifoQueue` Returns information about whether the queue is FIFO.
1186
+ # For more information, see [FIFO Queue Logic][8] in the *Amazon
1187
+ # Simple Queue Service Developer Guide*.
1122
1188
  #
1123
1189
  # <note markdown="1"> To determine whether a queue is [FIFO][7], you can check whether
1124
1190
  # `QueueName` ends with the `.fifo` suffix.
1125
1191
  #
1126
1192
  # </note>
1127
1193
  #
1128
- # * `ContentBasedDeduplication` - Returns whether content-based
1194
+ # * `ContentBasedDeduplication` Returns whether content-based
1129
1195
  # deduplication is enabled for the queue. For more information, see
1130
1196
  # [Exactly-Once Processing][9] in the *Amazon Simple Queue Service
1131
1197
  # Developer Guide*.
1132
1198
  #
1199
+ # **Preview: High throughput for FIFO queues**
1200
+ #
1201
+ # **High throughput for Amazon SQS FIFO queues is in preview release and
1202
+ # is subject to change.** This feature provides a high number of
1203
+ # transactions per second (TPS) for messages in FIFO queues. For
1204
+ # information on throughput quotas, see [Quotas related to messages][10]
1205
+ # in the *Amazon Simple Queue Service Developer Guide*.
1206
+ #
1207
+ # This preview includes two new attributes:
1208
+ #
1209
+ # * `DeduplicationScope` – Specifies whether message deduplication
1210
+ # occurs at the message group or queue level. Valid values are
1211
+ # `messageGroup` and `queue`.
1212
+ #
1213
+ # * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
1214
+ # quota applies to the entire queue or per message group. Valid values
1215
+ # are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
1216
+ # value is allowed only when the value for `DeduplicationScope` is
1217
+ # `messageGroup`.
1218
+ #
1219
+ # To enable high throughput for FIFO queues, do the following:
1220
+ #
1221
+ # * Set `DeduplicationScope` to `messageGroup`.
1222
+ #
1223
+ # * Set `FifoThroughputLimit` to `perMessageGroupId`.
1224
+ #
1225
+ # If you set these attributes to anything other than the values shown
1226
+ # for enabling high throughput, standard throughput is in effect and
1227
+ # deduplication occurs as specified.
1228
+ #
1229
+ # This preview is available in the following AWS Regions:
1230
+ #
1231
+ # * US East (Ohio); us-east-2
1232
+ #
1233
+ # * US East (N. Virginia); us-east-1
1234
+ #
1235
+ # * US West (Oregon); us-west-2
1236
+ #
1237
+ # * Europe (Ireland); eu-west-1
1238
+ #
1239
+ # For more information about high throughput for FIFO queues, see
1240
+ # [Preview: High throughput for FIFO queues][11] in the *Amazon Simple
1241
+ # Queue Service Developer Guide*.
1242
+ #
1133
1243
  #
1134
1244
  #
1135
1245
  # [1]: http://en.wikipedia.org/wiki/Unix_time
@@ -1141,6 +1251,8 @@ module Aws::SQS
1141
1251
  # [7]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
1142
1252
  # [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
1143
1253
  # [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1254
+ # [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
1255
+ # [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
1144
1256
  #
1145
1257
  # @return [Types::GetQueueAttributesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1146
1258
  #
@@ -1150,7 +1262,7 @@ module Aws::SQS
1150
1262
  #
1151
1263
  # resp = client.get_queue_attributes({
1152
1264
  # queue_url: "String", # required
1153
- # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
1265
+ # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit
1154
1266
  # })
1155
1267
  #
1156
1268
  # @example Response structure
@@ -1217,6 +1329,15 @@ module Aws::SQS
1217
1329
  # Returns a list of your queues that have the `RedrivePolicy` queue
1218
1330
  # attribute configured with a dead-letter queue.
1219
1331
  #
1332
+ # The `ListDeadLetterSourceQueues` methods supports pagination. Set
1333
+ # parameter `MaxResults` in the request to specify the maximum number of
1334
+ # results to be returned in the response. If you do not set
1335
+ # `MaxResults`, the response includes a maximum of 1,000 results. If you
1336
+ # set `MaxResults` and there are additional results to display, the
1337
+ # response includes a value for `NextToken`. Use `NextToken` as a
1338
+ # parameter in your next request to `ListDeadLetterSourceQueues` to
1339
+ # receive the next page of results.
1340
+ #
1220
1341
  # For more information about using dead-letter queues, see [Using Amazon
1221
1342
  # SQS Dead-Letter Queues][1] in the *Amazon Simple Queue Service
1222
1343
  # Developer Guide*.
@@ -1230,20 +1351,34 @@ module Aws::SQS
1230
1351
  #
1231
1352
  # Queue URLs and names are case-sensitive.
1232
1353
  #
1354
+ # @option params [String] :next_token
1355
+ # Pagination token to request the next set of results.
1356
+ #
1357
+ # @option params [Integer] :max_results
1358
+ # Maximum number of results to include in the response. Value range is 1
1359
+ # to 1000. You must set `MaxResults` to receive a value for `NextToken`
1360
+ # in the response.
1361
+ #
1233
1362
  # @return [Types::ListDeadLetterSourceQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1234
1363
  #
1235
1364
  # * {Types::ListDeadLetterSourceQueuesResult#queue_urls #queue_urls} => Array&lt;String&gt;
1365
+ # * {Types::ListDeadLetterSourceQueuesResult#next_token #next_token} => String
1366
+ #
1367
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1236
1368
  #
1237
1369
  # @example Request syntax with placeholder values
1238
1370
  #
1239
1371
  # resp = client.list_dead_letter_source_queues({
1240
1372
  # queue_url: "String", # required
1373
+ # next_token: "Token",
1374
+ # max_results: 1,
1241
1375
  # })
1242
1376
  #
1243
1377
  # @example Response structure
1244
1378
  #
1245
1379
  # resp.queue_urls #=> Array
1246
1380
  # resp.queue_urls[0] #=> String
1381
+ # resp.next_token #=> String
1247
1382
  #
1248
1383
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListDeadLetterSourceQueues AWS API Documentation
1249
1384
  #
@@ -1259,8 +1394,8 @@ module Aws::SQS
1259
1394
  # *Amazon Simple Queue Service Developer Guide*.
1260
1395
  #
1261
1396
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1262
- # information, see [Grant Cross-Account Permissions to a Role and a User
1263
- # Name][2] in the *Amazon Simple Queue Service Developer Guide*.
1397
+ # information, see [Grant cross-account permissions to a role and a user
1398
+ # name][2] in the *Amazon Simple Queue Service Developer Guide*.
1264
1399
  #
1265
1400
  # </note>
1266
1401
  #
@@ -1296,14 +1431,22 @@ module Aws::SQS
1296
1431
  req.send_request(options)
1297
1432
  end
1298
1433
 
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.
1434
+ # Returns a list of your queues in the current region. The response
1435
+ # includes a maximum of 1,000 results. If you specify a value for the
1436
+ # optional `QueueNamePrefix` parameter, only queues with a name that
1437
+ # begins with the specified value are returned.
1438
+ #
1439
+ # The `listQueues` methods supports pagination. Set parameter
1440
+ # `MaxResults` in the request to specify the maximum number of results
1441
+ # to be returned in the response. If you do not set `MaxResults`, the
1442
+ # response includes a maximum of 1,000 results. If you set `MaxResults`
1443
+ # and there are additional results to display, the response includes a
1444
+ # value for `NextToken`. Use `NextToken` as a parameter in your next
1445
+ # request to `listQueues` to receive the next page of results.
1303
1446
  #
1304
1447
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1305
- # information, see [Grant Cross-Account Permissions to a Role and a User
1306
- # Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1448
+ # information, see [Grant cross-account permissions to a role and a user
1449
+ # name][1] in the *Amazon Simple Queue Service Developer Guide*.
1307
1450
  #
1308
1451
  # </note>
1309
1452
  #
@@ -1317,20 +1460,34 @@ module Aws::SQS
1317
1460
  #
1318
1461
  # Queue URLs and names are case-sensitive.
1319
1462
  #
1463
+ # @option params [String] :next_token
1464
+ # Pagination token to request the next set of results.
1465
+ #
1466
+ # @option params [Integer] :max_results
1467
+ # Maximum number of results to include in the response. Value range is 1
1468
+ # to 1000. You must set `MaxResults` to receive a value for `NextToken`
1469
+ # in the response.
1470
+ #
1320
1471
  # @return [Types::ListQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1321
1472
  #
1322
1473
  # * {Types::ListQueuesResult#queue_urls #queue_urls} => Array&lt;String&gt;
1474
+ # * {Types::ListQueuesResult#next_token #next_token} => String
1475
+ #
1476
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1323
1477
  #
1324
1478
  # @example Request syntax with placeholder values
1325
1479
  #
1326
1480
  # resp = client.list_queues({
1327
1481
  # queue_name_prefix: "String",
1482
+ # next_token: "Token",
1483
+ # max_results: 1,
1328
1484
  # })
1329
1485
  #
1330
1486
  # @example Response structure
1331
1487
  #
1332
1488
  # resp.queue_urls #=> Array
1333
1489
  # resp.queue_urls[0] #=> String
1490
+ # resp.next_token #=> String
1334
1491
  #
1335
1492
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueues AWS API Documentation
1336
1493
  #
@@ -1445,15 +1602,15 @@ module Aws::SQS
1445
1602
  # A list of attributes that need to be returned along with each message.
1446
1603
  # These attributes include:
1447
1604
  #
1448
- # * `All` - Returns all values.
1605
+ # * `All` Returns all values.
1449
1606
  #
1450
- # * `ApproximateFirstReceiveTimestamp` - Returns the time the message
1607
+ # * `ApproximateFirstReceiveTimestamp` Returns the time the message
1451
1608
  # was first received from the queue ([epoch time][1] in milliseconds).
1452
1609
  #
1453
- # * `ApproximateReceiveCount` - Returns the number of times a message
1454
- # has been received from the queue but not deleted.
1610
+ # * `ApproximateReceiveCount` Returns the number of times a message
1611
+ # has been received across all queues but not deleted.
1455
1612
  #
1456
- # * `AWSTraceHeader` - Returns the AWS X-Ray trace header string.
1613
+ # * `AWSTraceHeader` Returns the AWS X-Ray trace header string.
1457
1614
  #
1458
1615
  # * `SenderId`
1459
1616
  #
@@ -1463,17 +1620,17 @@ module Aws::SQS
1463
1620
  # * For an IAM role, returns the IAM role ID, for example
1464
1621
  # `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
1465
1622
  #
1466
- # * `SentTimestamp` - Returns the time the message was sent to the queue
1623
+ # * `SentTimestamp` Returns the time the message was sent to the queue
1467
1624
  # ([epoch time][1] in milliseconds).
1468
1625
  #
1469
- # * `MessageDeduplicationId` - Returns the value provided by the
1626
+ # * `MessageDeduplicationId` Returns the value provided by the
1470
1627
  # producer that calls the ` SendMessage ` action.
1471
1628
  #
1472
- # * `MessageGroupId` - Returns the value provided by the producer that
1629
+ # * `MessageGroupId` Returns the value provided by the producer that
1473
1630
  # calls the ` SendMessage ` action. Messages with the same
1474
1631
  # `MessageGroupId` are returned in sequence.
1475
1632
  #
1476
- # * `SequenceNumber` - Returns the value provided by Amazon SQS.
1633
+ # * `SequenceNumber` Returns the value provided by Amazon SQS.
1477
1634
  #
1478
1635
  #
1479
1636
  #
@@ -1518,14 +1675,25 @@ module Aws::SQS
1518
1675
  # available and the wait time expires, the call returns successfully
1519
1676
  # with an empty list of messages.
1520
1677
  #
1678
+ # To avoid HTTP errors, ensure that the HTTP response timeout for
1679
+ # `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
1680
+ # parameter. For example, with the Java SDK, you can set HTTP transport
1681
+ # settings using the [ NettyNioAsyncHttpClient][1] for asynchronous
1682
+ # clients, or the [ ApacheHttpClient][2] for synchronous clients.
1683
+ #
1684
+ #
1685
+ #
1686
+ # [1]: https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/nio/netty/NettyNioAsyncHttpClient.html
1687
+ # [2]: https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/http/apache/ApacheHttpClient.html
1688
+ #
1521
1689
  # @option params [String] :receive_request_attempt_id
1522
1690
  # This parameter applies only to FIFO (first-in-first-out) queues.
1523
1691
  #
1524
1692
  # The token used for deduplication of `ReceiveMessage` calls. If a
1525
1693
  # 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
1694
+ # of a response you receive a generic error, it is possible to retry the
1695
+ # same action with an identical `ReceiveRequestAttemptId` to retrieve
1696
+ # the same set of messages, even if their visibility timeout has not yet
1529
1697
  # expired.
1530
1698
  #
1531
1699
  # * You can use `ReceiveRequestAttemptId` only for 5 minutes after a
@@ -1538,7 +1706,7 @@ module Aws::SQS
1538
1706
  # `ReceiveRequestAttemptId`, Amazon SQS generates a
1539
1707
  # `ReceiveRequestAttemptId`.
1540
1708
  #
1541
- # * You can retry the `ReceiveMessage` action with the same
1709
+ # * It is possible to retry the `ReceiveMessage` action with the same
1542
1710
  # `ReceiveRequestAttemptId` if none of the messages have been modified
1543
1711
  # (deleted or had their visibility changes).
1544
1712
  #
@@ -1569,7 +1737,7 @@ module Aws::SQS
1569
1737
  # visibility timeout expires. As a result, delays might occur but the
1570
1738
  # messages in the queue remain in a strict order.
1571
1739
  #
1572
- # The length of `ReceiveRequestAttemptId` is 128 characters.
1740
+ # The maximum length of `ReceiveRequestAttemptId` is 128 characters.
1573
1741
  # `ReceiveRequestAttemptId` can contain alphanumeric characters (`a-z`,
1574
1742
  # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
1575
1743
  # ``).
@@ -1591,7 +1759,7 @@ module Aws::SQS
1591
1759
  #
1592
1760
  # resp = client.receive_message({
1593
1761
  # queue_url: "String", # required
1594
- # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds
1762
+ # attribute_names: ["All"], # accepts All, Policy, VisibilityTimeout, MaximumMessageSize, MessageRetentionPeriod, ApproximateNumberOfMessages, ApproximateNumberOfMessagesNotVisible, CreatedTimestamp, LastModifiedTimestamp, QueueArn, ApproximateNumberOfMessagesDelayed, DelaySeconds, ReceiveMessageWaitTimeSeconds, RedrivePolicy, FifoQueue, ContentBasedDeduplication, KmsMasterKeyId, KmsDataKeyReusePeriodSeconds, DeduplicationScope, FifoThroughputLimit
1595
1763
  # message_attribute_names: ["MessageAttributeName"],
1596
1764
  # max_number_of_messages: 1,
1597
1765
  # visibility_timeout: 1,
@@ -1633,8 +1801,8 @@ module Aws::SQS
1633
1801
  # <note markdown="1"> * Only the owner of a queue can remove permissions from it.
1634
1802
  #
1635
1803
  # * Cross-account permissions don't apply to this action. For more
1636
- # information, see [Grant Cross-Account Permissions to a Role and a
1637
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1804
+ # information, see [Grant cross-account permissions to a role and a
1805
+ # user name][1] in the *Amazon Simple Queue Service Developer Guide*.
1638
1806
  #
1639
1807
  # * To remove the ability to change queue permissions, you must deny
1640
1808
  # permission to the `AddPermission`, `RemovePermission`, and
@@ -1694,7 +1862,8 @@ module Aws::SQS
1694
1862
  # Queue URLs and names are case-sensitive.
1695
1863
  #
1696
1864
  # @option params [required, String] :message_body
1697
- # The message to send. The maximum string size is 256 KB.
1865
+ # The message to send. The minimum size is one character. The maximum
1866
+ # size is 256 KB.
1698
1867
  #
1699
1868
  # A message can include only XML, JSON, and unformatted text. The
1700
1869
  # following Unicode characters are allowed:
@@ -1728,7 +1897,7 @@ module Aws::SQS
1728
1897
  #
1729
1898
  #
1730
1899
  #
1731
- # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-attributes.html
1900
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-message-metadata.html#sqs-message-attributes
1732
1901
  #
1733
1902
  # @option params [Hash<String,Types::MessageSystemAttributeValue>] :message_system_attributes
1734
1903
  # The message system attribute to send. Each message system attribute
@@ -1736,7 +1905,7 @@ module Aws::SQS
1736
1905
  #
1737
1906
  # * Currently, the only supported message system attribute is
1738
1907
  # `AWSTraceHeader`. Its type must be `String` and its value must be a
1739
- # correctly formatted AWS X-Ray trace string.
1908
+ # correctly formatted AWS X-Ray trace header string.
1740
1909
  #
1741
1910
  # * The size of a message system attribute doesn't count towards the
1742
1911
  # total size of a message.
@@ -1789,7 +1958,7 @@ module Aws::SQS
1789
1958
  #
1790
1959
  # </note>
1791
1960
  #
1792
- # The length of `MessageDeduplicationId` is 128 characters.
1961
+ # The maximum length of `MessageDeduplicationId` is 128 characters.
1793
1962
  # `MessageDeduplicationId` can contain alphanumeric characters (`a-z`,
1794
1963
  # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
1795
1964
  # ``).
@@ -1919,9 +2088,9 @@ module Aws::SQS
1919
2088
  # the `param.n` notation. Values of `n` are integers starting from 1.
1920
2089
  # For example, a parameter list with two elements looks like this:
1921
2090
  #
1922
- # `&Attribute.1=first`
2091
+ # `&AttributeName.1=first`
1923
2092
  #
1924
- # `&Attribute.2=second`
2093
+ # `&AttributeName.2=second`
1925
2094
  #
1926
2095
  #
1927
2096
  #
@@ -2008,8 +2177,8 @@ module Aws::SQS
2008
2177
  # it can handle new attributes gracefully.
2009
2178
  #
2010
2179
  # * Cross-account permissions don't apply to this action. For more
2011
- # information, see [Grant Cross-Account Permissions to a Role and a
2012
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
2180
+ # information, see [Grant cross-account permissions to a role and a
2181
+ # user name][1] in the *Amazon Simple Queue Service Developer Guide*.
2013
2182
  #
2014
2183
  # * To remove the ability to change queue permissions, you must deny
2015
2184
  # permission to the `AddPermission`, `RemovePermission`, and
@@ -2032,39 +2201,39 @@ module Aws::SQS
2032
2201
  # The following lists the names, descriptions, and values of the special
2033
2202
  # request parameters that the `SetQueueAttributes` action uses:
2034
2203
  #
2035
- # * `DelaySeconds` - The length of time, in seconds, for which the
2204
+ # * `DelaySeconds` The length of time, in seconds, for which the
2036
2205
  # delivery of all messages in the queue is delayed. Valid values: An
2037
2206
  # integer from 0 to 900 (15 minutes). Default: 0.
2038
2207
  #
2039
- # * `MaximumMessageSize` - The limit of how many bytes a message can
2208
+ # * `MaximumMessageSize` The limit of how many bytes a message can
2040
2209
  # contain before Amazon SQS rejects it. Valid values: An integer from
2041
2210
  # 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). Default: 262,144
2042
2211
  # (256 KiB).
2043
2212
  #
2044
- # * `MessageRetentionPeriod` - The length of time, in seconds, for which
2213
+ # * `MessageRetentionPeriod` The length of time, in seconds, for which
2045
2214
  # Amazon SQS retains a message. Valid values: An integer representing
2046
2215
  # seconds, from 60 (1 minute) to 1,209,600 (14 days). Default: 345,600
2047
2216
  # (4 days).
2048
2217
  #
2049
- # * `Policy` - The queue's policy. A valid AWS policy. For more
2218
+ # * `Policy` The queue's policy. A valid AWS policy. For more
2050
2219
  # information about policy structure, see [Overview of AWS IAM
2051
2220
  # Policies][1] in the *Amazon IAM User Guide*.
2052
2221
  #
2053
- # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
2222
+ # * `ReceiveMessageWaitTimeSeconds` The length of time, in seconds,
2054
2223
  # for which a ` ReceiveMessage ` action waits for a message to arrive.
2055
- # Valid values: an integer from 0 to 20 (seconds). Default: 0.
2224
+ # Valid values: An integer from 0 to 20 (seconds). Default: 0.
2056
2225
  #
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*.
2226
+ # * `RedrivePolicy` The string that includes the parameters for the
2227
+ # dead-letter queue functionality of the source queue as a JSON
2228
+ # object. For more information about the redrive policy and
2229
+ # dead-letter queues, see [Using Amazon SQS Dead-Letter Queues][2] in
2230
+ # the *Amazon Simple Queue Service Developer Guide*.
2062
2231
  #
2063
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
2232
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
2064
2233
  # dead-letter queue to which Amazon SQS moves messages after the
2065
2234
  # value of `maxReceiveCount` is exceeded.
2066
2235
  #
2067
- # * `maxReceiveCount` - The number of times a message is delivered to
2236
+ # * `maxReceiveCount` The number of times a message is delivered to
2068
2237
  # the source queue before being moved to the dead-letter queue. When
2069
2238
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
2070
2239
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
@@ -2075,22 +2244,22 @@ module Aws::SQS
2075
2244
  #
2076
2245
  # </note>
2077
2246
  #
2078
- # * `VisibilityTimeout` - The visibility timeout for the queue, in
2079
- # seconds. Valid values: an integer from 0 to 43,200 (12 hours).
2247
+ # * `VisibilityTimeout` The visibility timeout for the queue, in
2248
+ # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
2080
2249
  # Default: 30. For more information about the visibility timeout, see
2081
2250
  # [Visibility Timeout][3] in the *Amazon Simple Queue Service
2082
2251
  # Developer Guide*.
2083
2252
  #
2084
2253
  # The following attributes apply only to [server-side-encryption][4]\:
2085
2254
  #
2086
- # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
2255
+ # * `KmsMasterKeyId` The ID of an AWS-managed customer master key
2087
2256
  # (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
2088
2257
  # Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
2089
2258
  # always `alias/aws/sqs`, the alias of a custom CMK can, for example,
2090
2259
  # be `alias/MyAlias `. For more examples, see [KeyId][6] in the *AWS
2091
2260
  # Key Management Service API Reference*.
2092
2261
  #
2093
- # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
2262
+ # * `KmsDataKeyReusePeriodSeconds` The length of time, in seconds, for
2094
2263
  # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
2095
2264
  # messages before calling AWS KMS again. An integer representing
2096
2265
  # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
@@ -2102,11 +2271,11 @@ module Aws::SQS
2102
2271
  # The following attribute applies only to [FIFO (first-in-first-out)
2103
2272
  # queues][9]\:
2104
2273
  #
2105
- # * `ContentBasedDeduplication` - Enables content-based deduplication.
2274
+ # * `ContentBasedDeduplication` Enables content-based deduplication.
2106
2275
  # For more information, see [Exactly-Once Processing][10] in the
2107
- # *Amazon Simple Queue Service Developer Guide*.
2276
+ # *Amazon Simple Queue Service Developer Guide*. Note the following:
2108
2277
  #
2109
- # * Every message must have a unique `MessageDeduplicationId`,
2278
+ # * Every message must have a unique `MessageDeduplicationId`.
2110
2279
  #
2111
2280
  # * You may provide a `MessageDeduplicationId` explicitly.
2112
2281
  #
@@ -2134,6 +2303,50 @@ module Aws::SQS
2134
2303
  # `MessageDeduplicationId`, the two messages are treated as
2135
2304
  # duplicates and only one copy of the message is delivered.
2136
2305
  #
2306
+ # **Preview: High throughput for FIFO queues**
2307
+ #
2308
+ # **High throughput for Amazon SQS FIFO queues is in preview release and
2309
+ # is subject to change.** This feature provides a high number of
2310
+ # transactions per second (TPS) for messages in FIFO queues. For
2311
+ # information on throughput quotas, see [Quotas related to messages][11]
2312
+ # in the *Amazon Simple Queue Service Developer Guide*.
2313
+ #
2314
+ # This preview includes two new attributes:
2315
+ #
2316
+ # * `DeduplicationScope` – Specifies whether message deduplication
2317
+ # occurs at the message group or queue level. Valid values are
2318
+ # `messageGroup` and `queue`.
2319
+ #
2320
+ # * `FifoThroughputLimit` – Specifies whether the FIFO queue throughput
2321
+ # quota applies to the entire queue or per message group. Valid values
2322
+ # are `perQueue` and `perMessageGroupId`. The `perMessageGroupId`
2323
+ # value is allowed only when the value for `DeduplicationScope` is
2324
+ # `messageGroup`.
2325
+ #
2326
+ # To enable high throughput for FIFO queues, do the following:
2327
+ #
2328
+ # * Set `DeduplicationScope` to `messageGroup`.
2329
+ #
2330
+ # * Set `FifoThroughputLimit` to `perMessageGroupId`.
2331
+ #
2332
+ # If you set these attributes to anything other than the values shown
2333
+ # for enabling high throughput, standard throughput is in effect and
2334
+ # deduplication occurs as specified.
2335
+ #
2336
+ # This preview is available in the following AWS Regions:
2337
+ #
2338
+ # * US East (Ohio); us-east-2
2339
+ #
2340
+ # * US East (N. Virginia); us-east-1
2341
+ #
2342
+ # * US West (Oregon); us-west-2
2343
+ #
2344
+ # * Europe (Ireland); eu-west-1
2345
+ #
2346
+ # For more information about high throughput for FIFO queues, see
2347
+ # [Preview: High throughput for FIFO queues][12] in the *Amazon Simple
2348
+ # Queue Service Developer Guide*.
2349
+ #
2137
2350
  #
2138
2351
  #
2139
2352
  # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
@@ -2146,6 +2359,8 @@ module Aws::SQS
2146
2359
  # [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
2147
2360
  # [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
2148
2361
  # [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
2362
+ # [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/quotas-messages.html
2363
+ # [12]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/high-throughput-fifo.html
2149
2364
  #
2150
2365
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2151
2366
  #
@@ -2187,8 +2402,8 @@ module Aws::SQS
2187
2402
  # in the *Amazon Simple Queue Service Developer Guide*.
2188
2403
  #
2189
2404
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
2190
- # information, see [Grant Cross-Account Permissions to a Role and a User
2191
- # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
2405
+ # information, see [Grant cross-account permissions to a role and a user
2406
+ # name][3] in the *Amazon Simple Queue Service Developer Guide*.
2192
2407
  #
2193
2408
  # </note>
2194
2409
  #
@@ -2229,8 +2444,8 @@ module Aws::SQS
2229
2444
  # Simple Queue Service Developer Guide*.
2230
2445
  #
2231
2446
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
2232
- # information, see [Grant Cross-Account Permissions to a Role and a User
2233
- # Name][2] in the *Amazon Simple Queue Service Developer Guide*.
2447
+ # information, see [Grant cross-account permissions to a role and a user
2448
+ # name][2] in the *Amazon Simple Queue Service Developer Guide*.
2234
2449
  #
2235
2450
  # </note>
2236
2451
  #
@@ -2276,7 +2491,7 @@ module Aws::SQS
2276
2491
  params: params,
2277
2492
  config: config)
2278
2493
  context[:gem_name] = 'aws-sdk-sqs'
2279
- context[:gem_version] = '1.27.1'
2494
+ context[:gem_version] = '1.38.0'
2280
2495
  Seahorse::Client::Request.new(handlers, context)
2281
2496
  end
2282
2497