aws-sdk-sqs 1.10.0 → 1.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: b9cd5598bbd6f49e8cfb1081b279de223a67564a
4
- data.tar.gz: 66f55791d4137982c2d23eaf84c75cf18dd3a85b
2
+ SHA256:
3
+ metadata.gz: 8802cd9961e432ae5f7254386bcea98c00c48a401e7f86760b11ea95a68d0e36
4
+ data.tar.gz: 4f405f379817333584d149cb036b21445a9594eaad918c22f64c143c0ce29f2d
5
5
  SHA512:
6
- metadata.gz: d2f28b5257b0d427a38673596eb12ac554a8d6bcdd49d69a5b0f030bcbeba3f6ebf52eebc0abe6ccad22a71c04a0c43b3a86eb049ad8686847da5295f875dc69
7
- data.tar.gz: bbb0b454d2528982074c43d7d0f152c6f2ebd5612851cf540d89b598bf9eae0d3dc61f323997a2623c336cf1038be36e3191296863c1067b7fb5ef0f24fb93c9
6
+ metadata.gz: aa0d1e89af2425a31d4fc950e00ccb3d5a0e630ed7b391246e7536b0dfca3e7864968de9830ec19bfc6340bc18a5f7191392c81c8fa669be11bc0b50c77ebc6b
7
+ data.tar.gz: a8aec6d7e415d8c5b74a1553df3648feb1d85c03b02786f2c95133467ecada9c839e38d99c3558abd34ea3d7174253a8d9ca5f558810173c089fe3f337489eff
@@ -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:
@@ -5,6 +7,7 @@
5
7
  #
6
8
  # WARNING ABOUT GENERATED CODE
7
9
 
10
+
8
11
  require 'aws-sdk-core'
9
12
  require 'aws-sigv4'
10
13
 
@@ -26,24 +29,27 @@ require_relative 'aws-sdk-sqs/customizations'
26
29
  # methods each accept a hash of request parameters and return a response
27
30
  # structure.
28
31
  #
32
+ # sqs = Aws::SQS::Client.new
33
+ # resp = sqs.add_permission(params)
34
+ #
29
35
  # See {Client} for more information.
30
36
  #
31
37
  # # Errors
32
38
  #
33
- # Errors returned from Amazon Simple Queue Service all
34
- # extend {Errors::ServiceError}.
39
+ # Errors returned from Amazon Simple Queue Service are defined in the
40
+ # {Errors} module and all extend {Errors::ServiceError}.
35
41
  #
36
42
  # begin
37
43
  # # do stuff
38
44
  # rescue Aws::SQS::Errors::ServiceError
39
- # # rescues all service API errors
45
+ # # rescues all Amazon Simple Queue Service API errors
40
46
  # end
41
47
  #
42
48
  # See {Errors} for more information.
43
49
  #
44
- # @service
50
+ # @!group service
45
51
  module Aws::SQS
46
52
 
47
- GEM_VERSION = '1.10.0'
53
+ GEM_VERSION = '1.34.0'
48
54
 
49
55
  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:
@@ -23,6 +25,8 @@ require 'aws-sdk-core/plugins/idempotency_token.rb'
23
25
  require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
24
26
  require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
25
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
28
+ require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
+ require 'aws-sdk-core/plugins/http_checksum.rb'
26
30
  require 'aws-sdk-core/plugins/signature_v4.rb'
27
31
  require 'aws-sdk-core/plugins/protocols/query.rb'
28
32
  require 'aws-sdk-sqs/plugins/queue_urls.rb'
@@ -31,6 +35,18 @@ require 'aws-sdk-sqs/plugins/md5s.rb'
31
35
  Aws::Plugins::GlobalConfiguration.add_identifier(:sqs)
32
36
 
33
37
  module Aws::SQS
38
+ # An API client for SQS. To construct a client, you need to configure a `:region` and `:credentials`.
39
+ #
40
+ # client = Aws::SQS::Client.new(
41
+ # region: region_name,
42
+ # credentials: credentials,
43
+ # # ...
44
+ # )
45
+ #
46
+ # For details on configuring region and credentials see
47
+ # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
48
+ #
49
+ # See {#initialize} for a full list of supported configuration options.
34
50
  class Client < Seahorse::Client::Base
35
51
 
36
52
  include Aws::ClientStubs
@@ -57,6 +73,8 @@ module Aws::SQS
57
73
  add_plugin(Aws::Plugins::JsonvalueConverter)
58
74
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
59
75
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
76
+ add_plugin(Aws::Plugins::TransferEncoding)
77
+ add_plugin(Aws::Plugins::HttpChecksum)
60
78
  add_plugin(Aws::Plugins::SignatureV4)
61
79
  add_plugin(Aws::Plugins::Protocols::Query)
62
80
  add_plugin(Aws::SQS::Plugins::QueueUrls)
@@ -71,13 +89,28 @@ module Aws::SQS
71
89
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
72
90
  # credentials.
73
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
+ #
74
106
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
75
107
  # from an EC2 IMDS on an EC2 instance.
76
108
  #
77
- # * `Aws::SharedCredentials` - Used for loading credentials from a
78
- # shared file, such as `~/.aws/config`.
109
+ # * `Aws::ECSCredentials` - Used for loading credentials from
110
+ # instances running in ECS.
79
111
  #
80
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
112
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
113
+ # from the Cognito Identity service.
81
114
  #
82
115
  # When `:credentials` are not configured directly, the following
83
116
  # locations will be searched for credentials:
@@ -87,15 +120,15 @@ module Aws::SQS
87
120
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
88
121
  # * `~/.aws/credentials`
89
122
  # * `~/.aws/config`
90
- # * EC2 IMDS instance profile - When used by default, the timeouts are
91
- # very aggressive. Construct and pass an instance of
92
- # `Aws::InstanceProfileCredentails` to enable retries and extended
93
- # 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.
94
127
  #
95
128
  # @option options [required, String] :region
96
129
  # The AWS region to connect to. The configured `:region` is
97
130
  # used to determine the service `:endpoint`. When not passed,
98
- # a default `:region` is search for in the following locations:
131
+ # a default `:region` is searched for in the following locations:
99
132
  #
100
133
  # * `Aws.config[:region]`
101
134
  # * `ENV['AWS_REGION']`
@@ -110,6 +143,12 @@ module Aws::SQS
110
143
  # When set to `true`, a thread polling for endpoints will be running in
111
144
  # the background every 60 secs (default). Defaults to `false`.
112
145
  #
146
+ # @option options [Boolean] :adaptive_retry_wait_to_fill (true)
147
+ # Used only in `adaptive` retry mode. When true, the request will sleep
148
+ # until there is sufficent client side capacity to retry the request.
149
+ # When false, the request will raise a `RetryCapacityNotAvailableError` and will
150
+ # not retry instead of sleeping.
151
+ #
113
152
  # @option options [Boolean] :client_side_monitoring (false)
114
153
  # When `true`, client-side metrics will be collected for all API requests from
115
154
  # this client.
@@ -118,6 +157,10 @@ module Aws::SQS
118
157
  # Allows you to provide an identifier for this client which will be attached to
119
158
  # all generated client side metrics. Defaults to an empty string.
120
159
  #
160
+ # @option options [String] :client_side_monitoring_host ("127.0.0.1")
161
+ # Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client
162
+ # side monitoring agent is running on, where client metrics will be published via UDP.
163
+ #
121
164
  # @option options [Integer] :client_side_monitoring_port (31000)
122
165
  # Required for publishing client metrics. The port that the client side monitoring
123
166
  # agent is running on, where client metrics will be published via UDP.
@@ -130,6 +173,10 @@ module Aws::SQS
130
173
  # When `true`, an attempt is made to coerce request parameters into
131
174
  # the required types.
132
175
  #
176
+ # @option options [Boolean] :correct_clock_skew (true)
177
+ # Used only in `standard` and adaptive retry modes. Specifies whether to apply
178
+ # a clock skew correction and retry requests with skewed client clocks.
179
+ #
133
180
  # @option options [Boolean] :disable_host_prefix_injection (false)
134
181
  # Set to true to disable SDK automatically adding host prefix
135
182
  # to default service endpoint when available.
@@ -137,7 +184,7 @@ module Aws::SQS
137
184
  # @option options [String] :endpoint
138
185
  # The client endpoint is normally constructed from the `:region`
139
186
  # option. You should only configure an `:endpoint` when connecting
140
- # to test endpoints. This should be avalid HTTP(S) URI.
187
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
141
188
  #
142
189
  # @option options [Integer] :endpoint_cache_max_entries (1000)
