aws-sdk-sqs 1.64.0 → 1.73.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 +4 -4
- data/CHANGELOG.md +45 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-sqs/client.rb +143 -70
- data/lib/aws-sdk-sqs/client_api.rb +252 -58
- data/lib/aws-sdk-sqs/endpoint_provider.rb +2 -2
- data/lib/aws-sdk-sqs/errors.rb +251 -0
- data/lib/aws-sdk-sqs/plugins/endpoints.rb +4 -2
- data/lib/aws-sdk-sqs/plugins/md5s.rb +84 -35
- data/lib/aws-sdk-sqs/queue.rb +52 -8
- data/lib/aws-sdk-sqs/queue_poller.rb +31 -0
- data/lib/aws-sdk-sqs/types.rb +346 -25
- data/lib/aws-sdk-sqs.rb +1 -1
- data/sig/client.rbs +364 -0
- data/sig/errors.rbs +98 -0
- data/sig/message.rbs +73 -0
- data/sig/queue.rbs +164 -0
- data/sig/resource.rbs +105 -0
- data/sig/types.rbs +472 -0
- data/sig/waiters.rbs +13 -0
- metadata +16 -9
@@ -180,6 +180,16 @@ module Aws
|
|
180
180
|
# end
|
181
181
|
# ```
|
182
182
|
#
|
183
|
+
# * Configure an {#after_empty_receive} callback.
|
184
|
+
#
|
185
|
+
# ```
|
186
|
+
# poller.after_empty_receive do |stats|
|
187
|
+
# logger.info("requests: #{stats.request_count}")
|
188
|
+
# logger.info("messages: #{stats.received_message_count}")
|
189
|
+
# logger.info("last-timestamp: #{stats.last_message_received_at}")
|
190
|
+
# end
|
191
|
+
# ```
|
192
|
+
#
|
183
193
|
# * Accept a 2nd argument in the poll block, for example:
|
184
194
|
#
|
185
195
|
# ```
|
@@ -256,6 +266,21 @@ module Aws
|
|
256
266
|
@default_config = @default_config.with(before_request: block) if block_given?
|
257
267
|
end
|
258
268
|
|
269
|
+
# Registers a callback that is invoked when the poll requests returns with no messages.
|
270
|
+
# This callback is invoked after the idle timeout is checked.
|
271
|
+
#
|
272
|
+
# poller.after_empty_receive do |stats|
|
273
|
+
# # Handle empty receive
|
274
|
+
# end
|
275
|
+
#
|
276
|
+
# @yieldparam [PollerStats] stats An object that tracks a few
|
277
|
+
# client-side statistics about the queue polling.
|
278
|
+
#
|
279
|
+
# @return [void]
|
280
|
+
def after_empty_receive(&block)
|
281
|
+
@default_config = @default_config.with(after_empty_receive: block) if block_given?
|
282
|
+
end
|
283
|
+
|
259
284
|
# Polls the queue, yielded a message, or an array of messages.
|
260
285
|
# Messages are automatically deleted from the queue at the
|
261
286
|
# end of the given block. See the class documentation on
|
@@ -332,6 +357,7 @@ module Aws
|
|
332
357
|
messages = get_messages(config, stats)
|
333
358
|
if messages.empty?
|
334
359
|
check_idle_timeout(config, stats)
|
360
|
+
config.after_empty_receive&.call(stats)
|
335
361
|
else
|
336
362
|
process_messages(config, stats, messages, &block)
|
337
363
|
end
|
@@ -455,6 +481,7 @@ module Aws
|
|
455
481
|
idle_timeout
|
456
482
|
skip_delete
|
457
483
|
before_request
|
484
|
+
after_empty_receive
|
458
485
|
]
|
459
486
|
|
460
487
|
# @api private
|
@@ -475,6 +502,9 @@ module Aws
|
|
475
502
|
# @return [Proc,nil]
|
476
503
|
attr_reader :before_request
|
477
504
|
|
505
|
+
# @return [Proc,nil]
|
506
|
+
attr_reader :after_empty_receive
|
507
|
+
|
478
508
|
# @return [Hash]
|
479
509
|
attr_reader :request_params
|
480
510
|
|
@@ -482,6 +512,7 @@ module Aws
|
|
482
512
|
@idle_timeout = nil
|
483
513
|
@skip_delete = false
|
484
514
|
@before_request = nil
|
515
|
+
@after_empty_receive = nil
|
485
516
|
@request_params = {
|
486
517
|
wait_time_seconds: 20,
|
487
518
|
max_number_of_messages: 1,
|
data/lib/aws-sdk-sqs/types.rb
CHANGED
@@ -67,15 +67,29 @@ module Aws::SQS
|
|
67
67
|
|
68
68
|
# Two or more batch entries in the request have the same `Id`.
|
69
69
|
#
|
70
|
+
# @!attribute [rw] message
|
71
|
+
# @return [String]
|
72
|
+
#
|
70
73
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/BatchEntryIdsNotDistinct AWS API Documentation
|
71
74
|
#
|
72
|
-
class BatchEntryIdsNotDistinct <
|
75
|
+
class BatchEntryIdsNotDistinct < Struct.new(
|
76
|
+
:message)
|
77
|
+
SENSITIVE = []
|
78
|
+
include Aws::Structure
|
79
|
+
end
|
73
80
|
|
74
81
|
# The length of all the messages put together is more than the limit.
|
75
82
|
#
|
83
|
+
# @!attribute [rw] message
|
84
|
+
# @return [String]
|
85
|
+
#
|
76
86
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/BatchRequestTooLong AWS API Documentation
|
77
87
|
#
|
78
|
-
class BatchRequestTooLong <
|
88
|
+
class BatchRequestTooLong < Struct.new(
|
89
|
+
:message)
|
90
|
+
SENSITIVE = []
|
91
|
+
include Aws::Structure
|
92
|
+
end
|
79
93
|
|
80
94
|
# Gives a detailed description of the result of an action on each entry
|
81
95
|
# in the request.
|
@@ -646,9 +660,16 @@ module Aws::SQS
|
|
646
660
|
|
647
661
|
# The batch request doesn't contain any entries.
|
648
662
|
#
|
663
|
+
# @!attribute [rw] message
|
664
|
+
# @return [String]
|
665
|
+
#
|
649
666
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/EmptyBatchRequest AWS API Documentation
|
650
667
|
#
|
651
|
-
class EmptyBatchRequest <
|
668
|
+
class EmptyBatchRequest < Struct.new(
|
669
|
+
:message)
|
670
|
+
SENSITIVE = []
|
671
|
+
include Aws::Structure
|
672
|
+
end
|
652
673
|
|
653
674
|
# @!attribute [rw] queue_url
|
654
675
|
# The URL of the Amazon SQS queue whose attribute information is
|
@@ -918,18 +939,58 @@ module Aws::SQS
|
|
918
939
|
include Aws::Structure
|
919
940
|
end
|
920
941
|
|
942
|
+
# The `accountId` is invalid.
|
943
|
+
#
|
944
|
+
# @!attribute [rw] message
|
945
|
+
# @return [String]
|
946
|
+
#
|
947
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/InvalidAddress AWS API Documentation
|
948
|
+
#
|
949
|
+
class InvalidAddress < Struct.new(
|
950
|
+
:message)
|
951
|
+
SENSITIVE = []
|
952
|
+
include Aws::Structure
|
953
|
+
end
|
954
|
+
|
921
955
|
# The specified attribute doesn't exist.
|
922
956
|
#
|
957
|
+
# @!attribute [rw] message
|
958
|
+
# @return [String]
|
959
|
+
#
|
923
960
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/InvalidAttributeName AWS API Documentation
|
924
961
|
#
|
925
|
-
class InvalidAttributeName <
|
962
|
+
class InvalidAttributeName < Struct.new(
|
963
|
+
:message)
|
964
|
+
SENSITIVE = []
|
965
|
+
include Aws::Structure
|
966
|
+
end
|
967
|
+
|
968
|
+
# A queue attribute value is invalid.
|
969
|
+
#
|
970
|
+
# @!attribute [rw] message
|
971
|
+
# @return [String]
|
972
|
+
#
|
973
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/InvalidAttributeValue AWS API Documentation
|
974
|
+
#
|
975
|
+
class InvalidAttributeValue < Struct.new(
|
976
|
+
:message)
|
977
|
+
SENSITIVE = []
|
978
|
+
include Aws::Structure
|
979
|
+
end
|
926
980
|
|
927
981
|
# The `Id` of a batch entry in a batch request doesn't abide by the
|
928
982
|
# specification.
|
929
983
|
#
|
984
|
+
# @!attribute [rw] message
|
985
|
+
# @return [String]
|
986
|
+
#
|
930
987
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/InvalidBatchEntryId AWS API Documentation
|
931
988
|
#
|
932
|
-
class InvalidBatchEntryId <
|
989
|
+
class InvalidBatchEntryId < Struct.new(
|
990
|
+
:message)
|
991
|
+
SENSITIVE = []
|
992
|
+
include Aws::Structure
|
993
|
+
end
|
933
994
|
|
934
995
|
# The specified receipt handle isn't valid for the current version.
|
935
996
|
#
|
@@ -939,9 +1000,131 @@ module Aws::SQS
|
|
939
1000
|
|
940
1001
|
# The message contains characters outside the allowed set.
|
941
1002
|
#
|
1003
|
+
# @!attribute [rw] message
|
1004
|
+
# @return [String]
|
1005
|
+
#
|
942
1006
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/InvalidMessageContents AWS API Documentation
|
943
1007
|
#
|
944
|
-
class InvalidMessageContents <
|
1008
|
+
class InvalidMessageContents < Struct.new(
|
1009
|
+
:message)
|
1010
|
+
SENSITIVE = []
|
1011
|
+
include Aws::Structure
|
1012
|
+
end
|
1013
|
+
|
1014
|
+
# When the request to a queue is not HTTPS and SigV4.
|
1015
|
+
#
|
1016
|
+
# @!attribute [rw] message
|
1017
|
+
# @return [String]
|
1018
|
+
#
|
1019
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/InvalidSecurity AWS API Documentation
|
1020
|
+
#
|
1021
|
+
class InvalidSecurity < Struct.new(
|
1022
|
+
:message)
|
1023
|
+
SENSITIVE = []
|
1024
|
+
include Aws::Structure
|
1025
|
+
end
|
1026
|
+
|
1027
|
+
# The caller doesn't have the required KMS access.
|
1028
|
+
#
|
1029
|
+
# @!attribute [rw] message
|
1030
|
+
# @return [String]
|
1031
|
+
#
|
1032
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/KmsAccessDenied AWS API Documentation
|
1033
|
+
#
|
1034
|
+
class KmsAccessDenied < Struct.new(
|
1035
|
+
:message)
|
1036
|
+
SENSITIVE = []
|
1037
|
+
include Aws::Structure
|
1038
|
+
end
|
1039
|
+
|
1040
|
+
# The request was denied due to request throttling.
|
1041
|
+
#
|
1042
|
+
# @!attribute [rw] message
|
1043
|
+
# @return [String]
|
1044
|
+
#
|
1045
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/KmsDisabled AWS API Documentation
|
1046
|
+
#
|
1047
|
+
class KmsDisabled < Struct.new(
|
1048
|
+
:message)
|
1049
|
+
SENSITIVE = []
|
1050
|
+
include Aws::Structure
|
1051
|
+
end
|
1052
|
+
|
1053
|
+
# The request was rejected for one of the following reasons:
|
1054
|
+
#
|
1055
|
+
# * The KeyUsage value of the KMS key is incompatible with the API
|
1056
|
+
# operation.
|
1057
|
+
#
|
1058
|
+
# * The encryption algorithm or signing algorithm specified for the
|
1059
|
+
# operation is incompatible with the type of key material in the KMS
|
1060
|
+
# key (KeySpec).
|
1061
|
+
#
|
1062
|
+
# @!attribute [rw] message
|
1063
|
+
# @return [String]
|
1064
|
+
#
|
1065
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/KmsInvalidKeyUsage AWS API Documentation
|
1066
|
+
#
|
1067
|
+
class KmsInvalidKeyUsage < Struct.new(
|
1068
|
+
:message)
|
1069
|
+
SENSITIVE = []
|
1070
|
+
include Aws::Structure
|
1071
|
+
end
|
1072
|
+
|
1073
|
+
# The request was rejected because the state of the specified resource
|
1074
|
+
# is not valid for this request.
|
1075
|
+
#
|
1076
|
+
# @!attribute [rw] message
|
1077
|
+
# @return [String]
|
1078
|
+
#
|
1079
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/KmsInvalidState AWS API Documentation
|
1080
|
+
#
|
1081
|
+
class KmsInvalidState < Struct.new(
|
1082
|
+
:message)
|
1083
|
+
SENSITIVE = []
|
1084
|
+
include Aws::Structure
|
1085
|
+
end
|
1086
|
+
|
1087
|
+
# The request was rejected because the specified entity or resource
|
1088
|
+
# could not be found.
|
1089
|
+
#
|
1090
|
+
# @!attribute [rw] message
|
1091
|
+
# @return [String]
|
1092
|
+
#
|
1093
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/KmsNotFound AWS API Documentation
|
1094
|
+
#
|
1095
|
+
class KmsNotFound < Struct.new(
|
1096
|
+
:message)
|
1097
|
+
SENSITIVE = []
|
1098
|
+
include Aws::Structure
|
1099
|
+
end
|
1100
|
+
|
1101
|
+
# The request was rejected because the specified key policy isn't
|
1102
|
+
# syntactically or semantically correct.
|
1103
|
+
#
|
1104
|
+
# @!attribute [rw] message
|
1105
|
+
# @return [String]
|
1106
|
+
#
|
1107
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/KmsOptInRequired AWS API Documentation
|
1108
|
+
#
|
1109
|
+
class KmsOptInRequired < Struct.new(
|
1110
|
+
:message)
|
1111
|
+
SENSITIVE = []
|
1112
|
+
include Aws::Structure
|
1113
|
+
end
|
1114
|
+
|
1115
|
+
# Amazon Web Services KMS throttles requests for the following
|
1116
|
+
# conditions.
|
1117
|
+
#
|
1118
|
+
# @!attribute [rw] message
|
1119
|
+
# @return [String]
|
1120
|
+
#
|
1121
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/KmsThrottled AWS API Documentation
|
1122
|
+
#
|
1123
|
+
class KmsThrottled < Struct.new(
|
1124
|
+
:message)
|
1125
|
+
SENSITIVE = []
|
1126
|
+
include Aws::Structure
|
1127
|
+
end
|
945
1128
|
|
946
1129
|
# @!attribute [rw] queue_url
|
947
1130
|
# The URL of a dead-letter queue.
|
@@ -1062,8 +1245,9 @@ module Aws::SQS
|
|
1062
1245
|
#
|
1063
1246
|
# @!attribute [rw] approximate_number_of_messages_to_move
|
1064
1247
|
# The number of messages to be moved from the source queue. This
|
1065
|
-
# number is obtained at the time of starting the message movement
|
1066
|
-
# task
|
1248
|
+
# number is obtained at the time of starting the message movement task
|
1249
|
+
# and is only included after the message movement task is selected to
|
1250
|
+
# start.
|
1067
1251
|
# @return [Integer]
|
1068
1252
|
#
|
1069
1253
|
# @!attribute [rw] failure_reason
|
@@ -1371,17 +1555,31 @@ module Aws::SQS
|
|
1371
1555
|
# reached and `AddPermission` returns this error if the maximum number
|
1372
1556
|
# of permissions for the queue is reached.
|
1373
1557
|
#
|
1558
|
+
# @!attribute [rw] message
|
1559
|
+
# @return [String]
|
1560
|
+
#
|
1374
1561
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/OverLimit AWS API Documentation
|
1375
1562
|
#
|
1376
|
-
class OverLimit <
|
1563
|
+
class OverLimit < Struct.new(
|
1564
|
+
:message)
|
1565
|
+
SENSITIVE = []
|
1566
|
+
include Aws::Structure
|
1567
|
+
end
|
1377
1568
|
|
1378
1569
|
# Indicates that the specified queue previously received a `PurgeQueue`
|
1379
1570
|
# request within the last 60 seconds (the time it can take to delete the
|
1380
1571
|
# messages in the queue).
|
1381
1572
|
#
|
1573
|
+
# @!attribute [rw] message
|
1574
|
+
# @return [String]
|
1575
|
+
#
|
1382
1576
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/PurgeQueueInProgress AWS API Documentation
|
1383
1577
|
#
|
1384
|
-
class PurgeQueueInProgress <
|
1578
|
+
class PurgeQueueInProgress < Struct.new(
|
1579
|
+
:message)
|
1580
|
+
SENSITIVE = []
|
1581
|
+
include Aws::Structure
|
1582
|
+
end
|
1385
1583
|
|
1386
1584
|
# @!attribute [rw] queue_url
|
1387
1585
|
# The URL of the queue from which the `PurgeQueue` action deletes
|
@@ -1401,29 +1599,57 @@ module Aws::SQS
|
|
1401
1599
|
# You must wait 60 seconds after deleting a queue before you can create
|
1402
1600
|
# another queue with the same name.
|
1403
1601
|
#
|
1602
|
+
# @!attribute [rw] message
|
1603
|
+
# @return [String]
|
1604
|
+
#
|
1404
1605
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/QueueDeletedRecently AWS API Documentation
|
1405
1606
|
#
|
1406
|
-
class QueueDeletedRecently <
|
1607
|
+
class QueueDeletedRecently < Struct.new(
|
1608
|
+
:message)
|
1609
|
+
SENSITIVE = []
|
1610
|
+
include Aws::Structure
|
1611
|
+
end
|
1407
1612
|
|
1408
1613
|
# The specified queue doesn't exist.
|
1409
1614
|
#
|
1615
|
+
# @!attribute [rw] message
|
1616
|
+
# @return [String]
|
1617
|
+
#
|
1410
1618
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/QueueDoesNotExist AWS API Documentation
|
1411
1619
|
#
|
1412
|
-
class QueueDoesNotExist <
|
1620
|
+
class QueueDoesNotExist < Struct.new(
|
1621
|
+
:message)
|
1622
|
+
SENSITIVE = []
|
1623
|
+
include Aws::Structure
|
1624
|
+
end
|
1413
1625
|
|
1414
1626
|
# A queue with this name already exists. Amazon SQS returns this error
|
1415
1627
|
# only if the request includes attributes whose values differ from those
|
1416
1628
|
# of the existing queue.
|
1417
1629
|
#
|
1630
|
+
# @!attribute [rw] message
|
1631
|
+
# @return [String]
|
1632
|
+
#
|
1418
1633
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/QueueNameExists AWS API Documentation
|
1419
1634
|
#
|
1420
|
-
class QueueNameExists <
|
1635
|
+
class QueueNameExists < Struct.new(
|
1636
|
+
:message)
|
1637
|
+
SENSITIVE = []
|
1638
|
+
include Aws::Structure
|
1639
|
+
end
|
1421
1640
|
|
1422
1641
|
# The specified receipt handle isn't valid.
|
1423
1642
|
#
|
1643
|
+
# @!attribute [rw] message
|
1644
|
+
# @return [String]
|
1645
|
+
#
|
1424
1646
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ReceiptHandleIsInvalid AWS API Documentation
|
1425
1647
|
#
|
1426
|
-
class ReceiptHandleIsInvalid <
|
1648
|
+
class ReceiptHandleIsInvalid < Struct.new(
|
1649
|
+
:message)
|
1650
|
+
SENSITIVE = []
|
1651
|
+
include Aws::Structure
|
1652
|
+
end
|
1427
1653
|
|
1428
1654
|
# @!attribute [rw] queue_url
|
1429
1655
|
# The URL of the Amazon SQS queue from which messages are received.
|
@@ -1432,6 +1658,57 @@ module Aws::SQS
|
|
1432
1658
|
# @return [String]
|
1433
1659
|
#
|
1434
1660
|
# @!attribute [rw] attribute_names
|
1661
|
+
# This parameter has been deprecated but will be supported for
|
1662
|
+
# backward compatibility. To provide attribute names, you are
|
1663
|
+
# encouraged to use `MessageSystemAttributeNames`.
|
1664
|
+
#
|
1665
|
+
# A list of attributes that need to be returned along with each
|
1666
|
+
# message. These attributes include:
|
1667
|
+
#
|
1668
|
+
# * `All` – Returns all values.
|
1669
|
+
#
|
1670
|
+
# * `ApproximateFirstReceiveTimestamp` – Returns the time the message
|
1671
|
+
# was first received from the queue ([epoch time][1] in
|
1672
|
+
# milliseconds).
|
1673
|
+
#
|
1674
|
+
# * `ApproximateReceiveCount` – Returns the number of times a message
|
1675
|
+
# has been received across all queues but not deleted.
|
1676
|
+
#
|
1677
|
+
# * `AWSTraceHeader` – Returns the X-Ray trace header string.
|
1678
|
+
#
|
1679
|
+
# * `SenderId`
|
1680
|
+
#
|
1681
|
+
# * For a user, returns the user ID, for example
|
1682
|
+
# `ABCDEFGHI1JKLMNOPQ23R`.
|
1683
|
+
#
|
1684
|
+
# * For an IAM role, returns the IAM role ID, for example
|
1685
|
+
# `ABCDE1F2GH3I4JK5LMNOP:i-a123b456`.
|
1686
|
+
#
|
1687
|
+
# * `SentTimestamp` – Returns the time the message was sent to the
|
1688
|
+
# queue ([epoch time][1] in milliseconds).
|
1689
|
+
#
|
1690
|
+
# * `SqsManagedSseEnabled` – Enables server-side queue encryption
|
1691
|
+
# using SQS owned encryption keys. Only one server-side encryption
|
1692
|
+
# option is supported per queue (for example, [SSE-KMS][2] or
|
1693
|
+
# [SSE-SQS][3]).
|
1694
|
+
#
|
1695
|
+
# * `MessageDeduplicationId` – Returns the value provided by the
|
1696
|
+
# producer that calls the ` SendMessage ` action.
|
1697
|
+
#
|
1698
|
+
# * `MessageGroupId` – Returns the value provided by the producer that
|
1699
|
+
# calls the ` SendMessage ` action. Messages with the same
|
1700
|
+
# `MessageGroupId` are returned in sequence.
|
1701
|
+
#
|
1702
|
+
# * `SequenceNumber` – Returns the value provided by Amazon SQS.
|
1703
|
+
#
|
1704
|
+
#
|
1705
|
+
#
|
1706
|
+
# [1]: http://en.wikipedia.org/wiki/Unix_time
|
1707
|
+
# [2]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-configure-sse-existing-queue.html
|
1708
|
+
# [3]: https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-configure-sqs-sse-queue.html
|
1709
|
+
# @return [Array<String>]
|
1710
|
+
#
|
1711
|
+
# @!attribute [rw] message_system_attribute_names
|
1435
1712
|
# A list of attributes that need to be returned along with each
|
1436
1713
|
# message. These attributes include:
|
1437
1714
|
#
|
@@ -1517,8 +1794,8 @@ module Aws::SQS
|
|
1517
1794
|
# The duration (in seconds) for which the call waits for a message to
|
1518
1795
|
# arrive in the queue before returning. If a message is available, the
|
1519
1796
|
# call returns sooner than `WaitTimeSeconds`. If no messages are
|
1520
|
-
# available and the wait time expires, the call
|
1521
|
-
#
|
1797
|
+
# available and the wait time expires, the call does not return a
|
1798
|
+
# message list.
|
1522
1799
|
#
|
1523
1800
|
# To avoid HTTP errors, ensure that the HTTP response timeout for
|
1524
1801
|
# `ReceiveMessage` requests is longer than the `WaitTimeSeconds`
|
@@ -1549,10 +1826,6 @@ module Aws::SQS
|
|
1549
1826
|
# * When you set `FifoQueue`, a caller of the `ReceiveMessage` action
|
1550
1827
|
# can provide a `ReceiveRequestAttemptId` explicitly.
|
1551
1828
|
#
|
1552
|
-
# * If a caller of the `ReceiveMessage` action doesn't provide a
|
1553
|
-
# `ReceiveRequestAttemptId`, Amazon SQS generates a
|
1554
|
-
# `ReceiveRequestAttemptId`.
|
1555
|
-
#
|
1556
1829
|
# * It is possible to retry the `ReceiveMessage` action with the same
|
1557
1830
|
# `ReceiveRequestAttemptId` if none of the messages have been
|
1558
1831
|
# modified (deleted or had their visibility changes).
|
@@ -1606,6 +1879,7 @@ module Aws::SQS
|
|
1606
1879
|
class ReceiveMessageRequest < Struct.new(
|
1607
1880
|
:queue_url,
|
1608
1881
|
:attribute_names,
|
1882
|
+
:message_system_attribute_names,
|
1609
1883
|
:message_attribute_names,
|
1610
1884
|
:max_number_of_messages,
|
1611
1885
|
:visibility_timeout,
|
@@ -1649,11 +1923,44 @@ module Aws::SQS
|
|
1649
1923
|
include Aws::Structure
|
1650
1924
|
end
|
1651
1925
|
|
1926
|
+
# The request was denied due to request throttling.
|
1927
|
+
#
|
1928
|
+
# * The rate of requests per second exceeds the Amazon Web Services KMS
|
1929
|
+
# request quota for an account and Region.
|
1930
|
+
#
|
1931
|
+
# * A burst or sustained high rate of requests to change the state of
|
1932
|
+
# the same KMS key. This condition is often known as a "hot key."
|
1933
|
+
#
|
1934
|
+
# * Requests for operations on KMS keys in a Amazon Web Services
|
1935
|
+
# CloudHSM key store might be throttled at a lower-than-expected rate
|
1936
|
+
# when the Amazon Web Services CloudHSM cluster associated with the
|
1937
|
+
# Amazon Web Services CloudHSM key store is processing numerous
|
1938
|
+
# commands, including those unrelated to the Amazon Web Services
|
1939
|
+
# CloudHSM key store.
|
1940
|
+
#
|
1941
|
+
# @!attribute [rw] message
|
1942
|
+
# @return [String]
|
1943
|
+
#
|
1944
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/RequestThrottled AWS API Documentation
|
1945
|
+
#
|
1946
|
+
class RequestThrottled < Struct.new(
|
1947
|
+
:message)
|
1948
|
+
SENSITIVE = []
|
1949
|
+
include Aws::Structure
|
1950
|
+
end
|
1951
|
+
|
1652
1952
|
# One or more specified resources don't exist.
|
1653
1953
|
#
|
1954
|
+
# @!attribute [rw] message
|
1955
|
+
# @return [String]
|
1956
|
+
#
|
1654
1957
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/ResourceNotFoundException AWS API Documentation
|
1655
1958
|
#
|
1656
|
-
class ResourceNotFoundException <
|
1959
|
+
class ResourceNotFoundException < Struct.new(
|
1960
|
+
:message)
|
1961
|
+
SENSITIVE = []
|
1962
|
+
include Aws::Structure
|
1963
|
+
end
|
1657
1964
|
|
1658
1965
|
# @!attribute [rw] queue_url
|
1659
1966
|
# The URL of the Amazon SQS queue to which batched messages are sent.
|
@@ -2080,8 +2387,8 @@ module Aws::SQS
|
|
2080
2387
|
# are sorted by time sent. The caller can't specify a
|
2081
2388
|
# `MessageGroupId`.
|
2082
2389
|
#
|
2083
|
-
# The length of `MessageGroupId` is 128 characters. Valid
|
2084
|
-
# alphanumeric characters and punctuation ``
|
2390
|
+
# The maximum length of `MessageGroupId` is 128 characters. Valid
|
2391
|
+
# values: alphanumeric characters and punctuation ``
|
2085
2392
|
# (!"#$%&'()*+,-./:;<=>?@[\]^_`\{|\}~) ``.
|
2086
2393
|
#
|
2087
2394
|
# For best practices of using `MessageGroupId`, see [Using the
|
@@ -2449,15 +2756,29 @@ module Aws::SQS
|
|
2449
2756
|
|
2450
2757
|
# The batch request contains more entries than permissible.
|
2451
2758
|
#
|
2759
|
+
# @!attribute [rw] message
|
2760
|
+
# @return [String]
|
2761
|
+
#
|
2452
2762
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/TooManyEntriesInBatchRequest AWS API Documentation
|
2453
2763
|
#
|
2454
|
-
class TooManyEntriesInBatchRequest <
|
2764
|
+
class TooManyEntriesInBatchRequest < Struct.new(
|
2765
|
+
:message)
|
2766
|
+
SENSITIVE = []
|
2767
|
+
include Aws::Structure
|
2768
|
+
end
|
2455
2769
|
|
2456
2770
|
# Error code 400. Unsupported operation.
|
2457
2771
|
#
|
2772
|
+
# @!attribute [rw] message
|
2773
|
+
# @return [String]
|
2774
|
+
#
|
2458
2775
|
# @see http://docs.aws.amazon.com/goto/WebAPI/sqs-2012-11-05/UnsupportedOperation AWS API Documentation
|
2459
2776
|
#
|
2460
|
-
class UnsupportedOperation <
|
2777
|
+
class UnsupportedOperation < Struct.new(
|
2778
|
+
:message)
|
2779
|
+
SENSITIVE = []
|
2780
|
+
include Aws::Structure
|
2781
|
+
end
|
2461
2782
|
|
2462
2783
|
# @!attribute [rw] queue_url
|
2463
2784
|
# The URL of the queue.
|