Nodes

Docker disk usage (`docker system df`) for the control-plane host.

On-demand rather than sampled: walking every layer, rootfs and volume can take seconds, so the server monitoring page fetches it when opened or when the operator presses refresh. Node 0 only for now — a worker's daemon is only reachable through its agent, which does not relay this yet, and the error says exactly that instead of 404ing.

get/nodes/{node_id}/docker-disk-usage

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/nodes/{node_id}/docker-disk-usage
  • Auth: HTTP bearer

Path parameters

node_idinteger required

Node ID (0 = control plane)

Response

Docker disk usage by category

api_versionstring nullable

Docker API version the daemon answered with, when it reported one (Api-Version header). Useful when a category shows null reclaimable bytes.

collected_atstring required

When this snapshot was taken (ISO 8601, UTC).

total_bytesinteger required

Sum of the four category sizes.

Changes

No recorded changes to this operation across all 50 revisions of this API.