GET /api/v1/nodes/storage
Returns storage-pool utilization for every node in the cluster, aggregated from each node’s k7-agent DaemonSet pod:
kata_thinpool— thekata-firecracker-devmapperLVM thin-pool (lvs: size, data%, metadata%).k7d_disks— the k7d disk pool, an XFS loopback mount at/var/lib/k7d/disks(df: size, used, available).
Behavior
- Pools that don’t exist on a node (e.g. a
kql-only node with no thin-pool) produce an error detail for that field. - A node whose
k7-agentpod is unreachable gets a loud{"error": ...}entry — nodes are never silently omitted. - The same data is available via
k7 nodes storage(--jsonfor the raw payload) andClient.nodes_storage()in the Python SDK.
