capacity_bytesinteger nullable
The volume's configured per-volume storage cap in bytes, or null when
no cap is set (#496). Derived from the stored capacity_gib (the user's
configured intent) — the effective ceiling is min(this, org cap).
created_atstring date-time required
kind'host' | 'managed' required
Volume role: the organization's shared host volume or a named managed volume.
labelsobject required
User-defined labels (empty object when none set).
namestring nullable
User-facing name. null for the host volume (it has no name; it's
identified by kind).
status'active' | 'deleting' required
Lifecycle status of a volume.
storage'block' required
How a volume is physically backed — distinct from [VolumeKind] (ownership).
Every volume is Block today; the enum exists so future backings can be added
(and reported to the SDK) without another schema change.
updated_atstring date-time required
used_bytesinteger nullable
Bytes currently used under this volume's subtree. null when usage is
unavailable — the usage service is disabled or unreachable (list degrades
gracefully rather than failing) — or on create/delete, which don't sample
it.