143
190
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -152,7 +199,7 @@ module Aws::SQS
152
199
  # requests fetching endpoints information. Defaults to 60 sec.
153
200
  #
154
201
  # @option options [Boolean] :endpoint_discovery (false)
155
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
202
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
156
203
  #
157
204
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
158
205
  # The log formatter.
@@ -164,15 +211,29 @@ module Aws::SQS
164
211
  # The Logger instance to send log messages to. If this option
165
212
  # is not set, logging will be disabled.
166
213
  #
214
+ # @option options [Integer] :max_attempts (3)
215
+ # An integer representing the maximum number attempts that will be made for
216
+ # a single request, including the initial attempt. For example,
217
+ # setting this value to 5 will result in a request being retried up to
218
+ # 4 times. Used in `standard` and `adaptive` retry modes.
219
+ #
167
220
  # @option options [String] :profile ("default")
168
221
  # Used when loading credentials from the shared credentials file
169
222
  # at HOME/.aws/credentials. When not specified, 'default' is used.
170
223
  #
224
+ # @option options [Proc] :retry_backoff
225
+ # A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
226
+ # This option is only used in the `legacy` retry mode.
227
+ #
171
228
  # @option options [Float] :retry_base_delay (0.3)
172
- # The base delay in seconds used by the default backoff function.
229
+ # The base delay in seconds used by the default backoff function. This option
230
+ # is only used in the `legacy` retry mode.
173
231
  #
174
232
  # @option options [Symbol] :retry_jitter (:none)
175
- # A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
233
+ # A delay randomiser function used by the default backoff function.
234
+ # Some predefined functions can be referenced by name - :none, :equal, :full,
235
+ # otherwise a Proc that takes and returns a number. This option is only used
236
+ # in the `legacy` retry mode.
176
237
  #
177
238
  # @see https://www.awsarchitectureblog.com/2015/03/backoff.html
178
239
  #
@@ -180,11 +241,30 @@ module Aws::SQS
180
241
  # The maximum number of times to retry failed requests. Only
181
242
  # ~ 500 level server errors and certain ~ 400 level client errors
182
243
  # are retried. Generally, these are throttling errors, data
183
- # checksum errors, networking errors, timeout errors and auth
184
- # errors from expired credentials.
244
+ # checksum errors, networking errors, timeout errors, auth errors,
245
+ # endpoint discovery, and errors from expired credentials.
246
+ # This option is only used in the `legacy` retry mode.
185
247
  #
186
248
  # @option options [Integer] :retry_max_delay (0)
187
- # The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
249
+ # The maximum number of seconds to delay between retries (0 for no limit)
250
+ # used by the default backoff function. This option is only used in the
251
+ # `legacy` retry mode.
252
+ #
253
+ # @option options [String] :retry_mode ("legacy")
254
+ # Specifies which retry algorithm to use. Values are:
255
+ #
256
+ # * `legacy` - The pre-existing retry behavior. This is default value if
257
+ # no retry mode is provided.
258
+ #
259
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
260
+ # This includes support for retry quotas, which limit the number of
261
+ # unsuccessful retries a client can make.
262
+ #
263
+ # * `adaptive` - An experimental retry mode that includes all the
264
+ # functionality of `standard` mode along with automatic client side
265
+ # throttling. This is a provisional mode that may change behavior
266
+ # in the future.
267
+ #
188
268
  #
189
269
  # @option options [String] :secret_access_key
190
270
  #
@@ -209,6 +289,48 @@ module Aws::SQS
209
289
  # `Aws::Errors::Checksum` errors are raised for cases where checksums do
210
290
  # not match.
211
291
  #
292
+ # @option options [URI::HTTP,String] :http_proxy A proxy to send
293
+ # requests through. Formatted like 'http://proxy.com:123'.
294
+ #
295
+ # @option options [Float] :http_open_timeout (15) The number of
296
+ # seconds to wait when opening a HTTP session before raising a
297
+ # `Timeout::Error`.
298
+ #
299
+ # @option options [Integer] :http_read_timeout (60) The default
300
+ # number of seconds to wait for response data. This value can
301
+ # safely be set per-request on the session.
302
+ #
303
+ # @option options [Float] :http_idle_timeout (5) The number of
304
+ # seconds a connection is allowed to sit idle before it is
305
+ # considered stale. Stale connections are closed and removed
306
+ # from the pool before making a request.
307
+ #
308
+ # @option options [Float] :http_continue_timeout (1) The number of
309
+ # seconds to wait for a 100-continue response before sending the
310
+ # request body. This option has no effect unless the request has
311
+ # "Expect" header set to "100-continue". Defaults to `nil` which
312
+ # disables this behaviour. This value can safely be set per
313
+ # request on the session.
314
+ #
315
+ # @option options [Boolean] :http_wire_trace (false) When `true`,
316
+ # HTTP debug output will be sent to the `:logger`.
317
+ #
318
+ # @option options [Boolean] :ssl_verify_peer (true) When `true`,
319
+ # SSL peer certificates are verified when establishing a
320
+ # connection.
321
+ #
322
+ # @option options [String] :ssl_ca_bundle Full path to the SSL
323
+ # certificate authority bundle file that should be used when
324
+ # verifying peer certificates. If you do not pass
325
+ # `:ssl_ca_bundle` or `:ssl_ca_directory` the the system default
326
+ # will be used if available.
327
+ #
328
+ # @option options [String] :ssl_ca_directory Full path of the
329
+ # directory that contains the unbundled SSL certificate
330
+ # authority files for verifying peer certificates. If you do
331
+ # not pass `:ssl_ca_bundle` or `:ssl_ca_directory` the the
332
+ # system default will be used if available.
333
+ #
212
334
  def initialize(*args)
213
335
  super
214
336
  end
@@ -224,13 +346,16 @@ module Aws::SQS
224
346
  # Developers to Write Messages to a Shared Queue][2] in the *Amazon
225
347
  # Simple Queue Service Developer Guide*.
226
348
  #
227
- # <note markdown="1"> `AddPermission` writes an Amazon-SQS-generated policy. If you want to
228
- # write your own policy, use ` SetQueueAttributes ` to upload your
229
- # policy. For more information about writing your own policy, see [Using
230
- # Custom Policies with the Amazon SQS Access Policy Language][3] in the
231
- # *Amazon Simple Queue Service Developer Guide*.
349
+ # <note markdown="1"> * `AddPermission` generates a policy for you. You can use `
350
+ # SetQueueAttributes ` to upload your policy. For more information,
351
+ # see [Using Custom Policies with the Amazon SQS Access Policy
352
+ # Language][3] in the *Amazon Simple Queue Service Developer Guide*.
232
353
  #
233
- # An Amazon SQS policy can have a maximum of 7 actions.
354
+ # * An Amazon SQS policy can have a maximum of 7 actions.
355
+ #
356
+ # * To remove the ability to change queue permissions, you must deny
357
+ # permission to the `AddPermission`, `RemovePermission`, and
358
+ # `SetQueueAttributes` actions in your IAM policy.
234
359
  #
235
360
  # </note>
236
361
  #
@@ -238,22 +363,22 @@ module Aws::SQS
238
363
  # the `param.n` notation. Values of `n` are integers starting from 1.
239
364
  # For example, a parameter list with two elements looks like this:
240
365
  #
241
- # `&Attribute.1=first`
366
+ # `&AttributeName.1=first`
242
367
  #
243
- # `&Attribute.2=second`
368
+ # `&AttributeName.2=second`
244
369
  #
245
370
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
246
- # information, see see [Grant Cross-Account Permissions to a Role and a
247
- # User 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*.
248
373
  #
249
374
  # </note>
250
375
  #
251
376
  #
252
377
  #
253
- # [1]: http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P
254
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
255
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-creating-custom-policies.html
256
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
378
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P
379
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
380
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-creating-custom-policies.html
381
+ # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
257
382
  #
258
383
  # @option params [required, String] :queue_url
259
384
  # The URL of the Amazon SQS queue to which permissions are added.
@@ -275,8 +400,8 @@ module Aws::SQS
275
400
  #
276
401
  #
277
402
  #
278
- # [1]: http://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P
279
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-making-api-requests.html#sqs-api-request-authentication
403
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/glos-chap.html#P
404
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-making-api-requests.html#sqs-api-request-authentication
280
405
  #
281
406
  # @option params [required, Array<String>] :actions
282
407
  # The action the client wants to allow for the specified principal.
@@ -294,7 +419,7 @@ module Aws::SQS
294
419
  #
295
420
  #
296
421
  #
297
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-overview-of-managing-access.html
422
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-overview-of-managing-access.html
298
423
  #
299
424
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
300
425
  #
