{
  "id": "status",
  "title": "Node status requests",
  "url": "https://redis.io/docs/latest/operate/rs/7.8/references/rest-api/requests/nodes/status/",
  "summary": "Requests that return a node's hostname and role.",
  "content": "\n| Method | Path | Description |\n|--------|------|-------------|\n| [GET](#get-all-nodes-status) | `/v1/nodes/status` | Get the status of all nodes |\n| [GET](#get-node-status) | `/v1/nodes/{uid}/status` | Get a node's status |\n\n## Get all node statuses {#get-all-nodes-status}\n\n\tGET /v1/nodes/status\n\nGets the status of all nodes. Includes each node's hostname and role in the cluster:\n\n- Primary nodes return `\"role\": \"master\"`\n\n- Replica nodes return `\"role\": \"slave\"`\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_node_info]() |\n\n### Request {#get-all-request} \n\n#### Example HTTP request\n\n\tGET /v1/nodes/status\n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n### Response {#get-all-response} \n\nFor each node in the cluster, returns a JSON object that contains each node's hostname, role, and other status details.\n\nIf a maintenance snapshot exists due to an in-progress or improperly stopped [node maintenance]() process, the response includes a `maintenance_snapshot` field.\n\n#### Example JSON body\n\n```json\n{\n    \"1\": {\n        \"cores\": 8,\n        \"free_provisional_ram\": 0,\n        \"free_ram\": 3499368448,\n        \"hostname\": \"3d99db1fdf4b\",\n        \"maintenance_snapshot\": {\n            \"created_time\": \"2024-09-06 20:47:23\",\n            \"name\": \"maintenance_mode_2024-09-06_20-47-23\",\n            \"node_uid\": \"1\"\n        },\n        \"master_shards\": [],\n        \"node_overbooking_depth\": 0,\n        \"node_status\": \"active\",\n        \"role\": \"master\",\n        \"slave_shards\": [],\n        \"software_version\": \"7.4.6-22\",\n        \"software_version_sha\": \"6c37b1483b5fb6110c8055c1526aa58eec1d29d3519e92310859101419248831\",\n        \"total_memory\": 6219673600,\n        \"total_provisional_ram\": 0\n    },\n    \"2\": {\n        \"hostname\": \"fc7a3d332458\",\n        \"role\": \"slave\",\n        // additional fields\n    },\n    \"3\": {\n        \"hostname\": \"b87cc06c830f\",\n        \"role\": \"slave\",\n        // additional fields\n    }\n}\n```\n\n### Status codes {#get-all-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n\n\n## Get node status {#get-node-status}\n\n\tGET /v1/nodes/{int: uid}/status\n\nGets the status of a node. Includes the node's hostname and role in the cluster:\n\n- Primary nodes return `\"role\": \"master\"`\n\n- Replica nodes return `\"role\": \"slave\"`\n\n#### Required permissions\n\n| Permission name |\n|-----------------|\n| [view_node_info]() |\n\n### Request {#get-request} \n\n#### Example HTTP request\n\n\tGET /v1/nodes/1/status\n\n\n#### Request headers\n\n| Key | Value | Description |\n|-----|-------|-------------|\n| Host | cnm.cluster.fqdn | Domain name |\n| Accept | application/json | Accepted media type |\n\n\n#### URL parameters\n\n| Field | Type | Description |\n|-------|------|-------------|\n| uid | integer | The node's unique ID. |\n\n\n### Response {#get-response} \n\nReturns a JSON object that contains the node's hostname, role, and other status details.\n\nIf a maintenance snapshot exists due to an in-progress or improperly stopped [node maintenance]() process, the response includes a `maintenance_snapshot` field.\n\n#### Example JSON body\n\n```json\n{\n    \"cores\": 8,\n    \"free_provisional_ram\": 0,\n    \"free_ram\": 3504422912,\n    \"hostname\": \"3d99db1fdf4b\",\n    \"maintenance_snapshot\": {\n        \"created_time\": \"2024-09-06 20:47:23\",\n        \"name\": \"maintenance_mode_2024-09-06_20-47-23\",\n        \"node_uid\": \"1\"\n    },\n    \"master_shards\": [],\n    \"node_overbooking_depth\": 0,\n    \"node_status\": \"active\",\n    \"role\": \"master\",\n    \"slave_shards\": [],\n    \"software_version\": \"7.4.6-22\",\n    \"software_version_sha\": \"6c37b1483b5fb6110c8055c1526aa58eec1d29d3519e92310859101419248831\",\n    \"total_memory\": 6219673600,\n    \"total_provisional_ram\": 0\n}\n```\n\n### Status codes {#get-status-codes} \n\n| Code | Description |\n|------|-------------|\n| [200 OK](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1) | No error |\n| [404 Not Found](http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5) | Node UID does not exist |\n",
  "tags": ["docs","operate","rs"],
  "last_updated": "2026-04-01T08:10:08-05:00"
}