Nástroje pro soubory

Zapisujte a čtěte soubory a seznamte se s důsledky nahrání archivu.

Na této stránce

Zapište soubory do konceptu, nahrajte archiv nebo čtěte stávající soubory.

Informace

Připojení platí pro Space. Jste jeho členem a Space není zablokovaný.

Pro všech pět nástrojů potřebujete Vlastník, Administrátor nebo Uživatel, i pro čtení souborů.

Upozornění

Nový koncept začíná prázdný a neobsahuje kopii publikované verze.hosting_deploy publikuje jen jeho obsah; potřebujete k tomu index.html v nejvyšší složce.

Žádný nástroj této stránky nevyžaduje potvrzovací větu; zda se vás aplikace předem zeptá, záleží na aplikaci.

Jak spolu souvisejí koncept, aplikace a protokol?

Projekt má nejvýše jeden koncept. Rozhraní aplikace zapisuje do stejného konceptu jako nástroje. Protokol projektu zaznamenává otevření nového konceptu; zápis a mazání souborů nezaznamenává.

hosting_put_files Write files

mění údajemaže, přepisuje nebo mění viditelný obsah

Zapisuje do stávajícího nebo nového konceptu. Stejné cesty se přepisují; neuvedené soubory zůstávají.

Jedno volání dovoluje 200 souborů a 3 MB. Neplatné cesty vedou k odmítnutí celého volání; při vyčerpaných publikováních nebo plném úložišti se nic nevytvoří.

Parametry nástroje hosting_put_files
ParametrTypPovinnýPopis
spaceCelé číslopovinnýDesetimístné Space-ID.
projectCelé číslopovinnýČíslo projektu z hosting_list_projects.
filesSeznam objektůpovinný1 až 200 objektů s path a content. Pro cesty platí pravidla pro cesty; encoding je volitelné: utf8 (výchozí) nebo base64 pro binární soubory.

hosting_create_upload Create upload link

mění údajemaže, přepisuje nebo mění viditelný obsah

Vydává adresu pro nahrání archivu ZIP, TAR nebo TAR.GZ přes HTTP PUT.

Upozornění

Nahrání nahrazuje celý koncept soubory z archivu. Při neúspěšném zpracování archivu zůstává původní obsah zachovaný.

  • Volání podle potřeby otevře koncept a nahradí dřívější adresu nahrávání. Po nahrání zůstává koncept otevřený, dokud ho nepublikujete.
  • Adresa platí jednou a 15 minut.expires_at uvádí dobu platnosti, max_bytes povolenou velikost; nejvýše 200 MB.
  • Pokud tarif nedovoluje další publikování nebo je úložiště plné, TEISENDA volání odmítne a nic nevytvoří.
Parametry nástroje hosting_create_upload
ParametrTypPovinnýPopis
spaceCelé číslopovinnýDesetimístné Space-ID.
projectCelé číslopovinnýČíslo projektu z hosting_list_projects.

hosting_delete_files Delete files

mění údajemaže, přepisuje nebo mění viditelný obsah

Maže z konceptu až 200 cest k souborům. Dokončené verze zůstávají beze změny.

Při neplatné cestě se volání zastaví; dříve uvedené soubory už mohou být smazané.

Parametry nástroje hosting_delete_files
ParametrTypPovinnýPopis
spaceCelé číslopovinnýDesetimístné Space-ID.
projectCelé číslopovinnýČíslo projektu z hosting_list_projects.
pathsSeznam textůpovinnýSeznam 1 až 200 cest: soubory, které nástroj smaže z konceptu. Platí pravidla pro cesty.

hosting_list_files List files

pouze čte

Uvádí soubory verze seřazené podle cesty.

Odpověď obsahuje nejvýše 100 souborů; pokračujete pomocí next_offset.

Parametry nástroje hosting_list_files
ParametrTypPovinnýPopis
spaceCelé číslopovinnýDesetimístné Space-ID.
projectCelé číslopovinnýČíslo projektu z hosting_list_projects.
deployCelé číslovolitelnýČíslo verze tohoto projektu. Pokud chybí, nástroj použije koncept, jinak publikovanou verzi.
offsetCelé číslovolitelnýPočet souborů, které nástroj přeskočí. Výchozí hodnota je 0; pokračujete pomocí next_offset z předchozí odpovědi.
limitCelé číslovolitelnýNejvyšší počet souborů v odpovědi. Výchozí i maximální hodnota: 100.