@@ -317,29 +442,49 @@ module Aws::SQS
317
442
  end
318
443
 
319
444
  # Changes the visibility timeout of a specified message in a queue to a
320
- # new value. The maximum allowed timeout value is 12 hours. For more
445
+ # new value. The default visibility timeout for a message is 30 seconds.
446
+ # The minimum is 0 seconds. The maximum is 12 hours. For more
321
447
  # information, see [Visibility Timeout][1] in the *Amazon Simple Queue
322
448
  # Service Developer Guide*.
323
449
  #
324
450
  # For example, you have a message with a visibility timeout of 5
325
451
  # minutes. After 3 minutes, you call `ChangeMessageVisibility` with a
326
452
  # timeout of 10 minutes. You can continue to call
327
- # `ChangeMessageVisibility` to extend the visibility timeout to a
328
- # maximum of 12 hours. If you try to extend the visibility timeout
329
- # beyond 12 hours, your request is rejected.
453
+ # `ChangeMessageVisibility` to extend the visibility timeout to the
454
+ # maximum allowed time. If you try to extend the visibility timeout
455
+ # beyond the maximum, your request is rejected.
456
+ #
457
+ # An Amazon SQS message has three basic states:
458
+ #
459
+ # 1. Sent to a queue by a producer.
460
+ #
461
+ # 2. Received from the queue by a consumer.
330
462
  #
331
- # A message is considered to be *in flight* after it's received from a
332
- # queue by a consumer, but not yet deleted from the queue.
463
+ # 3. Deleted from the queue.
333
464
  #
334
- # For standard queues, there can be a maximum of 120,000 inflight
335
- # messages per queue. If you reach this limit, Amazon SQS returns the
465
+ # A message is considered to be *stored* after it is sent to a queue by
466
+ # a producer, but not yet received from the queue by a consumer (that
467
+ # is, between states 1 and 2). There is no limit to the number of stored
468
+ # messages. A message is considered to be *in flight* after it is
469
+ # received from a queue by a consumer, but not yet deleted from the
470
+ # queue (that is, between states 2 and 3). There is a limit to the
471
+ # number of inflight messages.
472
+ #
473
+ # Limits that apply to inflight messages are unrelated to the
474
+ # *unlimited* number of stored messages.
475
+ #
476
+ # For most standard queues (depending on queue traffic and message
477
+ # backlog), there can be a maximum of approximately 120,000 inflight
478
+ # messages (received from a queue by a consumer, but not yet deleted
479
+ # from the queue). If you reach this limit, Amazon SQS returns the
336
480
  # `OverLimit` error message. To avoid reaching the limit, you should
337
481
  # delete messages from the queue after they're processed. You can also
338
- # increase the number of queues you use to process your messages.
482
+ # increase the number of queues you use to process your messages. To
483
+ # request a limit increase, [file a support request][2].
339
484
  #
340
485
  # For FIFO queues, there can be a maximum of 20,000 inflight messages
341
- # per queue. If you reach this limit, Amazon SQS returns no error
342
- # messages.
486
+ # (received from a queue by a consumer, but not yet deleted from the
487
+ # queue). If you reach this limit, Amazon SQS returns no error messages.
343
488
  #
344
489
  # If you attempt to set the `VisibilityTimeout` to a value greater than
345
490
  # the maximum time left, Amazon SQS returns an error. Amazon SQS
@@ -356,7 +501,8 @@ module Aws::SQS
356
501
  #
357
502
  #
358
503
  #
359
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
504
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
505
+ # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&amp;limitType=service-code-sqs
360
506
  #
361
507
  # @option params [required, String] :queue_url
362
508
  # The URL of the Amazon SQS queue whose message's visibility is
@@ -371,7 +517,7 @@ module Aws::SQS
371
517
  #
372
518
  # @option params [required, Integer] :visibility_timeout
373
519
  # The new value for the message's visibility timeout (in seconds).
374
- # Values values: `0` to `43200`. Maximum: 12 hours.
520
+ # Values range: `0` to `43200`. Maximum: 12 hours.
375
521
  #
376
522
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
377
523
  #
@@ -406,9 +552,9 @@ module Aws::SQS
406
552
  # the `param.n` notation. Values of `n` are integers starting from 1.
407
553
  # For example, a parameter list with two elements looks like this:
408
554
  #
409
- # `&Attribute.1=first`
555
+ # `&AttributeName.1=first`
410
556
  #
411
- # `&Attribute.2=second`
557
+ # `&AttributeName.2=second`
412
558
  #
413
559
  # @option params [required, String] :queue_url
414
560
  # The URL of the Amazon SQS queue whose messages' visibility is
@@ -458,7 +604,7 @@ module Aws::SQS
458
604
  end
459
605
 
460
606
  # Creates a new standard or FIFO queue. You can pass one or more
461
- # attributes in the request. Keep the following caveats in mind:
607
+ # attributes in the request. Keep the following in mind:
462
608
  #
463
609
  # * If you don't specify the `FifoQueue` attribute, Amazon SQS creates
464
610
  # a standard queue.
@@ -482,6 +628,11 @@ module Aws::SQS
482
628
  # adheres to the [limits related to queues][2] and is unique within the
483
629
  # scope of your queues.
484
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
+ #
485
636
  # To get the queue URL, use the ` GetQueueUrl ` action. ` GetQueueUrl `
486
637
  # requires only the `QueueName` parameter. be aware of existing queue
487
638
  # names:
@@ -497,21 +648,21 @@ module Aws::SQS
497
648
  # the `param.n` notation. Values of `n` are integers starting from 1.
498
649
  # For example, a parameter list with two elements looks like this:
499
650
  #
500
- # `&Attribute.1=first`
651
+ # `&AttributeName.1=first`
501
652
  #
502
- # `&Attribute.2=second`
653
+ # `&AttributeName.2=second`
503
654
  #
504
655
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
505
- # information, see see [Grant Cross-Account Permissions to a Role and a
506
- # User 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*.
507
658
  #
508
659
  # </note>
509
660
  #
510
661
  #
511
662
  #
512
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving
513
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
514
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
663
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-moving
664
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/limits-queues.html
665
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
515
666
  #
516
667
  # @option params [required, String] :queue_name
517
668
  # The name of the new queue. The following limits apply to this name:
@@ -531,39 +682,39 @@ module Aws::SQS
531
682
  # The following lists the names, descriptions, and values of the special
532
683
  # request parameters that the `CreateQueue` action uses:
533
684
  #
534
- # * `DelaySeconds` - The length of time, in seconds, for which the
685
+ # * `DelaySeconds` The length of time, in seconds, for which the
535
686
  # delivery of all messages in the queue is delayed. Valid values: An
536
687
  # integer from 0 to 900 seconds (15 minutes). Default: 0.
537
688
  #
538
- # * `MaximumMessageSize` - The limit of how many bytes a message can
689
+ # * `MaximumMessageSize` The limit of how many bytes a message can
539
690
  # contain before Amazon SQS rejects it. Valid values: An integer from
540
691
  # 1,024 bytes (1 KiB) to 262,144 bytes (256 KiB). Default: 262,144
541
692
  # (256 KiB).
542
693
  #
543
- # * `MessageRetentionPeriod` - The length of time, in seconds, for which
694
+ # * `MessageRetentionPeriod` The length of time, in seconds, for which
544
695
  # Amazon SQS retains a message. Valid values: An integer from 60
545
696
  # seconds (1 minute) to 1,209,600 seconds (14 days). Default: 345,600
546
697
  # (4 days).
547
698
  #
548
- # * `Policy` - The queue's policy. A valid AWS policy. For more
699
+ # * `Policy` The queue's policy. A valid AWS policy. For more
549
700
  # information about policy structure, see [Overview of AWS IAM
550
701
  # Policies][1] in the *Amazon IAM User Guide*.
551
702
  #
552
- # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
703
+ # * `ReceiveMessageWaitTimeSeconds` The length of time, in seconds,
553
704
  # for which a ` ReceiveMessage ` action waits for a message to arrive.
554
705
  # Valid values: An integer from 0 to 20 (seconds). Default: 0.
555
706
  #
556
- # * `RedrivePolicy` - The string that includes the parameters for the
557
- # dead-letter queue functionality of the source queue. For more
558
- # information about the redrive policy and dead-letter queues, see
559
- # [Using Amazon SQS Dead-Letter Queues][2] in the *Amazon Simple Queue
560
- # 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*.
561
712
  #
562
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
713
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
563
714
  # dead-letter queue to which Amazon SQS moves messages after the
564
715
  # value of `maxReceiveCount` is exceeded.
565
716
  #
