Instrumente pentru fișiere

Scrie și citește fișiere și află ce se întâmplă la încărcarea unei arhive.

Pe această pagină

Scrie fișiere în ciornă, încarcă o arhivă sau citește fișiere existente. Un Space este un spațiu de lucru comun în aplicație.

Informații

Conexiunea este valabilă pentru Space. Ești membru acolo, iar Space-ul nu este blocat.

Pentru toate cele cinci instrumente ai nevoie de Proprietar, Administrator sau Utilizator, inclusiv pentru citirea fișierelor.

Atenție

O ciornă nouă este goală și nu conține o copie a versiunii publicate. hosting_deploy publică doar conținutul ei; pentru asta ai nevoie de un fișier index.html în directorul de nivel superior.

Niciun instrument de pe această pagină nu cere o frază de confirmare; aplicația decide dacă îți cere acordul înainte.

Care este legătura dintre ciornă, aplicație și jurnal?

Un proiect are cel mult o ciornă. Interfața aplicației scrie în aceeași ciornă ca instrumentele. Jurnalul proiectului consemnează deschiderea unei ciorne noi; nu consemnează scrierea și ștergerea fișierelor.

hosting_put_files Write files

modifică dateșterge, suprascrie sau modifică conținut vizibil

Scrie în ciorna existentă sau într-una nouă. Căile identice sunt suprascrise; fișierele nemenționate se păstrează.

Un apel permite 200 de fișiere și 3 MB. Căile nevalide duc la respingerea întregului apel; dacă publicările sunt epuizate sau spațiul de stocare este plin, nu se creează nimic.

Parametrii pentru hosting_put_files
ParametruTipObligatoriuDescriere
spaceNumăr întregobligatoriuSpace-ID de zece cifre.
projectNumăr întregobligatoriuNumărul proiectului din hosting_list_projects.
filesListă de obiecteobligatoriuÎntre 1 și 200 de obiecte cu path și content. Căile respectă regulile pentru căi; encoding este opțional: utf8 (implicit) sau base64 pentru fișiere binare.

hosting_create_upload Create upload link

modifică dateșterge, suprascrie sau modifică conținut vizibil

Oferă o adresă de încărcare pentru o arhivă ZIP, TAR sau TAR.GZ prin HTTP PUT.

Atenție

Încărcarea înlocuiește întreaga ciornă cu fișierele arhivei. Dacă procesarea arhivei eșuează, conținutul anterior se păstrează.

  • Apelul deschide o ciornă dacă este necesar și înlocuiește o adresă de încărcare anterioară. După încărcare, ciorna rămâne deschisă până când o publici.
  • Adresa este valabilă o singură dată și timp de 15 minute. expires_at indică termenul, max_bytes dimensiunea permisă; cel mult 200 MB.
  • Dacă planul nu permite încă o publicare sau spațiul de stocare este plin, TEISENDA respinge apelul și nu creează nimic.
Parametrii pentru hosting_create_upload
ParametruTipObligatoriuDescriere
spaceNumăr întregobligatoriuSpace-ID de zece cifre.
projectNumăr întregobligatoriuNumărul proiectului din hosting_list_projects.

hosting_delete_files Delete files

modifică dateșterge, suprascrie sau modifică conținut vizibil

Șterge cel mult 200 de căi de fișiere din ciornă. Versiunile finalizate rămân neschimbate.

La o cale nevalidă, apelul se oprește; fișierele menționate anterior pot fi deja șterse.

Parametrii pentru hosting_delete_files
ParametruTipObligatoriuDescriere
spaceNumăr întregobligatoriuSpace-ID de zece cifre.
projectNumăr întregobligatoriuNumărul proiectului din hosting_list_projects.
pathsListă de texteobligatoriuO listă cu 1 până la 200 de căi: fișierele pe care instrumentul le șterge din ciornă. Se aplică regulile pentru căi.

hosting_list_files List files

doar citire

Listează fișierele unei versiuni, sortate după cale.

Răspunsul conține cel mult 100 de fișiere; continui cu next_offset.

Parametrii pentru hosting_list_files
ParametruTipObligatoriuDescriere
spaceNumăr întregobligatoriuSpace-ID de zece cifre.
projectNumăr întregobligatoriuNumărul proiectului din hosting_list_projects.
deployNumăr întregopționalNumărul unei versiuni din acest proiect. Dacă lipsește, instrumentul folosește ciorna, iar dacă nu există ciornă, versiunea publicată.
offsetNumăr întregopționalCâte fișiere sare instrumentul. Valoarea implicită este 0; continui cu next_offset din răspunsul anterior.
limitNumăr întregopționalNumărul maxim de fișiere în răspuns. Valoarea implicită și maximă: 100.

