Ü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.