SFTP-Verzeichnis auflisten
Verzeichnisinhalte auf einem VPS auflisten. Gibt Dateinamen, Typen, Größen und Änderungszeiten zurück.
Erforderlicher Scope: vps:files
Pfadparameter
| Parameter |
Typ |
Beschreibung |
id |
string |
Die VPS-ID |
Abfrageparameter
| Parameter |
Typ |
Erforderlich |
Beschreibung |
path |
string |
Ja |
Absoluter Pfad des aufzulistenden Verzeichnisses |
Header
| Header |
Erforderlich |
Wert |
Authorization |
Ja |
Bearer DEIN_API_SCHLÜSSEL |
Antwort
{
"data": {
"path": "/var/log",
"entries": [
{
"name": "syslog",
"isDirectory": false,
"isSymlink": false,
"size": 524288,
"mode": "0644",
"modifiedAt": "2025-01-15T10:30:00.000Z"
},
{
"name": "nginx",
"isDirectory": true,
"isSymlink": false,
"size": 4096,
"mode": "0755",
"modifiedAt": "2025-01-14T08:00:00.000Z"
}
]
}
}
Antwortfelder
| Feld |
Typ |
Beschreibung |
path |
string |
Aufgelöster absoluter Pfad |
entries |
array |
Liste der Verzeichniseinträge |
entries[].name |
string |
Datei- oder Verzeichnisname |
entries[].isDirectory |
boolean |
Ob der Eintrag ein Verzeichnis ist |
entries[].isSymlink |
boolean |
Ob der Eintrag ein symbolischer Link ist |
entries[].size |
number |
Größe in Bytes |
entries[].mode |
string |
Berechtigungen als vierstellige Oktalzahl |
entries[].modifiedAt |
string |
Letzter Änderungszeitpunkt (ISO 8601) |
Fehler
| Status |
Code |
Beschreibung |
| 400 |
VALIDATION |
path fehlt, ist nicht absolut oder ungültig |
| 403 |
FORBIDDEN |
Kein Inhaber-Zugriff auf den VPS |
| 404 |
NOT_FOUND |
VPS oder Pfad nicht gefunden |
| 502 |
PROVIDER |
Verbindung oder SFTP-Vorgang fehlgeschlagen |
Beispiel
curl "https://site.quest/api/v1/vps/699cdea2ab57a244bb5273fd/sftp/list?path=/var/log" \
-H "Authorization: Bearer DEIN_API_SCHLÜSSEL"
MCP
Diese Aktion ist auch über das list_files MCP-Tool verfügbar.