Conditions de correspondance dans le moteur de règles standard de Microsoft Azure Content Delivery Network

Important

Azure CDN Standard de Microsoft (classique) sera mis hors service le 30 septembre 2027. Pour éviter toute interruption de service, il est important de migrer vos profils du niveau Azure CDN Standard de Microsoft (classique) vers le niveau Azure Front Door Standard ou Premium au plus tard le 30 septembre 2027. Pour découvrir plus d’informations, consultez Mise hors service d’Azure CDN Standard de Microsoft (classique).

Azure CDN d’Edgio sera mis hors service le 4 novembre 2025. Pour éviter toute interruption de service, vous devez migrer votre charge de travail vers Azure Front Door avant cette date. Pour plus d’informations, consultez la FAQ sur la mise hors service d’Azure CDN d’Edgio.

Dans le moteur de règles Standardde Microsoft Azure Content Delivery Network, une règle se compose d'une ou de plusieurs conditions de correspondance et d'une action. Cet article propose une description détaillée des conditions de correspondance que vous pouvez utiliser dans le moteur de règles standard de Microsoft Azure Content Delivery Network.

La première partie d’une règle est une condition de correspondance ou un ensemble de conditions de correspondance. Dans le moteur de règles standard de Microsoft Azure Content Delivery Network, chaque règle peut avoir jusqu'à quatre conditions de correspondance. Une condition de correspondance identifie des types spécifiques de requêtes pour lesquelles des actions définies sont exécutées. Si vous utilisez plusieurs conditions de correspondance, elles seront regroupées à l’aide de la logique AND.

Par exemple, vous pouvez utiliser une condition de correspondance pour les tâches suivantes :

  • Filtrer les requêtes en fonction d’une adresse IP, d’un pays ou d’une région.
  • Filtrer les requêtes d’après les informations d’en-tête.
  • Filtrer les requêtes provenant d’appareils mobiles ou de bureau.

Conditions de correspondance

Les conditions de correspondance suivantes peuvent être utilisées dans le moteur de règles Standard de Microsoft Azure Content Delivery Network.

Type d’appareil

Identifie les requêtes effectuées à partir d’un appareil mobile ou de bureau.

Champs obligatoires

Opérateur Valeurs prises en charge
Égal à, Non égal à Mobile et Bureau

Version HTTP

Identifie les requêtes en fonction de la version HTTP de la requête.

Champs obligatoires

Opérateur Valeurs prises en charge
Égal à, Non égal à 2.0, 1.1, 1.0, 0.9, Tout

Cookies de requête

Identifie les requêtes en fonction des informations des cookies figurant dans la requête entrante.

Champs obligatoires

Nom du cookie Opérateur Valeur du cookie Transformation de cas
String Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Informations essentielles

  • Vous ne pouvez pas utiliser de valeurs de caractère générique, y compris des astérisques (*), quand vous spécifiez un nom de cookie. Vous devez utiliser un nom de cookie exact.
  • Vous pouvez spécifier un seul nom de cookie par instance de cette condition de correspondance.
  • Les comparaisons de noms de cookie respectent la casse.
  • Pour spécifier plusieurs valeurs de cookie, utilisez un seul espace entre chaque valeur de cookie.
  • Les valeurs de cookie peuvent utiliser des valeurs de caractère générique.
  • Si aucune valeur de caractère générique n’est spécifiée, seule une correspondance exacte satisfait cette condition de correspondance. Par exemple, « Valeur » correspond à « Valeur », mais pas à « Valeur1 ».

Argument Post

Identifie les requêtes en fonction des arguments définis pour la méthode de demande POST utilisée dans la requête.

Champs obligatoires

Nom de l’argument Opérateur Valeur de l’argument Transformation de cas
String Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Chaîne de requête

Identifie les requêtes qui contiennent un paramètre de chaîne de requête spécifique. Ce paramètre est défini sur une valeur qui correspond à un modèle spécifique. Les paramètres de chaîne de requête (par exemple, paramètre = valeur) dans l’URL de requête déterminent si cette condition est remplie. Cette condition de correspondance identifie un paramètre de chaîne de requête par son nom et accepte une ou plusieurs valeurs pour la valeur du paramètre.

Champs obligatoires

Opérateur Chaîne de requête Transformation de cas
Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Adresse distante

Identifie les requêtes en fonction de l’emplacement ou de l’adresse IP du demandeur.

Champs obligatoires

Opérateur Valeurs prises en charge
Quelconque N/A
Géocorrespondance Code pays
Correspondance IP Adresse IP (séparée par des espaces)
Aucun N/A
Sans géocorrespondance Code pays
Sans correspondance IP Adresse IP (séparée par des espaces)

