Regelsatzaktionen
Ein Azure Front Door-Regelsatz besteht aus Regeln mit einer Kombination aus Vergleichsbedingungen und Aktionen. Dieser Artikel enthält detaillierte Beschreibungen der Aktionen, die Sie in einem Regelsatz verwenden können. Eine Aktion definiert das Verhalten, das auf einen Anforderungstyp angewendet wird, der von einer oder mehreren Vergleichsbedingungen identifiziert wird. Eine Regeln in einem Regelsatz kann über bis zu fünf Aktionen verfügen. Front Door unterstützt such Servervariablen in einer Regelsatzaktion.
Die folgenden Aktionen können in einem Regelsatz verwendet werden:
Routenkonfiguration überschreiben
Mit der Aktion Routenkonfiguration überschreiben, können Sie die Ursprungsgruppe oder Zwischenspeicherkonfiguration, die für die Anforderung verwendet werden soll, überschreiben. Sie können die in der Route angegebenen Konfigurationen der Ursprungsgruppe überschreiben oder einhalten. Wenn Sie jedoch die Routenkonfiguration überschreiben, müssen Sie die Zwischenspeicherung konfigurieren. Andernfalls wird die Zwischenspeicherung für die Anforderung deaktiviert.
Sie können auch überschreiben, wie Dateien für bestimmte Anforderungen zwischengespeichert werden, z. B.:
- Das vom Ursprung angegebene Verhalten beim Zwischenspeichern überschreiben.
- Wie Abfragezeichenfolgenparameter verwendet werden, um den Cacheschlüssel der Anforderung zu generieren.
- Wert für die Gültigkeitsdauer (Time to Live, TTL) überschreiben, um zu steuern, wie lange Inhalte im Cache verbleiben.
Eigenschaften
Eigenschaft | Unterstützte Werte |
---|---|
Ursprungsgruppe überschreiben |
|
Caching |
|
Wenn Ursprungsgruppe überschreiben auf Ja festgelegt ist, legen Sie die folgenden Eigenschaften fest:
Eigenschaft | Unterstützte Werte |
---|---|
Ursprungsgruppe | Die Ursprungsgruppe, an die die Anforderung geroutet werden soll. Durch diese Einstellung wird die in der Front Door-Endpunktroute angegebene Konfiguration außer Kraft gesetzt. |
Weiterleitungsprotokoll | Das Protokoll für Front Door, das beim Weiterleiten der Anforderung an den Ursprung verwendet werden soll. Unterstützte Werte sind „Nur HTTP“, „Nur HTTPS“, „Eingehende Anforderung abgleichen“. Durch diese Einstellung wird die in der Front Door-Endpunktroute angegebene Konfiguration außer Kraft gesetzt. |
Wenn Zwischenspeichern auf Aktiviert festgelegt ist, legen Sie die folgenden Eigenschaften fest:
Eigenschaft | Unterstützte Werte |
---|---|
Verhalten für das Zwischenspeichern von Abfragezeichenfolgen |
|
Abfrageparameter | Die Liste der Namen der Abfragezeichenfolgen-Parameter, die durch Kommas getrennt sind. Diese Eigenschaft wird nur festgelegt, wenn das Verhalten beim Zwischenspeichern von Abfragezeichenfolgen auf Angegebene Abfragezeichenfolgen ignorieren oder Angegebene Abfragezeichenfolgen einschließen festgelegt ist. |
Komprimierung |
|
Cacheverhalten |
|
Cachedauer | Wenn das Cacheverhalten auf Override always oder Override if origin missing festgelegt ist, müssen diese Felder die zu verwendende Cachedauer angeben. Die maximale Dauer beträgt 366 Tage. Diese Eigenschaft wird nur festgelegt, wenn Cacheverhalten auf Immer überschreiben oder Überschreiben, wenn Ursprung fehlt festgelegt ist.
|
Beispiele
In diesem Beispiel werden alle übereinstimmenden Anforderungen unabhängig von der Konfiguration in der Front Door-Endpunktroute an eine Ursprungsgruppe mit dem Namen MyOriginGroup
geroutet.
In diesem Beispiel legen wir den Cacheschlüssel so fest, dass er einen Abfragezeichenfolgen-Parameter mit dem Namen customerId
enthält. Die Komprimierung ist aktiviert, und die Zwischenspeicherrichtlinien des Ursprungs werden berücksichtigt.
In diesem Beispiel überschreiben wir den Cacheablauf auf 6 Stunden, für übereinstimmende Anforderungen, die noch keine Cachedauer angeben. Front Door ignoriert die Abfragezeichenfolge, wenn sie den Cacheschlüssel bestimmt, und die Komprimierung wird aktiviert.
Anforderungsheader ändern
Verwenden Sie die Aktion Anforderungsheader ändern, um die Header in der Anforderung zu ändern, wenn sie an Ihren Ursprung gesendet wird.
Eigenschaften
Eigenschaft | Unterstützte Werte |
---|---|
Betreiber |
|
Headername | Der Name des zu ändernden Headers. |
Headerwert | Der Wert, der angefügt oder überschrieben werden soll. |
Beispiel
In diesem Beispiel fügen wir den Wert AdditionalValue
an den MyRequestHeader
-Anforderungsheader an. Wenn der Ursprung den Antwortheader auf den Wert ValueSetByClient
festgelegt hat, hätte der Anforderungsheader nach dem Anwenden dieser Aktion den Wert ValueSetByClientAdditionalValue
.
Hinweis
Bestimmte reservierte Header von Azure Front Door können nicht mit Hilfe von Aktionen des Regelmoduls geändert werden, einschließlich der Aktionen zur Änderung von Anforderungs- und Antwort-Headern. Die folgende Liste der reservierten Header kann nicht geändert werden, ebenso wie alle Header mit den Präfixen x-ec
und x-fd
.
Accept-Ranges
Host
Connection
Content-Length
Transfer-Encoding
TE
Last-Modified
Keep-Alive
Expect
Upgrade
If-Modified-Since
If-Unmodified-Since
If-None-Match
If-Match
Range
If-Range
X-Ms-Via
X-Ms-Force-Refresh
X-MSEdge-Ref
Warning
Forwarded
Via
X-Forwarded-For
X-Forwarded-Proto
X-Forwarded-Host
X-Azure-RequestChain
X-Azure-FDID
X-Azure-RequestChainv2
X-Azure-Ref
Antwortheader ändern
Verwenden Sie die Aktion Antwortheader ändern, um Header zu ändern, die in Antworten vorhanden sind, bevor sie an die Clients zurückgegeben werden.
Eigenschaften
Eigenschaft | Unterstützte Werte |
---|---|
Betreiber |
|
Headername | Der Name des zu ändernden Headers. |
Headerwert | Der Wert, der angefügt oder überschrieben werden soll. |
Beispiel
In diesem Beispiel löschen wir den Header namens X-Powered-By
aus den Antworten, bevor sie an den Client zurückgegeben werden.
Hinweis
Bestimmte reservierte Header von Azure Front Door können nicht mit Hilfe von Aktionen des Regelmoduls geändert werden, einschließlich der Aktionen zur Änderung von Anforderungs- und Antwort-Headern. Die folgende Liste der reservierten Header kann nicht geändert werden, ebenso wie alle Header mit den Präfixen x-ec
und x-fd
.
Accept-Ranges
Host
Connection
Content-Length
Transfer-Encoding
TE
Last-Modified
Keep-Alive
Expect
Upgrade
If-Modified-Since
If-Unmodified-Since
If-None-Match
If-Match
Range
If-Range
X-Ms-Via
X-Ms-Force-Refresh
X-MSEdge-Ref
Warning
Forwarded
Via
X-Forwarded-For
X-Forwarded-Proto
X-Forwarded-Host
X-Azure-RequestChain
X-Azure-FDID
X-Azure-RequestChainv2
X-Azure-Ref
URL Redirect
Verwenden Sie die URL-Umleitungs-Aktion, um Clients an eine neue URL umzuleiten. Clients werden eine Umleitungsantwort von Front Door gesendet. Azure Front Door unterstützt die dynamische Erfassung des URL-Pfads mit der {url_path:seg#}
-Servervariable und konvertiert den URL-Pfad in Klein- oder Großbuchstaben mit {url_path.tolower}
oder {url_path.toupper}
. Weitere Informationen finden Sie unter Servervariablen.
Eigenschaften
Eigenschaft | Unterstützte Werte |
---|---|
Umleitungstyp | Der Antworttyp aus, der an den Anforderer zurückgegeben werden soll.
|
Umleitungsprotokoll |
|
Zielhost | Der Hostname, an den die Anforderung umgeleitet werden soll. Lassen Sie das Feld leer, um den eingehenden Host beizubehalten. |
Zielpfad | Der bei der Umleitung zu verwendende Pfad. Fügen Sie die führende / ein. Lassen Sie das Feld leer, um den eingehenden Pfad beizubehalten. |
Abfragezeichenfolge | Die bei der Umleitung zu verwendende Abfragezeichenfolge. Fügen Sie den führenden ? nicht ein. Lassen Sie das Feld leer, um die eingehende Abfragezeichenfolge beizubehalten. |
Zielfragment | Das bei der Umleitung zu verwendende Fragment. Lassen Sie das Feld leer, um das eingehende Fragment beizubehalten. |
Beispiel
In diesem Beispiel wird die Anforderung an https://contoso.com/exampleredirection?clientIp={client_ip}
umgeleitet, während das Fragment beibehalten wird. Eine temporäre HTTP-Umleitung (307) wird verwendet. Die IP-Adresse des Clients wird anstelle des {client_ip}
-Tokens innerhalb der URL mithilfe der client_ip
Servervariablen verwendet.
URL Rewrite
Verwenden Sie die URL-Rewrite-Aktion, um den Pfad einer Anforderung auf dem Weg zu Ihrem Ursprung erneut zu generieren. Azure Front Door unterstützt die dynamische Erfassung des URL-Pfads mit der {url_path:seg#}
-Servervariable und konvertiert den URL-Pfad in Klein- oder Großbuchstaben mit {url_path.tolower}
oder {url_path.toupper}
. Weitere Informationen finden Sie unter Servervariablen.
Eigenschaften
Eigenschaft | Unterstützte Werte |
---|---|
Quellmuster | Definieren Sie das Quellmuster im URL-Pfad, das ersetzt werden soll. Derzeit verwendet das Quellmuster eine auf Präfixen basierende Übereinstimmung. Verwenden Sie einen Schrägstrich (/ ) als Quellmusterwert, um alle URL-Pfade abzugleichen. |
Destination | Definieren Sie den Zielpfad, der für das erneute Generieren verwendet werden soll. Der Zielpfad überschreibt das Quellmuster. |
Nicht übereinstimmenden Pfad beibehalten | Wenn Ja ausgewählt ist, wird der verbleibende Pfad nach dem Quellmuster an den neuen Zielpfad angefügt. |
Beispiel
In diesem Beispiel werden alle Anforderungen in den /redirection
-Pfad neu geschrieben, und der Rest des Pfads wird nicht beibehalten.
Wichtig
Azure Front Door (klassisch) wird am 31. März 2027 eingestellt. Um Dienstunterbrechungen zu vermeiden, ist es wichtig, dass Sie Ihre (klassischen) Azure Front Door-Profile bis März 2027 zur Azure Front Door Standard- oder Premium-Stufe migrieren. Weitere Informationen finden Sie unter Einstellung von Azure Front Door (klassisch).
Ein Regelmodul in Azure Front Door (klassisch) kann bis zu 25 Regeln mit Vergleichsbedingungen und zugeordneten Aktionen enthalten. Dieser Artikel enthält detaillierte Beschreibungen der einzelnen Aktionen, die Sie in einer Regel definieren können.
Eine Aktion definiert das Verhalten, das auf den Anforderungstyp angewendet wird, der der Bedingung oder der Gruppe von Vergleichsbedingungen entspricht. Eine Regel in der Konfiguration der Regel-Engine kann bis zu zehn Vergleichsbedingungen und bis zu fünf Aktionen umfassen. Pro Regel kann immer nur eine einzelne Aktion vom Typ Routingkonfiguration überschreiben vorhanden sein.
Die folgenden Aktionen können in der Konfiguration der Regel-Engine verwendet werden:
Anforderungsheader ändern
Verwenden Sie diese Aktionen, um Header in Anforderungen zu ändern, die an Ihr Back-End gesendet werden.
Pflichtfelder
Aktion | HTTP-Headername | Wert |
---|---|---|
Anfügen | Wenn diese Option ausgewählt wird und die Regel übereinstimmt, wird der im Headernamen angegebene Header mit dem angegebenen Wert der Anforderung hinzugefügt. Wenn der Header bereits vorhanden ist, wird der Wert an den vorhandenen Wert angefügt. | String |
Overwrite | Wenn diese Option ausgewählt wird und die Regel übereinstimmt, wird der im Headernamen angegebene Header mit dem angegebenen Wert der Anforderung hinzugefügt. Wenn der Header bereits vorhanden ist, wird der vorhandene Wert von dem angegebenen Wert überschrieben. | String |
Löschen | Wenn diese Option mit übereinstimmenden Regeln ausgewählt wird und der in der Regel angegebene Header vorhanden ist, wird der Header aus der Anforderung gelöscht. | String |
Antwortheader ändern
Verwenden Sie diese Aktionen, um Header in Antworten zu ändern, die an Ihre Clients zurückgegeben werden.
Pflichtfelder
Aktion | HTTP-Headername | Wert |
---|---|---|
Anfügen | Wenn diese Option ausgewählt wird und die Regel übereinstimmt, wird der im Headernamen angegebene Header mit dem angegebenen Wert der Antwort hinzugefügt. Wenn der Header bereits vorhanden ist, wird der Wert an den vorhandenen Wert angefügt. | String |
Overwrite | Wenn diese Option ausgewählt ist und die Regel übereinstimmt, wird der im Headernamen angegebene Header mit dem angegebenen Wert der Antwort hinzugefügt. Wenn der Header bereits vorhanden ist, überschreibt der Wert den vorhandenen Wert. | String |
Löschen | Wenn diese Option mit Vergleichsregeln ausgewählt wird und der in der Regel angegebene Header vorhanden ist, wird der Header aus der Antwort gelöscht. | String |
Außerkraftsetzung der Routenkonfiguration
Routentyp: Umleiten
Verwenden Sie diese Aktionen, um Clients an eine neue URL umzuleiten.
Pflichtfelder
Feld | BESCHREIBUNG |
---|---|
Umleitungstyp | Die Umleitung ist eine Möglichkeit, Benutzer/Clients an eine andere URL zu senden. Ein Umleitungstyp legt den von Clients verwendeten Statuscode fest, um den Zweck der Umleitung zu verdeutlichen. Folgende Umleitungsstatuscodes sind verfügbar: „Gefunden (302)“, „Verschoben (301)“, „Temporäre Umleitung (307)“ und „Permanente Umleitung (308)“. |
Umleitungsprotokoll | Behalten Sie das Protokoll gemäß der eingehenden Anforderung bei, oder definieren Sie ein neues Protokoll für die Umleitung. Wählen Sie z. B. „HTTPS“ für die Umleitung von HTTP zu HTTPS. |
Zielhost | Legen Sie diesen Wert fest, um den Hostnamen in der URL für die Umleitung zu ändern oder ansonsten den Hostnamen aus der eingehenden Anforderung beizubehalten. |
Zielpfad | Hiermit wird entweder der Pfad gemäß der eingehenden Anforderung beibehalten, oder der Pfad wird in der URL für die Umleitung aktualisiert. |
Abfragezeichenfolge | Legen Sie diesen Wert fest, um vorhandene Abfragezeichenfolgen aus der eingehenden Anforderungs-URL zu ersetzen oder andernfalls den ursprünglichen Satz von Abfragezeichenfolgen beizubehalten. |
Zielfragment | Als Zielfragment wird der Teil der URL nach „#“ bezeichnet, der normalerweise von Browsern verwendet wird, um einen bestimmten Abschnitt einer Seite anzuzeigen. Legen Sie diesen Wert fest, um der Umleitungs-URL ein Fragment hinzuzufügen. |
Routentyp: Weiter
Verwenden Sie diese Aktionen, um Clients an eine neue URL weiterzuleiten. Diese Aktionen enthalten auch Unteraktionen für URL-Umschreibungen und Zwischenspeichern.
Feld | BESCHREIBUNG |
---|---|
Back-End-Pool | Wählen Sie den Back-End-Pool zum Überschreiben und Verarbeiten der Anforderungen aus. Alle vorkonfigurierten Back-End-Pools, die derzeit in Ihrem Front Door-Profil enthalten sind, werden angezeigt. |
Weiterleitungsprotokoll | Protokoll zur Weiterleitung der Anforderung an das Back-End oder zum Abgleich mit dem Protokoll der eingehenden Anforderung |
Umschreiben einer URL | Pfad, der beim Erstellen der Anforderung für URL-Rewrite zur Weiterleitung an das Back-End verwendet wird |
Caching | Aktivieren Sie die Zwischenspeicherung für diese Routingregel. Anschließend werden Ihre statischen Inhalte von Azure Front Door zwischengespeichert. |
URL Rewrite
Mit dieser Einstellung können Sie einen optionalen benutzerdefinierten Weiterleitungspfad konfigurieren, der beim Erstellen der Anforderung zur Weiterleitung an das Back-End verwendet werden soll.
Feld | BESCHREIBUNG |
---|---|
Benutzerdefinierter Weiterleitungspfad | Definieren Sie einen Pfad für die Weiterleitung von Anforderungen. |
Caching
Mit diesen Einstellungen können Sie steuern, wie Dateien für Anforderungen, die Abfragezeichenfolgen enthalten, zwischengespeichert werden. Sie bestimmen, ob der Inhalt basierend auf allen Parametern oder ausgewählten Parametern zwischengespeichert werden soll. Sie können diese Einstellungen verwenden, um den Wert für die Gültigkeitsdauer (Time to Live, TTL) zu überschreiben und so zu steuern, wie lange Inhalte im Cache verbleiben. Um das Zwischenspeichern als Aktion zu erzwingen, legen Sie das Zwischenspeicherungsfeld auf „Aktiviert“ fest. Wenn Sie das Zwischenspeichern erzwingen, werden die folgenden Optionen angezeigt:
Cacheverhalten | BESCHREIBUNG |
---|---|
Abfragezeichenfolge ignorieren | Sobald das Objekt zwischengespeichert ist, ignorieren alle nachfolgenden Anforderungen die Abfragezeichenfolgen, bis das zwischengespeicherte Objekt abläuft. |
Abfragezeichenfolge verwenden | Jede Anforderung wird mit einer eindeutigen URL, einschließlich der Abfragezeichenfolge, als eindeutiges Objekt mit eigenem Cache behandelt. |
Angegebene Abfragezeichenfolgen ignorieren | Abfragezeichenfolgen von Anforderungs-URLs, die unter der Einstellung „Abfrageparameter“ aufgeführt sind, werden für die Zwischenspeicherung ignoriert. |
Angegebene Abfragezeichenfolgen einschließen | Abfragezeichenfolgen von Anforderungs-URLs, die unter der Einstellung „Abfrageparameter“ aufgeführt sind, werden für die Zwischenspeicherung verwendet. |
Weitere Felder | BESCHREIBUNG |
---|---|
Dynamische Komprimierung | Azure Front Door Service komprimiert Inhalte dynamisch im Edgebereich, wodurch die Antwort kleiner ist und schneller erfolgt. |
Abfrageparameter | Eine kommagetrennte Liste zulässiger (oder unzulässiger) Parameter als Grundlage für die Zwischenspeicherung. |
Standardcachedauer verwenden | Legen Sie diese Option fest, um die Standardcachedauer von Azure Front Door zu verwenden, oder definieren Sie eine Cachedauer, bei der die Direktive für die Ursprungsantwort ignoriert wird. |
Nächste Schritte
- Erfahren Sie, wie Sie Ihren ersten Regelsatz konfigurieren.
- Erfahren Sie mehr über Vergleichsbedingungen für Regelsätze.
- Erfahren Sie mehr über Azure Front Door-Regelsätze.