API-Dokumentation

SFTP umbenennen oder verschieben

Eine Datei oder ein Verzeichnis auf einem VPS umbenennen oder verschieben. Das Ziel darf nicht bereits existieren; vorhandene Dateien werden nicht überschrieben.

Erforderlicher Scope: vps:manage

Pfadparameter

Parameter Typ Beschreibung
id string Die VPS-ID

Header

Header Erforderlich Wert
Authorization Ja Bearer DEIN_API_SCHLÜSSEL
Content-Type Ja application/json

Anfragekörper

Feld Typ Erforderlich Beschreibung
from string Ja Absoluter Quellpfad
to string Ja Absoluter Zielpfad 
{
  "from": "/var/www/alt.html",
  "to":   "/var/www/neu.html"
}

Antwort

{
  "data": {
    "from": "/var/www/alt.html",
    "to":   "/var/www/neu.html",
    "renamed": true
  }
}

Antwortfelder

Feld Typ Beschreibung
from string Normalisierter Quellpfad
to string Normalisierter Zielpfad
renamed boolean Bei Erfolg immer true

Fehler

Status Code Beschreibung
400 INVALID_BODY Anfragekörper ist kein gültiges JSON
400 INVALID_FROM from ist kein absoluter Pfad
400 INVALID_TO to ist kein absoluter Pfad
400 RENAME_FAILED Allgemeiner Umbenennungsfehler
403 RENAME_FAILED Keine Berechtigung
404 NOT_FOUND VPS nicht gefunden, kein Zugriff oder Quellpfad existiert nicht
409 RENAME_FAILED Ziel existiert bereits
502 SSH_AUTH SSH-Authentifizierung fehlgeschlagen
502 SSH_CONN Verbindung zum VPS nicht möglich
504 SSH_TIMEOUT SSH-Befehl hat das Zeitlimit überschritten

Beispiel

curl -X POST "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/rename" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"from": "/var/www/alt.html", "to": "/var/www/neu.html"}'

MCP

Dieser Endpunkt ist noch nicht als MCP-Tool verfügbar. Den obigen REST-Endpunkt direkt nutzen.