Get performance metrics for a specific virtual server

Retrieve detailed performance data for a specific virtual server (VM). This is useful for monitoring resources like CPU, memory, disk, and network usage over time. The endpoint returns a unique ID (requestId) that can be used in other API calls to track specific operations.

Path Parameters

vmid integer · min: 1 required Example

Unique vmid identifier

Query Parameters

timeframe string required

Headers

Accept Example

Content-Type Example

Responses

200

success boolean

timestamp string

requestId string

data object

400

error string

message string

code string

timestamp string

requestId string

401

error string

message string

code string

timestamp string

requestId string

403

error string

message string

code string

timestamp string

requestId string

429

error string

message string

retryAfter string

requestId string

GET https://cloud.hostup.se/api/vm/{vmid}/metrics

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/vm/17127/metrics?timeframe=string" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "timestamps": [
      0
    ],
    "cpu": [
      0
    ],
    "memory": [
      0
    ],
    "diskread": [
      0
    ],
    "diskwrite": [
      0
    ],
    "netin": [
      0
    ],
    "netout": [
      0
    ]
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "timestamps": {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        "cpu": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "memory": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "diskread": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "diskwrite": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "netin": {
          "type": "array",
          "items": {
            "type": "number"
          }
        },
        "netout": {
          "type": "array",
          "items": {
            "type": "number"
          }
        }
      }
    }
  }
}