Storage Distribution
See how much data each node in the cluster is holding.
| Endpoint | Method | Admin Required |
|---|---|---|
/api/v1/admin/cluster/storage | GET | Yes |
Returns how many bytes and objects each active node owns, across every bucket. Each object counts toward exactly one node - its primary (top-ranked) replica - so summing every entry's sizeBytes gives the true cluster-wide total, not an inflated one multiplied by the replication factor.
This walks every bucket on every node to compute - it's noticeably more expensive than List Nodes or Rebalance Status. The console fetches it once on page load and otherwise only on manual refresh, never on its regular health poll - do the same in your own tooling.
A node that's unreachable when this is computed is simply omitted from the result rather than failing the whole request.
Response
[
{
"nodeId": "B1C2D3E4-F5G6-7890-HIJK-LM1234567890",
"sizeBytes": 15728640,
"objectCount": 42
},
{
"nodeId": "C2D3E4F5-G6H7-8901-IJKL-MN2345678901",
"sizeBytes": 20971520,
"objectCount": 51
}
]
Response Fields
nodeId
string
The node's id, matching List Nodes.
sizeBytes
integer
Total bytes owned by this node as primary replica, across every bucket.
objectCount
integer
Total object/version count owned by this node as primary replica, across every bucket.