En bref. Utilisez un remplacement de configuration de route avec un comportement sélectif de mise en cache des chaînes de requête et une liste de paramètres séparés par des virgules.

Définition : Le comportement de mise en cache des chaînes de requête (Query string caching behavior) d’Azure Front Door détermine quels paramètres de la requête contribuent à la clé de cache. Dans un ensemble de règles Standard ou Premium, une action de remplacement de la configuration de route (Route configuration override) peut utiliser Ignore specified query string avec les noms des paramètres à exclure, ou Include specified query string avec ceux à conserver.

Points clés

L’action Route configuration override peut remplacer la configuration de mise en cache d’une requête. Si la configuration de route est remplacée, la mise en cache doit être configurée, sinon elle est désactivée pour cette requête, selon la référence des actions des ensembles de règles de Microsoft.
Ignore specified query string exclut de la génération de la clé de cache les noms saisis dans le champ des paramètres. Include specified query string utilise ces noms pour générer la clé de cache.
Le champ Query parameters contient les noms des paramètres de chaîne de requête, séparés par des virgules. Il est utilisé avec les deux comportements sélectifs.
La documentation sur la mise en cache de Microsoft montre une clé passant de /foo/image/asset.html?language=EN&userid=100&sessionid=200 à /foo/image/asset.html?language=EN&sessionid=200 lorsque userid est exclu.
La référence de l’API des routes Front Door expose queryParameters sous forme de chaîne de caractères et mentionne IgnoreSpecifiedQueryStrings et IncludeSpecifiedQueryStrings parmi les comportements pris en charge.

Comment fonctionnent les modes sélectifs ?

L’action de remplacement de la configuration de route applique les paramètres de mise en cache aux requêtes qui correspondent à une règle. Son champ Query string caching behavior propose quatre choix documentés : Ignore Query String, Use query string, Ignore specified query string et Include specified query string. Le premier ignore toutes les chaînes de requête lors de la génération de la clé de cache. Le deuxième attribue une clé de cache propre à chaque URL unique. Les deux choix sélectifs utilisent les noms indiqués dans Query parameters.

Pour une liste d’exclusion, il faut sélectionner IgnoreSpecifiedQueryStrings et saisir les noms des paramètres dans une valeur séparée par des virgules. Pour une liste d’inclusion, il faut sélectionner IncludeSpecifiedQueryStrings et saisir les noms qui doivent influer sur la clé. L’exemple JSON de Microsoft montre la structure du mode d’inclusion :

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IncludeSpecifiedQueryStrings",
      "queryParameters": "customerId",
      "isCompressionEnabled": "Enabled",
      "cacheBehavior": "HonorOrigin",
      "cacheDuration": null
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

Les mêmes noms de champs s’appliquent lorsque le comportement sélectionné est IgnoreSpecifiedQueryStrings ; la valeur du comportement change et queryParameters contient les noms à exclure. La référence décrit cette liste comme des noms de paramètres de chaîne de requête séparés par des virgules.

Que remplace la règle ?

L’action peut remplacer le groupe d’origines ou la configuration de mise en cache de la route. Lorsque la mise en cache est activée dans l’action, la configuration détermine également si Front Door respecte la réponse de l’origine, remplace la durée de mise en cache ou utilise une durée lorsque l’origine ne fournit aucune durée de vie (TTL). Ces réglages sont distincts du choix des noms utilisés pour générer la clé de cache.

La page de Microsoft sur la mise en cache indique que la configuration de mise en cache du moteur de règles (Rules Engine) remplace toujours celle de la route. Elle précise également que le comportement relatif aux chaînes de requête peut être configuré sur la route, tandis qu’une action de règle peut appliquer une configuration de mise en cache différente aux requêtes correspondantes. Dans l’API des routes, la configuration du cache contient queryStringCachingBehavior et queryParameters, ce dernier étant décrit comme les paramètres à inclure ou à exclure.

Comment vérifier le résultat ?

La documentation sur la mise en cache indique que le journal d’accès contient l’état du cache pour chaque requête et que les rapports renseignent sur l’utilisation du cache de Front Door dans une application. La vérification porte sur les entrées correspondant aux requêtes traitées par la règle concernée. L’exemple documenté de clé de cache montre la forme attendue lorsqu’un paramètre est exclu, tandis que l’autre paire de la chaîne de requête reste dans la clé.

Termes associés

Questions fréquentes

Azure Front Door peut-il ignorer toutes les chaînes de requête ?

Oui. Le comportement Ignore Query String exclut les chaînes de requête de la génération de la clé de cache. Pour sélectionner certains noms, utilisez Ignore specified query string et indiquez les noms dans Query parameters.

Quelle est la différence entre Ignore specified et Include specified ?

Ignore specified retire les noms listés de la génération de la clé de cache. Include specified utilise les noms listés pour la mise en cache.

Une action de règle est-elle prioritaire sur le réglage de la route ?

Oui. La documentation de Microsoft sur la mise en cache indique que la configuration de mise en cache de Rules Engine remplace toujours celle de la route. La référence de l’action de remplacement de la configuration de route précise aussi que la mise en cache doit être configurée lorsque la configuration de route est remplacée.

Sources

Vérifiez comment une page se lit pour les moteurs de réponse. Ouvrir l’analyseur de score GEO

Comment Azure Front Door peut-il ignorer certains paramètres de suivi dans sa clé de cache ?