Configure a dead-letter queue using the Amazon SQS console (original) (raw)

A dead-letter queue (DLQ) is a queue that receives messages that were not successfully processed from another queue, known as the source queue. Amazon SQS does not create the dead-letter queue automatically. You must first create the queue before using it as a dead-letter queue. When configuring a DLQ, the queue type must match the source queue type—a FIFO queue can only use a FIFO DLQ, and a standard queue can only use a standard DLQ. You can configure a dead-letter queue when you create or edit a queue. For more details, see Using dead-letter queues in Amazon SQS .

To configure a dead-letter queue for an existing queue (console)

1. Open the Amazon SQS console athttps://console.aws.amazon.com/sqs/.
2. In the navigation pane, choose Queues.
3. Select the source queue (the queue that will send failed messages to the dead-letter queue), then choose Edit.
4. Scroll to the Dead-letter queue section and toggleEnabled.
5. Under Dead-letter queue settings, choose the Amazon Resource Name (ARN) of an existing queue that you want to use as thedead-letter queue.
6. Set the Maximum receives value, which defines how many times a message can be received before being sent to the dead-letter queue (valid range: 1 to 1,000).
7. Choose Save.

Dead-letter queues

Configuring a dead-letter queue redrive

Did this page help you? - Yes

Thanks for letting us know we're doing a good job!

If you've got a moment, please tell us what we did right so we can do more of it.

Did this page help you? - No

Thanks for letting us know this page needs work. We're sorry we let you down.

If you've got a moment, please tell us how we can make the documentation better.