Tools für Weiterleitungen
Du liest Weiterleitungen und ersetzt ihre vollständige Regelliste.
Auf dieser Seite
Lies die Weiterleitungsregeln deines Projekts oder ersetze die vollständige Liste.
Hinweis
Die Verbindung gilt für den Space. Du bist dort Mitglied, und der Space ist nicht gesperrt. Ein Space ist ein gemeinsamer Arbeitsbereich in der App.
hosting_list_redirects rufst du mit jeder Rolle auf, auch mit Lesend. Für hosting_set_redirects brauchst du die Rolle Inhaber, Administrator oder Anwender.
hosting_list_redirects List redirects
liest nur
Listet die Weiterleitungsregeln eines Projekts auf, in ihrer Reihenfolge. Die erste Regel, die passt, gewinnt.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Nummer des Projekts, wie hosting_list_projects sie zeigt. |
hosting_set_redirects Set redirects
ändert Datenlöscht, überschreibt oder ändert Sichtbares
Lies zuerst mit hosting_list_redirects die bestehenden Regeln und sende mit der neuen Liste jede Regel, die bleiben soll.
Achtung
Fehlende Regeln werden entfernt; eine leere Liste entfernt alle. Das Tool arbeitet beim ersten Aufruf ohne Bestätigungssatz.
- Ein Projekt hat höchstens 200 Regeln. Die Quelle einer Regel hat bis zu 500 Zeichen, das Ziel bis zu 1.000. Ist eine Regel fehlerhaft oder die Liste zu lang, speichert TEISENDA die Liste nicht.
- Zwei Pfade können keine Quelle sein, mit allem, was darunter liegt:
/.teisendaund/.well-known/acme-challenge. Sie gehören dem Hosting-Knoten.
| Parameter | Typ | Angabe | Beschreibung |
|---|---|---|---|
space | Ganze Zahl | erforderlich | Die zehnstellige Space-ID. |
project | Ganze Zahl | erforderlich | Die Nummer des Projekts, wie hosting_list_projects sie zeigt. |
rules | Liste von Objekten | erforderlich | Die vollständige Liste, höchstens 200 Regeln; eine leere Liste entfernt jede Regel. Jede Regel ist ein Objekt mit source, target und wahlweise status. source ist die Quelle: ein Pfad, der mit / beginnt. Darin füllt :name einen Abschnitt des Pfads, und * am Ende nimmt den Rest. target ist das Ziel: ein Pfad oder eine vollständige Adresse mit https. :name und * aus der Quelle lassen sich im Ziel wiederverwenden. status ist 301, 302, 307 oder 308; fehlt er, gilt 301. |
Wenn etwas nicht klappt
Wo eine Abhilfe ein Tool nennt, bittest du die Anwendung, es aufzurufen.
Die Liste wurde nicht gespeichert:
Diese Meldung gibt nur hosting_set_redirects zurück. TEISENDA hat die Liste nicht gespeichert; auf die Meldung folgt je fehlerhafter Regel eine Zeile „Regel …: …“ mit ihrer Position und dem Grund. Korrigiere die genannten Regeln, und rufe das Tool mit der ganzen Liste erneut auf. Als Grund nennt die Zeile einen dieser Sätze:
- Die Quelle ist falsch gebaut oder länger als 500 Zeichen: Die Quelle muss ein Pfad sein, der mit / beginnt – ohne Leerzeichen, ? oder #. :name füllt einen ganzen Abschnitt, /* steht nur am Ende.
- Das Ziel ist falsch gebaut oder länger als 1.000 Zeichen: Das Ziel muss ein Pfad sein, der mit / beginnt, oder eine vollständige Adresse mit https://.
- Die Quelle ist ein reservierter Pfad, also
/.teisenda,/.well-known/acme-challengeoder etwas darunter: Dieser Pfad ist reserviert. - Das Ziel nennt einen unbekannten Platzhalter: Das Ziel benutzt einen Platzhalter, der in der Quelle nicht vorkommt.
- Der Status ist ein anderer als 301, 302, 307 oder 308: Erlaubt sind 301, 302, 307 und 308.
- Die Regel zeigt auf sich selbst oder läuft im Kreis: Diese Regel zeigt auf sich selbst oder läuft mit anderen im Kreis.
- Die Liste hat mehr als 200 Regeln: „Mehr als … Regeln sind nicht möglich.“
Meldungen zu Space und Projektnummer stehen bei den Tools für Spaces und Projekte. Alle anderen, die bei jedem Tool vorkommen können, stehen unter Fehler beim Connector beheben.