566
- # * `maxReceiveCount` - The number of times a message is delivered to
717
+ # * `maxReceiveCount` The number of times a message is delivered to
567
718
  # the source queue before being moved to the dead-letter queue. When
568
719
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
569
720
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
@@ -574,7 +725,7 @@ module Aws::SQS
574
725
  #
575
726
  # </note>
576
727
  #
577
- # * `VisibilityTimeout` - The visibility timeout for the queue, in
728
+ # * `VisibilityTimeout` The visibility timeout for the queue, in
578
729
  # seconds. Valid values: An integer from 0 to 43,200 (12 hours).
579
730
  # Default: 30. For more information about the visibility timeout, see
580
731
  # [Visibility Timeout][3] in the *Amazon Simple Queue Service
@@ -582,14 +733,14 @@ module Aws::SQS
582
733
  #
583
734
  # The following attributes apply only to [server-side-encryption][4]\:
584
735
  #
585
- # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
736
+ # * `KmsMasterKeyId` The ID of an AWS-managed customer master key
586
737
  # (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
587
738
  # Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
588
739
  # always `alias/aws/sqs`, the alias of a custom CMK can, for example,
589
740
  # be `alias/MyAlias `. For more examples, see [KeyId][6] in the *AWS
590
741
  # Key Management Service API Reference*.
591
742
  #
592
- # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
743
+ # * `KmsDataKeyReusePeriodSeconds` The length of time, in seconds, for
593
744
  # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
594
745
  # messages before calling AWS KMS again. An integer representing
595
746
  # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
@@ -601,16 +752,17 @@ module Aws::SQS
601
752
  # The following attributes apply only to [FIFO (first-in-first-out)
602
753
  # queues][9]\:
603
754
  #
604
- # * `FifoQueue` - Designates a queue as FIFO. Valid values: `true`,
605
- # `false`. You can provide this attribute only during queue creation.
606
- # You can't change it for an existing queue. When you set this
607
- # attribute, you must also provide the `MessageGroupId` for your
608
- # messages explicitly.
755
+ # * `FifoQueue` Designates a queue as FIFO. Valid values: `true`,
756
+ # `false`. If you don't specify the `FifoQueue` attribute, Amazon SQS
757
+ # creates a standard queue. You can provide this attribute only during
758
+ # queue creation. You can't change it for an existing queue. When you
759
+ # set this attribute, you must also provide the `MessageGroupId` for
760
+ # your messages explicitly.
609
761
  #
610
762
  # For more information, see [FIFO Queue Logic][10] in the *Amazon
611
763
  # Simple Queue Service Developer Guide*.
612
764
  #
613
- # * `ContentBasedDeduplication` - Enables content-based deduplication.
765
+ # * `ContentBasedDeduplication` Enables content-based deduplication.
614
766
  # Valid values: `true`, `false`. For more information, see
615
767
  # [Exactly-Once Processing][11] in the *Amazon Simple Queue Service
616
768
  # Developer Guide*.
@@ -645,17 +797,52 @@ module Aws::SQS
645
797
  #
646
798
  #
647
799
  #
648
- # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
649
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
650
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
651
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
652
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
653
- # [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
654
- # [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
655
- # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
656
- # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
657
- # [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
658
- # [11]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
800
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
801
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
802
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
803
+ # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
804
+ # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
805
+ # [6]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
806
+ # [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
807
+ # [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
808
+ # [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
809
+ # [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
810
+ # [11]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
811
+ #
812
+ # @option params [Hash<String,String>] :tags
813
+ # Add cost allocation tags to the specified Amazon SQS queue. For an
814
+ # overview, see [Tagging Your Amazon SQS Queues][1] in the *Amazon
815
+ # Simple Queue Service Developer Guide*.
816
+ #
817
+ # When you use queue tags, keep the following guidelines in mind:
818
+ #
819
+ # * Adding more than 50 tags to a queue isn't recommended.
820
+ #
821
+ # * Tags don't have any semantic meaning. Amazon SQS interprets tags as
822
+ # character strings.
823
+ #
824
+ # * Tags are case-sensitive.
825
+ #
826
+ # * A new tag with a key identical to that of an existing tag overwrites
827
+ # the existing tag.
828
+ #
829
+ # For a full list of tag restrictions, see [Limits Related to Queues][2]
830
+ # in the *Amazon Simple Queue Service Developer Guide*.
831
+ #
832
+ # <note markdown="1"> To be able to tag a queue on creation, you must have the
833
+ # `sqs:CreateQueue` and `sqs:TagQueue` permissions.
834
+ #
835
+ # Cross-account permissions don't apply to this action. For more
836
+ # information, see [Grant Cross-Account Permissions to a Role and a User
837
+ # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
838
+ #
839
+ # </note>
840
+ #
841
+ #
842
+ #
843
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
844
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
845
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
659
846
  #
660
847
  # @return [Types::CreateQueueResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
661
848
  #
@@ -668,6 +855,9 @@ module Aws::SQS
668
855
  # attributes: {
669
856
  # "All" => "String",
670
857
  # },
858
+ # tags: {
859
+ # "TagKey" => "TagValue",
860
+ # },
671
861
  # })
672
862
  #
673
863
  # @example Response structure
@@ -746,9 +936,9 @@ module Aws::SQS
746
936
  # the `param.n` notation. Values of `n` are integers starting from 1.
747
937
  # For example, a parameter list with two elements looks like this:
748
938
  #
749
- # `&Attribute.1=first`
939
+ # `&AttributeName.1=first`
750
940
  #
751
- # `&Attribute.2=second`
941
+ # `&AttributeName.2=second`
752
942
  #
753
943
  # @option params [required, String] :queue_url
754
944
  # The URL of the Amazon SQS queue from which messages are deleted.
@@ -795,8 +985,7 @@ module Aws::SQS
795
985
  end
796
986
 
797
987
  # Deletes the queue specified by the `QueueUrl`, regardless of the
798
- # queue's contents. If the specified queue doesn't exist, Amazon SQS
799
- # returns a successful response.
988
+ # queue's contents.
800
989
  #
801
990
  # Be careful with the `DeleteQueue` action: When you delete a queue, any
802
991
  # messages in the queue are no longer available.
@@ -810,14 +999,14 @@ module Aws::SQS
810
999
  # creating a queue with the same name.
811
1000
  #
812
1001
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
813
- # information, see see [Grant Cross-Account Permissions to a Role and a
814
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1002
+ # information, see [Grant Cross-Account Permissions to a Role and a User
1003
+ # Name][1] in the *Amazon Simple Queue Service Developer Guide*.
815
1004
  #
816
1005
  # </note>
817
1006
  #
818
1007
  #
819
1008
  #
820
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1009
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
821
1010
  #
822
1011
  # @option params [required, String] :queue_url
823
1012
  # The URL of the Amazon SQS queue to delete.
@@ -848,17 +1037,9 @@ module Aws::SQS
848
1037
  #
849
1038
  # </note>
850
1039
  #
851
- # Some actions take lists of parameters. These lists are specified using
852
- # the `param.n` notation. Values of `n` are integers starting from 1.
853
- # For example, a parameter list with two elements looks like this:
854
- #
855
- # `&Attribute.1=first`
856
- #
857
- # `&Attribute.2=second`
858
- #
859
1040
  #
860
1041
  #
861
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
1042
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
862
1043
  #
863
1044
  # @option params [required, String] :queue_url
864
1045
  # The URL of the Amazon SQS queue whose attribute information is
@@ -877,70 +1058,77 @@ module Aws::SQS
877
1058
  #
878
1059
  # The following attributes are supported:
879
1060
  #
880
- # * `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.
881
1067
  #
882
- # * `ApproximateNumberOfMessages` - Returns the approximate number of
1068
+ # * `All` Returns all values.
1069
+ #
1070
+ # * `ApproximateNumberOfMessages` – Returns the approximate number of
883
1071
  # messages available for retrieval from the queue.
884
1072
  #
885
- # * `ApproximateNumberOfMessagesDelayed` - Returns the approximate
1073
+ # * `ApproximateNumberOfMessagesDelayed` Returns the approximate
886
1074
  # number of messages in the queue that are delayed and not available
887
1075
  # for reading immediately. This can happen when the queue is
888
1076
  # configured as a delay queue or when a message has been sent with a
889
1077
  # delay parameter.
890
1078
  #
891
- # * `ApproximateNumberOfMessagesNotVisible` - Returns the approximate
1079
+ # * `ApproximateNumberOfMessagesNotVisible` Returns the approximate
892
1080
  # number of messages that are in flight. Messages are considered to be
893
1081
  # *in flight* if they have been sent to a client but have not yet been
