comment configurer le filtrage des paramètres - ApsaraVideo VOD

Lorsque vous activez le filtrage des paramètres, les points de présence (POP) d'Alibaba Cloud CDN suppriment les paramètres situés après le point d'interrogation (?) dans l'URL de la requête. Ces paramètres peuvent inclure des informations telles que les identifiants utilisateur et les canaux d'accès. Le service CDN utilise ensuite l'URL résultante pour générer une clé de hachage de cache. Ce processus améliore le taux de succès du cache et accélère la diffusion du contenu. Cette rubrique explique comment configurer le filtrage des paramètres.

Comparaison des fonctionnalités

Clé de cache personnalisée entre en conflit avec l'ignorance des paramètres. Si vous configurez simultanément l'ignorance des paramètres et la clé de cache personnalisée, l'ignorance des paramètres devient invalide.

La clé de cache personnalisée peut remplacer l'ignorance des paramètres pour la configuration de la clé de cache et offre des fonctionnalités plus complètes. Nous vous recommandons de l'utiliser en priorité. Comparaison des configurations :

Scénario	Ignorer les paramètres	Clé de cache personnalisée
Ignorer tous les paramètres de requête dans la clé de cache	Définissez Ignorer les paramètres sur Oui et laissez Conserver les paramètres spécifiés vide.	Ajoutez une règle de gestion des paramètres de requête : Action : Conserver Nom du paramètre : définissez-le sur un nom de paramètre inexistant, par exemple example-argument.
Conserver uniquement le paramètre de requête key1 dans la clé de cache	Définissez Ignorer les paramètres sur Oui et définissez Conserver les paramètres spécifiés sur `key1`.	Ajoutez une règle de gestion des paramètres de requête : Action : Conserver Nom du paramètre : key1
Supprimer uniquement le paramètre de requête key1 de la clé de cache	Supprimez le paramétrage pour `key1`.	Ajoutez une règle de gestion des paramètres de requête : Action : Supprimer Nom du paramètre : key1

Réécrire les paramètres d'origine peut remplacer l'ignorance des paramètres pour la réécriture des requêtes vers l'origine et offre des fonctionnalités plus complètes. Nous vous recommandons de l'utiliser en priorité.

Présentation de la fonctionnalité

Ignorer les paramètres

Fonction

Scénarios

Supprime les paramètres de requête (la partie située après ?) des URL de requête afin que les requêtes avec différents paramètres atteignent le même fichier en cache. Cela améliore le taux de succès du cache et réduit le trafic vers l'origine.

