This is an automated email from the ASF dual-hosted git repository.
jbertram pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/activemq-artemis.git
The following commit(s) were added to refs/heads/main by this push:
new 7067b75670 NO-JIRA clarify expiry config doc
7067b75670 is described below
commit 7067b75670ca34bcfdc1fad39c2d1919b23c8b46
Author: Justin Bertram <[email protected]>
AuthorDate: Mon May 20 15:08:53 2024 -0500
NO-JIRA clarify expiry config doc
---
docs/user-manual/message-expiry.adoc | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/docs/user-manual/message-expiry.adoc
b/docs/user-manual/message-expiry.adoc
index 2855e26120..2805b7dc53 100644
--- a/docs/user-manual/message-expiry.adoc
+++ b/docs/user-manual/message-expiry.adoc
@@ -91,6 +91,18 @@ Expiry address are defined in the address-setting
configuration:
If messages are expired and no expiry address is specified, messages are
simply removed from the queue and dropped.
Address xref:wildcard-syntax.adoc#wildcard-syntax[wildcards] can be used to
configure expiry address for a set of addresses.
+If a wildcard is used to configure the expiry address for a set of addresses
and you want to _unset_ the expiry address for a particular addess (or set of
addresses) then you can do so, e.g.:
+
+[,xml]
+----
+<address-setting match="#">
+ <expiry-address>expiryQueue</expiry-address>
+</address-setting>
+<address-setting match="exampleQueue">
+ <expiry-address/> <!-- unset expiry-address so messages which expire from
queues bound to matching addresses are dropped -->
+</address-setting>
+----
+
== Configuring Automatic Creation of Expiry Resources
It's common to segregate expired messages by their original address.