894
1082
  # deleted or have not yet reached the end of their visibility window.
895
1083
  #
896
- # * `CreatedTimestamp` - Returns the time when the queue was created in
1084
+ # * `CreatedTimestamp` Returns the time when the queue was created in
897
1085
  # seconds ([epoch time][1]).
898
1086
  #
899
- # * `DelaySeconds` - Returns the default delay on the queue in seconds.
1087
+ # * `DelaySeconds` Returns the default delay on the queue in seconds.
900
1088
  #
901
- # * `LastModifiedTimestamp` - Returns the time when the queue was last
1089
+ # * `LastModifiedTimestamp` Returns the time when the queue was last
902
1090
  # changed in seconds ([epoch time][1]).
903
1091
  #
904
- # * `MaximumMessageSize` - Returns the limit of how many bytes a message
1092
+ # * `MaximumMessageSize` Returns the limit of how many bytes a message
905
1093
  # can contain before Amazon SQS rejects it.
906
1094
  #
907
- # * `MessageRetentionPeriod` - Returns the length of time, in seconds,
1095
+ # * `MessageRetentionPeriod` Returns the length of time, in seconds,
908
1096
  # for which Amazon SQS retains a message.
909
1097
  #
910
- # * `Policy` - Returns the policy of the queue.
1098
+ # * `Policy` Returns the policy of the queue.
911
1099
  #
912
- # * `QueueArn` - Returns the Amazon resource name (ARN) of the queue.
1100
+ # * `QueueArn` Returns the Amazon resource name (ARN) of the queue.
913
1101
  #
914
- # * `ReceiveMessageWaitTimeSeconds` - Returns the length of time, in
1102
+ # * `ReceiveMessageWaitTimeSeconds` Returns the length of time, in
915
1103
  # seconds, for which the `ReceiveMessage` action waits for a message
916
1104
  # to arrive.
917
1105
  #
918
- # * `RedrivePolicy` - Returns the string that includes the parameters
919
- # for dead-letter queue functionality of the source queue. For more
920
- # information about the redrive policy and dead-letter queues, see
921
- # [Using Amazon SQS Dead-Letter Queues][2] in the *Amazon Simple Queue
922
- # 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*.
923
1111
  #
924
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
1112
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
925
1113
  # dead-letter queue to which Amazon SQS moves messages after the
926
1114
  # value of `maxReceiveCount` is exceeded.
927
1115
  #
928
- # * `maxReceiveCount` - The number of times a message is delivered to
1116
+ # * `maxReceiveCount` The number of times a message is delivered to
929
1117
  # the source queue before being moved to the dead-letter queue. When
930
1118
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
931
1119
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
932
1120
  #
933
- # * `VisibilityTimeout` - Returns the visibility timeout for the queue.
1121
+ # * `VisibilityTimeout` Returns the visibility timeout for the queue.
934
1122
  # For more information about the visibility timeout, see [Visibility
935
1123
  # Timeout][3] in the *Amazon Simple Queue Service Developer Guide*.
936
1124
  #
937
1125
  # The following attributes apply only to [server-side-encryption][4]\:
938
1126
  #
939
- # * `KmsMasterKeyId` - Returns the ID of an AWS-managed customer master
1127
+ # * `KmsMasterKeyId` Returns the ID of an AWS-managed customer master
940
1128
  # key (CMK) for Amazon SQS or a custom CMK. For more information, see
941
1129
  # [Key Terms][5].
942
1130
  #
943
- # * `KmsDataKeyReusePeriodSeconds` - Returns the length of time, in
1131
+ # * `KmsDataKeyReusePeriodSeconds` Returns the length of time, in
944
1132
  # seconds, for which Amazon SQS can reuse a data key to encrypt or
945
1133
  # decrypt messages before calling AWS KMS again. For more information,
946
1134
  # see [How Does the Data Key Reuse Period Work?][6].
@@ -948,7 +1136,7 @@ module Aws::SQS
948
1136
  # The following attributes apply only to [FIFO (first-in-first-out)
949
1137
  # queues][7]\:
950
1138
  #
951
- # * `FifoQueue` - Returns whether the queue is FIFO. For more
1139
+ # * `FifoQueue` Returns whether the queue is FIFO. For more
952
1140
  # information, see [FIFO Queue Logic][8] in the *Amazon Simple Queue
953
1141
  # Service Developer Guide*.
954
1142
  #
@@ -957,7 +1145,7 @@ module Aws::SQS
957
1145
  #
958
1146
  # </note>
959
1147
  #
960
- # * `ContentBasedDeduplication` - Returns whether content-based
1148
+ # * `ContentBasedDeduplication` Returns whether content-based
961
1149
  # deduplication is enabled for the queue. For more information, see
962
1150
  # [Exactly-Once Processing][9] in the *Amazon Simple Queue Service
963
1151
  # Developer Guide*.
@@ -965,14 +1153,14 @@ module Aws::SQS
965
1153
  #
966
1154
  #
967
1155
  # [1]: http://en.wikipedia.org/wiki/Unix_time
968
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
969
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
970
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
971
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
972
- # [6]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
973
- # [7]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
974
- # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
975
- # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1156
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
1157
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1158
+ # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
1159
+ # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
1160
+ # [6]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
1161
+ # [7]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
1162
+ # [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-understanding-logic
1163
+ # [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
976
1164
  #
977
1165
  # @return [Types::GetQueueAttributesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
978
1166
  #
@@ -1010,7 +1198,7 @@ module Aws::SQS
1010
1198
  #
1011
1199
  #
1012
1200
  #
1013
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
1201
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-writing-an-sqs-policy.html#write-messages-to-shared-queue
1014
1202
  #
1015
1203
  # @option params [required, String] :queue_name
1016
1204
  # The name of the queue whose URL must be fetched. Maximum 80
@@ -1049,33 +1237,56 @@ module Aws::SQS
1049
1237
  # Returns a list of your queues that have the `RedrivePolicy` queue
1050
1238
  # attribute configured with a dead-letter queue.
1051
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
+ #
1052
1249
  # For more information about using dead-letter queues, see [Using Amazon
1053
1250
  # SQS Dead-Letter Queues][1] in the *Amazon Simple Queue Service
1054
1251
  # Developer Guide*.
1055
1252
  #
1056
1253
  #
1057
1254
  #
1058
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
1255
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
1059
1256
  #
1060
1257
  # @option params [required, String] :queue_url
1061
1258
  # The URL of a dead-letter queue.
1062
1259
  #
1063
1260
  # Queue URLs and names are case-sensitive.
1064
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
+ #
1065
1270
  # @return [Types::ListDeadLetterSourceQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1066
1271
  #
1067
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}.
1068
1276
  #
1069
1277
  # @example Request syntax with placeholder values
1070
1278
  #
1071
1279
  # resp = client.list_dead_letter_source_queues({
1072
1280
  # queue_url: "String", # required
1281
+ # next_token: "Token",
1282
+ # max_results: 1,
1073
1283
  # })
1074
1284
  #
1075
1285
  # @example Response structure
1076
1286
  #
1077
1287
  # resp.queue_urls #=> Array
1078
1288
  # resp.queue_urls[0] #=> String
1289
+ # resp.next_token #=> String
1079
1290
  #
1080
1291
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListDeadLetterSourceQueues AWS API Documentation
1081
1292
  #
@@ -1090,37 +1301,16 @@ module Aws::SQS
1090
1301
  # For an overview, see [Tagging Your Amazon SQS Queues][1] in the
1091
1302
  # *Amazon Simple Queue Service Developer Guide*.
1092
1303
  #
1093
- # When you use queue tags, keep the following guidelines in mind:
1094
- #
1095
- # * Adding more than 50 tags to a queue isn't recommended.
1096
- #
1097
- # * Tags don't have any semantic meaning. Amazon SQS interprets tags as
1098
- # character strings.
1099
- #
1100
- # * Tags are case-sensitive.
1101
- #
1102
- # * A new tag with a key identical to that of an existing tag overwrites
1103
- # the existing tag.
1104
- #
1105
- # * Tagging actions are limited to 5 TPS per AWS account. If your
1106
- # application requires a higher throughput, file a [technical support
1107
- # request][2].
1108
- #
1109
- # For a full list of tag restrictions, see [Limits Related to Queues][3]
1110
- # in the *Amazon Simple Queue Service Developer Guide*.
1111
- #
1112
1304
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1113
- # information, see see [Grant Cross-Account Permissions to a Role and a
1114
- # User Name][4] in the *Amazon Simple Queue Service Developer Guide*.
1305
+ # information, see [Grant Cross-Account Permissions to a Role and a User
1306
+ # Name][2] in the *Amazon Simple Queue Service Developer Guide*.
1115
1307
  #
