xgroup-delconsumer.3valkey - Man Page
Deletes a consumer from a consumer group.
Synopsis
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
valkey-protocol(7) Integer reply: the number of pending messages the consumer had before it was deleted.
Complexity
O(1)
Acl Categories
@slow @stream @write
History
- Available since: 5.0.0
See Also
xack(3valkey), xadd(3valkey), xautoclaim(3valkey), xclaim(3valkey), xdel(3valkey), xgroup(3valkey), xgroup-create(3valkey), xgroup-createconsumer(3valkey), xgroup-destroy(3valkey), xgroup-help(3valkey), xgroup-setid(3valkey), xinfo(3valkey), xinfo-consumers(3valkey), xinfo-groups(3valkey), xinfo-help(3valkey), xinfo-stream(3valkey), xlen(3valkey), xpending(3valkey), xrange(3valkey), xread(3valkey), xreadgroup(3valkey), xrevrange(3valkey), xsetid(3valkey), xtrim(3valkey)