VPS-API: Backups und Firewall
Backups auflisten, erstellen, wiederherstellen und löschen und die Firewall-Regeln deiner Server verwalten, über die Sitequest REST-API.
Backups auflisten, erstellen, wiederherstellen und löschen und die Firewall-Regeln deiner Server verwalten, über die Sitequest REST-API.
Gibt alle vorhandenen Sicherungen eines VPS zurück.
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": [
{
"backupId": "backup_abc123",
"os": "Ubuntu 22.04",
"description": "Tägliche Sicherung",
"label": "Vor Update",
"size": 5368709120,
"created": "2026-03-27T02:00:00Z",
"status": "finished"
}
]
}
| Feld | Typ | Beschreibung |
|---|---|---|
backupId |
string | Eindeutige Sicherungs-ID |
os |
string | Betriebssystem zum Zeitpunkt der Sicherung |
description |
string | Beschreibung der Sicherung |
label |
string | null | Benutzerdefinierte Bezeichnung, oder null wenn nicht gesetzt |
size |
integer | Größe der Sicherung in Bytes |
created |
string | ISO-8601-Erstellungszeitstempel |
status |
string | finished oder pending |
| Status | Code | Beschreibung |
|---|---|---|
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Daten sind auch über das list_backups MCP-Tool verfügbar.
Erstellt eine neue Sicherung des VPS. Der Sicherungsvorgang läuft asynchron.
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 | Beschreibung |
|---|---|---|
label |
string | Optionale Bezeichnung für die Sicherung (max. 100 Zeichen) |
{
"label": "Vor Update"
}
{
"data": {
"backupId": "backup_def456",
"label": "Vor Update",
"success": true
}
}
| Status | Code | Beschreibung |
|---|---|---|
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 409 | NO_SLOTS |
Keine Sicherungsplätze verfügbar |
| 502 | PROVIDER_ERROR |
Upstream-Anbieterfehler |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"label": "Vor Update"}'
Diese Aktion ist auch über das create_backup MCP-Tool verfügbar.
Stellt einen VPS aus einer bestimmten Sicherung wieder her. Dies überschreibt den aktuellen Zustand des VPS.
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
backupId |
string | Die Sicherungs-ID zur Wiederherstellung |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
Es ist kein Anfragekörper erforderlich.
{
"data": {
"backupId": "backup_abc123",
"success": true
}
}
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_BACKUP_ID |
Sicherungs-ID fehlt oder ist ungültig |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | PROVIDER_ERROR |
Upstream-Anbieterfehler |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups/backup_abc123" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Aktion ist auch über das restore_backup MCP-Tool verfügbar.
Löscht eine Sicherung dauerhaft.
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
backupId |
string | Die zu löschende Sicherungs-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": {
"backupId": "backup_abc123",
"success": true
}
}
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_BACKUP_ID |
Sicherungs-ID fehlt oder ist ungültig |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | PROVIDER_ERROR |
Upstream-Anbieterfehler |
curl -X DELETE "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/backups/backup_abc123" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Aktion ist auch über das delete_backup MCP-Tool verfügbar.
Gibt den aktuellen Firewall-Status und alle Regeln eines VPS zurück. Die Firewall-Verwaltung erfolgt über SSH (unterstützt ufw und firewalld).
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": {
"tool": "ufw",
"active": true,
"defaultIncoming": "deny",
"defaultOutgoing": "allow",
"rules": [
{
"port": "22",
"proto": "tcp",
"action": "allow",
"source": "any"
},
{
"port": "80",
"proto": "tcp",
"action": "allow",
"source": "any"
},
{
"port": "443",
"proto": "tcp",
"action": "allow",
"source": "any"
}
],
"readViaSSH": true
}
}
| Feld | Typ | Beschreibung |
|---|---|---|
tool |
string | Erkanntes Firewall-Tool (ufw, firewalld oder none) |
active |
boolean | Ob die Firewall derzeit aktiv ist |
defaultIncoming |
string | Standardrichtlinie für eingehenden Datenverkehr |
defaultOutgoing |
string | Standardrichtlinie für ausgehenden Datenverkehr |
rules |
array | Liste der Firewall-Regeln |
rules[].port |
string | Port oder Portbereich (z.B. 80, 8000:8100) |
rules[].proto |
string | Protokoll: tcp, udp oder both |
rules[].action |
string | allow oder deny |
rules[].source |
string | Quell-IP oder any |
readViaSSH |
boolean | Ob der Status per SSH gelesen wurde |
| Status | Code | Beschreibung |
|---|---|---|
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | FIREWALL_ERROR |
Firewall-Operation auf dem Server fehlgeschlagen |
curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Daten sind auch über das get_firewall MCP-Tool verfügbar.
Fügt eine neue Firewall-Regel zu einem VPS hinzu.
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 |
|---|---|---|---|
port |
string | Ja | Port oder Portbereich (z.B. 80, 8000:8100) |
proto |
string | Ja | Protokoll: tcp, udp oder both |
action |
string | Ja | allow oder deny |
source |
string | Nein | Quell-IP-Adresse (Standard: any) |
comment |
string | Nein | Optionaler Kommentar für die Regel |
{
"port": "8080",
"proto": "tcp",
"action": "allow",
"source": "any",
"comment": "Web-App"
}
{
"data": {
"port": "8080",
"proto": "tcp",
"action": "allow",
"source": "any",
"success": true
}
}
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_PORT |
Port muss ein nicht-leerer String sein |
| 400 | INVALID_PROTO |
Protokoll muss tcp, udp oder both sein |
| 400 | INVALID_ACTION |
Aktion muss allow oder deny sein |
| 400 | INVALID_BODY |
Der Anfragekörper ist kein gültiges JSON |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | FIREWALL_ERROR |
Firewall-Operation auf dem Server fehlgeschlagen |
curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"port": "8080", "proto": "tcp", "action": "allow"}'
Firewall-Verwaltung ist auch über das manage_firewall MCP-Tool verfügbar.
Entfernt eine Firewall-Regel von einem VPS.
Die ruleId hat das Format port-proto-action (z.B. 80-tcp-allow). Für Portbereiche das vollständige Format verwenden (z.B. 8000:8100-tcp-allow).
Erforderlicher Scope: vps:manage
| Parameter | Typ | Beschreibung |
|---|---|---|
id |
string | Die VPS-ID |
ruleId |
string | Regelbezeichner im Format port-proto-action |
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
source |
string | Nein | Quell-IP der Regel (Standard: any) |
| Header | Erforderlich | Wert |
|---|---|---|
Authorization |
Ja | Bearer DEIN_API_SCHLÜSSEL |
{
"data": {
"port": "8080",
"proto": "tcp",
"action": "allow",
"source": "any",
"success": true
}
}
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_RULE_ID |
Regel-ID-Format ist ungültig |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | FIREWALL_ERROR |
Firewall-Operation auf dem Server fehlgeschlagen |
curl -X DELETE "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall/8080-tcp-allow" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
Diese Aktion ist auch über das manage_firewall MCP-Tool verfügbar.
Aktiviere oder deaktiviere die Firewall eines VPS.
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 |
|---|---|---|---|
enabled |
boolean | Ja | true zum Aktivieren, false zum Deaktivieren |
{
"enabled": true
}
{
"data": {
"enabled": true,
"success": true
}
}
| Status | Code | Beschreibung |
|---|---|---|
| 400 | INVALID_BODY |
Der Anfragekörper ist kein gültiges JSON |
| 404 | NOT_FOUND |
VPS nicht gefunden oder kein Zugriff |
| 502 | FIREWALL_ERROR |
Firewall-Operation auf dem Server fehlgeschlagen |
curl -X PUT "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/firewall" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"enabled": true}'
Diese Aktion ist auch über das manage_firewall MCP-Tool verfügbar.