1116
1308
  # </note>
1117
1309
  #
1118
1310
  #
1119
1311
  #
1120
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
1121
- # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=technical
1122
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
1123
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1312
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
1313
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1124
1314
  #
1125
1315
  # @option params [required, String] :queue_url
1126
1316
  # The URL of the queue.
@@ -1149,20 +1339,28 @@ module Aws::SQS
1149
1339
  req.send_request(options)
1150
1340
  end
1151
1341
 
1152
- # Returns a list of your queues. The maximum number of queues that can
1153
- # be returned is 1,000. If you specify a value for the optional
1154
- # `QueueNamePrefix` parameter, only queues with a name that begins with
1155
- # 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.
1156
1354
  #
1157
1355
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
1158
- # information, see see [Grant Cross-Account Permissions to a Role and a
1159
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1356
+ # information, see [Grant Cross-Account Permissions to a Role and a User
1357
+ # Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1160
1358
  #
1161
1359
  # </note>
1162
1360
  #
1163
1361
  #
1164
1362
  #
1165
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1363
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1166
1364
  #
1167
1365
  # @option params [String] :queue_name_prefix
1168
1366
  # A string to use for filtering the list results. Only those queues
@@ -1170,20 +1368,34 @@ module Aws::SQS
1170
1368
  #
1171
1369
  # Queue URLs and names are case-sensitive.
1172
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
+ #
1173
1379
  # @return [Types::ListQueuesResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1174
1380
  #
1175
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}.
1176
1385
  #
1177
1386
  # @example Request syntax with placeholder values
1178
1387
  #
1179
1388
  # resp = client.list_queues({
1180
1389
  # queue_name_prefix: "String",
1390
+ # next_token: "Token",
1391
+ # max_results: 1,
1181
1392
  # })
1182
1393
  #
1183
1394
  # @example Response structure
1184
1395
  #
1185
1396
  # resp.queue_urls #=> Array
1186
1397
  # resp.queue_urls[0] #=> String
1398
+ # resp.next_token #=> String
1187
1399
  #
1188
1400
  # @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ListQueues AWS API Documentation
1189
1401
  #
@@ -1284,10 +1496,10 @@ module Aws::SQS
1284
1496
  #
1285
1497
  #
1286
1498
  #
1287
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html
1499
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-long-polling.html
1288
1500
  # [2]: https://www.ietf.org/rfc/rfc1321.txt
1289
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html
1290
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1501
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-message-identifiers.html
1502
+ # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1291
1503
  #
1292
1504
  # @option params [required, String] :queue_url
1293
1505
  # The URL of the Amazon SQS queue from which messages are received.
@@ -1295,16 +1507,18 @@ module Aws::SQS
1295
1507
  # Queue URLs and names are case-sensitive.
1296
1508
  #
1297
1509
  # @option params [Array<String>] :attribute_names
1298
- # A list of s that need to be returned along with each message. These
1299
- # attributes include:
1510
+ # A list of attributes that need to be returned along with each message.
1511
+ # These attributes include:
1300
1512
  #
1301
- # * `All` - Returns all values.
1513
+ # * `All` Returns all values.
1302
1514
  #
1303
- # * `ApproximateFirstReceiveTimestamp` - Returns the time the message
1515
+ # * `ApproximateFirstReceiveTimestamp` Returns the time the message
1304
1516
  # was first received from the queue ([epoch time][1] in milliseconds).
1305
1517
  #
1306
- # * `ApproximateReceiveCount` - Returns the number of times a message
1307
- # 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.
1520
+ #
1521
+ # * `AWSTraceHeader` – Returns the AWS X-Ray trace header string.
1308
1522
  #
1309
1523
  # * `SenderId`
1310
1524
  #
@@ -1314,17 +1528,17 @@ module Aws::SQS
1314
1528
  # * For an IAM role, returns the IAM role ID, for example
1315
1529
  # `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
1316
1530
  #
1317
- # * `SentTimestamp` - Returns the time the message was sent to the queue
1531
+ # * `SentTimestamp` Returns the time the message was sent to the queue
1318
1532
  # ([epoch time][1] in milliseconds).
1319
1533
  #
1320
- # * `MessageDeduplicationId` - Returns the value provided by the
1534
+ # * `MessageDeduplicationId` Returns the value provided by the
1321
1535
  # producer that calls the ` SendMessage ` action.
1322
1536
  #
1323
- # * `MessageGroupId` - Returns the value provided by the producer that
1537
+ # * `MessageGroupId` Returns the value provided by the producer that
1324
1538
  # calls the ` SendMessage ` action. Messages with the same
1325
1539
  # `MessageGroupId` are returned in sequence.
1326
1540
  #
1327
- # * `SequenceNumber` - Returns the value provided by Amazon SQS.
1541
+ # * `SequenceNumber` Returns the value provided by Amazon SQS.
1328
1542
  #
1329
1543
  #
1330
1544
  #
@@ -1369,14 +1583,25 @@ module Aws::SQS
1369
1583
  # available and the wait time expires, the call returns successfully
1370
1584
  # with an empty list of messages.
1371
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
+ #
1372
1597
  # @option params [String] :receive_request_attempt_id
1373
1598
  # This parameter applies only to FIFO (first-in-first-out) queues.
1374
1599
  #
1375
1600
  # The token used for deduplication of `ReceiveMessage` calls. If a
1376
1601
  # networking issue occurs after a `ReceiveMessage` action, and instead
1377
- # of a response you receive a generic error, you can retry the same
1378
- # action with an identical `ReceiveRequestAttemptId` to retrieve the
1379
- # 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
1380
1605
  # expired.
1381
1606
  #
1382
1607
  # * You can use `ReceiveRequestAttemptId` only for 5 minutes after a
@@ -1389,7 +1614,7 @@ module Aws::SQS
1389
1614
  # `ReceiveRequestAttemptId`, Amazon SQS generates a
1390
1615
  # `ReceiveRequestAttemptId`.
1391
1616
  #
1392
- # * You can retry the `ReceiveMessage` action with the same
1617
+ # * It is possible to retry the `ReceiveMessage` action with the same
1393
1618
  # `ReceiveRequestAttemptId` if none of the messages have been modified
1394
1619
  # (deleted or had their visibility changes).
1395
1620
  #
@@ -1420,7 +1645,7 @@ module Aws::SQS
1420
1645
  # visibility timeout expires. As a result, delays might occur but the
1421
1646
  # messages in the queue remain in a strict order.
1422
1647
  #
1423
- # The length of `ReceiveRequestAttemptId` is 128 characters.
1648
+ # The maximum length of `ReceiveRequestAttemptId` is 128 characters.
1424
1649
  # `ReceiveRequestAttemptId` can contain alphanumeric characters (`a-z`,
1425
1650
  # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
1426
1651
  # ``).
@@ -1431,8 +1656,8 @@ module Aws::SQS
1431
1656
  #
1432
1657
  #
1433
1658
  #
1434
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1435
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-receiverequestattemptid-request-parameter.html
1659
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1660
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-receiverequestattemptid-request-parameter.html
1436
1661
  #
1437
1662
  # @return [Types::ReceiveMessageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1438
1663
  #
@@ -1481,17 +1706,21 @@ module Aws::SQS
1481
1706
  # Revokes any permissions in the queue policy that matches the specified
1482
1707
  # `Label` parameter.
1483
1708
  #
1484
- # <note markdown="1"> Only the owner of a queue can remove permissions from it.
1709
+ # <note markdown="1"> * Only the owner of a queue can remove permissions from it.
1710
+ #
1711
+ # * Cross-account permissions don't apply to this action. For more
1712
+ # information, see [Grant Cross-Account Permissions to a Role and a
1713
+ # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1485
1714
  #
1486
- # Cross-account permissions don't apply to this action. For more
1487
- # information, see see [Grant Cross-Account Permissions to a Role and a
1488
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1715
+ # * To remove the ability to change queue permissions, you must deny
1716
+ # permission to the `AddPermission`, `RemovePermission`, and
1717
+ # `SetQueueAttributes` actions in your IAM policy.
1489
1718
  #
1490
1719
  # </note>
1491
1720
  #
1492
1721
  #
1493
1722
  #
1494
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1723
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1495
1724
  #
1496
1725
  # @option params [required, String] :queue_url
1497
1726
  # The URL of the Amazon SQS queue from which permissions are removed.
@@ -1541,7 +1770,8 @@ module Aws::SQS
1541
1770
  # Queue URLs and names are case-sensitive.
