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
  • Ja: Die für die Anforderung verwendete Ursprungsgruppe wird überschrieben.
  • Nein: Die in der Route angegebene Ursprungsgruppe wird verwendet.
Caching
  • Aktiviert: Für die Anforderung wird die Aktivierung der Zwischenspeicherung erzwungen.
  • Deaktiviert: Für die Anforderung wird die Deaktivierung der Zwischenspeicherung erzwungen.

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
  • Abfragezeichenfolge ignorieren: Beim Generieren des Cacheschlüssels werden Abfragezeichenfolgen nicht berücksichtigt. Legen Sie in ARM-Vorlagen die queryStringCachingBehavior-Eigenschaft auf IgnoreQueryString fest.
  • Abfragezeichenfolge verwenden: Jede eindeutige URL verfügt über einen eigenen Cacheschlüssel. Verwenden Sie in ARM-Vorlagen den queryStringCachingBehavior von UseQueryString.
  • Angegebene Abfragezeichenfolgen ignorieren: Beim Generieren des Cacheschlüssels werden die in den Parametern angegebenen Abfragezeichenfolgen ausgeschlossen. Legen Sie in ARM-Vorlagen die queryStringCachingBehavior-Eigenschaft auf IgnoreSpecifiedQueryStrings fest.
  • Angegebene Abfragezeichenfolgen einschließen: Beim Generieren des Cacheschlüssels werden die in den Parametern angegebenen Abfragezeichenfolgen eingeschlossen. Legen Sie in ARM-Vorlagen die queryStringCachingBehavior-Eigenschaft auf IncludeSpecifiedQueryStrings fest.
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
  • Aktiviert: Azure Front Door komprimiert Inhalte dynamisch im Edgebereich, wodurch die Antwort kleiner ist und schneller erfolgt. Weitere Informationen finden Sie unter Dateikomprimierung. Legen Sie in ARM-Vorlagen die isCompressionEnabled-Eigenschaft auf Enabled fest.
  • Deaktiviert. Front Door führt keine Komprimierung durch. Legen Sie in ARM-Vorlagen die isCompressionEnabled-Eigenschaft auf Disabled fest.
Cacheverhalten
  • Berücksichtigung des Ursprungs: Front Door berücksichtigt immer die Antwortheaderanweisung des Ursprungs. Wenn die ursprüngliche Anweisung fehlt, speichert Front Door den Inhalt ein bis drei Tage lang zwischen. Legen Sie in ARM-Vorlagen die cacheBehavior-Eigenschaft auf HonorOrigin fest.
  • Immer überschreiben: Der von Ihrem Ursprung zurückgegebene TTL-Wert wird mit dem in der Aktion angegebenen Wert überschrieben. Dieses Verhalten wird nur angewendet, wenn die Antwort zwischengespeichert werden kann. Legen Sie in ARM-Vorlagen die cacheBehavior-Eigenschaft auf OverrideAlways fest.
  • Überschreiben, wenn Ursprung fehlt: Wenn vom Ursprung kein TTL-Wert zurückgegeben wird, legt die Regel den TTL-Wert auf den in der Aktion angegebenen Wert fest. Dieses Verhalten wird nur angewendet, wenn die Antwort zwischengespeichert werden kann. Legen Sie in ARM-Vorlagen die cacheBehavior-Eigenschaft auf OverrideIfOriginMissing fest.
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. Bei einem Wert von 0 Sekunden speichert das CDN den Inhalt im Cache, muss jedoch jede Anforderung mit dem Ursprungsserver erneut überprüfen. Diese Eigenschaft wird nur festgelegt, wenn Cacheverhalten auf Immer überschreiben oder Überschreiben, wenn Ursprung fehlt festgelegt ist.
  • Im Azure-Portal: Geben Sie die Tage, Stunden, Minuten und Sekunden an.
  • In ARM-Vorlagen: Verwenden Sie cacheDuration, um die Dauer im Format d.hh:mm:ss anzugeben.

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.

Screenshot des Portals mit der Aktion „ Ursprungsgruppe außer Kraft setzen“.

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.

Screenshot des Portals mit Aktion der Cacheschlüssel-Abfragezeichenfolgen.

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.

Screenshot des Portals, das die Cacheablauf-Aktion anzeigt.

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
  • Anfügen: Der in Headername angegebene Header wird mit dem angegebenen Wert zur Anforderung hinzugefügt. Wenn der Header bereits vorhanden ist, wird der Wert mithilfe der Zeichenfolgenverkettung an den vorhandenen Headerwert angefügt. Es werden keine Trennzeichen hinzugefügt. Verwenden Sie in ARM-Vorlagen den headerAction von Append.
  • Überschreiben: Der in Headername angegebene Header wird mit dem angegebenen Wert zur Anforderung hinzugefügt. Wenn der Header bereits vorhanden ist, wird der vorhandene Wert von dem angegebenen Wert überschrieben. Verwenden Sie in ARM-Vorlagen den headerAction von Overwrite.
  • Löschen: Wenn der in der Regel angegebene Header vorhanden ist, wird der Header aus der Anforderung gelöscht. Verwenden Sie in ARM-Vorlagen den headerAction von Delete.
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.

Screenshot des Portals mit Aktion zum Ändern des Anforderungsheaders.

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
  • Anfügen: Der in Headername angegebene Header wird mit dem angegebenen Wert zur Antwort hinzugefügt. Wenn der Header bereits vorhanden ist, wird der Wert mithilfe der Zeichenfolgenverkettung an den vorhandenen Headerwert angefügt. Es werden keine Trennzeichen hinzugefügt. Verwenden Sie in ARM-Vorlagen den headerAction von Append.
  • Überschreiben: Der in Headername angegebene Header wird mit dem angegebenen Wert zur Antwort hinzugefügt. Wenn der Header bereits vorhanden ist, wird der vorhandene Wert von dem angegebenen Wert überschrieben. Verwenden Sie in ARM-Vorlagen den headerAction von Overwrite.
  • Löschen: Wenn der in der Regel angegebene Header vorhanden ist, wird der Header aus der Antwort gelöscht. Verwenden Sie in ARM-Vorlagen den headerAction von Delete.
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.

Screenshot des Portals mit Aktion zum Ändern des Antwortheaders.

URL Redirect

Verwenden Sie die URL-Umleitungs-Aktion, um Clients an eine neue URL umzuleiten. Clients werden eine Umleitungsantwort von Front Door gesendet.

Eigenschaften

Eigenschaft Unterstützte Werte
Umleitungstyp Der Antworttyp aus, der an den Anforderer zurückgegeben werden soll.
  • Im Azure-Portal: Found („gefunden“) (302), Moved („verschoben“) (301), Temporary Redirect („temporäre Umleitung“) (307), Permanent Redirect („permanente Umleitung“) (308).
  • In ARM-Vorlagen: Found, Moved, TemporaryRedirect, PermanentRedirect
Umleitungsprotokoll
  • Im Azure-Portal: Match Request, HTTP, HTTPS
  • In ARM-Vorlagen: MatchRequest, Http, Https
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 Servervariablenclient_ip verwendet.

Screenshot des Portals, das URL-Umleitungsaktion anzeigt.

URL Rewrite

Verwenden Sie die URL-Rewrite-Aktion, um den Pfad einer Anforderung auf dem Weg zu Ihrem Ursprung erneut zu generieren.

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.

Screenshot des Portals, das die URL-Rewriteaktion anzeigt.

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 Dienstebene Azure Front Door Standard oder Premium 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