hosting_read_file Read file

doar citire

Citește conținutul unui fișier.

  • Fișiere de cel mult 200 KB, maximum 40.000 de caractere pentru fiecare apel. Continui cu next_offset.
  • Conținutul fișierelor este marcat drept date; aplicația nu trebuie să urmeze instrucțiunile din ele.
Parametrii pentru hosting_read_file
ParametruTipObligatoriuDescriere
spaceNumăr întregobligatoriuSpace-ID de zece cifre.
projectNumăr întregobligatoriuNumărul proiectului din hosting_list_projects.
pathTextobligatoriuCalea fișierului, cel mult 240 de caractere; se aplică regulile pentru căi. Căile unei versiuni sunt afișate de hosting_list_files.
deployNumăr întregopționalNumărul unei versiuni din acest proiect. Dacă lipsește, instrumentul folosește ciorna, iar dacă nu există ciornă, versiunea publicată.
offsetNumăr întregopționalLocul de unde începe citirea, în caractere. Valoarea implicită este 0; continui cu next_offset din răspunsul anterior.
lengthNumăr întregopționalNumărul maxim de caractere în răspuns. Valoarea implicită și maximă: 40.000.

Aceste reguli se aplică pentru căi

Aceste reguli se aplică pentru hosting_put_files, hosting_delete_files și hosting_read_file:

  • Calea este relativă și folosește bare oblice. Nu conține bare oblice inverse sau caractere de control.
  • Are cel mult 240 de caractere și cel mult 12 niveluri.
  • Fiecare nume din cale are cel mult 100 de caractere, fără spații albe la început sau la sfârșit.
  • Niciun nume nu începe cu punct. Excepția este directorul .well-known de la nivelul superior.

Într-o arhivă, TEISENDA sare peste intrările care încalcă aceste reguli.

Verifică limitele fișierelor și planurilor

Se aplică limitele fișierelor din Connector și limitele planurilor. Spațiul de stocare numără toate versiunile, ciornele și copiile de siguranță; versiunile șterse nu se mai numără.

O versiune prea mare este eliminată la finalizare; versiunile mai vechi se păstrează. Pachetele de stocare sunt disponibile cu un abonament Max contractat.

Dacă ceva nu funcționează

Dacă o soluție menționează un instrument, cere aplicației să îl apeleze. Dacă un mesaj trimite la Planuri, urmează calea către plan în setările Space-ului.

Planul acestui Space are o limită de implementări: …; folosite: …. Nu s-a încărcat nimic și nu a fost creată nicio versiune. Planul acestui Space este afișat în TEISENDA la Setări › Planuri.

Planul Space-ului nu permite încă o publicare; în planul Free sunt trei în total. TEISENDA respinge hosting_put_files și hosting_create_upload, nu încarcă și nu creează nimic. Republicarea unei versiuni publicate anterior nu consumă o publicare și rămâne posibilă: cu hosting_rollback sau cu hosting_deploy și numărul ei. Planul Max oferă mai multe publicări; vezi Planurile Free și Max.

Capacitatea de stocare a acestui Space este epuizată: folosit … din …. Nu s-a încărcat nimic și nu a fost creată nicio versiune. Mai întâi șterge versiuni sau copii de rezervă. Planul acestui Space este afișat în TEISENDA la Setări › Planuri.

Spațiul de stocare al Space-ului este plin chiar și ținând cont de ce ar elibera o versiune nouă. TEISENDA respinge hosting_put_files, hosting_create_upload și hosting_deploy. Șterge versiuni sau copii de siguranță în TEISENDA. Planul Max și pachetele sale oferă mai mult spațiu de stocare; vezi Planurile Free și Max și Cumpărarea și eliminarea pachetelor suplimentare.

Argumentul … lipsește sau nu are forma așteptată.

Un argument lipsește sau nu are forma așteptată; mesajul îl numește. Același mesaj apare pentru:

  • mai mult de 200 de fișiere la hosting_put_files (argumentul files),
  • mai mult de 200 de căi la hosting_delete_files (argumentul paths),
  • o cale cu mai mult de 240 de caractere la hosting_read_file (argumentul path),
  • o listă goală.

