Check QEMU Guest Agent availability

Check if the QEMU Guest Agent is installed and running on your VPS. This is crucial for OS-level communication, enabling features like file system backups and proper shutdowns. The endpoint returns a unique 'requestId' for tracking.

Path Parameters

vmid integer · min: 1 required Example

Unique vmid identifier

Query Parameters

pid string required

Headers

Accept Example

Content-Type Example

Responses

200

success boolean

timestamp string

requestId string

data object

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}/agent/exec

For AI assistants

cURL

curl -X GET "https://cloud.hostup.se/api/vm/17356/agent/exec?pid=string" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "success": true,
    "pid": 0,
    "exited": true,
    "exitcode": 0,
    "stdout": "string",
    "stderr": "string"
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean"
        },
        "pid": {
          "type": "integer"
        },
        "exited": {
          "type": "boolean"
        },
        "exitcode": {
          "type": "integer"
        },
        "stdout": {
          "type": "string"
        },
        "stderr": {
          "type": "string"
        }
      }
    }
  }
}