Skip to content

Commit 7d96b44

Browse files
maheshwaripelithrarOxyjun
authored andcommitted
Changelog for pause & purge (#21134)
* Updated changelog for pause and purge * Updated changelog entry * Fixed capitalization * typos * Made less verbose * Added link * Added links * Update src/content/changelog/queues/2025-03-25-pause-purge-queues.mdx Co-authored-by: Matt Silverlock <[email protected]> * Update src/content/changelog/queues/2025-03-25-pause-purge-queues.mdx Co-authored-by: Matt Silverlock <[email protected]> * Updated changelog with links * Update src/content/changelog/queues/2025-03-25-pause-purge-queues.mdx Co-authored-by: Matt Silverlock <[email protected]> * Update queues.yaml * Update 2025-03-25-pause-purge-queues.mdx * Apply suggestions from code review --------- Co-authored-by: Matt Silverlock <[email protected]> Co-authored-by: Jun Lee <[email protected]>
1 parent 3919954 commit 7d96b44

File tree

3 files changed

+53
-1
lines changed

3 files changed

+53
-1
lines changed
93 KB
Loading
Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: New Pause & Purge APIs for Queues
3+
description: Queues now supports the ability to pause delivery and/or delete messages from a queue, allowing you to better manage queue backlogs.
4+
products:
5+
- queues
6+
date: 2025-03-27 12:00:00 UTC
7+
---
8+
9+
[Queues](/queues/) now supports the ability to pause message delivery and/or purge (delete) messages on a queue. These operations can be useful when:
10+
11+
* Your consumer has a bug or downtime, and you want to temporarily stop messages from being processed while you fix the bug
12+
* You have pushed invalid messages to a queue due to a code change during development, and you want to clean up the backlog
13+
* Your queue has a backlog that is stale and you want to clean it up to allow new messages to be consumed
14+
15+
To pause a queue using [Wrangler](/workers/wrangler/), run the `pause-delivery` command. Paused queues continue to receive messages. And you can easily unpause a queue using the `resume-delivery` command.
16+
```bash title="Pause and resume a queue"
17+
$ wrangler queues pause-delivery my-queue
18+
Pausing message delivery for queue my-queue.
19+
Paused message delivery for queue my-queue.
20+
21+
$ wrangler queues resume-delivery my-queue
22+
Resuming message delivery for queue my-queue.
23+
Resumed message delivery for queue my-queue.
24+
```
25+
26+
Purging a queue permanently deletes all messages in the queue. Unlike pausing, purging is an irreversible operation:
27+
```bash title="Purge a queue"
28+
$ wrangler queues purge my-queue
29+
✔ This operation will permanently delete all the messages in queue my-queue. Type my-queue to proceed. … my-queue
30+
Purged queue 'my-queue'
31+
```
32+
33+
You can also do these operations using the [Queues REST API](/api/resources/queues/), or the dashboard page for a queue.
34+
35+
![Pause and purge using the dashboard](~/assets/images/queues/pause-purge.png)
36+
37+
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).

src/content/release-notes/queues.yaml

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,22 @@ productLink: "/queues/"
55
productArea: Developer platform
66
productAreaLink: /workers/platform/changelog/platform/
77
entries:
8+
- publish_date: "2025-03-27"
9+
title: Pause delivery and purge queues
10+
description: |-
11+
Queues now supports the ability to pause delivery and/or delete messages from a queue, allowing you to better manage queue backlogs.
12+
13+
Message delivery from a Queue to consumers can be paused / resumed. Queues continue to receive messages while paused.
14+
15+
Queues can be purged to permanently delete all messages currently stored in a Queue. This operation is useful while testing a new application, if a queue producer was misconfigured and is sending bad messages.
16+
17+
Refer to the [documentation on Pause & Purge](/queues/configuration/pause-purge/) to learn how to use both operations.
18+
- publish_date: "2025-02-14"
19+
title: Customize message retention period
20+
description: |-
21+
You can now customize a queue's message retention period, from a minimum of 60 seconds to a maximum of 14 days. Previously, it was fixed to the default of 4 days.
22+
23+
Refer to the [Queues confiuguration documentation](/queues/configuration/configure-queues/#queue-configuration) to learn more.
824
- publish_date: "2024-09-26"
925
title: Queues is GA, with higher throughput & consumer concurrency
1026
description: |-
@@ -13,7 +29,6 @@ entries:
1329
The per-queue message throughput has increased from 400 to 5,000 messages per second. This applies to new and existing queues.
1430
1531
Maximum concurrent consumers has increased from 20 to 250. This applies to new and existing queues. Queues with no explicit limit will automatically scale to the new maximum. Review the [consumer concurrency documentation](/queues/configuration/consumer-concurrency) to learn more.
16-
1732
- publish_date: "2024-03-26"
1833
title: Delay messages published to a queue
1934
description: |-

0 commit comments

Comments
 (0)