VPS abrufen

Gibt detaillierte Informationen über einen einzelnen VPS zurück, einschließlich Live-Status und Konfiguration vom Hosting-Provider.

Erforderlicher Scope: vps:read

Pfadparameter

Parameter	Typ	Beschreibung
`id`	string	Die VPS-ID

Header

Header	Erforderlich	Wert
`Authorization`	Ja	`Bearer DEIN_API_SCHLÜSSEL`

Antwort

{
  "data": {
    "id": "699cdea2ab57a244bb5273fd",
    "name": "mein-server",
    "status": "RUNNING",
    "cores": 4,
    "mem": 8,
    "nvme": 20,
    "hdd": 0,
    "ips": 1,
    "backupSlots": 0,
    "networkSpeed": 1000,
    "os": "Ubuntu 22.04",
    "iso": null,
    "datacenter": "SkyLink Data Center BV",
    "country": "NL",
    "cpuUsage": 1.02,
    "memUsage": 42.31,
    "nvmeUsage": 0.44,
    "hddUsage": 0,
    "availability": 100,
    "ipv4": [
      {
        "address": "45.84.196.79",
        "gateway": "45.84.196.1",
        "rdns": "mein-server.site.quest"
      }
    ],
    "ipv6": [],
    "config": { ... },
    "liveStatus": { ... },
    "subscription": {
      "cancelledAt": null,
      "expiresAt": null,
      "interval": "1 month"
    },
    "createdAt": "2026-02-23T23:11:30.525Z"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`id`	string	Eindeutige Server-ID
`name`	string	Anzeigename des Servers
`status`	string	Aktueller Status
`cores`	number	Anzahl der CPU-Kerne
`mem`	number	RAM in GB
`nvme`	number	NVMe-Speicher in GB
`hdd`	number	HDD-Speicher in GB
`ips`	number	Anzahl der IP-Adressen
`backupSlots`	number	Anzahl der Backup-Slots
`networkSpeed`	number	Netzwerkgeschwindigkeit in Mbit/s
`os`	string	Betriebssystem
`iso`	string \| null	Eingebundenes ISO-Image, falls vorhanden
`datacenter`	string	Rechenzentrum
`country`	string	Ländercode
`cpuUsage`	number	CPU-Auslastung in Prozent
`memUsage`	number	Speicherauslastung in Prozent
`nvmeUsage`	number	NVMe-Auslastung in Prozent
`hddUsage`	number	HDD-Auslastung in Prozent
`availability`	number	Verfügbarkeit in Prozent
`ipv4`	array	IPv4-Adressen mit Gateway und rDNS
`ipv6`	array	IPv6-Adressen
`config`	object \| null	Live-Konfiguration vom Hosting-Provider
`liveStatus`	object \| null	Live-Status vom Hosting-Provider
`subscription`	object \| null	Abonnement-Status (siehe unten)
`createdAt`	string	ISO-8601-Erstellungszeitstempel

Abonnement-Felder

Feld	Typ	Beschreibung
`cancelledAt`	string \| null	Wann das Abonnement gekündigt wurde (ISO 8601), oder `null` wenn aktiv
`expiresAt`	string \| null	Wann das Abonnement abläuft (ISO 8601), oder `null` wenn es verlängert wird
`interval`	string \| null	Abrechnungsintervall (z.B. `"1 month"`, `"12 months"`)

Sensible Felder wie password und username werden aus dem config-Objekt entfernt.

Fehler

Status	Code	Beschreibung
404	`NOT_FOUND`	VPS nicht gefunden oder kein Zugriff

Beispiel

curl https://hosting.site.quest/api/v1/vps/699cdea2ab57a244bb5273fd \
  -H "Authorization: Bearer sq_live_a94ecfca096d..."

MCP

Diese Daten sind auch über das get_vm MCP-Tool verfügbar.