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 15 janvier 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.