|
| 1 | +--- |
| 2 | +title: Pause & Purge Queues |
| 3 | +description: Manage downtime and bad messages by pausing delivery, or deleting messages, from a Queue. |
| 4 | +products: |
| 5 | + - queues |
| 6 | +date: 2025-02-14 12:00:00 UTC |
| 7 | +--- |
| 8 | + |
| 9 | +You can now pause message delivery from a Queue, and purge all messages from a Queue. These operations are useful to manage downtime, handle bad messages in a queue, or run migrations. |
| 10 | + |
| 11 | +To pause a queue using Wrangler, run the `pause-delivery` command. Paused queues continue to receive messages. |
| 12 | +```bash title="Pause a Queue" |
| 13 | +$ wrangler queues pause-delivery my-queue |
| 14 | +Pausing message delivery for queue my-queue. |
| 15 | +Paused message delivery for queue my-queue. |
| 16 | +``` |
| 17 | + |
| 18 | +Pausing a queue is a reversible operation. To unpause the queue, run the `resume-delivery` command: |
| 19 | +```bash title="Resume a Queue" |
| 20 | +$ wrangler queues resume-delivery my-queue |
| 21 | +Resuming message delivery for Queue my-queue. |
| 22 | +Resumed message delivery for Queue my-queue. |
| 23 | +``` |
| 24 | + |
| 25 | +Purging a queue permanently deletes all messages in the queue. Unlike pausing, purging is an irreversible operation: |
| 26 | +```bash title="Purge a Queue" |
| 27 | +$ wrangler queues purge my-queue |
| 28 | +✔ This operation will permanently delete all the messages in Queue my-queue. Type my-queue to proceed. … my-queue |
| 29 | +Purged Queue 'mar-21' |
| 30 | +``` |
| 31 | + |
| 32 | +As seen above, you can do these operations using Wrangler. You can also do these operations using our REST API, or our Queues dashboard. |
| 33 | + |
| 34 | + |
| 35 | +This feature is available on all new and existing queues. Head over to the [pause and purge documentation](/queues/configuration/pause-purge) to learn more. And if you haven't used Cloudflare Queues before, [get started with the Cloudflare Queues guide](/queues/get-started). |
0 commit comments