Datei einer Anwendung erstellen oder ändern
Erstelle oder überschreibe eine Datei in einer Anwendung mit PUT /v2/apps//files. Binärdateien als base64, bis 10 MB pro Datei, ohne Neustart.
PUT
Datei einer Anwendung erstellen oder ändern
string
erforderlich
Der API-Schlüssel für dein Konto. Du findest ihn in deinen Kontoeinstellungen.
files:write.
Datei erstellen/ändern schreibt content nach path innerhalb einer laufenden Anwendung, erstellt die Datei, falls sie nicht existiert, oder überschreibt sie, falls doch. Für Binärdateien sende content base64-kodiert zusammen mit encoding: "base64", das empfohlene Format. content akzeptiert außerdem eine UTF-8-Zeichenkette für Textdateien, ein einfaches Byte-Array ([104, 105]) oder ein { type: "Buffer", data: number[] }-Objekt. Ein leerer content ("" oder []) schreibt eine leere Datei. Jeder Schreibvorgang umfasst bis zu 10 MB, gemessen an den dekodierten Bytes. Schreibvorgänge sind auf 10 Anfragen alle 5 Sekunden pro Nutzer begrenzt. Nutze es für kleine, gezielte Änderungen, etwa das Anpassen eines Konfigurationswerts oder das Ablegen einer generierten Datei, ohne die gesamte Anwendung neu hochzuladen; für Massenänderungen oder eine .zip-Datei nutze stattdessen Anwendung committen.
Ein Schreibvorgang auf squarecloud.app oder squarecloud.config wird besonders behandelt: Die Plattform parst die Datei als Konfiguration der Anwendung (Anzeigename, Beschreibung, Speicher, Autorestart, Subdomain) und validiert jedes Feld; ein ungültiger Wert liefert einen spezifischen Fehlercode (zum Beispiel INVALID_MEMORY oder INVALID_SUBDOMAIN) statt die Datei zu schreiben. Diese Konfigurationsänderungen sind auf 1 Anfrage alle 15 Sekunden pro Benutzer begrenzt.
Bei Workspace-geteilten Anwendungen benötigt der Aufrufer die Rolle maintain oder admin, und Mitglieder ohne die Berechtigung für eingeschränkte Dateien dürfen nicht in ausgeschlossene Pfade wie .env schreiben. Wie andere Dateimanager-Routen startet auch dieser Endpunkt die Anwendung nicht neu, rufe Anwendung neu starten auf, um Änderungen anzuwenden, die einen frischen Prozess benötigen.
Parameter
string
erforderlich
Die ID der Anwendung. Du findest sie in der URL des Dashboards deiner Anwendung.
string
erforderlich
Der Pfad, unter dem die Datei erstellt werden soll, bis zu 256 Zeichen. Beispiel: /test.txt
string | number[]
erforderlich
Der Inhalt der zu erstellenden Datei: base64, wenn
encoding gleich base64 ist, sonst eine UTF-8-Zeichenkette oder ein Byte-Array.string
Setze es auf
base64, wenn content die base64-kodierte Datei ist. Für Binärdateien empfohlen.Antwort
string
Gibt an, ob der Aufruf erfolgreich war:
success, wenn ja, error, wenn nicht.Häufige Fehler
Siehe auch
- CLI:
squarecloud app file write - SDKs:
api.apps.files.write()(JavaScript),client.apps.files.write()(Python),c.Apps.Files.Write()(Go)

