Redirect Map

Die Redirect Map liefert eine große Liste exakter, pfadgenauer Weiterleitungen direkt am Edge aus -- ohne Umweg über den Origin. Jeder Eintrag ordnet einer exakten Quelle (host/pfad) ein Ziel zu, zusammen mit einem Weiterleitungsmodus und einem HTTP-Statuscode. Gedacht ist sie für Migrationen und Relaunches, bei denen viele alte URLs auf neue zeigen sollen.

Im Hub liegt die Redirect Map innerhalb einer Zone unter Konfiguration → Redirects.

Die Redirect Map einer Zone: eine durchsuchbare, sortierbare Tabelle exakter Weiterleitungen.

Beta

Die Redirect Map befindet sich derzeit in der Beta-Phase. Verhalten und Grenzen können sich noch ändern.

Redirect Map vs. Weiterleitungen

Dies ist nicht dasselbe wie die Weiterleitungen auf Organisationsebene, die einen ganzen Hostnamen per CNAME auf einen anderen Hostnamen umleiten. Die Redirect Map arbeitet innerhalb einer Zone und trifft einzelne Pfade auf den Hostnamen, die die Zone bereits ausliefert.

---

So funktioniert das Matching

Jeder Eintrag besteht aus einer Quelle, einem Ziel, einem Modus und einem Status:

• Quelle -- der exakte Schlüssel im Format host/pfad, z. B. www.example.com/alte-seite. Der Host wird ohne Beachtung der Groß-/Kleinschreibung verglichen, der Pfad exakt (mit Beachtung der Groß-/Kleinschreibung). Verglichen werden nur Host und Pfad -- Query-Strings sind nicht Teil des Schlüssels.
• Ziel -- wohin die Anfrage geht: eine vollständige URL (z. B. https://www.example.com/neue-seite) oder ein reiner Host im Modus Host-Tausch.
• Modus -- wie Pfad und Query der eingehenden Anfrage auf das Ziel übertragen werden (siehe unten).
• Status -- der HTTP-Weiterleitungscode, der an den Besucher zurückgegeben wird: 301 (Standard), 302, 307 oder 308.

Das Matching ist exakt: Es gibt keine Wildcards oder Präfix-Regeln. Eine Anfrage wird nur dann weitergeleitet, wenn Host und Pfad exakt einem Schlüssel entsprechen. Genau das erlaubt es, die Map auf sehr große Listen zu skalieren, die vollständig am Edge ausgeliefert werden.

Weiterleitungsmodi

Modus	Code	Verhalten	Beispiel
Literal	L	Das Ziel ist die endgültige URL und wird unverändert genutzt.	example.com/a → https://example.com/b
Query beibehalten	Q	Der eingehende Query-String wird an das Ziel angehängt.	example.com/a?ref=x → https://example.com/b?ref=x
Host-Tausch	H	Der eingehende Pfad bleibt erhalten, nur der Host wird getauscht.	old.example.com/a/b → https://new.example.com/a/b

Ohne Angabe eines Modus gilt Literal (L) als Standard.

---

Einträge verwalten

Die Redirect-Map-Seite zeigt alle Einträge in einer durchsuchbaren, sortierbaren und seitenweise geblätterten Tabelle:

• Suche filtert nach einem Teilstring von Quelle oder Ziel.
• Sortierung nach Quelle, Ziel, Modus oder Status; die Sortierung gilt für die gesamte (gefilterte) Map, nicht nur für die aktuelle Seite.

Einträge werden per CSV-Import angelegt und gepflegt; daneben gibt es einen Export und eine Aktion zum vollständigen Leeren.

Import per CSV

Über CSV importieren wird eine Datei ausgewählt und festgelegt, wie sie angewendet wird:

• Alle ersetzen -- der Upload wird zur gesamten Map (vorhandene Einträge werden verworfen).
• Anhängen -- der Upload wird mit der bestehenden Map zusammengeführt.

Der Import-Dialog: CSV-Datei wählen und zwischen Ersetzen und Anhängen entscheiden.

CSV-Format. Eine Weiterleitung pro Zeile, Spalten in dieser Reihenfolge:

source,target,mode,status
www.example.com/alt,https://www.example.com/neu,L,301
shop.example.com/sale,https://shop.example.com/deals,Q,302
old.example.com/,new.example.com,H,301

Spalte	Pflicht	Standard	Hinweise
source	Ja	--	Exakter Schlüssel host/pfad.
target	Ja	--	Vollständige URL oder reiner Host im Host-Tausch-Modus.
mode	Nein	L	L, Q oder H.
status	Nein	301	301, 302, 307 oder 308.

• Eine optionale Kopfzeile (source,target) wird ignoriert.
• Leere Zeilen und Zeilen, die mit # beginnen, werden ignoriert -- so lassen sich Kommentare ergänzen.
• Felder mit Kommas können in doppelte Anführungszeichen gesetzt werden.

Validierung. Der Upload wird geprüft, bevor etwas gespeichert wird. Problematische Zeilen werden übersprungen, statt den gesamten Import scheitern zu lassen; das Ergebnis meldet, wie viele Einträge importiert und wie viele Weiterleitungsketten zusammengefasst wurden, sowie eine Meldung je abgelehnter Zeile.

Situation	Was passiert
Fehlende source oder target	Zeile übersprungen
Ungültiger mode oder status	Zeile übersprungen
Doppelte source	Abgelehnt -- das erste Vorkommen bleibt erhalten
Kette (A → B → C)	Zu einem einzigen Sprung zusammengefasst (A → C), damit der Edge nie doppelt weiterleitet
Zyklus (A → B → A)	Abgelehnt -- die beteiligten Einträge werden verworfen

TIP

Da Ketten schon beim Import zusammengefasst werden, landet ein Besucher stets in einem einzigen Sprung am endgültigen Ziel -- auch wenn die CSV die Weiterleitungen in mehreren Schritten auflistet.

Export als CSV

CSV exportieren lädt die gesamte Map als CSV-Datei im selben Format herunter, das der Import akzeptiert. So lässt sie sich sichern, in einer Tabellenkalkulation bearbeiten und erneut importieren.

Alle löschen

Alle löschen entfernt jede Weiterleitung der Zone und leert die Map. Das lässt sich nicht rückgängig machen -- vorher exportieren, falls die Liste später noch benötigt wird.

---

API

Die Redirect Map ist auch über die API verfügbar, jeweils auf eine Zone bezogen:

Methode	Endpunkt	Zweck
GET	/zones/{zoneId}/redirect-map	Einträge auflisten (unterstützt search, order[<feld>], Paging)
POST	/zones/{zoneId}/redirect-map/import	CSV importieren (multipart file, mode = replace oder append)
GET	/zones/{zoneId}/redirect-map/export	Gesamte Map als CSV herunterladen
DELETE	/zones/{zoneId}/redirect-map	Map leeren