aws-sdk-sqs 1.10.0 → 1.34.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- 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