Connectorin työkalut
Löydät kunkin työkalun vaikutukset, rajat ja parametrit.
Tällä sivulla
Löydä sopiva työkalu ja sen parametrit. Kukin hosting-työkalu toimii täsmälleen yhdessä Spacessa.
Tietoa
Sovellus on yhdistetty TEISENDA-tiliisi eikä yhteyttä ole päätetty; ohjeet: Claude ja ChatGPT.
Hosting-työkalun yhteys koskee kutsussa annettua Spacea. Olet sen jäsen eikä Space ole lukittu.
Roolisi Spacessa sallii työkalun.
Argumentti space määrittää Spacen
Jokainen hosting-työkalu vaatii argumentin space: kymmennumeroisen Space-ID:n. whoami ei ota argumentteja.
Sovelluksen tulee valita Space työkalun whoami tuloksesta tai antamastasi tiedosta ja kysyä, jos mahdollisia Spaceja on useita.
TEISENDA tarkistaa itse jokaisella kutsulla, kuuluuko Space yhteyteen ja oletko sen jäsen. Työkalu toimii vain tässä yhdessä Spacessa.
Minkä arvon space hyväksyy?
Kymmennumeroisen kokonaisluvun tai täsmälleen kymmenestä numerosta koostuvan tekstin. TEISENDA vastaa muihin arvoihin kuin puuttuvaan Spaceen, esimerkiksi lyhyempään tai pidempään numeroon. Jos kymmenen numeroa ei vastaa yhteyden Spacea, TEISENDA ilmoittaa, ettei Space kuulu yhteyteen. Molemmat ilmoitukset ovat kohdassa Space-työkalu.
Hosting-työkalun tulos kertoo ensin Spacen
Tulos kertoo ensin Space-ID:n ja näyttönimen. Tarkista ne; väärän Spacen kohdalla sovelluksen tulee ohjeidensa mukaan pysähtyä.
Jos näkyy Tallennettu, mutta sitä ei ole vielä siirretty hosting-solmuun:, muutos on tallennettu mutta sitä ei ole vielä lähetetty. Tarkista tila myöhemmin työkalulla hosting_project_status .
Milloin tulos ei ole virhe, vaikka jotain vielä puuttuu?
Joitakin tuloksia ei merkitä virheiksi: työkalu teki mahdollisen ja kertoo puuttuvan osan. Näin on, jos annettu versio on jo julkaistu, verkkotunnuksen DNS ei vielä ole oikein, projekti on poistettu mutta hosting-solmu ei ole vahvistanut sitä tai kaksivaiheisen työkalun vastaus pyytää vahvistuslausetta.
Mitä työkalu muuttaa TEISENDAssa ja mistä näen sen?
Jokainen työkalu kutsuu samoja palveluita kuin sovelluksen käyttöliittymä samoilla oikeuksilla ja rajoilla. Työkalun muutos näkyy TEISENDAssa kuin olisit tehnyt sen käyttöliittymässä.
Projektin loki kirjaa muutokset kanavalla Yhdistetty sovellus, kun toiminto luo lokirivin. Lukevat työkalut eivät kirjoita riviä. Tiedostoja kirjoitettaessa tai poistettaessa kirjataan vain uuden luonnoksen avaaminen.
Roolisi sallii työkalun
Omistaja, Järjestelmänvalvoja ja Käyttäjä saavat kutsua kaikkia hosting-työkaluja. Vain luku saa käyttää vain viittä lukevaa hosting-työkalua; luettelo on kohdassa Käyttöoikeudet.
Työkaluluettelo näyttää myös rooliltasi kielletyt työkalut. Oikeus tarkistetaan kutsun yhteydessä.
Lukitussa Spacessa mikään hosting-työkalu ei toimi
whoami näyttää lukitun Spacen edelleen ja merkitsee sen lukituksi, mutta mikään hosting-työkalu ei toimi siinä. Yhteys, jonka kaikki Spacet ovat lukittuja, tarjoaa sovellukselle vain työkalun whoami . Korjausohje on kohdassa Space-työkalu; lukituksista kerrotaan lisää kohdassa Tutustu Spaceihin.
Tunnisteet kertovat, lukeeko työkalu vai muuttaako se jotain
Tunnisteet ovat työkalun kohdalla ja alla olevassa luettelossa.
| Tunniste | Merkitys |
|---|---|
| „vain lukee“ | Työkalu ei muuta mitään, ei kirjoita sovelluksessa näkyvää lokiriviä ja voidaan toistaa ilman vaikutusta. Tämä koskee seitsemää hosting-työkalua ja työkalua whoami. |
| „muuttaa tietoja“ | Työkalu muuttaa jotain. Tämä koskee muita 16 hosting-työkalua. |
| „poistaa, korvaa tai muuttaa näkyvää sisältöä“ | Työkalu poistaa, korvaa tai muuttaa verkkosivuston vierailijoiden näkemää sisältöä. Tunniste ei tarkoita, että työkalu poistaisi; vaikutus kerrotaan sen osiossa. |
| „kaksi vaihetta“ | Työkalu vaatii vahvistuslauseen. |
Kolme työkalua vaatii vahvistuslauseen
hosting_delete_project, hosting_remove_domain ja julkiseksi vaihtaminen työkalulla hosting_set_visibility toimivat kahdessa vaiheessa: ilman parametria confirm vastaus kertoo seurauksen ja lauseen; vasta kutsu tällä lauseella suorittaa toiminnon.
Sovelluksen tulee pyytää suostumuksesi ensin. Tarkista projekti ja Space; Käyttöoikeudet selittää menettelyn.
Varoitus
Kaikki muut työkalut toimivat ensimmäisellä kutsulla, myös verkkosivustoa poistettaessa, korvattaessa tai muutettaessa. Sovelluksen vahvistuspyyntöä ei taata.
Työkalut käyttävät joistakin asioista eri nimiä
Työkalujen kuvaukset ovat englanniksi. Niiden saksankieliset vastaukset käyttävät joistakin asioista eri nimiä kuin tämä dokumentaatio. Seuraava taulukko kertoo saksankielisten vastausten käsitteet.
| Saksankielisissä vastauksissa | Tässä dokumentaatiossa |
|---|---|
„Stand“, „Deployment“; parametrina deploy |
Versio. Työkalut käyttävät tätä myös luonnoksesta. |
„Deployment“ paketin laskennassa; kenttänä deployments |
Julkaisu: version ensimmäinen julkaisukerta kuluttaa yhden. Aiemmin julkaistun version julkaiseminen uudelleen ei kuluta julkaisua. |
| „offener Stand“ | Luonnos: sen tiedostoja voi vielä muuttaa eikä se ole julkaistu. Projektilla on enintään yksi. |
| „abgeschlossen“ | Valmis versio: jokainen tarkistettu versio, jota ei voi enää muuttaa, riippumatta julkaisemisesta. |
| „fertig, aber nicht veröffentlicht“ | Julkaisuvalmis versio: valmis versio, jota ei ole koskaan julkaistu. |
| „automatic address“ työkalujen kuvauksissa | TEISENDA-osoite: TEISENDAn itse projektille antama osoite. |
Jokaisella työkalulla on osio alasivulla
Nimi vie työkalun osioon parametreineen. Otsikot ovat englanniksi.
| Työkalu | Nimi | Ominaisuudet |
|---|---|---|
whoami | Show user and spaces | vain lukee |
hosting_list_projects | List projects | vain lukee |
hosting_create_project | Create project | muuttaa tietoja |
hosting_project_status | Project status | vain lukee |
hosting_rename_project | Rename project | muuttaa tietoja |
hosting_set_offline | Take project offline or online | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_delete_project | Delete project | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöäkaksi vaihetta |
hosting_put_files | Write files | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_delete_files | Delete files | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_list_files | List files | vain lukee |
hosting_read_file | Read file | vain lukee |
hosting_create_upload | Create upload link | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_deploy | Publish deployment | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_deploy_status | Deployment status | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_list_deploys | List deployments | vain lukee |
hosting_rollback | Roll back deployment | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_add_domain | Add domain | muuttaa tietoja |
hosting_check_domain | Check domain | muuttaa tietoja |
hosting_set_primary_domain | Set primary domain | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
hosting_remove_domain | Remove domain | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöäkaksi vaihetta |
hosting_get_visibility | Get visibility | vain lukee |
hosting_set_visibility | Set visibility | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöäkaksi vaihetta |
hosting_list_redirects | List redirects | vain lukee |
hosting_set_redirects | Set redirects | muuttaa tietojapoistaa, korvaa tai muuttaa näkyvää sisältöä |
Osa rajoista ja ilmoituksista koskee kaikkia kutsuja
Kutsu kestää enintään kaksi minuuttia ja pyyntö on enintään 8 Mt. Muut rajat ja virheohje koskevat kaikkia työkaluja.
Spacen paketin rajat kerrotaan työkaluissa, jotka koskevat projekteja, verkkotunnuksia, tiedostoja ja julkaisemista; paketit selitetään kohdassa Free- ja Max-paketit.