Amazon SQS Delay Queues
Delay queues let you postpone the delivery of new messages in a queue for the specified
number of seconds. If you create a delay queue, any message that you send to that queue
is invisible to consumers for the duration of the delay period. You can use the
CreateQueue action to create a delay queue by setting the
DelaySeconds attribute to any value between
900 (15 minutes). You can also change an existing queue into a delay
queue using the
SetQueueAttributes action to set the queue's
For standard queues, the per-queue delay setting isn't
retroactive: If you change the
it doesn't affect the delay of messages already in the queue.
For FIFO queues, the per-queue delay setting is
retroactive: If you change the
DelaySeconds attribute, it
affects the delay of messages already in the queue.
Delay queues are similar to visibility timeouts because both features make messages unavailable to consumers for a specific period of time. The difference between delay queues and visibility timeouts is that for delay queues a message is hidden when it's first added to queue, whereas for visibility timeouts a message is hidden only after a message is consumed from the queue. The following figure illustrates the relationship between delay queues and visibility timeouts.
A message is considered to be in flight after it's received from a queue by a consumer, but not yet deleted from the queue.
For standard queues, there can be a maximum of 120,000 inflight messages per queue. If you reach this limit, Amazon SQS returns
OverLimit error message.
To avoid reaching the limit, you should delete messages from the queue after they're processed. You can also increase the
number of queues you use to process your messages.
For FIFO queues, there can be a maximum of 20,000 inflight messages per queue. If you reach this limit, Amazon SQS returns no error messages.
To set delay seconds on individual messages, rather than for an entire queue, use message timers. If you send a message with a message timer, Amazon SQS uses the message timer's delay seconds value instead of the delay queue's delay seconds value. For more information, see Amazon SQS Message Timers.
Creating Delay Queues with the AWS Management Console
You can create a delay queue using the AWS Management Console by setting a Delivery
Delay to a value greater than
To create a delay queue with the AWS Management Console
Sign in to the AWS Management Console and open the Amazon SQS console at https://console.aws.amazon.com/sqs/.
Choose Create New Queue.
In the Create New Queue dialog box, type your Queue Name.
For Delivery Delay, type a positive integer value.
Choose Create Queue.
You can use the AWS Management Console to change the Delivery Delay setting for an existing queue by selecting the Configure Queue action with an existing queue selected.
To set a new delivery delay value for an existing queue
Select an existing queue and then from the Queue Actions drop-down box select Configure Queue.
Change the Delivery Delay value to a positive integer.
Choose Save Changes.
Creating Delay Queues with the Query API
The following Query API example calls the
CreateQueue action to create a delay queue that hides each message from consumers for the first 45 seconds that the message is in the
How you structure the AUTHPARAMS depends on how you're signing your API request. For information on AUTHPARAMS in Signature Version 4, see Examples of Signed Signature Version 4 Requests.
http://sqs.us-east-2.amazonaws.com/ ?Action=CreateQueue &QueueName=testQueue &Attribute.1.Name=DelaySeconds &Attribute.1.Value=45 &Version=2012-11-05 &Expires=2015-12-20T22%3A52%3A43PST &AUTHPARAMS
Queue names and queue URLs are case-sensitive.
You can also change an existing queue into a delay queue by changing the DelaySeconds attribute from its default value of
0 to a positive integer value that is less than or equal to 900. The following example calls
SetQueueAttributes to set the
DelaySeconds attribute of a queue named
testQueue to 45 seconds.
http://sqs.us-east-2.amazonaws.com/123456789012/testQueue/ ?Action=SetQueueAttributes &DelaySeconds=45 &Version=2012-11-05 &Expires=2015-12-20T22%3A52%3A43PST &AUTHPARAMS