Skip to main content
PUT
Créer ou modifier un fichier d'une application
string
requis
La clé d’API de votre compte. Vous pouvez la trouver dans les paramètres de votre compte.
Nécessite une clé API avec le scope files:write. Create/Modify File écrit content dans path à l’intérieur d’une application en cours d’exécution, créant le fichier s’il n’existe pas ou l’écrasant s’il existe déjà. Pour les fichiers binaires, envoyez content encodé en base64 avec encoding: "base64", le format recommandé. content accepte aussi une chaîne UTF-8 pour les fichiers texte, un simple tableau d’octets ([104, 105]) ou un objet { type: "Buffer", data: number[] }. Un content vide ("" ou []) écrit un fichier vide. Chaque écriture accepte jusqu’à 10 Mo, mesurés sur les octets décodés. Les écritures sont limitées à 10 requêtes toutes les 5 secondes par utilisateur. Utilisez-le pour des modifications ciblées et de petite taille, comme ajuster une valeur de configuration ou déposer un fichier généré, sans réenvoyer l’application entière ; pour des changements en masse ou un .zip, utilisez plutôt Commiter une application. Écrire dans squarecloud.app ou squarecloud.config est traité de façon particulière : la plateforme l’interprète comme la configuration de l’application (nom d’affichage, description, mémoire, autorestart, sous-domaine) et valide chaque champ, une valeur invalide renvoie un code d’erreur spécifique (par exemple INVALID_MEMORY ou INVALID_SUBDOMAIN) plutôt que d’écrire le fichier. Ces réécritures de configuration sont limitées à 1 requête toutes les 15 secondes par utilisateur. Sur les applications partagées en workspace, l’appelant doit avoir le rôle maintain ou admin, et les membres sans la permission des fichiers restreints ne peuvent pas écrire dans les chemins exclus comme .env. Comme les autres routes du gestionnaire de fichiers, cela ne redémarre pas l’application, appelez Redémarrer l’application pour appliquer les changements qui nécessitent un processus neuf.

Paramètres

string
requis
L’ID de l’application. Vous le trouverez dans l’URL du dashboard de votre application.
string
requis
Le chemin où le fichier doit être créé, jusqu’à 256 caractères. Exemple : /test.txt
string | number[]
requis
Le contenu du fichier à créer : du base64 lorsque encoding vaut base64, sinon une chaîne UTF-8 ou un tableau d’octets.
string
Définissez-le sur base64 lorsque content est le fichier encodé en base64. Recommandé pour les fichiers binaires.

Réponse

string
Indique si l’appel a réussi : success si c’est le cas, error sinon.

Erreurs courantes

Voir aussi