Værktøjer til filer
Skriv og læs filer, og kend konsekvenserne af et arkivupload.
På denne side
Skriv filer i kladden, upload et arkiv, eller læs eksisterende filer.
Information
Forbindelsen gælder for dit Space. Du er medlem dér, og det er ikke spærret.
Alle fem værktøjer kræver Ejer, Administrator eller Bruger, også til læsning af filer.
Advarsel
En ny kladde starter tom og indeholder ingen kopi af den publicerede version. hosting_deploy publicerer kun kladdens indhold; det kræver en index.html i den øverste mappe.
Intet værktøj på denne side kræver en bekræftelsessætning; applikationen afgør, om den spørger dig først.
Hvordan hænger kladde, app og log sammen?
Et projekt har højst én kladde. Appens brugerflade skriver i samme kladde som værktøjerne. Projektloggen registrerer, at en ny kladde er åbnet; den registrerer ikke skrivning og sletning af filer.
hosting_put_files Write files
ændrer datasletter, overskriver eller ændrer synligt indhold
Skriver i den eksisterende eller en ny kladde. Ens stier overskrives; filer, der ikke nævnes, bevares.
Et kald tillader 200 filer og 3 MB. Ugyldige stier afviser hele kaldet; hvis publiceringerne er brugt eller lageret er fyldt, oprettes intet.
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
space | Heltal | påkrævet | Det ticifrede Space-ID. |
project | Heltal | påkrævet | Projektnummeret fra hosting_list_projects. |
files | Liste med objekter | påkrævet | 1 til 200 objekter med path og content. Stier følger stireglerne; encoding er valgfri: utf8 (standard) eller base64 til binære filer. |
hosting_create_upload Create upload link
ændrer datasletter, overskriver eller ændrer synligt indhold
Udsteder en uploadadresse til et ZIP-, TAR- eller TAR.GZ-arkiv via HTTP PUT.
Advarsel
Upload erstatter hele kladden med arkivets filer. Hvis arkivet mislykkes, bevares det tidligere indhold.
- Kaldet åbner om nødvendigt en kladde og erstatter en tidligere uploadadresse. Efter upload forbliver kladden åben, indtil du publicerer den.
- Adressen gælder én gang og i 15 minutter.
expires_atangiver fristen ogmax_bytesden tilladte størrelse; højst 200 MB. - Hvis planen ikke tillader flere publiceringer, eller lageret er fyldt, afviser TEISENDA kaldet og opretter intet.
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
space | Heltal | påkrævet | Det ticifrede Space-ID. |
project | Heltal | påkrævet | Projektnummeret fra hosting_list_projects. |
hosting_delete_files Delete files
ændrer datasletter, overskriver eller ændrer synligt indhold
Sletter op til 200 filstier fra kladden. Afsluttede versioner bevares uændret.
Ved en ugyldig sti stopper kaldet; tidligere nævnte filer kan allerede være slettet.
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
space | Heltal | påkrævet | Det ticifrede Space-ID. |
project | Heltal | påkrævet | Projektnummeret fra hosting_list_projects. |
paths | Liste med tekster | påkrævet | En liste med 1 til 200 stier: de filer, som værktøjet sletter fra kladden. Stireglerne gælder. |
hosting_list_files List files
læser kun
Viser en versions filer sorteret efter sti.
Svaret indeholder højst 100 filer; fortsæt med next_offset.
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
space | Heltal | påkrævet | Det ticifrede Space-ID. |
project | Heltal | påkrævet | Projektnummeret fra hosting_list_projects. |
deploy | Heltal | valgfri | Nummeret på en version i dette projekt. Hvis det mangler, bruger værktøjet kladden, ellers den publicerede version. |
offset | Heltal | valgfri | Hvor mange filer værktøjet springer over. 0 er standard; fortsæt med next_offset fra det forrige svar. |
limit | Heltal | valgfri | Det maksimale antal filer i svaret. Standard og maksimum: 100. |
hosting_read_file Read file
læser kun
Læser en fils indhold.
- Filer op til 200 KB, højst 40.000 tegn pr. kald. Fortsæt med
next_offset. - Filindhold markeres som data; applikationen skal ikke følge instruktioner i det.
| Parameter | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
space | Heltal | påkrævet | Det ticifrede Space-ID. |
project | Heltal | påkrævet | Projektnummeret fra hosting_list_projects. |
path | Tekst | påkrævet | Filens sti med højst 240 tegn; stireglerne gælder. En versions stier vises af hosting_list_files. |
deploy | Heltal | valgfri | Nummeret på en version i dette projekt. Hvis det mangler, bruger værktøjet kladden, ellers den publicerede version. |
offset | Heltal | valgfri | Hvor læsningen begynder, i tegn. 0 er standard; fortsæt med next_offset fra det forrige svar. |
length | Heltal | valgfri | Det maksimale antal tegn i svaret. Standard og maksimum: 40.000. |
Disse regler gælder for stier
Reglerne gælder for hosting_put_files, hosting_delete_files og hosting_read_file:
- Stien er relativ og bruger skråstreger. Den indeholder ingen omvendte skråstreger eller kontroltegn.
- Den har højst 240 tegn og højst 12 niveauer.
- Hvert navn i stien har højst 100 tegn og ingen blanktegn i begyndelsen eller slutningen.
- Intet navn begynder med et punktum. Undtagelsen er mappen
.well-knowni den øverste mappe.
I et arkiv springer TEISENDA indgange over, der bryder disse regler.
Kontrollér fil- og plangrænser
Der gælder Connectors filgrænser og plangrænser. Lagerforbruget tæller alle versioner, kladder og backups; slettede versioner tæller ikke længere.
En version, der er for stor, forkastes ved afslutning; ældre versioner bevares. Lagerpakker findes til et bestilt Max-abonnement.
Hvis noget ikke virker
Hvis løsningen nævner et værktøj, skal du bede applikationen kalde det. Hvis en besked henviser til Planer, skal du følge vejen til planen i indstillingerne for dit Space.
Planen for dette Space tillader … udrulninger, og … er brugt. Intet blev uploadet, og der blev ikke oprettet nogen version. Planen for dette Space vises i TEISENDA under Indstillinger › Planer.
Planen for dit Space tillader ingen ny publicering; i Free er det tre i alt. TEISENDA afviser hosting_put_files og hosting_create_upload, uploader intet og opretter intet. Genpublicering af en tidligere publiceret version bruger ingen publicering og er fortsat mulig: med hosting_rollback eller med hosting_deploy og dens nummer. Max tillader flere publiceringer; se Planerne Free og Max.
Lageret for dette Space er fyldt: … af … er brugt. Intet blev uploadet, og der blev ikke oprettet nogen version. Slet først versioner eller backups. Planen for dette Space vises i TEISENDA under Indstillinger › Planer.
Lageret for dit Space er fyldt, også når pladsen, en ny version ville frigøre, medregnes. TEISENDA afviser hosting_put_files, hosting_create_upload og hosting_deploy. Slet versioner eller backups i TEISENDA. Max og tilhørende pakker har mere lagerplads; se Planerne Free og Max og Køb og afbestil pakker.
Argumentet … mangler eller har ikke den forventede form.
Et argument mangler eller har ikke den forventede form; beskeden angiver det. Samme besked vises ved:
- mere end 200 filer til
hosting_put_files(argumentfiles), - mere end 200 stier til
hosting_delete_files(argumentpaths), - en sti med mere end 240 tegn til
hosting_read_file(argumentpath), - en tom liste.
Kald værktøjet igen med argumentet i den form, som beskrivelsen angiver.
Der er ingen åben version. Læg først filer ind med hosting_put_files.
Projektet har ingen kladde, som hosting_delete_files kan slette fra. Skriv først filer med hosting_put_files.
Versionen … findes ikke i dette projekt.
Projektet har ingen version med nummeret fra argumentet deploy. Se projektets versioner med hosting_list_deploys.
En sti er ikke tilladt. Stier er relative, bruger / og begynder ikke med et punktum.
En filsti bryder stireglerne. hosting_put_files skrev da intet. hosting_delete_files slettede allerede de filer, som kaldet nævner før den afviste sti. Ret stien, og kald værktøjet igen; kontrollér efter hosting_delete_files med hosting_list_files, hvad der er tilbage.
Det er for meget til ét kald. Del filerne op på flere kald.
Et kald af hosting_put_files indeholder mere end 3 MB filer. Fordel filerne på flere kald, eller upload et arkiv via hosting_create_upload.
Filen er for stor til at blive læst her.
Filen er større end 200 KB. Sådan en fil kan ikke læses via Connector.
En fil er for stor.
En enkelt fil er større end 25 MB. Gør filen mindre.
Versionen er samlet set for stor.
Versionen er samlet større end 300 MB. Gør websitet mindre.
Versionen indeholder for mange filer.
Versionen indeholder mere end 5.000 filer. Reducer antallet af filer.
Projektet har nået det højeste antal udrulninger. Slet først en ældre i TEISENDA.
Hostingnoden åbner ingen ny version, fordi den allerede har 20 versioner af projektet, også dem, der er slettet i TEISENDA, men endnu ikke fjernet fra noden. Hvis du lige har slettet versioner, skal du vente et par minutter og prøve igen. Slet ellers en ældre version i appens versionsliste på projektsiden. Intet Connector-værktøj sletter målrettet en enkelt version.
Projektet er offline.
Projektet er offline. Hostingnoden udsteder da ingen uploadadresse. Samme besked vises for alle projekter i et Space, som TEISENDA har sat på pause efter et abonnements ophør, selvom selve projektet ikke er sat offline; se Værktøjerne kører fortsat i et Space på pause. Hvis selve projektet er sat offline, skal du sætte det online igen med hosting_set_offline. Det hjælper ikke ved et Space på pause.
Projektet er endnu ikke overført til hostingknuden.
TEISENDA har endnu ikke overført projektet til hostingnoden og kan derfor ikke modtage filer. Spørg med hosting_project_status og prøv igen, når noden har indstillingerne.
Hostingknuden har afvist det.
Hostingnoden afviste noget, som TEISENDA ikke har en særlig sætning for. Sådan viser hosting_deploy_status og hosting_list_deploys også en versions problem efter et ubrugeligt arkiv. Kald da hosting_create_upload igen: Kaldet bruger samme version og udsteder en ny adresse. Kontrollér ellers tilstanden med hosting_project_status; kontakt support, hvis det fortsætter.
Denne fil findes ikke i versionen.
Versionen indeholder ingen fil med den sti, som hosting_read_file skal læse. Se stierne med hosting_list_files.
Forskydningen … ligger efter listens slutning (filer i versionen: …).
Værdien offset til hosting_list_files ligger efter listens slutning. Begynd igen ved offset 0, eller fortsæt med next_offset fra det forrige svar.
Forskydningen … ligger efter filens slutning (tegn i filen: …).
Værdien offset til hosting_read_file ligger efter filens slutning. Begynd igen ved offset 0, eller fortsæt med next_offset fra det forrige svar.
Beskeder om Space og projektnummer står ved værktøjerne til Spaces og projekter. Alle andre beskeder, der kan forekomme ved hvert værktøj, står under Løs problemer med Connector.