hosting_read_file Read file

pouze čte

Čte obsah souboru.

  • Soubory do 200 KB, v jednom volání nejvýše 40 000 znaků. Pokračujete pomocí next_offset.
  • Obsah souborů je označený jako data; aplikace nemá následovat pokyny v něm obsažené.
Parametry nástroje hosting_read_file
ParametrTypPovinnýPopis
spaceCelé číslopovinnýDesetimístné Space-ID.
projectCelé číslopovinnýČíslo projektu z hosting_list_projects.
pathTextpovinnýCesta k souboru, nejvýše 240 znaků; platí pravidla pro cesty. Cesty verze uvádí hosting_list_files.
deployCelé číslovolitelnýČíslo verze tohoto projektu. Pokud chybí, nástroj použije koncept, jinak publikovanou verzi.
offsetCelé číslovolitelnýZačátek čtení ve znacích. Výchozí hodnota je 0; pokračujete pomocí next_offset z předchozí odpovědi.
lengthCelé číslovolitelnýNejvyšší počet znaků v odpovědi. Výchozí i maximální hodnota: 40 000.

Pro cesty platí tato pravidla

Tato pravidla platí pro hosting_put_files, hosting_delete_files a hosting_read_file:

  • Cesta je relativní a používá lomítka. Neobsahuje zpětné lomítko ani řídicí znaky.
  • Má nejvýše 240 znaků a nejvýše 12 úrovní.
  • Každý název v ní má nejvýše 100 znaků a nemá prázdné znaky na začátku ani na konci.
  • Žádný název nezačíná tečkou. Výjimkou je složka .well-known v nejvyšší složce.

V archivu TEISENDA přeskakuje položky, které porušují tato pravidla.

Ověřte limity souborů a tarifu

Platí limity souborů Connectoru a limity tarifů. Úložiště započítává všechny verze, koncepty a zálohy; smazané verze už se nepočítají.

Příliš velká verze se při dokončení zahodí; starší verze zůstávají. Balíčky úložiště jsou dostupné k objednanému předplatnému Max.

Když něco nefunguje

Pokud náprava uvádí nástroj, požádejte aplikaci o jeho volání. Pokud zpráva odkazuje na Tarify, použijte cestu k tarifu v nastavení Space.

Tarif tohoto Space umožňuje … nasazení, využito je …. Nic nebylo nahráno a nebyla vytvořena žádná verze. Tarif tohoto Space najdete v TEISENDA v části Nastavení › Tarify.

Tarif Space nedovoluje další publikování; ve Free jsou celkem tři. TEISENDA odmítne hosting_put_files a hosting_create_upload, nic nenahraje a nic nevytvoří. Opětovné publikování verze, která už někdy byla publikovaná, nespotřebovává publikování a zůstává možné: pomocí hosting_rollback nebo pomocí hosting_deploy s jejím číslem. Další publikování nabízí Max; viz Tarify Free a Max.

Úložiště tohoto Space je plné: využito … z …. Nic nebylo nahráno a nebyla vytvořena žádná verze. Nejprve smažte verze nebo zálohy. Tarif tohoto Space najdete v TEISENDA v části Nastavení › Tarify.

Úložiště Space je plné i po započítání místa, které by uvolnila nová verze. TEISENDA odmítne hosting_put_files, hosting_create_upload a hosting_deploy. Smažte verze nebo zálohy v TEISENDA. Více úložiště nabízí Max a jeho balíčky; viz Tarify Free a Max a Dokoupit a odebrat balíčky.

Argument … chybí nebo nemá očekávaný tvar.

Argument chybí nebo nemá očekávaný tvar; zpráva ho uvádí. Stejná zpráva se objeví při:

  • více než 200 souborech pro hosting_put_files (argument files),
  • více než 200 cestách pro hosting_delete_files (argument paths),
  • cestě s více než 240 znaky pro hosting_read_file (argument path),
  • prázdném seznamu.

