SFTP Berechtigungen ändern

Unix-Berechtigungen einer Datei oder eines Verzeichnisses auf einem VPS ändern. Der Modus kann als oktaler String (z. B. "0755", "644") oder als Dezimalzahl im Bereich 0–4095 angegeben werden.

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
`path`	string	Ja	Absoluter Pfad der Datei oder des Verzeichnisses
`mode`	string \| number	Ja	Oktaler String (`"0755"`, `"644"`) oder Dezimalzahl (`0`–`4095`)

{
  "path": "/var/www/html/script.sh",
  "mode": "0755"
}

Antwort

{
  "data": {
    "path": "/var/www/html/script.sh",
    "mode": "0755"
  }
}

Antwortfelder

Feld	Typ	Beschreibung
`path`	string	Normalisierter absoluter Pfad
`mode`	string	Angewendeter Berechtigungsmodus als 3- oder 4-stelliger oktaler String

Fehler

Status	Code	Beschreibung
400	`INVALID_BODY`	Anfragekörper ist kein gültiges JSON
400	`INVALID_PATH`	Pfad ist nicht absolut
400	`INVALID_MODE`	Modus ist kein oktaler String oder gültige Dezimalzahl (`0`–`4095`)
400	`CHMOD_FAILED`	Allgemeiner chmod-Fehler
403	`CHMOD_FAILED`	Keine Berechtigung
404	`CHMOD_FAILED`	Zielpfad existiert nicht
404	`NOT_FOUND`	VPS nicht gefunden oder kein Zugriff
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/chmod" \
  -H "Authorization: Bearer DEIN_API_SCHLÜSSEL" \
  -H "Content-Type: application/json" \
  -d '{"path": "/var/www/html/script.sh", "mode": "0755"}'

MCP

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