Si les paramètres de l'URL de la requête initiale diffèrent de ceux attendus par votre serveur d'origine, utilisez la fonctionnalité de réécriture des paramètres pour modifier les paramètres de l'URL de la requête de récupération d'origine. Cette fonctionnalité permet d'ajouter, de supprimer, de conserver, de modifier ou d'ignorer des paramètres.
Format des paramètres d'URL
Les paramètres d'URL sont constitués d'une ou plusieurs paires
name/valueajoutées à une URL après un caractère?, selon le formatname=value. Plusieurs paramètres sont séparés par un caractère&.-
Une URL peut également contenir un caractère
#et le texte qui le suit. Le caractère#indique au navigateur une position spécifique sur une page web.Par exemple, dans
http://www.example.com/index.html#segment, la partie#segmentpointe vers l'emplacementsegmentde la pageindex.html. Une fois la page chargée, le navigateur fait automatiquement défiler la vue jusqu'à cet emplacement.
Priorité des opérations
La réécriture des paramètres vous permet de configurer plusieurs opérations de réécriture pour les paramètres de requête dans l'URL de récupération d'origine. L'ordre de priorité est le suivant : Add > Delete > Reserve Only > Modify. Lorsque différentes opérations ciblent le même paramètre, seule celle ayant la priorité la plus élevée prend effet.
Si l'option Ignore Parameters est activée, l'opération Add est la seule autre opération qui prend effet.
Conflits avec d'autres fonctionnalités
La fonctionnalité Parameter Rewrite peut entrer en conflit avec la règle enhance break de la fonction Réécrire l'URL de récupération d'origine et la fonctionnalité Ignorer les paramètres. En cas de conflit, la dernière fonctionnalité configurée est prioritaire.
Impact sur la clé de cache
La fonctionnalité Parameter Rewrite s'exécute au niveau du point de présence (POP) de récupération d'origine. Elle n'affecte pas le routage interne du CDN et ne réécrit pas la clé de cache.
La fonctionnalité Ignorer les paramètres s'exécute au niveau du nœud périphérique. Elle affecte le routage interne du CDN et réécrit la clé de cache.
Si une configuration utilise une condition de règle issue du moteur de règles, la priorité de la condition détermine l'ordre d'exécution, remplaçant ainsi l'ordre de configuration des fonctionnalités.
Procédure
Connectez-vous à la console CDN.
Dans le volet de navigation de gauche, cliquez sur Domain Names.
Sur la page Domain Names, localisez le nom de domaine cible et cliquez sur Manage dans la colonne Actions.
Dans le volet de navigation de gauche dédié au nom de domaine, cliquez sur Origin Fetch.
Cliquez sur l'onglet Parameter Rewrite.
Activez l'option Feature Switch.
-
Configurez les paramètres à réécrire.
Configurez les opérations de réécriture selon vos besoins. Vous pouvez également ajouter plusieurs paramètres dans la zone de texte pour chaque type d'opération. Pour plus d'informations, consultez les Exemples de configuration.
-
Cliquez sur OK pour appliquer la configuration.
Vous pouvez également cliquer sur Modify sur la page Parameter Rewrite pour modifier les règles existantes.
Exemples de configuration
-
Exemple 1 : Ignorer tous les paramètres
Parameter
Value
Ignore Parameters
Activé
Add
Aucun
Delete
Aucun
Reserve Only
Aucun
Modify
Aucun
Rule Condition
Non utilisé
Résultat
Requête d'origine :
http://example.com/index.html?code1=1&code2=2&code3=3Requête de récupération d'origine réécrite :
http://example.com/index.html -
Exemple 2 : Conserver un paramètre spécifique
Parameter
Value
Ignore Parameters
Désactivé
Add
Aucun
Delete
Aucun
Reserve Only
code2
Modify
Aucun
Rule Condition
Non utilisé
Résultat
Requête d'origine :
http://example.com/index.html?code1=1&code2=2&code3=3Requête de récupération d'origine réécrite :
http://example.com/index.html?code2=2 -
Exemple 3 : Ajouter, supprimer et modifier des paramètres
Parameter
Value
Ignore Parameters
Désactivé
Add
code4=4
Delete
code2
Reserve Only
Aucun
Modify
code3=0
Rule Condition
Non utilisé
Résultat
Requête d'origine :
http://example.com/index.html?code1=1&code2=2&code3=3Requête de récupération d'origine réécrite :
http://example.com/index.html?code1=1&code3=0&code4=4