Skip to main content
Der Dateimanager befindet sich unter c.Apps.Files. Jede Methode nimmt zuerst ctx und die App-ID und dann einen Pfad innerhalb der App. Pfade sind höchstens 256 Zeichen lang. Jedes Snippet unten läuft für sich allein in diesem Programm: Füge jeweils eines in main ein und führe goimports aus (siehe Beispiele ausführen).

Ein Verzeichnis auflisten

Files.List(ctx, appID, path) listet ein Verzeichnis auf ("" für das Stammverzeichnis der App).
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(ctx, appID, path) gibt die Bytes der Datei als []byte zurück. Dateien sind auf 10 MB begrenzt: Eine größere ergibt 413 FILE_TOO_LARGE.

Eine Datei schreiben

Files.Write(ctx, appID, path, content) erstellt oder überschreibt eine Datei. content ist ein []byte:
  • Er wird immer als Base64 gesendet, sodass Text- und Binärinhalte Byte für Byte erhalten bleiben. Um einen String zu schreiben, übergib []byte(s).
  • Leerer Inhalt (nil oder ein leerer Slice) 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 erhält wie ein Upload keine Standard-Deadline: Begrenze oder brich ihn über ctx ab. 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.