CLUSTER DELSLOTS slot [slot ...]
- Available since:
- Time complexity:
- O(N) where N is the total number of hash slot arguments
- ACL categories:
In Redis Cluster, each node keeps track of which master is serving a particular hash slot.
CLUSTER DELSLOTS command asks a particular Redis Cluster node to
forget which master is serving the hash slots specified as arguments.
In the context of a node that has received a
CLUSTER DELSLOTS command and
has consequently removed the associations for the passed hash slots,
we say those hash slots are unbound. Note that the existence of
unbound hash slots occurs naturally when a node has not been
configured to handle them (something that can be done with the
CLUSTER ADDSLOTS command) and if it has not received any information about
who owns those hash slots (something that it can learn from heartbeat
or update messages).
If a node with unbound hash slots receives a heartbeat packet from another node that claims to be the owner of some of those hash slots, the association is established instantly. Moreover, if a heartbeat or update message is received with a configuration epoch greater than the node's own, the association is re-established.
However, note that:
- The command only works if all the specified slots are already associated with some node.
- The command fails if the same slot is specified multiple times.
- As a side effect of the command execution, the node may go into down state because not all hash slots are covered.
The following command removes the association for slots 5000 and 5001 from the node receiving the command:
> CLUSTER DELSLOTS 5000 5001 OK
Usage in Redis Cluster
This command only works in cluster mode and may be useful for
debugging and in order to manually orchestrate a cluster configuration
when a new cluster is created. It is currently not used by
and mainly exists for API completeness.
Simple string reply:
OK if the command was successful. Otherwise
an error is returned.