1542
1771
  #
1543
1772
  # @option params [required, String] :message_body
1544
- # 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.
1545
1775
  #
1546
1776
  # A message can include only XML, JSON, and unformatted text. The
1547
1777
  # following Unicode characters are allowed:
@@ -1575,7 +1805,18 @@ module Aws::SQS
1575
1805
  #
1576
1806
  #
1577
1807
  #
1578
- # [1]: http://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
1809
+ #
1810
+ # @option params [Hash<String,Types::MessageSystemAttributeValue>] :message_system_attributes
1811
+ # The message system attribute to send. Each message system attribute
1812
+ # consists of a `Name`, `Type`, and `Value`.
1813
+ #
1814
+ # * Currently, the only supported message system attribute is
1815
+ # `AWSTraceHeader`. Its type must be `String` and its value must be a
1816
+ # correctly formatted AWS X-Ray trace header string.
1817
+ #
1818
+ # * The size of a message system attribute doesn't count towards the
1819
+ # total size of a message.
1579
1820
  #
1580
1821
  # @option params [String] :message_deduplication_id
1581
1822
  # This parameter applies only to FIFO (first-in-first-out) queues.
@@ -1625,7 +1866,7 @@ module Aws::SQS
1625
1866
  #
1626
1867
  # </note>
1627
1868
  #
1628
- # The length of `MessageDeduplicationId` is 128 characters.
1869
+ # The maximum length of `MessageDeduplicationId` is 128 characters.
1629
1870
  # `MessageDeduplicationId` can contain alphanumeric characters (`a-z`,
1630
1871
  # `A-Z`, `0-9`) and punctuation (`` !"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~
1631
1872
  # ``).
@@ -1636,8 +1877,8 @@ module Aws::SQS
1636
1877
  #
1637
1878
  #
1638
1879
  #
1639
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1640
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagededuplicationid-property.html
1880
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1881
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagededuplicationid-property.html
1641
1882
  #
1642
1883
  # @option params [String] :message_group_id
1643
1884
  # This parameter applies only to FIFO (first-in-first-out) queues.
@@ -1671,12 +1912,13 @@ module Aws::SQS
1671
1912
  #
1672
1913
  #
1673
1914
  #
1674
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html
1915
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/using-messagegroupid-property.html
1675
1916
  #
1676
1917
  # @return [Types::SendMessageResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1677
1918
  #
1678
1919
  # * {Types::SendMessageResult#md5_of_message_body #md5_of_message_body} => String
1679
1920
  # * {Types::SendMessageResult#md5_of_message_attributes #md5_of_message_attributes} => String
1921
+ # * {Types::SendMessageResult#md5_of_message_system_attributes #md5_of_message_system_attributes} => String
1680
1922
  # * {Types::SendMessageResult#message_id #message_id} => String
1681
1923
  # * {Types::SendMessageResult#sequence_number #sequence_number} => String
1682
1924
  #
@@ -1695,6 +1937,15 @@ module Aws::SQS
1695
1937
  # data_type: "String", # required
1696
1938
  # },
1697
1939
  # },
1940
+ # message_system_attributes: {
1941
+ # "AWSTraceHeader" => {
1942
+ # string_value: "String",
1943
+ # binary_value: "data",
1944
+ # string_list_values: ["String"],
1945
+ # binary_list_values: ["data"],
1946
+ # data_type: "String", # required
1947
+ # },
1948
+ # },
1698
1949
  # message_deduplication_id: "String",
1699
1950
  # message_group_id: "String",
1700
1951
  # })
@@ -1703,6 +1954,7 @@ module Aws::SQS
1703
1954
  #
1704
1955
  # resp.md5_of_message_body #=> String
1705
1956
  # resp.md5_of_message_attributes #=> String
1957
+ # resp.md5_of_message_system_attributes #=> String
1706
1958
  # resp.message_id #=> String
1707
1959
  # resp.sequence_number #=> String
1708
1960
  #
@@ -1744,9 +1996,9 @@ module Aws::SQS
1744
1996
  # the `param.n` notation. Values of `n` are integers starting from 1.
1745
1997
  # For example, a parameter list with two elements looks like this:
1746
1998
  #
1747
- # `&Attribute.1=first`
1999
+ # `&AttributeName.1=first`
1748
2000
  #
1749
- # `&Attribute.2=second`
2001
+ # `&AttributeName.2=second`
1750
2002
  #
1751
2003
  #
1752
2004
  #
@@ -1783,6 +2035,15 @@ module Aws::SQS
1783
2035
  # data_type: "String", # required
1784
2036
  # },
1785
2037
  # },
2038
+ # message_system_attributes: {
2039
+ # "AWSTraceHeader" => {
2040
+ # string_value: "String",
2041
+ # binary_value: "data",
2042
+ # string_list_values: ["String"],
2043
+ # binary_list_values: ["data"],
2044
+ # data_type: "String", # required
2045
+ # },
2046
+ # },
1786
2047
  # message_deduplication_id: "String",
1787
2048
  # message_group_id: "String",
1788
2049
  # },
@@ -1796,6 +2057,7 @@ module Aws::SQS
1796
2057
  # resp.successful[0].message_id #=> String
1797
2058
  # resp.successful[0].md5_of_message_body #=> String
1798
2059
  # resp.successful[0].md5_of_message_attributes #=> String
2060
+ # resp.successful[0].md5_of_message_system_attributes #=> String
1799
2061
  # resp.successful[0].sequence_number #=> String
1800
2062
  # resp.failed #=> Array
1801
2063
  # resp.failed[0].id #=> String
@@ -1818,19 +2080,23 @@ module Aws::SQS
1818
2080
  # made to the `MessageRetentionPeriod` attribute can take up to 15
1819
2081
  # minutes.
1820
2082
  #
1821
- # <note markdown="1"> In the future, new attributes might be added. If you write code that
1822
- # calls this action, we recommend that you structure your code so that
1823
- # it can handle new attributes gracefully.
2083
+ # <note markdown="1"> * In the future, new attributes might be added. If you write code that
2084
+ # calls this action, we recommend that you structure your code so that
2085
+ # it can handle new attributes gracefully.
2086
+ #
2087
+ # * Cross-account permissions don't apply to this action. For more
2088
+ # information, see [Grant Cross-Account Permissions to a Role and a
2089
+ # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
1824
2090
  #
1825
- # Cross-account permissions don't apply to this action. For more
1826
- # information, see see [Grant Cross-Account Permissions to a Role and a
1827
- # User Name][1] in the *Amazon Simple Queue Service Developer Guide*.
2091
+ # * To remove the ability to change queue permissions, you must deny
2092
+ # permission to the `AddPermission`, `RemovePermission`, and
2093
+ # `SetQueueAttributes` actions in your IAM policy.
1828
2094
  #
1829
2095
  # </note>
1830
2096
  #
1831
2097
  #
1832
2098
  #
1833
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
2099
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
1834
2100
  #
1835
2101
  # @option params [required, String] :queue_url
1836
2102
  # The URL of the Amazon SQS queue whose attributes are set.
@@ -1843,39 +2109,39 @@ module Aws::SQS
1843
2109
  # The following lists the names, descriptions, and values of the special
1844
2110
  # request parameters that the `SetQueueAttributes` action uses:
1845
2111
  #
1846
- # * `DelaySeconds` - The length of time, in seconds, for which the
2112
+ # * `DelaySeconds` The length of time, in seconds, for which the
1847
2113
  # delivery of all messages in the queue is delayed. Valid values: An
1848
2114
  # integer from 0 to 900 (15 minutes). Default: 0.
1849
2115
  #
1850
- # * `MaximumMessageSize` - The limit of how many bytes a message can
2116
+ # * `MaximumMessageSize` The limit of how many bytes a message can
1851
2117
  # contain before Amazon SQS rejects it. Valid values: An integer from
1852
2118
  # 1,024 bytes (1 KiB) up to 262,144 bytes (256 KiB). Default: 262,144
1853
2119
  # (256 KiB).
1854
2120
  #
1855
- # * `MessageRetentionPeriod` - The length of time, in seconds, for which
2121
+ # * `MessageRetentionPeriod` The length of time, in seconds, for which
1856
2122
  # Amazon SQS retains a message. Valid values: An integer representing
1857
2123
  # seconds, from 60 (1 minute) to 1,209,600 (14 days). Default: 345,600
1858
2124
  # (4 days).
1859
2125
  #
1860
- # * `Policy` - The queue's policy. A valid AWS policy. For more
2126
+ # * `Policy` The queue's policy. A valid AWS policy. For more
1861
2127
  # information about policy structure, see [Overview of AWS IAM
