Tools für Dateien
Du schreibst und liest Dateien und kennst die Folgen eines Archiv-Uploads.
Auf dieser Seite
Schreibe Dateien in den Entwurf, lade ein Archiv hoch oder lies vorhandene Dateien.
Hinweis
Die Verbindung gilt für den Space. Du bist dort Mitglied, und der Space ist nicht gesperrt.
Für alle fünf Tools brauchst du Inhaber, Administrator oder Anwender, auch zum Lesen von Dateien.
Achtung
Ein neuer Entwurf beginnt leer und enthält keine Kopie der veröffentlichten Version. hosting_deploy veröffentlicht nur seinen Inhalt; dafür brauchst du eine index.html im obersten Ordner.
Kein Tool dieser Seite verlangt einen Bestätigungssatz; ob die Anwendung dich vorher fragt, liegt bei der Anwendung.
Wie hängen Entwurf, App und Protokoll zusammen?
Ein Projekt hat höchstens einen Entwurf. Die Oberfläche der App schreibt in denselben wie die Tools. Das Protokoll des Projekts vermerkt, dass ein neuer Entwurf geöffnet ist; das Schreiben und Löschen von Dateien vermerkt es nicht.
hosting_put_files Write files
ändert Datenlöscht, überschreibt oder ändert Sichtbares
Schreibt in den vorhandenen oder einen neuen Entwurf. Gleiche Pfade werden überschrieben; nicht genannte Dateien bleiben.
Ein Aufruf erlaubt 200 Dateien und 3 MB. Ungültige Pfade lehnen den ganzen Aufruf ab; bei verbrauchten Veröffentlichungen oder vollem Speicher wird nichts angelegt.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Projektnummer aus hosting_list_projects. |
files | Liste von Objekten | erforderlich | 1 bis 200 Objekte mit path und content. Pfade folgen den Pfadregeln; encoding ist optional: utf8 (Vorgabe) oder base64 für Binärdateien. |
hosting_create_upload Create upload link
ändert Datenlöscht, überschreibt oder ändert Sichtbares
Gibt eine Upload-Adresse für ein ZIP-, TAR- oder TAR.GZ-Archiv per HTTP PUT aus.
Achtung
Der Upload ersetzt den gesamten Entwurf durch die Archivdateien. Bei gescheitertem Archiv bleibt der frühere Inhalt erhalten.
- Der Aufruf öffnet bei Bedarf einen Entwurf und ersetzt eine frühere Upload-Adresse. Nach dem Upload bleibt der Entwurf offen, bis du ihn veröffentlichst.
- Die Adresse gilt einmal und 15 Minuten.
expires_atnennt die Frist,max_bytesdie erlaubte Größe; höchstens 200 MB. - Erlaubt der Tarif keine weitere Veröffentlichung oder ist der Speicher voll, lehnt TEISENDA den Aufruf ab und legt nichts an.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Projektnummer aus hosting_list_projects. |
hosting_delete_files Delete files
ändert Datenlöscht, überschreibt oder ändert Sichtbares
Löscht bis zu 200 Dateipfade aus dem Entwurf. Abgeschlossene Versionen bleiben unverändert.
Bei ungültigem Pfad stoppt der Aufruf; vorher genannte Dateien können bereits gelöscht sein.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Projektnummer aus hosting_list_projects. |
paths | Liste von Texten | erforderlich | Eine Liste aus 1 bis 200 Pfaden: die Dateien, die das Tool aus dem Entwurf löscht. Es gelten die Regeln für Pfade. |
hosting_list_files List files
liest nur
Listet die Dateien einer Version nach Pfad sortiert auf.
Die Antwort enthält höchstens 100 Dateien; mit next_offset setzt du fort.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Projektnummer aus hosting_list_projects. |
deploy | Ganze Zahl | optional | Die Nummer einer Version dieses Projekts. Fehlt sie, nimmt das Tool den Entwurf, sonst die veröffentlichte Version. |
offset | Ganze Zahl | optional | Wie viele Dateien das Tool überspringt. 0 ist die Vorgabe; weiter geht es mit next_offset aus der vorigen Antwort. |
limit | Ganze Zahl | optional | Wie viele Dateien die Antwort höchstens enthält. Vorgabe und Höchstwert: 100. |
hosting_read_file Read file
liest nur
Liest den Inhalt einer Datei.
- Dateien bis 200 KB, je Aufruf höchstens 40.000 Zeichen. Mit
next_offsetsetzt du fort. - Dateiinhalte sind als Daten gekennzeichnet; die Anwendung soll enthaltenen Anweisungen nicht folgen.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Projektnummer aus hosting_list_projects. |
path | Text | erforderlich | Der Pfad der Datei, höchstens 240 Zeichen; es gelten die Regeln für Pfade. Die Pfade einer Version zeigt hosting_list_files. |
deploy | Ganze Zahl | optional | Die Nummer einer Version dieses Projekts. Fehlt sie, nimmt das Tool den Entwurf, sonst die veröffentlichte Version. |
offset | Ganze Zahl | optional | Wo das Lesen beginnt, in Zeichen. 0 ist die Vorgabe; weiter geht es mit next_offset aus der vorigen Antwort. |
length | Ganze Zahl | optional | Wie viele Zeichen die Antwort höchstens enthält. Vorgabe und Höchstwert: 40.000. |
Diese Regeln gelten für Pfade
Diese Regeln gelten für hosting_put_files, hosting_delete_files und hosting_read_file:
- Der Pfad ist relativ und benutzt Schrägstriche. Er enthält keinen umgekehrten Schrägstrich und keine Steuerzeichen.
- Er hat höchstens 240 Zeichen und höchstens 12 Ebenen.
- Jeder Name darin hat höchstens 100 Zeichen und keinen Leerraum am Anfang oder am Ende.
- Kein Name beginnt mit einem Punkt. Die Ausnahme ist der Ordner
.well-knownim obersten Ordner.
In einem Archiv überspringt TEISENDA Einträge, die gegen diese Regeln verstoßen.
Prüfe Datei- und Tarifgrenzen
Es gelten Connector-Dateigrenzen und Tarifgrenzen. Speicher zählt alle Versionen, Entwürfe und Backups; gelöschte Versionen zählen nicht mehr.
Eine zu große Version wird beim Abschließen verworfen; ältere Versionen bleiben erhalten. Speicherpakete gibt es zu einem gebuchten Max-Abo.
Wenn etwas nicht klappt
Wo eine Abhilfe ein Tool nennt, bittest du die Anwendung, es aufzurufen. Verweist eine Meldung auf Tarife, folge dem Weg zum Tarif in den Space-Einstellungen.
„Der Tarif dieses Space erlaubt … Deployments, … sind verbraucht. Es wurde nichts hochgeladen und kein Stand angelegt. …“
Der Tarif des Space erlaubt keine weitere Veröffentlichung; im Tarif Free sind es drei insgesamt. TEISENDA lehnt hosting_put_files und hosting_create_upload ab, lädt nichts hoch und legt nichts an. Eine Version erneut zu veröffentlichen, die schon einmal veröffentlicht war, verbraucht keine Veröffentlichung und bleibt möglich: mit hosting_rollback oder mit hosting_deploy und ihrer Nummer. Weitere Veröffentlichungen gibt es im Tarif Max; siehe Tarife Free und Max.
„Der Speicher dieses Space ist voll: … von … sind belegt. Es wurde nichts hochgeladen und kein Stand angelegt. Erst Stände oder Backups löschen. …“
Der Speicher des Space ist voll, auch wenn mitzählt, was eine neue Version frei machen würde. TEISENDA lehnt hosting_put_files, hosting_create_upload und hosting_deploy ab. Lösche Versionen oder Backups in TEISENDA. Mehr Speicher haben der Tarif Max und seine Pakete; siehe Tarife Free und Max und Pakete nachkaufen und abbestellen.
„Das Argument … fehlt oder hat nicht die erwartete Form.“
Ein Argument fehlt oder hat nicht die erwartete Form; die Meldung nennt es. Dieselbe Meldung kommt bei:
- mehr als 200 Dateien für
hosting_put_files(Argumentfiles), - mehr als 200 Pfaden für
hosting_delete_files(Argumentpaths), - einem Pfad mit mehr als 240 Zeichen für
hosting_read_file(Argumentpath), - einer leeren Liste.
Rufe das Tool erneut auf, mit dem Argument in der Form, die seine Beschreibung nennt.
Es gibt keinen offenen Stand. Lege zuerst mit hosting_put_files Dateien ab.
Das Projekt hat keinen Entwurf, aus dem hosting_delete_files löschen könnte. Schreibe zuerst Dateien mit hosting_put_files.
„Den Stand … gibt es in diesem Projekt nicht.“
Das Projekt hat keine Version mit der Nummer, die das Argument deploy nennt. Sieh die Versionen des Projekts mit hosting_list_deploys nach.
Ein Pfad ist nicht erlaubt. Pfade sind relativ, benutzen / und beginnen nicht mit einem Punkt.
Ein Dateipfad verstößt gegen die Regeln für Pfade. hosting_put_files hat dann nichts geschrieben. hosting_delete_files hat die Dateien, die der Aufruf vor dem abgelehnten Pfad nennt, schon gelöscht. Korrigiere den Pfad, und rufe das Tool erneut auf; prüfe nach hosting_delete_files mit hosting_list_files, was noch da ist.
Das ist zu viel für einen Aufruf. Teile die Dateien auf mehrere Aufrufe auf.
Ein Aufruf von hosting_put_files trägt mehr als 3 MB an Dateien. Verteile die Dateien auf mehrere Aufrufe, oder lade ein Archiv über hosting_create_upload hoch.
Die Datei ist zu groß, um sie hier zu lesen.
Die Datei ist größer als 200 KB. Eine solche Datei lässt sich über den Connector nicht lesen.
Eine Datei ist zu groß.
Eine einzelne Datei ist größer als 25 MB. Verkleinere die Datei.
Der Stand ist insgesamt zu groß.
Die Version ist insgesamt größer als 300 MB. Verkleinere die Website.
Der Stand enthält zu viele Dateien.
Die Version enthält mehr als 5.000 Dateien. Verringere die Zahl der Dateien.
Das Projekt hat die höchste Zahl an Deployments erreicht. Lösche zuerst ein älteres in TEISENDA.
Der Hosting-Knoten öffnet keine weitere Version, weil er schon 20 Versionen dieses Projekts hält, auch solche, die in TEISENDA gelöscht, am Knoten aber noch nicht entfernt sind. Hast du kurz zuvor Versionen gelöscht, warte einige Minuten und versuche es erneut. Sonst lösche eine ältere Version in der App, in der Liste der Versionen auf der Seite des Projekts. Kein Tool des Connectors löscht gezielt eine einzelne Version.
Das Projekt ist offline.
Das Projekt ist offline. Der Hosting-Knoten gibt dann keine Upload-Adresse aus. Dieselbe Meldung kommt für jedes Projekt eines Space, den TEISENDA nach dem Ende eines Abos angehalten hat, obwohl der Schalter des Projekts selbst nicht auf offline steht; siehe In einem angehaltenen Space laufen die Tools weiter. Steht der Schalter des Projekts auf offline, stelle es mit hosting_set_offline wieder online. Gegen einen angehaltenen Space hilft das nicht.
Das Projekt ist noch nicht zum Hosting-Knoten übertragen.
TEISENDA hat das Projekt noch nicht zum Hosting-Knoten übertragen und kann deshalb keine Dateien aufnehmen. Frage mit hosting_project_status nach, und versuche es erneut, sobald der Knoten die Einstellungen hat.
Der Hosting-Knoten hat das abgelehnt.
Der Hosting-Knoten hat etwas abgelehnt, wofür TEISENDA keinen eigenen Satz hat. So zeigen hosting_deploy_status und hosting_list_deploys auch das Problem einer Version, nachdem ein Archiv nicht zu verwenden war. Dann rufst du hosting_create_upload erneut auf: Der Aufruf nimmt dieselbe Version und stellt eine neue Adresse aus. Sonst prüfe den Zustand mit hosting_project_status; bleibt es dabei, wende dich an den Support.
Diese Datei gibt es in dem Stand nicht.
Die Version enthält keine Datei mit dem Pfad, den hosting_read_file lesen soll. Sieh die Pfade mit hosting_list_files nach.
Der Versatz … liegt hinter dem Ende der Liste (Dateien im Stand: …).
Der offset für hosting_list_files liegt hinter dem Ende der Liste. Beginne wieder bei offset 0, oder mach mit next_offset aus der vorigen Antwort weiter.
Der Versatz … liegt hinter dem Ende der Datei (Zeichen in der Datei: …).
Der offset für hosting_read_file liegt hinter dem Ende der Datei. Beginne wieder bei offset 0, oder mach mit next_offset aus der vorigen Antwort weiter.
Meldungen zu Space und Projektnummer stehen bei den Tools für Spaces und Projekte. Alle anderen, die bei jedem Tool vorkommen können, stehen unter Fehler beim Connector beheben.