Freigeben über


Übereinstimmungsbedingungen in der Standardregel-Engine für Azure Content Delivery Network

Wichtig

Azure CDN Standard von Microsoft (klassisch) wird am 30. September 2027 eingestellt. Um Dienstunterbrechungen zu vermeiden, ist es wichtig, dass Sie Ihre Profile von Azure CDN Standard von Microsoft (klassisch) bis zum 30. September 2027 auf die Dienstebene Azure Front Door Standard oder Premium migrieren. Weitere Informationen finden Sie unter Einstellung von Azure CDN Standard von Microsoft (klassisch).

Azure CDN von Edgio wird am 4. November 2025 eingestellt. Sie müssen Ihre Workload vor diesem Datum zu Azure Front Door migrieren, um Dienstunterbrechungen zu vermeiden. Weitere Informationen finden Sie unter Häufig gestellte Fragen zur Einstellung von Azure CDN von Edgio.

In der Standardregel-Engine für Azure Content Delivery Network besteht eine Regel aus mindestens einer Übereinstimmungsbedingung und einer Aktion. In diesem Artikel werden die Übereinstimmungsbedingungen, die Sie in der Standardregel-Engine für Azure Content Delivery Network verwenden können, ausführlich beschrieben.

Der erste Teil einer Regel besteht aus einer Übereinstimmungsbedingung oder aus mehreren Übereinstimmungsbedingungen. In der Standardregel-Engine für Azure Content Delivery Network kann jede Regel bis zu vier Übereinstimmungsbedingungen haben. Eine Übereinstimmungsbedingung gibt bestimmte Typen von Anforderungen an, für die definierte Aktionen ausgeführt werden. Wenn Sie mehrere Übereinstimmungsbedingungen verwenden, werden die Übereinstimmungsbedingungen mit UND-Logik gruppiert.

Sie können eine Übereinstimmungsbedingung z.B. für Folgendes verwenden:

  • Filtern von Anforderungen basierend auf einer bestimmten IP-Adresse oder einem bestimmten Land/einer bestimmten Region.
  • Filtern von Anforderungen nach Headerinformationen
  • Filtern von Anforderungen von Mobil- oder Desktopgeräten.

Übereinstimmungsbedingungen

Die folgenden Übereinstimmungsbedingungen können auch in der Standardregel-Engine für Azure Content Delivery Network verwendet werden.

Gerätetyp

Identifiziert Anforderungen von einem Mobil- oder Desktopgerät.

Pflichtfelder

Operator Unterstützte Werte
Gleich, Ungleich Mobil, Desktop

HTTP-Version

Identifiziert Anforderungen auf der Grundlage der HTTP-Version der Anforderung.

Pflichtfelder

Operator Unterstützte Werte
Gleich, Ungleich 2.0, 1.1, 1.0, 0.9, All

Anforderungscookies

Identifiziert Anforderungen anhand der Cookieinformationen in der eingehenden Anforderung.

Pflichtfelder

Cookiename Operator Cookiewert Umwandlung der Groß-/Kleinschreibung
String Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Wichtige Informationen

  • In Cookienamen können Sie keine Platzhalterwerte (einschließlich Sternchen (*)) verwenden. Sie müssen den genauen Cookienamen angeben.
  • Für jede Instanz dieser Übereinstimmungsbedingung kann nur ein einziger Cookiename angegeben werden.
  • Beim Vergleichen von Cookienamen wird die Groß-/Kleinschreibung nicht beachtet.
  • Verwenden Sie zum Angeben mehrerer Cookiewerte ein einzelnes Leerzeichen zwischen den jeweiligen Cookiewerten.
  • Für Cookiewerte können Platzhalterwerte verwendet werden.
  • Wenn kein Platzhalterwert angegeben wurde, wird diese Übereinstimmungsbedingung nur bei einer genauen Übereinstimmung erfüllt. Beispielsweise entspricht „Value“ dem Wert „Value“, aber nicht dem Wert „Value1“.

POST-Argument

Identifiziert Anforderungen auf der Grundlage von Argumenten, die für die POST-Anforderungsmethode definiert sind, die in der Anforderung verwendet wird.

Pflichtfelder

Argumentname Operator Argumentwert Umwandlung der Groß-/Kleinschreibung
String Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Abfragezeichenfolge

Identifiziert Anforderungen, die einen bestimmten Abfragezeichenfolgenparameter enthalten. Dieser Parameter wird auf einen Wert festgelegt, der mit einem bestimmten Muster übereinstimmt. Abfragezeichenfolgenparameter (z.B. parameter=value) in der Anforderungs-URL bestimmen, ob diese Bedingung erfüllt ist. Mit dieser Übereinstimmungsbedingung wird ein Abfragezeichenfolgenparameter anhand des Namens identifiziert, und für den Parameterwert werden ein oder mehrere Werte akzeptiert.

Pflichtfelder

Operator Abfragezeichenfolge Umwandlung der Groß-/Kleinschreibung
Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Remoteadresse

Identifiziert Anforderungen basierend auf dem Standort oder der IP-Adresse des Anforderers.

Pflichtfelder

Operator Unterstützte Werte
Any
Geografische Übereinstimmung Landesvorwahl
IP-Übereinstimmung IP-Adresse (durch Leerzeichen getrennt)
Keine
Keine geografische Übereinstimmung Landesvorwahl
Keine IP-Übereinstimmung IP-Adresse (durch Leerzeichen getrennt)