Activez l'ignorance des paramètres lorsque les paramètres d'URL ne sont pas liés au contenu de la ressource (comme l'UID utilisateur, la source de référence ou les codes promotionnels). Par exemple, ces deux requêtes accèdent à la même ressource mais comportent des UID différents :

Utilisateur A : http://example.com/1.jpg?uid=123***

Utilisateur B : http://example.com/1.jpg?uid=654***

Sans l'ignorance des paramètres, les nœuds de bordure CDN traitent ces requêtes comme des ressources différentes et ne peuvent pas partager le même cache, ce qui nécessite une récupération depuis l'origine pour chaque requête. Avec l'ignorance des paramètres activée, les nœuds de bordure CDN suppriment les paramètres et utilisent http://example.com/1.jpg pour faire correspondre le cache.

Remarque

Signature d'URL est prioritaire sur l'ignorance des paramètres. La signature de type A inclut les paramètres d'URL dans sa signature. Le service CDN effectue d'abord l'authentification et met en cache le réplica uniquement après une validation réussie.

Conserver les paramètres d'origine

Fonction

Scénarios

Conserve tous les paramètres d'URL d'origine lors des récupérations depuis l'origine pour garantir que le serveur d'origine reçoit les informations utilisateur critiques.

Lorsque l'ignorance des paramètres est activée, les nœuds de bordure CDN utilisent par défaut l'URL dépouillée de ses paramètres pour les récupérations depuis l'origine. Dans l'exemple ci-dessus, l'utilisateur A et l'utilisateur B déclencheraient tous deux une requête vers l'origine vers http://example.com/1.jpg, perdant ainsi des informations critiques comme l'UID. L'activation de l'option Conserver les paramètres d'origine garantit que le service CDN utilise l'URL d'origine pour les récupérations depuis l'origine, en conservant les paramètres tels que l'UID pour le serveur d'origine.

Procédure

Connectez-vous à la console ApsaraVideo VOD.
Dans le volet de navigation de gauche, choisissez Configuration Management > CDN Configuration > Domain Names.
Sur la page Domain Names, recherchez le nom de domaine que vous souhaitez gérer et cliquez sur Configure dans la colonne Actions.
Dans le volet de navigation de gauche, cliquez sur Performance Optimization.
Dans la section Ignore Parameters, cliquez sur Modify.

Configurez les éléments requis, tels que le modèle de filtrage et les paramètres de filtrage.

Le tableau suivant décrit les paramètres.

Important

Le changement de modèle de filtrage supprime la configuration actuelle.

Modèle de filtrage : Conserver les paramètres spécifiés

Paramètre	Description	Exemple
Ignore Parameters	Oui : Active le filtrage des paramètres. Pour les requêtes de récupération depuis l'origine, les paramètres situés après le point d'interrogation (`?`) dans l'URL sont supprimés. Remarque Si vous activez Ignore Parameters mais laissez Retain specified parameters vide, tous les paramètres situés après le point d'interrogation (`?`) sont supprimés. Non : Désactive la fonctionnalité d'ignorance des paramètres.	Supposons que l'URL d'origine soit `http://example.com/1.jpg?key1=1&key2=2&key3=3`. Les exemples suivants montrent comment le service CDN traite l'URL en fonction des différentes configurations : Exemple 1 : Filtrer tous les paramètres + Utiliser l'URL traitée pour la récupération depuis l'origine : Configuration : définissez Ignore Parameters sur Oui, laissez Retain specified parameters vide et définissez Retain back-to-origin parameters sur Non. Clé de cache : `http://example.com/1.jpg` URL de récupération depuis l'origine : `http://example.com/1.jpg` Exemple 2 : Conserver les paramètres spécifiés + Utiliser l'URL traitée pour la récupération depuis l'origine : Configuration : définissez Ignore Parameters sur Oui, définissez Retain specified parameters sur `key1` et définissez Retain origin parameters sur Non. Clé de cache : `http://example.com/1.jpg?key1=1` URL de récupération depuis l'origine : `http://example.com/1.jpg?key1=1` Exemple 3 : Filtrer tous les paramètres + Utiliser l'URL d'origine pour la récupération depuis l'origine : Configuration : définissez Ignore Parameters sur Oui, laissez Retain specified parameters vide et définissez Retain back-to-origin parameters sur Oui. Clé de cache : `http://example.com/1.jpg` URL de récupération depuis l'origine : `http://example.com/1.jpg?key1=1&key2=2&key3=3` Exemple 4 : Conserver les paramètres spécifiés + Utiliser l'URL d'origine pour la récupération depuis l'origine : Configuration : définissez Ignore Parameters sur Oui, définissez Retain specified parameters sur `key1` et définissez Retain origin parameters sur Oui. Clé de cache : `http://example.com/1.jpg?key1=1` URL de récupération depuis l'origine : `http://example.com/1.jpg?key1=1&key2=2&key3=3`
Retain Specified Parameters	Spécifiez les paramètres à conserver. Vous pouvez spécifier jusqu'à 10 paramètres. Séparez plusieurs paramètres par des virgules (,).
Retain Origin Parameters	Oui : conserve tous les paramètres de l'URL de requête d'origine dans la requête de retour vers l'origine. Non : les paramètres de la requête de retour vers l'origine sont identiques aux paramètres de la clé de hachage de cache. Cela signifie que seuls les paramètres spécifiés sont conservés.

Modèle de filtrage : Supprimer les paramètres spécifiés

Paramètre

Description

Exemple

Supprimer les paramètres spécifiés

Spécifiez les paramètres à supprimer. Vous pouvez spécifier jusqu'à 10 paramètres. Séparez plusieurs paramètres par des espaces.

Supposons que l'URL d'origine soit http://example.com/1.jpg?key1=1&key2=2&key3=3. Les exemples suivants montrent comment le service CDN traite l'URL en fonction des différentes configurations :

Exemple 1 : Supprimer les paramètres spécifiés + Utiliser l'URL traitée pour la récupération depuis l'origine :
- Configuration : définissez Delete specified parameters sur key1 et définissez Retain origin parameters sur Non.
- Clé de cache : http://example.com/1.jpg?key2=2&key3=3
- URL de récupération depuis l'origine : http://example.com/1.jpg?key2=2&key3=3
Exemple 2 : Supprimer les paramètres spécifiés + Utiliser l'URL d'origine pour la récupération depuis l'origine :
- Configuration : définissez Delete specified parameters sur key1 et définissez Retain origin parameters sur Oui.
- Clé de cache : http://example.com/1.jpg?key2=2&key3=3
- URL de récupération depuis l'origine : http://example.com/1.jpg?key1=1&key2=2&key3=3

Retain Origin Parameters

Oui : conserve tous les paramètres de l'URL de requête d'origine dans la requête de retour vers l'origine.
Non : les paramètres de la requête de retour vers l'origine sont identiques aux paramètres de la clé de hachage de cache. Cela signifie que les paramètres spécifiés sont supprimés.

Cliquez sur OK.