Nodes API

View information about the physical or virtual nodes in your Kubernetes cluster.

List Nodes

GET /api/v1/nodes
Response:
[
  {
    "name": "node-01",
    "status": "Ready",
    "roles": ["control-plane", "worker"],
    "version": "v1.28.4+k3s1",
    "os": "Ubuntu 22.04",
    "architecture": "amd64",
    "cpu_capacity": "8",
    "memory_capacity": "16Gi",
    "cpu_allocatable": "7800m",
    "memory_allocatable": "15Gi",
    "pods_running": 24,
    "pods_capacity": 110,
    "created_at": "2024-01-01T00:00:00Z"
  }
]

Node Status

StatusDescription
ReadyNode is healthy and accepting workloads
NotReadyNode is unhealthy or unreachable
SchedulingDisabledNode is cordoned (no new pods)