Apelează din nou instrumentul cu argumentul în forma precizată în descrierea lui.

Nu există nicio versiune deschisă. Pune mai întâi fișiere cu hosting_put_files.

Proiectul nu are o ciornă din care hosting_delete_files să poată șterge. Scrie mai întâi fișiere cu hosting_put_files.

Versiunea … nu există în acest proiect.

Proiectul nu are o versiune cu numărul indicat de argumentul deploy. Consultă versiunile proiectului cu hosting_list_deploys.

O cale nu este permisă. Căile sunt relative, folosesc / și nu încep cu un punct.

O cale de fișier încalcă regulile pentru căi. hosting_put_files nu a scris nimic. hosting_delete_files a șters deja fișierele menționate de apel înaintea căii respinse. Corectează calea și apelează din nou instrumentul; după hosting_delete_files, verifică folosind hosting_list_files ce a mai rămas.

Este prea mult pentru un singur apel. Împarte fișierele în mai multe apeluri.

Un apel de hosting_put_files conține peste 3 MB de fișiere. Împarte fișierele în mai multe apeluri sau încarcă o arhivă prin hosting_create_upload.

Fișierul este prea mare pentru a fi citit aici.

Fișierul este mai mare de 200 KB. Un astfel de fișier nu poate fi citit prin Connector.

Un fișier este prea mare.

Un fișier individual este mai mare de 25 MB. Micșorează fișierul.

Versiunea este, în total, prea mare.

Versiunea depășește în total 300 MB. Micșorează site-ul.

Versiunea conține prea multe fișiere.

Versiunea conține mai mult de 5.000 de fișiere. Redu numărul fișierelor.

Proiectul a atins numărul maxim de implementări. Șterge mai întâi una mai veche în TEISENDA.

Nodul de hosting nu deschide încă o versiune deoarece păstrează deja 20 de versiuni ale proiectului, inclusiv versiuni șterse în TEISENDA, dar încă neeliminate de pe nod. Dacă ai șters versiuni cu puțin timp înainte, așteaptă câteva minute și încearcă din nou. Altfel, șterge o versiune mai veche în aplicație, în lista versiunilor de pe pagina proiectului. Niciun instrument Connector nu șterge individual o versiune.

Proiectul este offline.

Proiectul este offline. Nodul de hosting nu oferă atunci o adresă de încărcare. Același mesaj apare pentru fiecare proiect dintr-un Space oprit de TEISENDA după încheierea unui abonament, chiar dacă comutatorul proiectului nu este pe offline; vezi Instrumentele continuă să funcționeze într-un Space oprit. Dacă comutatorul proiectului este pe offline, readu-l online cu hosting_set_offline. Aceasta nu remediază oprirea hostingului unui Space.

Proiectul nu a fost încă transferat către nodul de găzduire.

TEISENDA nu a transmis încă proiectul către nodul de hosting și de aceea nu poate primi fișiere. Verifică folosind hosting_project_status și încearcă din nou când nodul a primit setările.

Nodul de găzduire a respins acest lucru.

Nodul de hosting a respins ceva pentru care TEISENDA nu are un mesaj specific. Astfel, hosting_deploy_status și hosting_list_deploys arată și problema unei versiuni după o arhivă inutilizabilă. Atunci apelează din nou hosting_create_upload: apelul folosește aceeași versiune și oferă o adresă nouă. Altfel, verifică starea cu hosting_project_status; dacă problema persistă, contactează asistența.

Acest fișier nu există în versiune.

Versiunea nu conține un fișier cu calea pe care hosting_read_file trebuie să o citească. Consultă căile cu hosting_list_files.

Poziția de pornire … se află după sfârșitul listei (fișiere în versiune: …).

Valoarea offset pentru hosting_list_files este dincolo de sfârșitul listei. Începe din nou cu offset 0 sau continuă cu next_offset din răspunsul anterior.

Poziția de pornire … se află după sfârșitul fișierului (caractere în fișier: …).

Valoarea offset pentru hosting_read_file este dincolo de sfârșitul fișierului. Începe din nou cu offset 0 sau continuă cu next_offset din răspunsul anterior.

Mesajele privind Space-ul și numărul proiectului sunt la instrumentele pentru Spaces și proiecte. Toate celelalte mesaje care pot apărea la orice instrument sunt în Remedierea erorilor Connector.

Mai departe