Informations essentielles

  • Utiliser la notation du routage CIDR (Classless InterDomain Routing).
  • Pour spécifier plusieurs adresses IP et blocs d’adresses IP, utilisez un espace unique entre les valeurs :
    • Exemple IPv4 : 1.2.3.4 10.20.30.40 correspond aux requêtes qui proviennent de l’adresse 1.2.3.4 ou 10.20.30.40.
    • Exemple IPv6 : 1:2:3:4:5:6:7:8 10:20:30:40:50:60:70:80 correspond aux requêtes qui proviennent de l’adresse 1:2:3:4:5:6:7:8 ou 10:20:30:40:50:60:70:80.
  • La syntaxe d’un bloc d’adresses IP est l’adresse IP de base suivie d’une barre oblique et de la taille de préfixe. Par exemple :
    • Exemple IPv4 : 5.5.5.64/26 correspond aux requêtes qui proviennent des adresses 5.5.5.64 à 5.5.5.127.
    • Exemple IPv6 : 1:2:3:/48 correspond aux requêtes qui proviennent des adresses 1:2:3:0:0:0:0:0 à 1:2:3:ffff:ffff:ffff:ffff:ffff.
  • L’adresse distante représente l’adresse IP d’origine du client, c’est-à-dire soit à partir de la connexion réseau, soit de l’en-tête de requête X-Forwarded-For si l’utilisateur se trouve derrière un proxy.

Corps de la demande

Identifie les requêtes en fonction d’un texte spécifique qui apparaît dans le corps de la requête.

Champs obligatoires

Opérateur Corps de la demande Transformation de cas
Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

En-tête de requête

Identifie les requêtes qui utilisent un en-tête spécifique dans la requête.

Champs obligatoires

Nom de l’en-tête Opérateur Valeur de l’en-tête Transformation de cas
String Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Méthode de requête

Identifie les requêtes qui utilisent la méthode de demande spécifiée.

Champs obligatoires

Opérateur Valeurs prises en charge
Égal à, Non égal à GET, POST, PUT, DELETE, HEAD, OPTIONS, TRACE

Informations essentielles

  • Seule la méthode de demande GET peut générer du contenu mis en cache dans Microsoft Azure Content Delivery Network. Toutes les autres méthodes de requête sont traitées par proxy sur le réseau.

Protocole de requête

Identifie les requêtes qui utilisent le protocole spécifié.

Champs obligatoires

Opérateur Valeurs prises en charge
Égal à, Non égal à HTTP, HTTPS

URL de la demande

Identifie les requêtes qui correspondent à l’URL spécifiée.

Champs obligatoires

Opérateur URL de la demande Transformation de cas
Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Informations essentielles

  • Lorsque vous utilisez cette condition de règle, veillez à inclure les informations de protocole. Par exemple : « https://www.<votredomaine>.com.

Extension de fichier d’URL

Identifie les requêtes qui incluent l’extension de fichier spécifiée dans le nom de fichier dans l’URL de la requête.

Champs obligatoires

Opérateur Extension Transformation de cas
Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Informations essentielles

  • Pour l’extension, n’incluez pas de point de début ; par exemple, utilisez html au lieu de .html.

Nom de fichier d’URL

Identifie les requêtes qui incluent le nom de fichier spécifié dans l’URL de la requête.

Champs obligatoires

Opérateur Nom de fichier Transformation de cas
Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Informations essentielles

  • Si vous spécifiez plusieurs noms de fichier, séparez chaque nom par une espace.

Chemin d'accès de l'URL

Identifie les requêtes qui incluent le chemin d’accès spécifié dans l’URL de la requête.

Champs obligatoires

Opérateur Valeur Transformation de cas
Liste des opérateurs standard Chaîne, Int Aucune transformation, en majuscules, en minuscules

Informations essentielles

  • Une valeur de nom de fichier peut utiliser des valeurs de caractère générique. Par exemple, chaque modèle de nom de fichier peut contenir un ou plusieurs astérisques (*), où chaque astérisque correspond à une séquence d’un ou de plusieurs caractères.

Informations de référence des conditions de correspondance du moteur de règles

Liste des opérateurs standard

Pour les règles qui acceptent les valeurs de la liste des opérateurs standard, les opérateurs suivants sont valides :

  • Quelconque
  • Égal à
  • Contient
  • Commence par
  • Se termine par
  • Inférieur à
  • Inférieur ou égal à
  • Supérieur à
  • Supérieur ou égal à
  • Aucun
  • Ne contient pas
  • Ne commence pas par
  • Ne se termine pas par
  • N’est pas inférieur à
  • N’est pas inférieur ou égal à
  • N’est pas supérieur à
  • N’est pas supérieur ou égal à

Pour les opérateurs numériques tels que Inférieur à et Supérieur ou égal à, la comparaison utilisée est basée sur la longueur. Dans ce cas, la valeur de la condition de correspondance doit être un entier égal à la longueur que vous souhaitez comparer.

Étapes suivantes