Verktyg i Connector
Hitta varje verktyg med dess effekt, gränser och parametrar.
På den här sidan
Hitta rätt verktyg och dess parametrar. Varje Hosting-verktyg arbetar i exakt ett Space. Ett Space är en gemensam arbetsyta i appen.
Information
Applikationen är ansluten till ditt TEISENDA-konto, och anslutningen är inte avslutad; stegen finns för Claude och ChatGPT.
För ett Hosting-verktyg gäller anslutningen det Space som anropet anger. Du är medlem där och det är inte spärrat.
Din roll i detta Space tillåter verktyget.
Argumentet space bestämmer detta Space
Varje Hosting-verktyg kräver argumentet space: det tiosiffriga Space-ID:t. whoami tar inget argument.
Applikationen ska välja detta Space från whoami eller din uppgift och fråga om flera Spaces är möjliga.
TEISENDA kontrollerar vid varje anrop att detta Space tillhör anslutningen och att du är medlem där. Verktyget körs endast i detta Space.
Vilket värde accepterar space?
Ett tiosiffrigt heltal eller en text med exakt tio siffror. Allt annat besvaras av TEISENDA som ett saknat Space, till exempel ett tal med färre eller fler siffror. Tio siffror som inte är ett Space i anslutningen ger meddelandet att detta Space inte tillhör anslutningen. Båda meddelandena finns vid verktyget för Spaces.
Resultatet av ett Hosting-verktyg anger först detta Space
Resultatet anger först Space-ID och visningsnamn. Kontrollera dem; vid fel Space ska applikationen stanna enligt sina anvisningar.
Vid Sparat, men ännu inte överfört till hostingnoden: är ändringen sparad men ännu inte överförd. Kontrollera senare tillståndet med hosting_project_status.
När är ett resultat inget fel trots att något återstår?
Vissa resultat är inte markerade som fel: verktyget har gjort vad det kunde och anger vad som saknas. Det gäller när den angivna versionen redan är publicerad, när en domäns DNS ännu inte stämmer, när ett projekt är raderat men Hosting-noden ännu inte bekräftat det, samt svaret från ett verktyg med två steg som begär bekräftelsefrasen.
Vad ändrar ett verktyg i TEISENDA, och var ser jag det?
Varje verktyg anropar samma tjänster som appens gränssnitt, med samma rättigheter och gränser. Det som ett verktyg ändrar är ändrat i TEISENDA som om du hade gjort det i gränssnittet.
Projektloggen registrerar ändringar med kanalen Ansluten app när åtgärden skapar en rad. Läsande verktyg skapar ingen rad där. Vid skrivning eller radering av filer registreras endast att ett nytt utkast har öppnats.
Din roll tillåter verktyget
Ägare, Administratör och Användare får anropa alla Hosting-verktyg. Läsbehörighet får bara använda fem läsande Hosting-verktyg; listan finns under Behörigheter.
Verktygslistan visar även verktyg som din roll inte tillåter. Rättigheten kontrolleras vid anropet.
Inget Hosting-verktyg arbetar i ett spärrat Space
whoami listar fortfarande ett spärrat Space och markerar det som spärrat, men inget Hosting-verktyg arbetar där. En anslutning vars Spaces alla är spärrade erbjuder endast whoami till applikationen. Vad du kan göra finns vid verktyget för Spaces; mer om spärrar under Förstå Spaces.
Markeringarna visar om ett verktyg bara läser eller ändrar något
Markeringarna finns vid verktyget och i listan nedanför.
| Markering | Betydelse |
|---|---|
| ”läser endast” | Verktyget ändrar inget, skapar ingen loggrad som någon ser i appen och kan upprepas utan effekt. Det gäller sju Hosting-verktyg och whoami. |
| ”ändrar data” | Verktyget ändrar något. Det gäller de övriga 16 Hosting-verktygen. |
| ”raderar, skriver över eller ändrar synligt innehåll” | Verktyget raderar, skriver över eller ändrar det besökare ser på en webbplats. Markeringen betyder inte att verktyget raderar; vad det gör beskrivs i dess avsnitt. |
| ”två steg” | Verktyget kräver en bekräftelsefras. |
Tre verktyg kräver en bekräftelsefras
hosting_delete_project, hosting_remove_domain och byte till offentligt med hosting_set_visibility arbetar i två steg: utan confirm anger svaret följden och frasen; först ett anrop med denna fras utför åtgärden.
Applikationen ska först inhämta ditt godkännande. Kontrollera projekt och Space; Behörigheter förklarar förfarandet.
Varning
Alla andra verktyg arbetar vid det första anropet, även vid radering, överskrivning eller ändring av webbplatsen. En fråga om godkännande från applikationen är inte garanterad.
Verktygen använder delvis andra ord än dokumentationen
Verktygen beskrivs på engelska. Deras tyska svar använder delvis andra ord än dokumentationen.
| I tyska svar | I denna dokumentation |
|---|---|
”Stand”, ”Deployment”; som parameter deploy |
Version. Verktygen kallar även utkastet så. |
”Deployment” när planen räknar; som fält deployments |
Publicering: att publicera en version för första gången förbrukar en publicering. Att återpublicera en version som redan varit publicerad förbrukar ingen. |
| ”offener Stand” | Utkast: dess filer kan fortfarande ändras, och det är inte publicerat. Ett projekt har högst ett. |
| ”abgeschlossen” | Färdigställd version: varje kontrollerad version som inte längre kan ändras, oavsett om den är publicerad eller inte. |
| ”fertig, aber nicht veröffentlicht” | Färdig version: en färdigställd version som aldrig varit publicerad. |
| ”automatic address” i verktygsbeskrivningarna | TEISENDA-adress: adressen som TEISENDA självt tilldelar projektet. |
Varje verktyg har ett avsnitt på en undersida
Namnet leder till verktygets avsnitt med dess parametrar. Titlarna är på engelska.
| Verktyg | Titel | Egenskaper |
|---|---|---|
whoami | Show user and spaces | läser enbart |
hosting_list_projects | List projects | läser enbart |
hosting_create_project | Create project | ändrar data |
hosting_project_status | Project status | läser enbart |
hosting_rename_project | Rename project | ändrar data |
hosting_set_offline | Take project offline or online | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_delete_project | Delete project | ändrar datatar bort, skriver över eller ändrar synligt innehålltvå steg |
hosting_put_files | Write files | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_delete_files | Delete files | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_list_files | List files | läser enbart |
hosting_read_file | Read file | läser enbart |
hosting_create_upload | Create upload link | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_deploy | Publish deployment | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_deploy_status | Deployment status | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_list_deploys | List deployments | läser enbart |
hosting_rollback | Roll back deployment | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_add_domain | Add domain | ändrar data |
hosting_check_domain | Check domain | ändrar data |
hosting_set_primary_domain | Set primary domain | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
hosting_remove_domain | Remove domain | ändrar datatar bort, skriver över eller ändrar synligt innehålltvå steg |
hosting_get_visibility | Get visibility | läser enbart |
hosting_set_visibility | Set visibility | ändrar datatar bort, skriver över eller ändrar synligt innehålltvå steg |
hosting_list_redirects | List redirects | läser enbart |
hosting_set_redirects | Set redirects | ändrar datatar bort, skriver över eller ändrar synligt innehåll |
Vissa gränser och meddelanden gäller varje anrop
Ett anrop tar högst två minuter; en förfrågan är högst 8 MB. Ytterligare gränser och felsökningen gäller alla verktyg.
Vad planen för detta Space begränsar finns vid verktygen för projekt, domäner, filer och publicering; planerna beskrivs under Planerna Free och Max.