CLUSTER-REPLICAS(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

💖 CLUSTER-REPLICAS 💖

okay bestie, this is the valkey command manual, section 3valkey, and today's main character is cluster-replicas. it's giving "who's in whose group chat" energy. let's go 💅

✨ NAME ✨

cluster-replicas — lists the replica nodes of a primary node. yes, that's it, that's the whole job, and it does it flawlessly. 👑

🌸 SYNOPSIS 🌸

CLUSTER REPLICAS node-id

🦋 DESCRIPTION 🦋

so basically, this command hands you a list of all the replica nodes that are replicating from the primary node you specified. that's it. that's the tea. 🍵

the list comes back in the exact same format used by valkey-cluster-nodes(7)'s CLUSTER NODES — so if you need the full spec of that format, go read that page, because this one is not about to re-explain it, it's just borrowing the fit. ✨

now, the vibe check: the command will fail if the node you named is not known, OR if it's not a primary according to the node table of whatever node is receiving the command. so if you point it at a replica and ask "who are your replicas", bestie, that's not how this works 😭

⚠️ important lowkey warning: if a replica gets added, moved, or removed from a given primary node, and you ask CLUSTER REPLICAS on a node that hasn't received the configuration update yet, it may show you stale information. it's not lying to you, it just hasn't heard the news yet 🙈

but — and this is the slay part — 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 primary. so the drama always resolves. 🌈

📬 REPLY 📬

valkey-protocol(7) Array reply: a list of replica nodes replicating from the specified primary node, provided in the same format used by CLUSTER NODES. it's a little array of besties, essentially 🫶

🔥 COMPLEXITY 🔥

O(N) where N is the number of replicas. not bad, not bad at all 💅

🎀 ACL CATEGORIES 🎀

@admin @dangerous @slow

bestie these are the three little badges it wears. @admin means it's admin-tier, @dangerous means treat it with respect, @slow means don't spam it in a hot loop unless you want to be the problem 😭

⭐ HISTORY ⭐

  • Available since: 5.0.0

so it's been here since 5.0.0, a true veteran. iconic behavior 👑

👑 SEE ALSO 👑

okay that's the whole page, you ate that 🫶 this was valkey manual version 9.0.0, dated 2025-10-21, and you're officially a cluster-replicas understander now. periodt. 💜✨🎀

📦 where this page comes from