Skip to main content
Der Dateimanager befindet sich unter client.apps.files. Jede Methode nimmt zuerst die App-ID und dann einen Pfad innerhalb der App. Pfade sind höchstens 256 Zeichen lang. Die Beispiele verwenden den client aus Client erstellen. app_id ist die ID einer deiner Apps: client.account.me() listet sie auf.

Ein Verzeichnis auflisten

files.list(app_id, path=None) listet ein Verzeichnis auf (das Stammverzeichnis der App, wenn path fehlt). Anders als andere optionale Modifikatoren kann path als Positionsargument übergeben werden.
Ein Verzeichnis, das nicht existiert, ergibt 404 FILE_NOT_FOUND. Ein Pfad, den der Dateimanager nicht freigibt, ergibt 403 BLOCKED_PATH.

Eine Datei lesen

files.read(app_id, path) gibt den Inhalt der Datei als bytes zurück. Dateien sind auf 10 MB begrenzt: Eine größere ergibt 413 FILE_TOO_LARGE.

Eine Datei schreiben

files.write(app_id, path, content) erstellt oder überschreibt eine Datei.
  • Ein str wird als reiner Text gesendet.
  • bytes werden als Base64 gesendet, sodass jeder Binärinhalt unverändert ankommt.
  • Leerer Inhalt ('' oder b'') erstellt eine leere Datei.
Inhalt über 10 MB schlägt lokal mit FILE_TOO_LARGE (Status 0) fehl, bevor etwas gesendet wird. Inhalt über 1 MiB wird wie ein Upload nach dem Verbindungsaufbau ohne Timeout gesendet. Für größere Dateien verwende apps.commit().
Das Schreiben startet die App nicht neu. Rufe apps.restart() auf, um die Änderung anzuwenden.

Eine Datei verschieben oder umbenennen

Eine Datei löschen

Fehler

Unter Fehler findest du die Codes, die jeder Aufruf zurückgeben kann.

Nächste Schritte

Umgebungsvariablen

Die Variablen einer App lesen und ändern.

API-Referenz des Dateimanagers

Die REST-Endpunkte hinter diesen Methoden.

Dateien über die CLI verwalten

Dieselben Aktionen im Terminal.