XGROUP DELCONSUMER · Valkey

XGROUP DELCONSUMER

Deletes a consumer from a consumer group.

Usage

XGROUP DELCONSUMER key group consumer

Description

The XGROUP DELCONSUMER command deletes a consumer from the consumer group.

Sometimes it may be useful to remove old consumers since they are no longer used.

Note, however, that any pending messages that the consumer had will become unclaimable after it was deleted. It is strongly recommended, therefore, that any pending messages are claimed or acknowledged prior to deleting the consumer from the group.

Reply

Integer reply: the number of pending messages the consumer had before it was deleted.

Complexity

O(1)

ACL Categories

@slow @stream @write

History

See also

XACK, XADD, XAUTOCLAIM, XCLAIM, XDEL, XGROUP, XGROUP CREATE, XGROUP CREATECONSUMER, XGROUP DESTROY, XGROUP HELP, XGROUP SETID, XINFO, XINFO CONSUMERS, XINFO GROUPS, XINFO HELP, XINFO STREAM, XLEN, XPENDING, XRANGE, XREAD, XREADGROUP, XREVRANGE, XSETID, XTRIM.