Get host resource capacity and allocations

Changed on

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

Request

  • Base URL
    http://localhost:4973
  • URL
    http://localhost:4973/resources
  • Auth
    HTTP bearer

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,
    "allocatable_slots": 57,
    "quarantined_slots": 2,
    "placement_disabled_reason": "VF health state unavailable: unmarshal VF health state: invalid character 'x'",
    "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
    }
  ]
}

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status