Wichtige Informationen

  • Verwenden Sie klassenlose Interdomänenrouting (CIDR)-Notation.
  • Verwenden Sie zum Angeben mehrerer IP-Adressen und IP-Adressblöcke ein einzelnes Leerzeichen zwischen den Werten:
    • IPv4-Beispiel:1.2.3.4 10.20.30.30.40 entspricht allen Anforderungen, die entweder von der Adresse 1.2.3.4 oder 10.20.30.40 eingehen.
    • IPv6-Beispiel:1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:80 entspricht allen Anforderungen, die von einer der Adressen 1:2:3:4:5:6:7:8 oder 10:20:30:40:50:60:70:80 eingehen.
  • Die Syntax für einen IP-Adressblock besteht aus der IP-Basisadresse, gefolgt von einem Schrägstrich und der Präfixgröße. Beispiel:
    • IPv4-Beispiel:5.5.5.64/26 entspricht allen Anforderungen, die von den Adressen 5.5.5.64 bis 5.5.5.127 eingehen.
    • IPv6-Beispiel: Die Angabe 1:2:3:/48 führt zur Übereinstimmung mit eingehenden Anforderungen von den Adressen 1:2:3:0:0:0:0:0 bis 1:2:3:ffff:ffff:ffff:ffff:ffff.
  • Die Remoteadresse stellt die ursprüngliche Client-IP dar, die entweder von der Netzwerkverbindung oder in der Regel vom X-Forwarded-For-Anforderungs-Header kommt, wenn sich der Benutzer hinter einem Proxy befindet.

Anforderungstext

Identifiziert Anforderungen auf der Grundlage eines bestimmten Texts, der im Textkörper der Anforderung vorhanden ist.

Pflichtfelder

Operator Anforderungstext Umwandlung der Groß-/Kleinschreibung
Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Anforderungsheader

Identifiziert Anforderungen, die einen bestimmten Header in der Anforderung verwenden.

Pflichtfelder

Headername Operator Headerwert Umwandlung der Groß-/Kleinschreibung
String Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Anforderungsmethode

Identifiziert Anforderungen, die die angegebene Anforderungsmethode verwenden.

Pflichtfelder

Operator Unterstützte Werte
Gleich, Ungleich GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE

Wichtige Informationen

  • Nur die GET-Anforderungsmethode kann zwischengespeicherte Inhalte im Azure Content Delivery Network generieren. Alle anderen Anforderungsmethoden werden per Proxy durch das Netzwerk gesendet.

Anforderungsprotokoll

Identifiziert Anforderungen, die das angegebene Protokoll verwenden.

Pflichtfelder

Operator Unterstützte Werte
Gleich, Ungleich HTTP, HTTPS

Anfrage-URL

Identifiziert Anforderungen, die mit der angegebenen URL übereinstimmen.

Pflichtfelder

Operator Anfrage-URL Umwandlung der Groß-/Kleinschreibung
Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Wichtige Informationen

  • Wenn Sie diese Regelbedingung verwenden, achten Sie darauf, dass Sie Protokollinformationen einschließen. Beispiel: https://www.<yourdomain>.com

URL-Dateierweiterung

Identifiziert Anforderungen, die die angegebene Dateierweiterung in den Dateinamen in der anfordernden URL einschließen.

Pflichtfelder

Operator Durchwahl Umwandlung der Groß-/Kleinschreibung
Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Wichtige Informationen

  • Lassen Sie bei der Erweiterung den vorangestellten Punkt weg. Verwenden Sie also html anstelle von .html.

URL-Dateiname

Identifiziert Anforderungen, die den angegebenen Dateinamen in der anfordernden URL einschließen.

Pflichtfelder

Operator Dateiname Umwandlung der Groß-/Kleinschreibung
Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Wichtige Informationen

  • Um mehrere Dateinamen anzugeben, trennen Sie die einzelnen Dateinamen jeweils durch ein einzelnes Leerzeichen.

URL-Pfad

Identifiziert Anforderungen, die den angegebenen Pfad in der anfordernden URL einschließen.

Pflichtfelder

Operator Wert Umwandlung der Groß-/Kleinschreibung
Liste der Standardoperatoren String, Int Keine Umwandlung, in Großbuchstaben, in Kleinbuchstaben

Wichtige Informationen

  • Für Dateinamen können Platzhalterwerte verwendet werden. Beispielsweise kann jedes Dateinamensmuster ein oder mehrere Sternchen (*) enthalten, wobei jedes Sternchen für ein Zeichen oder eine Folge von Zeichen steht.

Referenz für Übereinstimmungsbedingungen der Regel-Engine

Liste der Standardoperatoren

Für Regeln, die Werte aus der Liste der Standardoperatoren akzeptieren, sind die folgenden Operatoren gültig:

  • Any
  • Equals
  • Enthält
  • Beginnt mit
  • Endet mit
  • Kleiner als
  • Kleiner als oder gleich
  • Größer als
  • Größer als oder gleich
  • Keine
  • Enthält nicht
  • Beginnt nicht mit
  • Endet nicht mit
  • Nicht kleiner als
  • Nicht kleiner als oder gleich
  • Nicht größer als
  • Nicht größer als oder gleich

Für numerische Operatoren wie Kleiner als oder Größer als oder gleich basiert der verwendete Vergleich auf der Länge. In diesem Fall muss der Wert in der Übereinstimmungsbedingung eine ganze Zahl sein, die der Länge entspricht, die Sie vergleichen möchten.

Nächste Schritte