Verktøy for filer
Du skriver og leser filer og kjenner konsekvensene av en arkivopplasting.
På denne siden
Skriv filer i utkastet, last opp et arkiv eller les eksisterende filer.
Informasjon
Forbindelsen gjelder for Space. Du er medlem der, og Space er ikke sperret.
For alle fem verktøy trenger du Eier, Administrator eller Bruker, også for å lese filer.
Advarsel
Et nytt utkast begynner tomt og inneholder ingen kopi av den publiserte versjonen. hosting_deploy publiserer bare innholdet i det; dette krever en index.html i rotmappen.
Ingen verktøy på denne siden krever en bekreftelsessetning; applikasjonen bestemmer om den spør deg først.
Hvordan henger utkast, app og logg sammen?
Et prosjekt har maksimalt ett utkast. Appens overflate skriver i det samme som verktøyene. Prosjektloggen registrerer at et nytt utkast er åpnet; den registrerer ikke skriving og sletting av filer.
hosting_put_files Write files
endrer datasletter, overskriver eller endrer synlig innhold
Skriver i det eksisterende utkastet eller et nytt. Identiske stier overskrives; filer som ikke er oppgitt, beholdes.
Ett kall tillater 200 filer og 3 MB. Ugyldige stier avviser hele kallet; hvis publiseringene er brukt opp eller lagringsplassen er full, opprettes ingenting.
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
space | Heltall | påkrevd | Den tisifrede Space-ID-en. |
project | Heltall | påkrevd | Prosjektnummeret fra hosting_list_projects. |
files | Liste med objekter | påkrevd | 1 til 200 objekter med path og content. Stier følger stireglene; encoding er valgfritt: utf8 (standard) eller base64 for binærfiler. |
hosting_create_upload Create upload link
endrer datasletter, overskriver eller endrer synlig innhold
Gir en opplastingsadresse for et ZIP-, TAR- eller TAR.GZ-arkiv via HTTP PUT.
Advarsel
Opplastingen erstatter hele utkastet med arkivfilene. Hvis arkivet mislykkes, beholdes det tidligere innholdet.
- Kallet åpner et utkast ved behov og erstatter en tidligere opplastingsadresse. Etter opplasting forblir utkastet åpent til du publiserer det.
- Adressen gjelder én gang og i 15 minutter.
expires_atoppgir fristen,max_bytesden tillatte størrelsen; maksimalt 200 MB. - Hvis abonnementstypen ikke tillater en ny publisering eller lagringsplassen er full, avviser TEISENDA kallet og oppretter ingenting.
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
space | Heltall | påkrevd | Den tisifrede Space-ID-en. |
project | Heltall | påkrevd | Prosjektnummeret fra hosting_list_projects. |
hosting_delete_files Delete files
endrer datasletter, overskriver eller endrer synlig innhold
Sletter opptil 200 filstier fra utkastet. Ferdigstilte versjoner forblir uendret.
Ved ugyldig sti stopper kallet; filer oppgitt tidligere kan allerede være slettet.
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
space | Heltall | påkrevd | Den tisifrede Space-ID-en. |
project | Heltall | påkrevd | Prosjektnummeret fra hosting_list_projects. |
paths | Liste med tekster | påkrevd | En liste med 1 til 200 stier: filene verktøyet sletter fra utkastet. Følgende gjelder: Regler for stier. |
hosting_list_files List files
leser bare
Lister filene i en versjon sortert etter sti.
Svaret inneholder maksimalt 100 filer; fortsett med next_offset .
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
space | Heltall | påkrevd | Den tisifrede Space-ID-en. |
project | Heltall | påkrevd | Prosjektnummeret fra hosting_list_projects. |
deploy | Heltall | valgfri | Nummeret til en versjon av dette prosjektet. Hvis det mangler, velger verktøyet utkastet, ellers den publiserte versjonen. |
offset | Heltall | valgfri | Hvor mange filer verktøyet hopper over. Standard er 0; fortsett med next_offset fra forrige svar. |
limit | Heltall | valgfri | Maksimalt antall filer i svaret. Standard og maksimalverdi: 100. |
hosting_read_file Read file
leser bare
Leser innholdet i en fil.
- Filer på opptil 200 KB, maksimalt 40 000 tegn per kall. Fortsett med
next_offset. - Filinnhold er merket som data; applikasjonen skal ikke følge instruksjoner i det.
| Parameter | Type | Påkrevd | Beskrivelse |
|---|---|---|---|
space | Heltall | påkrevd | Den tisifrede Space-ID-en. |
project | Heltall | påkrevd | Prosjektnummeret fra hosting_list_projects. |
path | Tekst | påkrevd | Filens sti, maksimalt 240 tegn; følgende gjelder: Regler for stier. Stiene i en versjon vises av hosting_list_files. |
deploy | Heltall | valgfri | Nummeret til en versjon av dette prosjektet. Hvis det mangler, velger verktøyet utkastet, ellers den publiserte versjonen. |
offset | Heltall | valgfri | Hvor lesingen begynner, i tegn. Standard er 0; fortsett med next_offset fra forrige svar. |
length | Heltall | valgfri | Maksimalt antall tegn i svaret. Standard og maksimalverdi: 40 000. |
Disse reglene gjelder for stier
Disse reglene gjelder for hosting_put_files, hosting_delete_files og hosting_read_file:
- Stien er relativ og bruker skråstreker. Den inneholder ingen omvendt skråstrek eller kontrolltegn.
- Den har maksimalt 240 tegn og maksimalt 12 nivåer.
- Hvert navn i den har maksimalt 100 tegn og ingen blanktegn først eller sist.
- Ingen navn begynner med et punktum. Unntaket er mappen
.well-knowni rotmappen.
I et arkiv hopper TEISENDA over oppføringer som bryter disse reglene.
Kontroller fil- og abonnementsgrenser
Følgende gjelder: Connectorens filgrenser og grenser for abonnementstypen. Lagringsplassen teller alle versjoner, utkast og sikkerhetskopier; slettede versjoner teller ikke lenger.
En for stor versjon forkastes ved ferdigstilling; eldre versjoner beholdes. Lagringspakker finnes for et bestilt Max-abonnement.
Hvis noe ikke virker
Når en løsning nevner et verktøy, ber du applikasjonen kalle det. Hvis en melding viser til Planer, følger du veien til abonnementstypen i Space-innstillingene.
Planen for dette Space tillater … utrullinger, og … er brukt. Ingenting ble lastet opp, og ingen versjon ble opprettet. Planen for dette Space vises i TEISENDA under Innstillinger › Planer.
Abonnementstypen i Space tillater ikke en ny publisering; med Free er det tre totalt. TEISENDA avviser hosting_put_files og hosting_create_upload og laster ikke opp eller oppretter noe. Å publisere en tidligere publisert versjon på nytt bruker ingen publisering og er fortsatt mulig: med hosting_rollback eller med hosting_deploy og dens nummer. Max gir flere publiseringer; se Free og Max.
Lagringen for dette Space er full: … av … er brukt. Ingenting ble lastet opp, og ingen versjon ble opprettet. Slett først versjoner eller backuper. Planen for dette Space vises i TEISENDA under Innstillinger › Planer.
Lagringsplassen i Space er full, også når det som ville bli frigjort av en ny versjon, regnes med. TEISENDA avviser hosting_put_files, hosting_create_upload og hosting_deploy . Slett versjoner eller sikkerhetskopier i TEISENDA. Max og pakkene gir mer lagringsplass; se Free og Max og Kjøp og si opp tilleggspakker.
Argumentet … mangler eller har ikke forventet form.
Et argument mangler eller har ikke forventet form; meldingen oppgir hvilket. Samme melding kommer ved:
- mer enn 200 filer for
hosting_put_files(argumentfiles), - mer enn 200 stier for
hosting_delete_files(argumentpaths), - en sti med mer enn 240 tegn for
hosting_read_file(argumentpath), - en tom liste.
Kall verktøyet på nytt med argumentet i formen beskrivelsen oppgir.
Det finnes ingen åpen versjon. Legg først inn filer med hosting_put_files.
Prosjektet har ikke et utkast som hosting_delete_files kan slette fra. Skriv først filer med hosting_put_files.
Versjonen … finnes ikke i dette prosjektet.
Prosjektet har ingen versjon med nummeret argumentet deploy oppgir. Se prosjektets versjoner med hosting_list_deploys .
En sti er ikke tillatt. Stier er relative, bruker / og begynner ikke med et punktum.
En filsti bryter reglene for stier. hosting_put_files har da ikke skrevet noe. hosting_delete_files har allerede slettet filene kallet oppgir før den avviste stien. Rett stien og kall verktøyet på nytt; kontroller etter hosting_delete_files med hosting_list_fileshva som fortsatt finnes.
Det er for mye for ett kall. Del filene opp på flere kall.
Et kall til hosting_put_files inneholder mer enn 3 MB filer. Fordel filene på flere kall, eller last opp et arkiv via hosting_create_upload .
Filen er for stor til å leses her.
Filen er større enn 200 KB. En slik fil kan ikke leses gjennom connectoren.
En fil er for stor.
Én fil er større enn 25 MB. Gjør filen mindre.
Versjonen er for stor totalt sett.
Versjonen er totalt større enn 300 MB. Gjør nettstedet mindre.
Versjonen inneholder for mange filer.
Versjonen inneholder mer enn 5 000 filer. Reduser antallet filer.
Prosjektet har nådd det høyeste antallet utrullinger. Slett først en eldre i TEISENDA.
Hostingnoden åpner ingen ny versjon fordi den allerede har 20 versjoner av dette prosjektet, også dem som er slettet i TEISENDA, men ennå ikke fjernet på noden. Hvis du nylig har slettet versjoner, vent noen minutter og prøv igjen. Ellers slett en eldre versjon i appen, i versjonslisten på prosjektsiden. Ingen verktøy i connectoren sletter én bestemt versjon.
Prosjektet er offline.
Prosjektet er frakoblet. Hostingnoden gir da ikke ut en opplastingsadresse. Samme melding kommer for alle prosjekter i et Space som TEISENDA har stanset etter slutten på et abonnement, selv om selve prosjektets bryter ikke står på frakoblet; se Verktøyene fortsetter å kjøre i et stanset Space. Hvis prosjektets bryter står på frakoblet, setter du det på nett igjen med hosting_set_offline . Dette hjelper ikke mot et stanset Space.
Prosjektet er ennå ikke overført til hostingnoden.
TEISENDA har ennå ikke overført prosjektet til hostingnoden og kan derfor ikke ta imot filer. Spør med hosting_project_status og prøv igjen så snart noden har innstillingene.
Hostingnoden avviste det.
Hostingnoden avviste noe TEISENDA ikke har en egen setning for. Slik viser hosting_deploy_status og hosting_list_deploys også problemet med en versjon etter at et arkiv ikke kunne brukes. Kall da hosting_create_upload på nytt: Kallet tar samme versjon og gir en ny adresse. Ellers kontrollerer du tilstanden med hosting_project_status; hvis det fortsetter, kontakt kundestøtte.
Denne filen finnes ikke i versjonen.
Versjonen inneholder ingen fil med stien hosting_read_file skal lese. Se stiene med hosting_list_files .
Forskyvningen … ligger etter slutten på listen (filer i versjonen: …).
offset for hosting_list_files ligger etter slutten av listen. Begynn igjen ved offset 0 eller fortsett med next_offset fra forrige svar.
Forskyvningen … ligger etter slutten på filen (tegn i filen: …).
offset for hosting_read_file ligger etter slutten av filen. Begynn igjen ved offset 0 eller fortsett med next_offset fra forrige svar.
Meldinger om Space og prosjektnummer finnes ved verktøyene for Spaces og prosjekter. Alle andre som kan forekomme ved hvert verktøy, finnes under Løs problemer med connectoren.