Zavolejte nástroj znovu s argumentem ve tvaru uvedeném v jeho popisu.

Neexistuje žádná otevřená verze. Nejprve uložte soubory pomocí hosting_put_files.

Projekt nemá koncept, ze kterého by hosting_delete_files mohl mazat. Nejprve zapište soubory pomocí hosting_put_files.

Verze … v tomto projektu neexistuje.

Projekt nemá verzi s číslem uvedeným v argumentu deploy. Verze projektu zjistíte pomocí hosting_list_deploys.

Cesta není povolena. Cesty jsou relativní, používají / a nezačínají tečkou.

Cesta k souboru porušuje pravidla pro cesty. hosting_put_files pak nic nezapsal.hosting_delete_files už smazal soubory uvedené ve volání před odmítnutou cestou. Opravte cestu a zavolejte nástroj znovu; po hosting_delete_files pomocí hosting_list_files ověřte, co zůstalo.

To je na jedno volání příliš. Rozdělte soubory do několika volání.

Volání hosting_put_files obsahuje více než 3 MB souborů. Rozdělte soubory do více volání, nebo nahrajte archiv pomocí hosting_create_upload.

Soubor je příliš velký na to, aby se zde dal přečíst.

Soubor je větší než 200 KB. Takový soubor nelze číst přes Connector.

Soubor je příliš velký.

Jeden soubor je větší než 25 MB. Zmenšete soubor.

Verze je celkově příliš velká.

Celá verze je větší než 300 MB. Zmenšete web.

Verze obsahuje příliš mnoho souborů.

Verze obsahuje více než 5 000 souborů. Snižte počet souborů.

Projekt dosáhl nejvyššího počtu nasazení. Nejprve v TEISENDA smažte starší.

Hostingový uzel neotevře další verzi, protože už uchovává 20 verzí tohoto projektu, včetně verzí smazaných v TEISENDA, ale dosud neodebraných z uzlu. Pokud jste verze právě smazali, počkejte několik minut a zkuste to znovu. Jinak smažte starší verzi v aplikaci, v seznamu verzí na stránce projektu. Žádný nástroj Connectoru cíleně nemaže jednotlivou verzi.

Projekt je offline.

Projekt je offline. Hostingový uzel pak nevydává adresu nahrávání. Stejná zpráva se objeví pro každý projekt Space, který TEISENDA po konci předplatného pozastavila, i když přepínač samotného projektu není nastavený na offline; viz V pozastaveném Space nástroje pracují dál. Pokud je projekt přepnutý do režimu offline, přepněte ho zpět online pomocí hosting_set_offline. Pro pozastavený Space to nepomůže.

Projekt ještě nebyl přenesen na hostingový uzel.

TEISENDA projekt dosud nepřenesla na hostingový uzel, a proto nemůže přijímat soubory. Zjistěte stav pomocí hosting_project_status a zkuste to znovu, až uzel bude mít nastavení.

Hostingový uzel to odmítl.

Hostingový uzel odmítl něco, pro co TEISENDA nemá vlastní větu. Takto hosting_deploy_status a hosting_list_deploys zobrazují také problém verze po nepoužitelném archivu. Pak zavolejte hosting_create_upload znovu: volání použije stejnou verzi a vydá novou adresu. Jinak ověřte stav pomocí hosting_project_status; pokud problém trvá, obraťte se na podporu.

Tento soubor ve verzi neexistuje.

Verze neobsahuje soubor s cestou, kterou má číst hosting_read_file. Cesty zjistíte pomocí hosting_list_files.

Posun … leží za koncem seznamu (počet souborů ve verzi: …).

Hodnota offset pro hosting_list_files je za koncem seznamu. Začněte znovu s offset 0, nebo pokračujte s next_offset z předchozí odpovědi.

Posun … leží za koncem souboru (počet znaků: …).

Hodnota offset pro hosting_read_file je za koncem souboru. Začněte znovu s offset 0, nebo pokračujte s next_offset z předchozí odpovědi.

Zprávy ke Space a číslu projektu uvádějí nástroje pro Spaces a projekty. Další zprávy pro všechny nástroje uvádí návod Řešení problémů Connectoru.

Další kroky