Get host resource capacity and allocations
Returns current host resource capacity, allocation status, and per-instance breakdown. Resources include CPU, memory, disk, and network. Oversubscription ratios are applied to calculate effective limits.
get/resources
Response
Resource status
Example response
{
"cpu": {
"type": "cpu",
"capacity": 64,
"effective_limit": 128,
"allocated": 48,
"available": 80,
"oversub_ratio": 2,
"source": "detected"
},
"memory": {
"type": "cpu",
"capacity": 64,
"effective_limit": 128,
"allocated": 48,
"available": 80,
"oversub_ratio": 2,
"source": "detected"
},
"disk": {
"type": "cpu",
"capacity": 64,
"effective_limit": 128,
"allocated": 48,
"available": 80,
"oversub_ratio": 2,
"source": "detected"
},
"network": {
"type": "cpu",
"capacity": 64,
"effective_limit": 128,
"allocated": 48,
"available": 80,
"oversub_ratio": 2,
"source": "detected"
},
"disk_io": {
"type": "cpu",
"capacity": 64,
"effective_limit": 128,
"allocated": 48,
"available": 80,
"oversub_ratio": 2,
"source": "detected"
},
"disk_breakdown": {
"images_bytes": 214748364800,
"oci_cache_bytes": 53687091200,
"volumes_bytes": 107374182400,
"overlays_bytes": 227633306624
},
"gpu": {
"mode": "vgpu",
"total_slots": 64,
"used_slots": 5,
"profiles": [
{
"name": "L40S-1Q",
"framebuffer_mb": 1024,
"available": 59
}
],
"devices": [
{
"name": "NVIDIA L40S",
"available": true
}
]
},
"allocations": [
{
"instance_id": "abc123",
"instance_name": "my-vm",
"cpu": 4,
"memory_bytes": 8589934592,
"disk_bytes": 10737418240,
"network_download_bps": 125000000,
"network_upload_bps": 125000000,
"disk_io_bps": 104857600
}
]
}