Skip to main content
PUT
Crea o aggiorna un file dell'applicazione
string
obbligatorio
La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.
Richiede una chiave API con lo scope files:write. Crea/Modifica File scrive content in path all’interno di un’applicazione in esecuzione, creando il file se non esiste o sovrascrivendolo se esiste già. Per i file binari, invia content codificato in base64 insieme a encoding: "base64", il formato consigliato. content accetta anche una stringa UTF-8 per i file di testo, un semplice array di byte ([104, 105]) o un oggetto { type: "Buffer", data: number[] }. Un content vuoto ("" o []) scrive un file vuoto. Ogni scrittura accetta fino a 10 MB, misurati sui byte decodificati. Le scritture sono limitate a 10 richieste ogni 5 secondi per utente. Usalo per modifiche piccole e mirate, come cambiare un valore di configurazione o aggiungere un file generato, senza dover ricaricare l’intera applicazione; per modifiche massive o un file .zip, usa invece Commit Applicazione. Scrivere su squarecloud.app o squarecloud.config è trattato in modo speciale: la piattaforma lo analizza come la configurazione dell’applicazione (nome visualizzato, descrizione, memoria, autorestart, sottodominio) e valida ogni campo; un valore non valido restituisce un codice di errore specifico (ad esempio INVALID_MEMORY o INVALID_SUBDOMAIN) invece di scrivere il file. Queste riscritture di configurazione sono limitate a 1 richiesta ogni 15 secondi per utente. Sulle applicazioni condivise in un workspace, chi effettua la richiesta deve avere il ruolo maintain o admin, e i membri senza il permesso sui file riservati non possono scrivere su percorsi esclusi come .env. Come le altre route del file manager, questa non riavvia l’applicazione: chiama Riavvia Applicazione per applicare modifiche che richiedono un processo nuovo.

Parametri

string
obbligatorio
L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.
string
obbligatorio
Il percorso in cui il file deve essere creato, fino a 256 caratteri. Esempio: /test.txt
string | number[]
obbligatorio
Il contenuto del file da creare: base64 quando encoding è base64, altrimenti una stringa UTF-8 o un array di byte.
string
Impostalo su base64 quando content è il file codificato in base64. Consigliato per i file binari.

Risposta

string
Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

Errori comuni

Vedi anche