Skip to main content
Le gestionnaire de fichiers se trouve sur client.apps.files. Chaque méthode prend d’abord l’identifiant de l’application, puis un chemin dans l’application. Les chemins font au maximum 256 caractères. Les exemples utilisent le client présenté dans Créer le client. app_id est l’identifiant de l’une de vos applications : client.account.me() les liste.

Lister un répertoire

files.list(app_id, path=None) liste un répertoire (la racine de l’application quand path est omis). Contrairement aux autres modificateurs optionnels, path peut être passé par position.
Un répertoire inexistant donne 404 FILE_NOT_FOUND. Un chemin que le gestionnaire de fichiers n’expose pas donne 403 BLOCKED_PATH.

Lire un fichier

files.read(app_id, path) renvoie le contenu du fichier sous forme de bytes. Les fichiers sont limités à 10 Mo : un fichier plus volumineux donne 413 FILE_TOO_LARGE.

Écrire un fichier

files.write(app_id, path, content) crée ou écrase un fichier.
  • Une str est envoyée en texte brut.
  • Des bytes sont envoyés en base64, de sorte que tout contenu binaire est conservé à l’identique.
  • Un contenu vide ('' ou b'') crée un fichier vide.
Un contenu de plus de 10 Mo échoue localement avec FILE_TOO_LARGE (statut 0) avant tout envoi. Un contenu de plus de 1 MiB est envoyé sans timeout une fois connecté, comme un envoi. Pour les fichiers plus volumineux, utilisez apps.commit().
L’écriture ne redémarre pas l’application. Appelez apps.restart() pour appliquer la modification.

Déplacer ou renommer un fichier

Supprimer un fichier

Erreurs

Voir Erreurs pour les codes que chaque appel peut renvoyer.

Prochaines étapes

Variables d'environnement

Lisez et modifiez les variables d’une application.

Référence de l'API du gestionnaire de fichiers

Les endpoints REST derrière ces méthodes.

Gérer les fichiers depuis la CLI

Les mêmes actions depuis le terminal.