VPS-API: Server erstellen und steuern
Server erstellen, upgraden, kündigen und neu installieren, ein- und ausschalten, ISOs einbinden und Monitoring abrufen, per REST-API.
Server erstellen, upgraden, kündigen und neu installieren, ein- und ausschalten, ISOs einbinden und Monitoring abrufen, per REST-API.
Gibt die VPS-Komponentenpreise gruppiert nach Hostsystem zurück. Verwende diese Daten, um die monatlichen Kosten einer VPS-Konfiguration vor der Bestellung zu berechnen. Preise werden standardmäßig als Bruttopreise in EUR zurückgegeben; verwende currency und display zur Anpassung.
Du kannst auch Ressourcenmengen direkt übergeben, um den Gesamtpreis für eine bestimmte Konfiguration berechnen zu lassen.
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
currency |
Nein | Preiswährung: EUR (Standard) oder USD |
display |
Nein | Preisanzeige: gross (Standard, Brutto) oder net (Netto, ohne MwSt.) |
hostsystem |
Nein | Hostsystem-Kennung für Preisberechnung (z.B. de_epyc). Erforderlich bei Angabe von Ressourcenmengen. |
core |
Nein | Anzahl CPU-Kerne |
mem |
Nein | RAM in GB |
nvme |
Nein | NVMe-Speicher in GB (Vielfaches von 10) |
ipv4 |
Nein | Anzahl IPv4-Adressen |
backup |
Nein | Anzahl Backup-Slots |
network |
Nein | Netzwerkgeschwindigkeit in Mbit/s (Vielfaches von 1000) |
hdd |
Nein | HDD-Speicher in GB (Vielfaches von 10) |
Wenn keine Ressourcenmengen angegeben werden, wird die vollständige Preistabelle zurückgegeben.
{
"data": {
"hostsystems": [
{
"hostsystem": "de_epyc",
"components": [
{ "component": "core", "price": 0.00, "step": 1, "min": 1, "max": 16, "unit": "core", "included": 0 },
{ "component": "mem", "price": 0.00, "step": 1, "min": 1, "max": 32, "unit": "GB", "included": 0 },
{ "component": "nvme", "price": 0.00, "step": 10, "min": 10, "max": 500, "unit": "GB", "included": 0 },
{ "component": "ipv4", "price": 0.00, "step": 1, "min": 1, "max": 8, "unit": "IP", "included": 0 },
{ "component": "backup", "price": 0.00, "step": 1, "min": 2, "max": 10, "unit": "slot", "included": 2 },
{ "component": "network", "price": 0.00, "step": 1000, "min": 1000, "max": 10000, "unit": "Mbit/s", "included": 1000 }
]
}
],
"yearlyDiscount": 10,
"currency": "EUR",
"display": "gross"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
hostsystems |
array | Liste der verfügbaren Hostsysteme mit Komponentenpreisen |
hostsystems[].hostsystem |
string | Hostsystem-Kennung (z.B. de_epyc) |
hostsystems[].components |
array | Komponentenpreise für dieses Hostsystem |
hostsystems[].components[].component |
string | Komponentenname: core, mem, nvme, ipv4, backup, network, hdd |
hostsystems[].components[].price |
number | Preis pro Schritt pro Monat in der angeforderten Währung und Anzeigemodus |
hostsystems[].components[].step |
number | Was ein Schritt darstellt (z.B. 1 bei mem = 1 GB) |
hostsystems[].components[].min |
number | Mindestwert für diese Komponente |
hostsystems[].components[].max |
number | Maximalwert für diese Komponente |
hostsystems[].components[].unit |
string | Lesbare Einheit (z.B. core, GB, IP) |
hostsystems[].components[].included |
number | Kostenlos enthaltene Menge (z.B. 2 bei Backup = 2 Slots gratis, 1000 bei Network = 1 Gbit/s gratis). 0 bedeutet kein Freitier. |
yearlyDiscount |
number | Rabattprozentsatz für jährliche Abrechnung (z.B. 10 = 10 % Rabatt) |
currency |
string | Währungscode (EUR oder USD) |
display |
string | Anzeigemodus (gross oder net) |
Wenn Ressourcenmengen zusammen mit einem hostsystem angegeben werden, berechnet die API den Gesamtpreis für die angegebene Konfiguration. Nur die von dir angegebenen Komponenten werden im Ergebnis aufgeführt.
GET /api/v1/vps/pricing?hostsystem=de_epyc&core=4&mem=8&nvme=50&backup=4
{
"data": {
"hostsystem": "de_epyc",
"components": [
{ "component": "core", "quantity": 4, "included": 0, "subtotal": 0.00 },
{ "component": "mem", "quantity": 8, "included": 0, "subtotal": 0.00 },
{ "component": "nvme", "quantity": 50, "included": 0, "subtotal": 0.00 },
{ "component": "backup", "quantity": 4, "included": 2, "subtotal": 0.00 }
],
"monthly": 0.00,
"yearly": 0.00,
"yearlyDiscount": 10,
"currency": "EUR",
"display": "gross"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
hostsystem |
string | Das für die Berechnung verwendete Hostsystem |
components |
array | Aufschlüsselung pro angeforderter Komponente |
components[].component |
string | Komponentenname |
components[].quantity |
number | Angeforderte Menge |
components[].included |
number | Kostenlose Menge (wird vor der Berechnung abgezogen) |
components[].subtotal |
number | Monatliche Kosten für diese Komponente nach Abzug der Freimenge |
monthly |
number | Monatliche Gesamtkosten |
yearly |
number | Jährliche Gesamtkosten (monatlich x 12 mit Jahresrabatt) |
yearlyDiscount |
number | Angewandter Rabattprozentsatz für jährliche Abrechnung |
currency |
string | Währungscode (EUR oder USD) |
display |
string | Anzeigemodus (gross oder net) |
Um den monatlichen Preis für eine VPS-Konfiguration zu berechnen, multipliziere den Komponentenpreis mit der Anzahl der Schritte. Ziehe die included-Freimenge vor der Berechnung ab:
monatliche_kosten = SUMME(component.price * MAX(0, menge / component.step - component.included / component.step))
Beispiel: 4 Kerne zu 0,00 EUR/Kern + 8 GB RAM zu 0,00 EUR/GB + 4 Backup-Slots (2 inklusive) zu 0,00 EUR/Slot:
4 * 0,00 + 8 * 0,00 + (4 - 2) * 0,00 = 0,00 + 0,00 + 0,00 = 0,00 EUR/Monat
Für jährliche Abrechnung den Rabatt anwenden:
jaehrliche_kosten = monatliche_kosten * 12 * (1 - yearlyDiscount / 100)
# Vollständige Preistabelle abrufen
curl https://site.quest/api/v1/vps/pricing \
-H "Authorization: Bearer sq_live_a94ecfca096d..."
# Nettopreise in USD abrufen
curl "https://site.quest/api/v1/vps/pricing?currency=USD&display=net" \
-H "Authorization: Bearer sq_live_a94ecfca096d..."
# Preis für eine bestimmte Konfiguration berechnen
curl "https://site.quest/api/v1/vps/pricing?hostsystem=de_epyc&core=4&mem=8&nvme=50&backup=4" \
-H "Authorization: Bearer sq_live_a94ecfca096d..."
Diese Daten sind auch über das MCP-Tool get_vps_pricing verfügbar.
Erstelle eine neue VPS-Instanz. Dieser Endpunkt erstellt eine Bestellung, belastet deine gespeicherte Zahlungsmethode und stellt den Server bereit. Verwende den Bestellstatus-Endpunkt, um den Fortschritt zu verfolgen.
Erforderlicher Scope: vps:provision
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Content-Type |
Ja | application/json |
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
hostsystem |
Ja | Hostsystem-Kennung (z.B. de_epyc, de_ryzen) |
os |
Ja | Betriebssystem-Kennung (z.B. ubuntu-24.04) |
cores |
Ja | Anzahl der CPU-Kerne (>= 1) |
mem |
Ja | RAM in GB (z.B. 8) |
disk |
Ja | NVMe-Speicher in GB (z.B. 20) |
ips |
Nein | Anzahl der IPv4-Adressen (Standard: 1) |
backupSlots |
Nein | Anzahl der Backup-Slots (Standard: 2) |
networkSpeed |
Nein | Netzwerkgeschwindigkeit in Mbit/s (Standard: 1000) |
storage |
Nein | Zusätzlicher HDD-Speicher in GB |
name |
Nein | Anzeigename für den VPS |
{
"data": {
"orderId": "507f1f77bcf86cd799439011",
"orderToken": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"hostsystem": "de_epyc",
"os": "ubuntu-24.04",
"cores": 4,
"mem": 8,
"disk": 80,
"status": "completed",
"paymentId": "tr_abc123"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
orderId |
string | Bestell-ID zur Nachverfolgung |
orderToken |
string | Bestell-Token (UUID) zur Nachverfolgung |
hostsystem |
string | Das verwendete Hostsystem |
os |
string | Das zu installierende Betriebssystem |
cores |
number | Bereitgestellte CPU-Kerne |
mem |
number | RAM in GB |
disk |
number | NVMe-Speicher in GB |
status |
string | completed, payment_pending oder payment_failed |
paymentId |
string | Mollie-Zahlungs-ID |
| Status | Beschreibung |
|---|---|
completed |
Zahlung erfolgreich, VPS wird bereitgestellt |
payment_pending |
Zahlung eingeleitet (z.B. SEPA-Lastschrift), warte auf Bestätigung |
payment_failed |
Zahlung wurde abgelehnt oder ist fehlgeschlagen |
Stelle vor der Nutzung dieses Endpunkts sicher, dass:
Verwende den VPS-Preise-Endpunkt, um verfügbare Hostsysteme, Betriebssysteme und Komponentenpreise vor der Erstellung eines VPS zu prüfen.
| Status | Code | Beschreibung |
|---|---|---|
| 400 | MISSING_HOSTSYSTEM |
Das Feld hostsystem ist erforderlich |
| 400 | MISSING_OS |
Das Feld os ist erforderlich |
| 400 | INVALID_CORES |
Das Feld cores muss >= 1 sein |
| 400 | INVALID_MEM |
Das Feld mem muss >= 1 sein |
| 400 | INVALID_DISK |
Das Feld disk muss >= 1 sein |
| 400 | PRICING_UNAVAILABLE |
Preis für VPS-Bestellung konnte nicht berechnet werden |
| 403 | account_suspended |
Konto ist gesperrt |
| 403 | no_valid_mandate |
Keine gültige Zahlungsmethode hinterlegt |
| 403 | no_billing_address |
Rechnungsadresse fehlt |
| 403 | INSUFFICIENT_SCOPE |
API-Schlüssel hat nicht den erforderlichen vps:provision-Scope |
| 409 | DUPLICATE_ORDER |
Eine identische Bestellung ist bereits ausstehend |
# Einfachen VPS erstellen
curl -X POST https://site.quest/api/v1/vps/create \
-H "Authorization: Bearer sq_live_a94ecfca096d..." \
-H "Content-Type: application/json" \
-d '{
"hostsystem": "de_epyc",
"os": "ubuntu-24.04",
"cores": 4,
"mem": 8,
"disk": 80
}'
# VPS mit allen Optionen erstellen
curl -X POST https://site.quest/api/v1/vps/create \
-H "Authorization: Bearer sq_live_a94ecfca096d..." \
-H "Content-Type: application/json" \
-d '{
"hostsystem": "de_epyc",
"os": "ubuntu-24.04",
"cores": 8,
"mem": 16,
"disk": 160,
"ips": 2,
"backupSlots": 4,
"networkSpeed": 2000,
"name": "Produktions-Server"
}'
Diese Aktion ist auch über das create_vm MCP-Tool verfügbar.
Gibt alle VPS zurück, auf die der authentifizierte API-Schlüssel Zugriff hat.
Erforderlicher Scope: vps:read
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": [
{
"id": "699cdea2ab57a244bb5273fd",
"name": "mein-server",
"status": "RUNNING",
"cores": 4,
"mem": 8,
"nvme": 20,
"hdd": 0,
"os": "Ubuntu 22.04",
"datacenter": "SkyLink Data Center BV",
"country": "NL",
"ip": "45.84.196.79",
"cpuUsage": 1.02,
"memUsage": 42.31,
"nvmeUsage": 0.44,
"hddUsage": 0,
"availability": 100,
"subscription": {
"cancelledAt": null,
"expiresAt": null,
"interval": "1 month"
},
"createdAt": "2026-02-23T23:11:30.525Z"
}
]
}
| Feld | Typ | Beschreibung |
|---|---|---|
id |
string | Eindeutige Server-ID |
name |
string | Anzeigename des Servers |
status |
string | Aktueller Status: RUNNING, STOPPED, INSTALLING usw. |
cores |
number | Anzahl der CPU-Kerne |
mem |
number | RAM in GB |
nvme |
number | NVMe-Speicher in GB |
hdd |
number | HDD-Speicher in GB |
os |
string | Betriebssystem |
datacenter |
string | Rechenzentrum |
country |
string | Ländercode (ISO 3166-1 alpha-2) |
ip |
string | null | Primäre IPv4-Adresse |
cpuUsage |
number | CPU-Auslastung in Prozent (0–100) |
memUsage |
number | Speicherauslastung in Prozent (0–100) |
nvmeUsage |
number | NVMe-Auslastung in Prozent (0–100) |
hddUsage |
number | HDD-Auslastung in Prozent (0–100) |
availability |
number | Verfügbarkeit in Prozent (0–100) |
subscription |
object | null | Abonnement-Status: cancelledAt, expiresAt, interval |
createdAt |
string | ISO-8601-Erstellungszeitstempel |
curl https://site.quest/api/v1/vps \
-H "Authorization: Bearer sq_live_a94ecfca096d..."
Diese Daten sind auch über das list_vms MCP-Tool verfügbar.
Gibt detaillierte Informationen über einen einzelnen VPS zurück, einschließlich Live-Status und Konfiguration vom Hosting-Provider.
Erforderlicher Scope: vps:read
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"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"
}
}
| 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 |
| 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.
| Status | Code | Beschreibung |
|---|---|---|
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
curl https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd \
-H "Authorization: Bearer sq_live_a94ecfca096d..."
Diese Daten sind auch über das get_vm MCP-Tool verfügbar.
Upgrade VPS-Ressourcen wie CPU-Kerne, RAM, Speicher, Backup-Slots und Netzwerkgeschwindigkeit. Nur Upgrades sind erlaubt — alle Werte müssen größer oder gleich der aktuellen Konfiguration sein.
Das Upgrade wird sofort über eine anteilige Einmalzahlung abgerechnet, basierend auf den verbleibenden Tagen im aktuellen Abrechnungszeitraum. Deine gespeicherte Zahlungsmethode (Mandat) wird automatisch belastet. Infrastrukturänderungen werden asynchron nach der Zahlungsbestätigung angewendet, was in der Regel einige Sekunden dauert.
Dein wiederkehrender Abonnementbetrag wird nach dem Upgrade auf den neuen monatlichen Preis aktualisiert.
Erforderlicher Scope: vps:scale
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Content-Type |
Ja | application/json |
Alle Felder sind optional. Gib nur die Werte an, die du ändern möchtest. Nicht angegebene Felder behalten ihre aktuellen Werte.
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
cores |
Nein | Neue Anzahl CPU-Kerne (muss >= aktuell sein) |
mem |
Nein | Neuer RAM in GB (muss >= aktuell sein) |
disk |
Nein | Neuer NVMe-Speicher in GB (muss >= aktuell sein) |
storage |
Nein | Neuer HDD-Speicher in GB (muss >= aktuell sein) |
backupSlots |
Nein | Neue Anzahl Backup-Slots (muss >= aktuell sein) |
networkSpeed |
Nein | Neue Netzwerkgeschwindigkeit in Mbit/s (muss >= aktuell sein) |
{
"data": {
"id": "507f1f77bcf86cd799439011",
"name": "Produktions-Server",
"orderId": "609c1f77bcf86cd799439022",
"paymentId": "tr_AbCdEf1234",
"status": "payment_pending",
"immediateCost": 4.52,
"newMonthlyAmount": 29.99,
"requested": {
"cores": 8,
"mem": 16,
"disk": 160,
"storage": 500,
"backupSlots": 4,
"networkSpeed": 2000
}
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
name |
string | Der VPS-Anzeigename |
orderId |
string | Die Upgrade-Bestell-ID zur Nachverfolgung |
paymentId |
string | Die Mollie-Zahlungs-ID |
status |
string | "payment_pending" (Mandatsbelastung eingeleitet) oder "completed" |
immediateCost |
number | Anteilige Einmalbelastung in EUR für den verbleibenden Abrechnungszeitraum |
newMonthlyAmount |
number | Aktualisierter monatlicher Abonnementpreis in EUR nach dem Upgrade |
requested |
object | Die angeforderte neue Ressourcenkonfiguration |
requested.cores |
number | Angeforderte Anzahl CPU-Kerne |
requested.mem |
number | Angeforderter RAM in GB |
requested.disk |
number | Angeforderter NVMe-Speicher in GB |
requested.storage |
number | Angeforderter HDD-Speicher in GB |
requested.backupSlots |
number | Angeforderte Anzahl Backup-Slots |
requested.networkSpeed |
number | Angeforderte Netzwerkgeschwindigkeit in Mbit/s |
Die Upgrade-Kosten werden wie folgt berechnet:
(neuerMonatspreis - aktuellerMonatspreis) / Gesamttage * verbleibendeTageInfrastrukturänderungen (CPU, RAM, Speicher usw.) werden automatisch nach Zahlungsbestätigung angewendet.
| Status | Code | Beschreibung |
|---|---|---|
| 400 | DOWNGRADE_NOT_ALLOWED |
Ein oder mehrere Werte sind kleiner als die aktuelle Konfiguration |
| 400 | NO_CHANGES |
Keine Änderungen erkannt |
| 400 | NO_MANDATE |
Keine gültige Zahlungsmethode hinterlegt |
| 400 | NO_SUBSCRIPTION |
Kein aktives Abonnement für dieses VPS gefunden |
| 400 | NO_BILLING_DIFFERENCE |
Keine Preisdifferenz für dieses Upgrade |
| 403 | INSUFFICIENT_SCOPE |
API-Schlüssel hat nicht den erforderlichen vps:scale-Scope |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Eigentümerzugriff |
| 409 | DUPLICATE_UPGRADE |
Eine Upgrade-Bestellung ist bereits ausstehend für dieses VPS |
| 500 | PAYMENT_NOT_CONFIGURED |
Zahlungsdienst nicht konfiguriert |
| 502 | PAYMENT_FAILED |
Zahlung konnte nicht erstellt werden |
| 502 | SUBSCRIPTION_FETCH_FAILED |
Abonnementdetails konnten nicht abgerufen werden |
# CPU und RAM upgraden
curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/upgrade \
-H "Authorization: Bearer sq_live_a94ecfca096d..." \
-H "Content-Type: application/json" \
-d '{"cores": 8, "mem": 16}'
# Speicher und Netzwerkgeschwindigkeit upgraden
curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/upgrade \
-H "Authorization: Bearer sq_live_a94ecfca096d..." \
-H "Content-Type: application/json" \
-d '{"disk": 320, "networkSpeed": 2000}'
Diese Aktion ist auch über das upgrade_vm MCP-Tool verfügbar. Bei der Verwendung von MCP folgt das Upgrade dem gleichen Abrechnungsablauf — deine gespeicherte Zahlungsmethode wird mit dem anteiligen Betrag belastet und Infrastrukturänderungen werden nach Zahlungsbestätigung angewendet.
Führe eine Poweraktion auf einem VPS aus: starten, stoppen oder neustarten.
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Content-Type |
Ja | application/json |
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
action |
string | Ja | Entweder start, stop oder restart |
{
"action": "restart"
}
{
"data": {
"action": "restart",
"success": true
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
action |
string | Die ausgeführte Poweraktion |
success |
boolean | Ob die Aktion akzeptiert wurde |
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_ACTION |
Der action-Wert ist nicht start, stop oder restart |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | PROVIDER_ERROR |
Upstream-Anbieterfehler |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/power" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"action": "restart"}'
Diese Aktion ist auch über das vm_power MCP-Tool verfügbar.
Installiere das Betriebssystem eines VPS neu. Dies ist eine destruktive Aktion — alle Daten auf dem Server werden gelöscht.
Erforderlicher Scope: vps:provision
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Content-Type |
Ja | application/json |
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
os |
string | Ja | Die Betriebssystem-Kennung (z.B. ubuntu-24.04) |
{
"os": "ubuntu-24.04"
}
{
"data": {
"os": "ubuntu-24.04",
"success": true
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
os |
string | Das zu installierende Betriebssystem |
success |
boolean | Ob die Neuinstallation gestartet wurde |
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_OS |
Das os-Feld fehlt oder ist kein String |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | PROVIDER_ERROR |
Upstream-Anbieterfehler |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/os" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"os": "ubuntu-24.04"}'
Diese Aktion ist auch über das vm_reinstall_os MCP-Tool verfügbar.
ISO-Image auf einem VPS einbinden oder aushängen. Das Einbinden eines ISO ermöglicht das Booten von einem benutzerdefinierten Installationsimage.
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Content-Type |
Ja | application/json |
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
os |
string | null | Ja | ISO-Kennung zum Einbinden oder null zum Aushängen |
ISO einbinden:
{
"os": "ubuntu-24.04-live"
}
Aktuelles ISO aushängen:
{
"os": null
}
Einbinden-Antwort:
{
"data": {
"mounted": true,
"os": "ubuntu-24.04-live",
"success": true
}
}
Aushängen-Antwort:
{
"data": {
"mounted": false,
"success": true
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
mounted |
boolean | Ob ein ISO jetzt eingebunden ist |
os |
string | Die eingebundene ISO-Kennung (nur beim Einbinden vorhanden) |
success |
boolean | Ob die Aktion akzeptiert wurde |
| Status | Code | Beschreibung |
|---|---|---|
| 400 | MISSING_FIELD |
Das os-Feld ist nicht im Anfragekörper vorhanden |
| 400 | INVALID_OS |
Der os-Wert ist weder ein String noch null |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | PROVIDER_ERROR |
Upstream-Anbieterfehler |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/iso" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"os": "ubuntu-24.04-live"}'
Diese Aktion ist auch über das vm_mount_iso MCP-Tool verfügbar.
Generiere ein neues Root-Passwort für einen VPS. Das neue Passwort wird in der Antwort zurückgegeben und sollte sicher gespeichert werden.
Erforderlicher Scope: vps:exec
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Es ist kein Anfragekörper erforderlich.
{
"data": {
"password": "aB3$kLm9pQr2"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
password |
string | Das neu generierte Root-Passwort |
| Status | Code | Beschreibung |
|---|---|---|
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | PROVIDER_ERROR |
Upstream-Anbieterfehler |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/reset-password" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Aktion ist auch über das vm_reset_password MCP-Tool verfügbar.
Aktualisiere den Anzeigenamen eines VPS. Dies ist ein lokaler Vorgang und hat keine Auswirkung auf den Hosting-Anbieter.
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Content-Type |
Ja | application/json |
| Feld | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name |
string | Ja | Neuer Anzeigename (1–32 Zeichen) |
{
"name": "Produktionsserver"
}
{
"data": {
"name": "Produktionsserver",
"success": true
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
name |
string | Der neue Anzeigename |
success |
boolean | Ob die Umbenennung erfolgreich war |
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_NAME |
Der Name muss 1–32 Zeichen lang sein |
| 400 | INVALID_BODY |
Der Anfragekörper ist kein gültiges JSON |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/rename" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"name": "Produktionsserver"}'
Diese Aktion ist auch über das rename_vm MCP-Tool verfügbar.
Gibt CPU-, Arbeitsspeicher- und Ping-Verlaufsdaten eines VPS zuruck, zusammen mit Ausfall-Statistiken.
Das Monitoring muss auf dem Server aktiviert sein, damit Messdaten erfasst werden.
Erforderlicher Scope: vps:read
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": {
"timings": [
{
"date": "2026-03-27T12:00:00Z",
"cpu": 12.5,
"mem": 42.3,
"ping": 1.2
},
{
"date": "2026-03-27T12:05:00Z",
"cpu": 8.1,
"mem": 41.8,
"ping": 1.1
}
],
"incidents": {
"statistic": {
"LAST_24_HOURS": {
"downtime": 0,
"availability": 100,
"incidents": 0,
"longestIncident": 0,
"averageIncident": 0
},
"LAST_7_DAYS": {
"downtime": 120,
"availability": 99.98,
"incidents": 1,
"longestIncident": 120,
"averageIncident": 120
}
},
"incidents": [
{
"start": "2026-03-22T03:15:00Z",
"end": "2026-03-22T03:17:00Z",
"downtime": 120,
"type": "PING_TIMEOUT"
}
]
}
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
date |
string | ISO-8601-Zeitstempel |
cpu |
number | CPU-Auslastung in Prozent (0–100) |
mem |
number | Arbeitsspeicher-Auslastung in Prozent (0–100) |
ping |
number | Ping-Latenz in Millisekunden |
Statistiken werden für mehrere Zeiträume bereitgestellt: LAST_24_HOURS, LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS, LAST_180_DAYS.
| Feld | Typ | Beschreibung |
|---|---|---|
downtime |
number | Gesamte Ausfallzeit in Sekunden |
availability |
number | Verfügbarkeit in Prozent (0–100) |
incidents |
number | Anzahl der Ausfälle |
longestIncident |
number | Längster Ausfall in Sekunden |
averageIncident |
number | Durchschnittliche Ausfalldauer in Sekunden |
| Feld | Typ | Beschreibung |
|---|---|---|
start |
string | ISO-8601-Startzeit |
end |
string | null | ISO-8601-Endzeit (null wenn noch andauernd) |
downtime |
number | Dauer in Sekunden |
type |
string | PING_TIMEOUT oder VM_STOPPED |
curl -X GET "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/monitoring" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Daten sind auch über das MCP-Tool get_vm_monitoring verfügbar.
Gibt die Bandbreitennutzung des aktuellen Monats und ein tägliches Traffic-Protokoll eines VPS zurück.
Erforderlicher Scope: vps:read
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": {
"usage": {
"month": "2026-03",
"usage": {
"total": 52428800,
"in": 31457280,
"out": 20971520
},
"limit": {
"monthly": 10737418240,
"additional": null,
"remaining": 10684989440,
"vmStatus": "normal"
}
},
"log": {
"month": "2026-03",
"log": [
{
"date": "2026-03-25",
"in": 10485760,
"out": 7340032
},
{
"date": "2026-03-26",
"in": 12582912,
"out": 8388608
},
{
"date": "2026-03-27",
"in": 8388608,
"out": 5242880
}
]
}
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
month |
string | Monat im Format YYYY-MM |
usage.total |
number | Gesamte übertragene Bytes in diesem Monat |
usage.in |
number | Eingehende Bytes |
usage.out |
number | Ausgehende Bytes |
| Feld | Typ | Beschreibung |
|---|---|---|
monthly |
number | Monatliches Bandbreitenlimit in Bytes |
additional |
number | null | Zusätzlich erworbene Bandbreite in Bytes |
remaining |
number | Verbleibende Bandbreite in Bytes |
vmStatus |
string | normal oder throttled |
| Feld | Typ | Beschreibung |
|---|---|---|
date |
string | Datum im Format YYYY-MM-DD |
in |
number | Eingehende Bytes pro Tag |
out |
number | Ausgehende Bytes pro Tag |
curl -X GET "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/traffic" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Daten sind auch über das MCP-Tool get_vm_traffic verfügbar.
Kündige ein VPS-Abonnement zum Ende der aktuellen Abrechnungsperiode. Der VPS läuft bis zum Ablaufdatum weiter. Dies ersetzt das alte sofortige Löschen durch ein Kündigungsmodell mit Fristablauf.
Erforderlicher Scope: vps:cancel
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": {
"id": "507f1f77bcf86cd799439011",
"name": "Produktions-Server",
"cancelled": true,
"expiresAt": "2026-04-15T00:00:00.000Z"
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
name |
string | Der VPS-Anzeigename |
cancelled |
boolean | Immer true nach erfolgreicher Kündigung |
expiresAt |
string | ISO 8601 Datum, an dem der VPS abläuft |
| Status | Code | Beschreibung |
|---|---|---|
| 400 | NO_SUBSCRIPTION |
Kein aktives Abonnement für diesen VPS gefunden |
| 400 | CANCEL_FAILED |
Kündigung des Abonnements fehlgeschlagen |
| 403 | INSUFFICIENT_SCOPE |
API-Schlüssel hat nicht den erforderlichen vps:cancel-Scope |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Eigentümerzugriff |
curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/cancel \
-H "Authorization: Bearer sq_live_a94ecfca096d..."
Um einen gekündigten VPS vor dem Ablaufdatum zu reaktivieren, verwende den VPS reaktivieren Endpunkt.
Diese Aktion ist auch über das cancel_vm MCP-Tool verfügbar.
Reaktiviere ein gekündigtes VPS-Abonnement vor dem Ablaufdatum. Dies erstellt ein neues wiederkehrendes Abonnement und hebt die Kündigung auf, sodass der VPS normal weiter verlängert wird.
Erforderlicher Scope: vps:cancel
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": {
"id": "507f1f77bcf86cd799439011",
"name": "Produktions-Server",
"reactivated": true
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
name |
string | Der VPS-Anzeigename |
reactivated |
boolean | Immer true nach erfolgreicher Reaktivierung |
| Status | Code | Beschreibung |
|---|---|---|
| 400 | NOT_CANCELLED |
Kein gekündigtes Abonnement für diesen VPS gefunden |
| 400 | UNCANCEL_FAILED |
Reaktivierung des Abonnements fehlgeschlagen |
| 403 | INSUFFICIENT_SCOPE |
API-Schlüssel hat nicht den erforderlichen vps:cancel-Scope |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Eigentümerzugriff |
curl -X POST https://site.quest/api/v1/vps/507f1f77bcf86cd799439011/uncancel \
-H "Authorization: Bearer sq_live_a94ecfca096d..."
Diese Aktion ist auch über das uncancel_vm MCP-Tool verfügbar.