PG_AUTOCTL GET NODE CANDIDATE-PRIORITY(1)

✨ PG_AUTOCTL GET NODE CANDIDATE-PRIORITY ✨

okay bestie, welcome to the pg_auto_failover manual, this one's from pg_autoctl and it is genuinely so useful, i promise 💖

---

🌸 NAME 🌸

pg_autoctl get node candidate-priority — pg_autoctl get node candidate-priority

pg_autoctl get candidate-priority — bestie, this one grabs the candidate-priority property straight from the monitor ✨

---

🎀 SYNOPSIS 🎀

so basically, this command prints the pg_autoctl candidate priority for a given node:

usage: pg_autoctl get node candidate-priority  [ --pgdata ] [ --json ] [ --formation ] [ --name ]

--pgdata      path to data directory
--formation   pg_auto_failover formation
--name        pg_auto_failover node name
--json        output data in the JSON format

---

💅 DESCRIPTION 💅

ngl, the one thing to know here is: also go look at pg_autoctl show settings if you want the full list of replication settings 👑 like, that's where the whole menu lives.

---

✨ OPTIONS ✨

• --pgdata — this is where the Postgres node you're managing locally keeps its data. defaults to the environment variable PGDATA. and like, use --monitor if you wanna connect to a monitor from literally anywhere, instead of using the monitor URI that a local Postgres node managed with pg_autoctl would use 🦋
• --json — outputs the data in JSON format ✨
• --formation — shows replication settings for the given formation. defaults to default 🎀
• --name — shows replication settings for the given node, picked out by name 💖

---

🌈 EXAMPLES 🌈

first one, no json, just the number, slay:

$ pg_autoctl get node candidate-priority --name node1
50

and now with --json because we love structured data in this house:

$ pg_autoctl get node candidate-priority --name node1 --json
{
    "name": "node1",
    "candidate-priority": 50
}

---

👑 AUTHOR 👑

Microsoft

---

💜 COPYRIGHT 💜

Copyright (c) Microsoft Corporation. All rights reserved.

---

okay that's the whole page bestie, go forth and check those priorities 🫶

mwah 💋 this was pg_autoctl get node candidate-priority, version 2.2, dated Apr 07, 2025, part of the pg_auto_failover family — ily, bye!! 🌸✨💖