1862
2128
  # Policies][1] in the *Amazon IAM User Guide*.
1863
2129
  #
1864
- # * `ReceiveMessageWaitTimeSeconds` - The length of time, in seconds,
2130
+ # * `ReceiveMessageWaitTimeSeconds` The length of time, in seconds,
1865
2131
  # for which a ` ReceiveMessage ` action waits for a message to arrive.
1866
- # Valid values: an integer from 0 to 20 (seconds). Default: 0.
2132
+ # Valid values: An integer from 0 to 20 (seconds). Default: 0.
1867
2133
  #
1868
- # * `RedrivePolicy` - The string that includes the parameters for the
1869
- # dead-letter queue functionality of the source queue. For more
1870
- # information about the redrive policy and dead-letter queues, see
1871
- # [Using Amazon SQS Dead-Letter Queues][2] in the *Amazon Simple Queue
1872
- # 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*.
1873
2139
  #
1874
- # * `deadLetterTargetArn` - The Amazon Resource Name (ARN) of the
2140
+ # * `deadLetterTargetArn` The Amazon Resource Name (ARN) of the
1875
2141
  # dead-letter queue to which Amazon SQS moves messages after the
1876
2142
  # value of `maxReceiveCount` is exceeded.
1877
2143
  #
1878
- # * `maxReceiveCount` - The number of times a message is delivered to
2144
+ # * `maxReceiveCount` The number of times a message is delivered to
1879
2145
  # the source queue before being moved to the dead-letter queue. When
1880
2146
  # the `ReceiveCount` for a message exceeds the `maxReceiveCount` for
1881
2147
  # a queue, Amazon SQS moves the message to the dead-letter-queue.
@@ -1886,22 +2152,22 @@ module Aws::SQS
1886
2152
  #
1887
2153
  # </note>
1888
2154
  #
1889
- # * `VisibilityTimeout` - The visibility timeout for the queue, in
1890
- # 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).
1891
2157
  # Default: 30. For more information about the visibility timeout, see
1892
2158
  # [Visibility Timeout][3] in the *Amazon Simple Queue Service
1893
2159
  # Developer Guide*.
1894
2160
  #
1895
2161
  # The following attributes apply only to [server-side-encryption][4]\:
1896
2162
  #
1897
- # * `KmsMasterKeyId` - The ID of an AWS-managed customer master key
2163
+ # * `KmsMasterKeyId` The ID of an AWS-managed customer master key
1898
2164
  # (CMK) for Amazon SQS or a custom CMK. For more information, see [Key
1899
2165
  # Terms][5]. While the alias of the AWS-managed CMK for Amazon SQS is
1900
2166
  # always `alias/aws/sqs`, the alias of a custom CMK can, for example,
1901
2167
  # be `alias/MyAlias `. For more examples, see [KeyId][6] in the *AWS
1902
2168
  # Key Management Service API Reference*.
1903
2169
  #
1904
- # * `KmsDataKeyReusePeriodSeconds` - The length of time, in seconds, for
2170
+ # * `KmsDataKeyReusePeriodSeconds` The length of time, in seconds, for
1905
2171
  # which Amazon SQS can reuse a [data key][7] to encrypt or decrypt
1906
2172
  # messages before calling AWS KMS again. An integer representing
1907
2173
  # seconds, between 60 seconds (1 minute) and 86,400 seconds (24
@@ -1913,7 +2179,7 @@ module Aws::SQS
1913
2179
  # The following attribute applies only to [FIFO (first-in-first-out)
1914
2180
  # queues][9]\:
1915
2181
  #
1916
- # * `ContentBasedDeduplication` - Enables content-based deduplication.
2182
+ # * `ContentBasedDeduplication` Enables content-based deduplication.
1917
2183
  # For more information, see [Exactly-Once Processing][10] in the
1918
2184
  # *Amazon Simple Queue Service Developer Guide*.
1919
2185
  #
@@ -1947,16 +2213,16 @@ module Aws::SQS
1947
2213
  #
1948
2214
  #
1949
2215
  #
1950
- # [1]: http://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
1951
- # [2]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
1952
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
1953
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
1954
- # [5]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
1955
- # [6]: http://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
1956
- # [7]: http://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
1957
- # [8]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
1958
- # [9]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
1959
- # [10]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
2216
+ # [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/PoliciesOverview.html
2217
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-dead-letter-queues.html
2218
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-visibility-timeout.html
2219
+ # [4]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html
2220
+ # [5]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-sse-key-terms
2221
+ # [6]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
2222
+ # [7]: https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#data-keys
2223
+ # [8]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-server-side-encryption.html#sqs-how-does-the-data-key-reuse-period-work
2224
+ # [9]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html
2225
+ # [10]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/FIFO-queues.html#FIFO-queues-exactly-once-processing
1960
2226
  #
1961
2227
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1962
2228
  #
@@ -1994,25 +2260,20 @@ module Aws::SQS
1994
2260
  # * A new tag with a key identical to that of an existing tag overwrites
1995
2261
  # the existing tag.
1996
2262
  #
1997
- # * Tagging actions are limited to 5 TPS per AWS account. If your
1998
- # application requires a higher throughput, file a [technical support
1999
- # request][2].
2000
- #
2001
- # For a full list of tag restrictions, see [Limits Related to Queues][3]
2263
+ # For a full list of tag restrictions, see [Limits Related to Queues][2]
2002
2264
  # in the *Amazon Simple Queue Service Developer Guide*.
2003
2265
  #
2004
2266
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
2005
- # information, see see [Grant Cross-Account Permissions to a Role and a
2006
- # User Name][4] in the *Amazon Simple Queue Service Developer Guide*.
2267
+ # information, see [Grant Cross-Account Permissions to a Role and a User
2268
+ # Name][3] in the *Amazon Simple Queue Service Developer Guide*.
2007
2269
  #
2008
2270
  # </note>
2009
2271
  #
2010
2272
  #
2011
2273
  #
2012
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
2013
- # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=technical
2014
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
2015
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
2274
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
2275
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
2276
+ # [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
2016
2277
  #
2017
2278
  # @option params [required, String] :queue_url
2018
2279
  # The URL of the queue.
@@ -2044,37 +2305,16 @@ module Aws::SQS
2044
2305
  # an overview, see [Tagging Your Amazon SQS Queues][1] in the *Amazon
2045
2306
  # Simple Queue Service Developer Guide*.
2046
2307
  #
2047
- # When you use queue tags, keep the following guidelines in mind:
2048
- #
2049
- # * Adding more than 50 tags to a queue isn't recommended.
2050
- #
2051
- # * Tags don't have any semantic meaning. Amazon SQS interprets tags as
2052
- # character strings.
2053
- #
2054
- # * Tags are case-sensitive.
2055
- #
2056
- # * A new tag with a key identical to that of an existing tag overwrites
2057
- # the existing tag.
2058
- #
2059
- # * Tagging actions are limited to 5 TPS per AWS account. If your
2060
- # application requires a higher throughput, file a [technical support
2061
- # request][2].
2062
- #
2063
- # For a full list of tag restrictions, see [Limits Related to Queues][3]
2064
- # in the *Amazon Simple Queue Service Developer Guide*.
2065
- #
2066
2308
  # <note markdown="1"> Cross-account permissions don't apply to this action. For more
2067
- # information, see see [Grant Cross-Account Permissions to a Role and a
2068
- # User Name][4] in the *Amazon Simple Queue Service Developer Guide*.
2309
+ # information, see [Grant Cross-Account Permissions to a Role and a User
2310
+ # Name][2] in the *Amazon Simple Queue Service Developer Guide*.
2069
2311
  #
2070
2312
  # </note>
2071
2313
  #
2072
2314
  #
2073
2315
  #
2074
- # [1]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
2075
- # [2]: https://console.aws.amazon.com/support/home#/case/create?issueType=technical
2076
- # [3]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-limits.html#limits-queues
2077
- # [4]: http://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
2316
+ # [1]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-queue-tags.html
2317
+ # [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-customer-managed-policy-examples.html#grant-cross-account-permissions-to-role-and-user-name
2078
2318
  #
2079
2319
  # @option params [required, String] :queue_url
2080
2320
  # The URL of the queue.
@@ -2113,7 +2353,7 @@ module Aws::SQS
2113
2353
  params: params,
2114
2354
  config: config)
2115
2355
  context[:gem_name] = 'aws-sdk-sqs'
2116
- context[:gem_version] = '1.10.0'
2356
+ context[:gem_version] = '1.34.0'
2117
2357
  Seahorse::Client::Request.new(handlers, context)
2118
2358
  end
2119
2359