Virtual machines

Get VM metrics

GET
/cloud/project/{project_uuid}/vm/{vmid}/rrd/

Returns CPU, RAM, network, and disk load history for the period. Each sample is the peak of its interval; lists are empty while the VM has no data.

Authorization

bearerAuth
AuthorizationBearer <token>

API key created in the portal (Settings → API Keys). Send as Authorization: Bearer <key>.

In: header

Path Parameters

project_uuid*string

Project UUID.

vmid*integer

VM identifier (VMID).

Query Parameters

timeframe?string

Period. Defaults to hour.

Value in

  • "day"
  • "hour"
  • "month"
  • "week"
  • "year"

Response Body

application/json

curl -X GET "https://example.com/cloud/project/string/vm/0/rrd/"
{  "cpu_history": [    {      "timestamp": 0,      "value": 0.1    }  ],  "mem_history": [    {      "timestamp": 0,      "used": 0,      "total": 0,      "percentage": 0.1    }  ],  "network_history": [    {      "timestamp": 0,      "in": 0,      "out": 0    }  ],  "disk_history": [    {      "timestamp": 0,      "read": 0,      "write": 0    }  ]}