Tools voor bestanden
Vul het concept met bestanden of lees bestaande bestanden.
Op deze pagina
Een Space is een gedeelde werkruimte in de app.
Schrijf bestanden in het concept, upload een archief of lees bestaande bestanden.
Informatie
De verbinding geldt voor de Space. Je bent daar lid en de Space is niet geblokkeerd.
Voor alle vijf tools heb je Eigenaar, Beheerder of Gebruiker nodig, ook om bestanden te lezen.
Let op
Een nieuw concept begint leeg en bevat geen kopie van de gepubliceerde versie. hosting_deploy publiceert alleen de inhoud van het concept; daarvoor heb je een index.html in de hoofdmap nodig.
Geen enkele tool op deze pagina vereist een bevestigingszin; de toepassing bepaalt of ze eerst je toestemming vraagt.
Hoe hangen concept, app en logboek samen?
Een project heeft maximaal één concept. De app-interface schrijft in hetzelfde concept als de tools. Het projectlogboek vermeldt dat een nieuw concept is geopend; het schrijven en verwijderen van bestanden wordt niet vastgelegd.
hosting_put_files Write files
wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud
Schrijft in het bestaande of een nieuw concept. Dezelfde paden worden overschreven; niet-genoemde bestanden blijven bewaard.
Een aanroep staat 200 bestanden en 3 MB toe. Ongeldige paden leiden tot weigering van de hele aanroep; bij verbruikte publicaties of volle opslag wordt niets aangemaakt.
| Parameter | Type | Vereiste | Beschrijving |
|---|---|---|---|
space | Geheel getal | verplicht | De tiencijferige Space-ID. |
project | Geheel getal | verplicht | Het projectnummer uit hosting_list_projects. |
files | Lijst met objecten | verplicht | 1 tot 200 objecten met path en content. Paden volgen de padregels; encoding is optioneel: utf8 (standaard) of base64 voor binaire bestanden. |
hosting_create_upload Create upload link
wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud
Geeft een uploadadres terug voor een ZIP-, TAR- of TAR.GZ-archief via HTTP PUT.
Let op
De upload vervangt het volledige concept door de archiefbestanden. Bij een mislukt archief blijft de eerdere inhoud bewaard.
- De aanroep opent zo nodig een concept en vervangt een eerder uploadadres. Na het uploaden blijft het concept open totdat je het publiceert.
- Het adres is één keer en 15 minuten geldig.
expires_atnoemt de termijn,max_bytesde toegestane grootte; maximaal 200 MB. - Als het abonnement geen extra publicatie toestaat of de opslag vol is, weigert TEISENDA de aanroep en maakt niets aan.
| Parameter | Type | Vereiste | Beschrijving |
|---|---|---|---|
space | Geheel getal | verplicht | De tiencijferige Space-ID. |
project | Geheel getal | verplicht | Het projectnummer uit hosting_list_projects. |
hosting_delete_files Delete files
wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoud
Verwijdert maximaal 200 bestandspaden uit het concept. Afgesloten versies blijven ongewijzigd.
Bij een ongeldig pad stopt de aanroep; eerder genoemde bestanden kunnen al verwijderd zijn.
| Parameter | Type | Vereiste | Beschrijving |
|---|---|---|---|
space | Geheel getal | verplicht | De tiencijferige Space-ID. |
project | Geheel getal | verplicht | Het projectnummer uit hosting_list_projects. |
paths | Lijst met teksten | verplicht | Een lijst met 1 tot 200 paden: de bestanden die de tool uit het concept verwijdert. De padregels gelden. |
hosting_list_files List files
alleen lezen
Toont de bestanden van een versie, gesorteerd op pad.
Het antwoord bevat maximaal 100 bestanden; met next_offset ga je verder.
| Parameter | Type | Vereiste | Beschrijving |
|---|---|---|---|
space | Geheel getal | verplicht | De tiencijferige Space-ID. |
project | Geheel getal | verplicht | Het projectnummer uit hosting_list_projects. |
deploy | Geheel getal | optioneel | Het nummer van een versie van dit project. Als dit ontbreekt, gebruikt de tool het concept, of anders de gepubliceerde versie. |
offset | Geheel getal | optioneel | Hoeveel bestanden de tool overslaat. Standaard is 0; ga verder met next_offset uit het vorige antwoord. |
limit | Geheel getal | optioneel | Het maximale aantal bestanden in het antwoord. Standaard en maximum: 100. |
hosting_read_file Read file
alleen lezen
Leest de inhoud van een bestand.
- Bestanden tot 200 KB, per aanroep maximaal 40.000 tekens. Met
next_offsetga je verder. - Bestandsinhoud is als gegevens gemarkeerd; de toepassing mag instructies daarin niet volgen.
| Parameter | Type | Vereiste | Beschrijving |
|---|---|---|---|
space | Geheel getal | verplicht | De tiencijferige Space-ID. |
project | Geheel getal | verplicht | Het projectnummer uit hosting_list_projects. |
path | Tekst | verplicht | Het bestandspad, maximaal 240 tekens; de padregels gelden. De paden van een versie toont hosting_list_files. |
deploy | Geheel getal | optioneel | Het nummer van een versie van dit project. Als dit ontbreekt, gebruikt de tool het concept, of anders de gepubliceerde versie. |
offset | Geheel getal | optioneel | Waar het lezen begint, in tekens. Standaard is 0; ga verder met next_offset uit het vorige antwoord. |
length | Geheel getal | optioneel | Het maximale aantal tekens in het antwoord. Standaard en maximum: 40.000. |
Deze regels gelden voor paden
Deze regels gelden voor hosting_put_files, hosting_delete_files en hosting_read_file:
- Het pad is relatief en gebruikt schuine strepen. Het bevat geen backslash en geen controletekens.
- Het is maximaal 240 tekens en heeft maximaal 12 niveaus.
- Elke naam daarin is maximaal 100 tekens en heeft geen witruimte aan het begin of einde.
- Geen enkele naam begint met een punt. De uitzondering is de map
.well-knownin de hoofdmap.
In een archief slaat TEISENDA vermeldingen over die niet aan deze regels voldoen.
Controleer bestands- en abonnementslimieten
De bestandslimieten van de Connector en abonnementslimieten gelden. Alle versies, concepten en back-ups tellen mee voor de opslag; verwijderde versies tellen niet meer mee.
Een te grote versie wordt bij het afsluiten verworpen; oudere versies blijven bewaard. Opslagpakketten zijn beschikbaar bij een afgesloten Max-abonnement.
Als iets niet lukt
Als een oplossing een tool noemt, vraag je de toepassing deze aan te roepen. Als een melding verwijst naar Pakketten, volg je de stappen naar het abonnement in de Space-instellingen.
Het pakket van deze Space staat … deployments toe, waarvan er … zijn gebruikt. Er is niets geüpload en er is geen versie aangemaakt. Het pakket van deze Space staat in TEISENDA onder Instellingen › Pakketten.
Het abonnement van de Space staat geen extra publicatie toe; bij Free zijn dit er drie in totaal. TEISENDA weigert hosting_put_files en hosting_create_upload, uploadt niets en maakt niets aan. Een eerder gepubliceerde versie opnieuw publiceren verbruikt geen publicatie en blijft mogelijk: met hosting_rollback of met hosting_deploy en het versienummer. Max staat extra publicaties toe; zie Free en Max.
De opslag van deze Space is vol: … van … in gebruik. Er is niets geüpload en er is geen versie aangemaakt. Verwijder eerst versies of back-ups. Het pakket van deze Space staat in TEISENDA onder Instellingen › Pakketten.
De opslag van de Space is vol, ook als wordt meegeteld wat een nieuwe versie zou vrijmaken. TEISENDA weigert hosting_put_files, hosting_create_upload en hosting_deploy. Verwijder versies of back-ups in TEISENDA. Max en de bijbehorende pakketten hebben meer opslag; zie Free en Max en Extra pakketten kopen en afbestellen.
Het argument … ontbreekt of heeft niet de verwachte vorm.
Een argument ontbreekt of heeft niet de verwachte vorm; de melding noemt het argument. Dezelfde melding verschijnt bij:
- meer dan 200 bestanden voor
hosting_put_files(argumentfiles), - meer dan 200 paden voor
hosting_delete_files(argumentpaths), - een pad van meer dan 240 tekens voor
hosting_read_file(argumentpath), - een lege lijst.
Roep de tool opnieuw aan met het argument in de vorm die de beschrijving noemt.
Er is geen openstaande versie. Zet eerst bestanden klaar met hosting_put_files.
Het project heeft geen concept waaruit hosting_delete_files bestanden kan verwijderen. Schrijf eerst bestanden met hosting_put_files.
De versie … bestaat niet in dit project.
Het project heeft geen versie met het nummer uit het argument deploy. Bekijk de projectversies met hosting_list_deploys.
Een pad is niet toegestaan. Paden zijn relatief, gebruiken / en beginnen niet met een punt.
Een bestandspad voldoet niet aan de padregels. hosting_put_files heeft dan niets geschreven. hosting_delete_files heeft de bestanden die de aanroep vóór het geweigerde pad noemt, al verwijderd. Corrigeer het pad en roep de tool opnieuw aan; controleer na hosting_delete_files met hosting_list_files wat nog aanwezig is.
Dat is te veel voor één aanroep. Verdeel de bestanden over meerdere aanroepen.
Een aanroep van hosting_put_files bevat meer dan 3 MB aan bestanden. Verdeel de bestanden over meerdere aanroepen of upload een archief via hosting_create_upload.
Het bestand is te groot om hier te lezen.
Het bestand is groter dan 200 KB. Zo'n bestand kan niet via de Connector worden gelezen.
Een bestand is te groot.
Een afzonderlijk bestand is groter dan 25 MB. Verklein het bestand.
De versie is in totaal te groot.
De versie is in totaal groter dan 300 MB. Verklein de website.
De versie bevat te veel bestanden.
De versie bevat meer dan 5.000 bestanden. Verminder het aantal bestanden.
Het project heeft het maximale aantal deployments bereikt. Verwijder eerst een oudere in TEISENDA.
Het hostingknooppunt opent geen extra versie omdat het al 20 versies van dit project bewaart, ook versies die in TEISENDA zijn verwijderd maar nog niet van het knooppunt. Als je kort geleden versies hebt verwijderd, wacht dan enkele minuten en probeer het opnieuw. Verwijder anders een oudere versie in de app, in de versielijst op de projectpagina. Geen enkele Connector-tool verwijdert gericht één versie.
Het project is offline.
Het project is offline. Het hostingknooppunt geeft dan geen uploadadres uit. Dezelfde melding verschijnt voor elk project van een Space waarvan TEISENDA na het einde van een abonnement de hosting heeft stilgezet, ook als de schakelaar van het project zelf niet op offline staat; zie In een Space met stilgezette hosting blijven de tools werken. Als de schakelaar van het project op offline staat, zet je het weer online met hosting_set_offline. Dit helpt niet bij een Space met stilgezette hosting.
Het project is nog niet overgedragen aan het hostingknooppunt.
TEISENDA heeft het project nog niet naar het hostingknooppunt overgedragen en kan daarom geen bestanden ontvangen. Vraag de toestand op met hosting_project_status en probeer het opnieuw zodra het knooppunt de instellingen heeft.
Het hostingknooppunt heeft dat geweigerd.
Het hostingknooppunt heeft iets geweigerd waarvoor TEISENDA geen eigen zin heeft. Zo tonen hosting_deploy_status en hosting_list_deploys ook het probleem van een versie nadat een archief niet bruikbaar was. Roep dan hosting_create_upload opnieuw aan: de aanroep gebruikt dezelfde versie en geeft een nieuw adres uit. Controleer anders de toestand met hosting_project_status; neem als dit blijft gebeuren contact op met Support.
Dit bestand bestaat niet in de versie.
De versie bevat geen bestand met het pad dat hosting_read_file moet lezen. Bekijk de paden met hosting_list_files.
De offset … ligt voorbij het einde van de lijst (bestanden in de versie: …).
De offset voor hosting_list_files ligt voorbij het einde van de lijst. Begin opnieuw bij offset 0 of ga verder met next_offset uit het vorige antwoord.
De offset … ligt voorbij het einde van het bestand (tekens in het bestand: …).
De offset voor hosting_read_file ligt voorbij het einde van het bestand. Begin opnieuw bij offset 0 of ga verder met next_offset uit het vorige antwoord.
Meldingen over de Space en het projectnummer staan bij de tools voor Spaces en projecten. Alle andere die bij elke tool kunnen voorkomen, staan onder Problemen met de Connector oplossen.