Anwendung – Dateimanager
Datei erstellen/ändern
Dateien in deiner Anwendung erstellen.
PUT
Datei erstellen/ändern
string
erforderlich
Der API-Schlüssel für Ihr Konto. Sie finden ihn in Ihren Kontoeinstellungen.
content nach path innerhalb einer laufenden Anwendung, erstellt die Datei, falls sie nicht existiert, oder überschreibt sie, falls doch. content akzeptiert eine UTF-8-Zeichenkette für Textdateien, ein einfaches Byte-Array ([104, 105]; ein leeres Array [] schreibt eine leere Datei) oder ein { type: "Buffer", data: number[] }-Objekt für Binärinhalte, bis zu 10 MB pro Schreibvorgang. 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 Maintainer oder Administrator, 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. Beispiel: /test.txt
string | number[]
erforderlich
Der Inhalt der zu erstellenden Datei.
Antwort
string
Gibt an, ob der Aufruf erfolgreich war.
success bei Erfolg, error andernfalls.
