Back to Redis

CLUSTER SLAVES

content/commands/cluster-slaves.md

latest2.1 KB
Original Source

A note about the word slave used in this man page and command name: starting with Redis version 5, if not for backward compatibility, the Redis project no longer uses the word slave. Please use the new command [CLUSTER REPLICAS]({{< relref "/commands/cluster-replicas" >}}). The command CLUSTER SLAVES will continue to work for backward compatibility.

The command provides a list of replica nodes replicating from the specified master node. The list is provided in the same format used by [CLUSTER NODES]({{< relref "/commands/cluster-nodes" >}}) (please refer to its documentation for the specification of the format).

The command will fail if the specified node is not known or if it is not a master according to the node table of the node receiving the command.

Note that if a replica is added, moved, or removed from a given master node, and we ask CLUSTER SLAVES to a node that has not yet received the configuration update, it may show stale information. However eventually (in a matter of seconds if there are no network partitions) all the nodes will agree about the set of nodes associated with a given master.

Redis Software and Redis Cloud compatibility

| Redis Software | Redis Cloud | <span style="min-width: 9em; display: table-cell">Notes</span> | |:----------------------|:-----------------|:------| | <span title="Not supported">❌ Standard</span> <span title="Not supported"><nobr>❌ Active-Active</nobr></span> | <span title="Not supported">❌ Standard</span> <span title="Not supported"><nobr>❌ Active-Active</nobr></span> | Deprecated as of Redis v5.0.0. |

Return information

{{< multitabs id="cluster-slaves-return-info" tab1="RESP2" tab2="RESP3" >}}

Array reply: a list of replica nodes replicating from the specified master node provided in the same format used by CLUSTER NODES.

-tab-sep-

Array reply: a list of replica nodes replicating from the specified master node provided in the same format used by CLUSTER NODES.

{{< /multitabs >}}