Outils pour les fichiers
Vous écrivez et lisez des fichiers et connaissez les conséquences d’un envoi d’archive.
Sur cette page
Écrivez des fichiers dans le brouillon, envoyez une archive ou lisez des fichiers existants.
À savoir
La connexion inclut le Space. Vous en êtes membre, et il n’est pas bloqué.
Les cinq outils nécessitent Propriétaire, Administrateur ou Utilisateur, même pour lire des fichiers.
Attention
Un nouveau brouillon est vide et ne contient aucune copie de la version publiée. hosting_deploy ne publie que son contenu ; il faut pour cela une index.html dans le dossier racine.
Aucun outil de cette page n’exige de phrase de confirmation ; l’application décide si elle vous demande votre accord auparavant.
Quel est le lien entre le brouillon, l’app et le journal ?
Un projet a au maximum un brouillon. L’interface de l’app écrit dans le même brouillon que les outils. Le journal du projet indique l’ouverture d’un nouveau brouillon ; il ne consigne pas l’écriture ni la suppression de fichiers.
hosting_put_files Write files
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Écrit dans le brouillon existant ou dans un nouveau. Les chemins identiques sont remplacés ; les fichiers non mentionnés restent.
Un appel autorise 200 fichiers et 3 Mo. Des chemins invalides entraînent le refus de tout l’appel ; si toutes les publications sont utilisées ou si le stockage est plein, rien n’est créé.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro de projet de hosting_list_projects. |
files | Liste d’objets | obligatoire | De 1 à 200 objets avec path et content. Les chemins respectent les règles des chemins ; encoding est facultatif : utf8 (par défaut) ou base64 pour les fichiers binaires. |
hosting_create_upload Create upload link
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Fournit une adresse d’envoi pour une archive ZIP, TAR ou TAR.GZ par HTTP PUT.
Attention
L’envoi remplace le brouillon entier par les fichiers de l’archive. Si l’archive échoue, le contenu précédent est conservé.
- L’appel ouvre un brouillon si nécessaire et remplace une adresse d’envoi précédente. Après l’envoi, le brouillon reste ouvert jusqu’à sa publication.
- L’adresse est valable une fois et pendant 15 minutes.
expires_atindique l’expiration, etmax_bytesla taille autorisée ; au maximum 200 Mo. - Si l’offre n’autorise plus de publication ou si le stockage est plein, TEISENDA refuse l’appel et ne crée rien.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro de projet de hosting_list_projects. |
hosting_delete_files Delete files
modifie des donnéessupprime, remplace ou modifie des éléments visibles
Supprime jusqu’à 200 chemins de fichiers du brouillon. Les versions finalisées restent inchangées.
Un chemin invalide arrête l’appel ; les fichiers indiqués auparavant peuvent déjà avoir été supprimés.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro de projet de hosting_list_projects. |
paths | Liste de textes | obligatoire | Une liste de 1 à 200 chemins : les fichiers que l’outil supprime du brouillon. Les règles des chemins s’appliquent. |
hosting_list_files List files
lecture seule
Liste les fichiers d’une version, triés par chemin.
La réponse contient au maximum 100 fichiers ; continuez avec next_offset.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro de projet de hosting_list_projects. |
deploy | Nombre entier | facultatif | Le numéro d’une version de ce projet. S’il manque, l’outil utilise le brouillon, ou à défaut la version publiée. |
offset | Nombre entier | facultatif | Le nombre de fichiers à ignorer. La valeur par défaut est 0 ; continuez avec next_offset de la réponse précédente. |
limit | Nombre entier | facultatif | Le nombre maximal de fichiers dans la réponse. Valeur par défaut et maximum : 100. |
hosting_read_file Read file
lecture seule
Lit le contenu d’un fichier.
- Fichiers jusqu’à 200 Ko, au maximum 40 000 caractères par appel. Continuez avec
next_offset. - Le contenu est identifié comme données ; les instructions du Connector demandent à l’application de ne pas suivre les instructions qu’il contient.
| Paramètre | Type | Présence | Description |
|---|---|---|---|
space | Nombre entier | obligatoire | La Space-ID à dix chiffres. |
project | Nombre entier | obligatoire | Le numéro de projet de hosting_list_projects. |
path | Texte | obligatoire | Le chemin du fichier, au maximum 240 caractères ; les règles des chemins s’appliquent. hosting_list_files indique les chemins d’une version. |
deploy | Nombre entier | facultatif | Le numéro d’une version de ce projet. S’il manque, l’outil utilise le brouillon, ou à défaut la version publiée. |
offset | Nombre entier | facultatif | Le début de la lecture, en caractères. La valeur par défaut est 0 ; continuez avec next_offset de la réponse précédente. |
length | Nombre entier | facultatif | Le nombre maximal de caractères dans la réponse. Valeur par défaut et maximum : 40 000. |
Règles des chemins
Ces règles s’appliquent à hosting_put_files, hosting_delete_files et hosting_read_file :
- Le chemin est relatif et utilise des barres obliques. Il ne contient aucune barre oblique inversée ni caractère de contrôle.
- Il comporte au maximum 240 caractères et 12 niveaux.
- Chaque nom comporte au maximum 100 caractères et aucun espace blanc au début ou à la fin.
- Aucun nom ne commence par un point. L’exception est le dossier
.well-knowndans le dossier racine.
Dans une archive, TEISENDA ignore les entrées qui ne respectent pas ces règles.
Vérifier les limites des fichiers et des offres
Les limites de fichiers du Connector et les limites des offres s’appliquent. Le stockage comprend toutes les versions, les brouillons et les sauvegardes ; les versions supprimées ne comptent plus.
Une version trop volumineuse est abandonnée lors de sa finalisation ; les versions antérieures restent conservées. Les packs de stockage nécessitent un abonnement Max.
En cas de problème
Si une solution mentionne un outil, demandez à l’application de l’appeler. Si un message renvoie à Offres, suivez le chemin vers l’offre dans les paramètres du Space.
L'offre de ce Space autorise … déploiements, dont … sont déjà utilisés. Rien n'a été envoyé et aucune version n'a été créée. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.
L’offre du Space n’autorise plus de publication ; Free en autorise trois au total. TEISENDA refuse hosting_put_files et hosting_create_upload, n’envoie rien et ne crée rien. Republier une version déjà publiée ne consomme aucune publication et reste possible avec hosting_rollback ou avec hosting_deploy et son numéro. Max autorise davantage de publications ; consultez Offres Free et Max.
Le stockage de ce Space est plein : … utilisés sur …. Rien n'a été envoyé et aucune version n'a été créée. Supprimez d'abord des versions ou des sauvegardes. L'offre de ce Space figure dans TEISENDA sous Paramètres › Offres.
Le stockage du Space est plein, même en tenant compte de ce qu’une nouvelle version libérerait. TEISENDA refuse hosting_put_files, hosting_create_upload et hosting_deploy. Supprimez des versions ou des sauvegardes dans TEISENDA. Max et ses packs offrent davantage de stockage ; consultez Offres Free et Max et Acheter et retirer des packs.
L'argument … est manquant ou n'a pas la forme attendue.
Un argument manque ou n’a pas la forme attendue ; le message le nomme. Le même message apparaît pour :
- plus de 200 fichiers pour
hosting_put_files(argumentfiles), - plus de 200 chemins pour
hosting_delete_files(argumentpaths), - un chemin de plus de 240 caractères pour
hosting_read_file(argumentpath), - une liste vide.
Rappelez l’outil avec l’argument sous la forme indiquée dans sa description.
Il n'y a pas de version ouverte. Déposez d'abord des fichiers avec hosting_put_files.
Le projet n’a aucun brouillon dont hosting_delete_files pourrait supprimer des fichiers. Écrivez d’abord des fichiers avec hosting_put_files.
La version … n'existe pas dans ce projet.
Le projet n’a aucune version portant le numéro indiqué par deploy. Consultez les versions du projet avec hosting_list_deploys.
Un chemin n'est pas autorisé. Les chemins sont relatifs, utilisent / et ne commencent pas par un point.
Un chemin de fichier ne respecte pas les règles des chemins. hosting_put_files n’a alors rien écrit. hosting_delete_files a déjà supprimé les fichiers indiqués avant le chemin refusé. Corrigez le chemin et rappelez l’outil ; après hosting_delete_files, vérifiez avec hosting_list_files ce qui reste.
C'est trop pour un seul appel. Répartissez les fichiers sur plusieurs appels.
Un appel de hosting_put_files contient plus de 3 Mo de fichiers. Répartissez les fichiers sur plusieurs appels ou envoyez une archive via hosting_create_upload.
Le fichier est trop volumineux pour être lu ici.
Le fichier dépasse 200 Ko. Un tel fichier ne peut pas être lu via le Connector.
Un fichier est trop volumineux.
Un fichier individuel dépasse 25 Mo. Réduisez sa taille.
La version est trop volumineuse dans son ensemble.
La version dépasse au total 300 Mo. Réduisez la taille du site.
La version contient trop de fichiers.
La version contient plus de 5 000 fichiers. Réduisez leur nombre.
Le projet a atteint le nombre maximal de déploiements. Supprimez-en d'abord un plus ancien dans TEISENDA.
Le nœud d’hébergement n’ouvre plus de version, car il en conserve déjà 20 pour ce projet, y compris celles supprimées dans TEISENDA mais pas encore retirées du nœud. Si vous venez de supprimer des versions, attendez quelques minutes et réessayez. Sinon, supprimez une version antérieure dans l’app, dans la liste des versions sur la page du projet. Aucun outil du Connector ne supprime une version individuelle choisie.
Le projet est hors ligne.
Le projet est hors ligne. Le nœud ne fournit alors aucune adresse d’envoi. Le même message apparaît pour chaque projet d’un Space dont TEISENDA a suspendu l’hébergement après la fin d’un abonnement, même si le réglage du projet lui-même n’est pas hors ligne ; consultez Les outils continuent à fonctionner dans un Space suspendu. Si le réglage du projet est hors ligne, remettez-le en ligne avec hosting_set_offline. Cela ne résout pas la suspension d’un Space.
Le projet n'a pas encore été transféré au nœud d'hébergement.
TEISENDA n’a pas encore transmis le projet au nœud d’hébergement et ne peut donc pas recevoir de fichiers. Consultez hosting_project_status et réessayez dès que le nœud a les paramètres.
Le nœud d'hébergement l'a refusé.
Le nœud a refusé quelque chose pour lequel TEISENDA n’a pas de phrase spécifique. hosting_deploy_status et hosting_list_deploys affichent aussi ainsi le problème d’une version après une archive inutilisable. Rappelez alors hosting_create_upload : l’appel reprend la même version et fournit une nouvelle adresse. Sinon, vérifiez l’état avec hosting_project_status ; si le problème persiste, contactez le support.
Ce fichier n'existe pas dans la version.
La version ne contient aucun fichier au chemin que hosting_read_file doit lire. Consultez les chemins avec hosting_list_files.
Le décalage … dépasse la fin de la liste (fichiers dans la version : …).
L’offset de hosting_list_files dépasse la fin de la liste. Recommencez à offset 0 ou continuez avec next_offset de la réponse précédente.
Le décalage … dépasse la fin du fichier (caractères dans le fichier : …).
L’offset de hosting_read_file dépasse la fin du fichier. Recommencez à offset 0 ou continuez avec next_offset de la réponse précédente.
Les messages concernant le Space et le numéro de projet figurent dans les outils pour les Spaces et les projets. Les autres messages communs aux outils figurent dans Résoudre les problèmes du Connector.