Tous les produits
Search
Centre de documentation

CDN:Purger et précharger des ressources

Dernière mise à jour :Oct 11, 2026

La fonctionnalité de purge permet d'invalider les ressources mises en cache sur les nœuds edge CDN afin de forcer leur récupération depuis votre serveur d'origine. Cette approche s'avère particulièrement utile lors de la mise à jour de contenu, de la publication de nouvelles ressources, de la suppression de contenus non conformes ou de l'application de modifications de configuration de domaine. Le préchargement, quant à lui, place en cache les ressources populaires sur les nœuds edge avant les pics de trafic, ce qui allège la charge de votre serveur d'origine.

Fonctionnement

Purge des ressources

Une opération de purge envoie une commande d'invalidation de cache aux nœuds edge plutôt que de supprimer directement les fichiers. Lorsqu'un nœud edge reçoit cette commande, il marque les ressources en cache correspondantes comme « invalides » ou « expirées ». Lors de la requête suivante pour cette ressource, le nœud edge détecte l'invalidité du cache, interroge le serveur d'origine pour récupérer la dernière version, puis la diffuse à l'utilisateur tout en la mettant en cache.

Méthode de purge par défaut dans la console : lorsque vous effectuez une purge de répertoire ou une purge basée sur des expressions régulières dans la console CDN, le système applique par défaut une purge douce (soft purge). Celle-ci se contente de marquer le cache comme expiré. Lors de l'interrogation du serveur d'origine, le nœud edge inclut un en-tête If-Modified-Since ou If-None-Match dans la requête. Si le serveur d'origine renvoie une réponse 304 Not Modified, le nœud edge conserve l'ancienne copie en cache. Cette méthode économise le trafic d'interrogation vers l'origine, mais risque de laisser les utilisateurs accéder à un contenu obsolète, notamment lors de mises à jour de fichiers portant le même nom, de suppressions de contenus non conformes ou après des modifications de configuration. Pour vider complètement le cache, nous vous recommandons d'appeler l'opération d'API purgeObjectCaches et de définir le paramètre Force sur true afin d'exécuter une purge forcée.

Cas d'utilisation

  • Mises à jour et publications de ressources : après avoir mis à jour ou amélioré des ressources sur votre serveur d'origine, envoyez les URL ou répertoires correspondants pour une purge. Les utilisateurs accèdent ainsi au contenu le plus récent, qui est ensuite mis en cache sur les nœuds edge.

  • Suppression de ressources non conformes : si votre site web contient des éléments non conformes, leur simple suppression du serveur d'origine ne suffit pas, car ils peuvent subsister dans le cache des nœuds edge. Une purge d'URL s'impose alors pour éliminer les ressources mises en cache et garantir le retrait rapide de ces contenus.

Préchargement des ressources

Le préchargement repose sur un mécanisme de type « pull » : les nœuds edge récupèrent de manière proactive les ressources depuis votre serveur d'origine pour les placer en cache. Il ne s'agit donc pas d'une poussée (« push ») depuis l'origine. Cette technique accélère l'accès initial aux nouvelles ressources ou aux pages d'événements. Elle réduit également la pression sur le serveur d'origine lors du lancement de produits ou de campagnes, protégeant ainsi votre infrastructure.

Mécanisme de préchargement : par défaut, une opération de préchargement stocke les ressources sur les nœuds d'interrogation d'origine de niveau 2 (la couche de cache L2) au lieu de les distribuer à tous les nœuds edge L1. Lors du premier accès d'un utilisateur à une ressource, le nœud edge L1 récupère le contenu depuis un nœud d'interrogation d'origine de niveau 2 ou depuis le serveur d'origine, puis le met en cache. Le préchargement sert donc principalement à alléger la charge de votre serveur d'origine. Une couverture complète du cache sur les nœuds edge L1 dépend des habitudes réelles d'accès des utilisateurs. Ce n'est qu'après la mise en cache locale du contenu par un nœud L1, déclenchée par la requête d'un utilisateur, que les utilisateurs suivants de la même région bénéficient d'un accès direct au cache de ce nœud L1.

Cas d'utilisation

  • Configuration initiale de CDN : après avoir ajouté votre domaine à CDN, préchargez les ressources statiques populaires sur les nœuds edge. Les nœuds edge répondent alors directement aux requêtes des utilisateurs, ce qui supprime les temps de chargement initiaux élevés et améliore l'expérience utilisateur.

  • Lancement d'opérations promotionnelles : avant un événement majeur, préchargez toutes les ressources statiques des pages concernées. Au démarrage de l'événement, ces ressources sont déjà présentes dans le cache des nœuds edge et peuvent être diffusées immédiatement, garantissant ainsi des temps de chargement rapides.

  • Publication de packages d'installation ou de fichiers volumineux : avant de publier une nouvelle version ou un package de mise à jour, préchargez les ressources sur les nœuds edge. Dès la mise en ligne du produit, les nœuds edge traitent directement les requêtes de téléchargement, ce qui augmente la vitesse de transfert et diminue la charge de votre serveur d'origine.

Hiérarchie du cache de préchargement et résultats attendus

Une opération de préchargement stocke principalement les ressources sur les nœuds d'agrégation L2, et non sur l'ensemble des nœuds edge L1 (POP). Lorsqu'un utilisateur demande une ressource préchargée pour la première fois, le POP L1 la récupère depuis le nœud L2 ou le serveur d'origine. Le préchargement vise donc avant tout à réduire la pression sur le serveur d'origine, sans garantir de succès immédiat dans le cache de tous les POP L1.

  • Évaluation des coûts : le préchargement contribue à améliorer les taux de réussite dans le cache. Toutefois, pour les petits fichiers ou les ressources peu consultées, évaluez soigneusement son coût. En effet, cette opération génère un trafic d'interrogation vers l'origine, approximativement égal à la taille du fichier multipliée par le nombre de nœuds L2.

Prérequis

  • Permissions : pour appeler les opérations d'API de purge et de préchargement (telles que RefreshObjectCaches et PushObjectCache) ou pour exécuter ces opérations dans la console, un utilisateur RAM doit disposer des permissions cdn:RefreshObjectCaches (pour la purge) et cdn:PushObjectCache (pour le préchargement). Nous vous recommandons d'appliquer le principe du moindre privilège et de n'accorder que les permissions strictement nécessaires à votre activité. Pour plus d'informations, consultez la rubrique Autoriser un utilisateur RAM à précharger et purger des ressources.

  • Format d'URL : si une URL contient des caractères non ASCII, comme des caractères chinois ou des espaces, elle doit être encodée en pourcentage à l'aide de UTF-8. Dans le cas contraire, la tâche de purge ou de préchargement risque de ne pas prendre effet.

    Exemple : si un fichier de votre serveur d'origine possède le chemin https://<accelerated domain name>/文档/说明.pdf, encodez-le sous la forme https://<accelerated domain name>/%E6%96%87%E6%A1%A3/%E8%AF%B4%E6%98%8E.pdf avant d'envoyer la tâche de purge.

Remarques sur l'utilisation de la purge et du préchargement

  • Planification des tâches : les opérations de purge et de préchargement du cache génèrent toutes deux du trafic d'interrogation vers l'origine. Exécutez les tâches de purge et de préchargement à grande échelle pendant les heures creuses.

  • Configurer un cache partagé :

    • L'envoi d'une tâche de purge via le domaine principal ou n'importe quel domaine associé invalide le cache pour l'ensemble des domaines associés.

    • L'envoi d'une tâche de préchargement via le domaine principal ne précharge le contenu que pour le groupe de nœuds d'interrogation d'origine de ce domaine principal. Pour précharger également le contenu des domaines associés, soumettez une requête afin de vérifier si les groupes de nœuds d'interrogation d'origine du domaine principal et des domaines associés sont identiques. Si tel est le cas, le préchargement du domaine principal suffit.

  • Réécriture d'URL d'accès : si vous avez configuré une règle pour réécrire une URL d'accès, les nœuds génèrent la clé de cache à partir de l'URL réécrite. Par conséquent, soumettez l'URL réécrite pour les opérations de purge et de préchargement.

  • Purge et règles de cache : une purge d'URL invalide uniquement certaines ressources mises en cache sur les POP. Elle ne supprime ni ne modifie les règles de cache au niveau du répertoire configurées dans la console.

  • Indépendance vis-à-vis du serveur d'origine : les opérations de purge ciblent le cache des POP CDN et ne permettent pas de purger le cache d'un serveur d'origine spécifique. CDN masque les différences entre plusieurs serveurs d'origine ; les purges s'appliquent donc uniformément à toutes les ressources correspondantes sur l'ensemble des nœuds.

  • Purge d'URL avec paramètres ignorés : si un nom de domaine utilise une règle de cache de type « filtrage des paramètres », assurez-vous que l'URL de purge correspond à la clé de cache réelle, ou optez pour une purge de répertoire. Lors des déploiements canaris où les anciennes et nouvelles versions coexistent, purgez l'URL accompagnée de ses paramètres de version pour récupérer le contenu le plus récent.

  • Lorsque vous purgez ou préchargez des ressources pour un nom de domaine accéléré dans Alibaba Cloud CDN utilisant la signature d'URL, envoyez une URL correspondant à la clé de cache de la ressource. La console ne supprime pas les paramètres d'authentification, n'encode pas en pourcentage les valeurs des paramètres de requête et ne normalise d'aucune autre manière l'URL que vous envoyez.

    Pour un nom de domaine accéléré dont le traitement de signature d'URL a été confirmé comme supprimant les paramètres d'authentification et encodant en pourcentage les barres obliques dans les valeurs des paramètres de requête métier conservés, construisez l'URL finale de purge ou de préchargement de la manière suivante :

    1. URL d'accès client. Cette URL contient les paramètres de requête métier et les paramètres d'authentification.

      https://image.example.com/cat.jpg?x-oss-process=image/resize,m_fill,w_390,h_520,limit_1/auto-orient,1/sharpen,100/quality,q_80&k=123456789abcdefg&t=123abc
    2. URL après suppression des paramètres d'authentification. Retirez les paramètres de signature et d'horodatage configurés, tout en conservant les paramètres de requête métier.

      https://image.example.com/cat.jpg?x-oss-process=image/resize,m_fill,w_390,h_520,limit_1/auto-orient,1/sharpen,100/quality,q_80
    3. URL finale de purge ou de préchargement. Encodez en pourcentage les barres obliques présentes dans la valeur du paramètre de requête conservé afin que l'URL corresponde à la clé de cache confirmée. Les séparateurs de chemin, comme la barre oblique précédant cat.jpg, restent inchangés.

      https://image.example.com/cat.jpg?x-oss-process=image%2Fresize,m_fill,w_390,h_520,limit_1%2Fauto-orient,1%2Fsharpen,100%2Fquality,q_80

    Dans la méthode F, les noms des champs Signature Parameter et Timestamp Parameter se configurent pour chaque nom de domaine accéléré. Les paramètres k et t de cet exemple ne constituent pas des noms de paramètres fixes.

    Pour obtenir des instructions sur l'envoi d'URL de purge et de préchargement, consultez la rubrique Purger et précharger des ressources.

Coûts

Les fonctionnalités de purge et de préchargement n'entraînent aucuns frais opérationnels.

Ces deux opérations amènent toutefois les nœuds edge à récupérer des ressources sur le serveur d'origine, ce qui génère du trafic et des requêtes de récupération depuis l'origine. La facturation de ce trafic et de ces requêtes dépend du type de votre serveur d'origine :

Des opérations de purge ou de préchargement à grande échelle, en particulier lorsqu'elles sont réalisées sur une courte période, peuvent augmenter les coûts de récupération depuis l'origine. Évaluez l'impact financier potentiel avant de lancer ces opérations.

Procédure

Purger les ressources

  1. Connectez-vous à la console CDN.

  2. Dans le volet de navigation de gauche, cliquez sur Purge and Prefetch.

  3. Sous l'onglet Purge/Prefetch, sélectionnez Purge comme type d'opération.

  4. Choisissez un type de purge, puis envoyez la tâche.

Type de purge

Description

Purge d'URL

Objectif : invalider le cache d'un ou plusieurs fichiers spécifiques. Action : dans le champ de saisie URL, saisissez les URL complètes en incluant http:// ou https://, à raison d'une URL par ligne. Un compte peut soumettre jusqu'à 10 000 URL à purger par jour. Exemple : https://<accelerated domain name>/static/image.jpg.

Purge de répertoire

Objectif : invalider le cache de tous les fichiers et sous-répertoires situés sous un répertoire d'URL donné.Action : saisissez l'URL complète du répertoire, qui doit se terminer par une barre oblique (/). Exemple : https://<accelerated domain name>/static/. Remarque : cette méthode effectue une purge douce (soft purge). Pour forcer la purge d'un répertoire entier, utilisez l'API purgeObjectCaches et définissez Force=true. Vous pouvez soumettre jusqu'à 100 chemins de répertoires à la fois, et au maximum 100 chemins de répertoires par minute pour un même domaine.

Regular Expression

Objectif : invalider le cache de nombreuses ressources en faisant correspondre des chemins d'URL à une expression régulière. Cette approche convient aux purges groupées basées sur des numéros de version, des types de fichiers ou des segments de chemin.

Action : saisissez une URL contenant une expression régulière. Exemple : https://<accelerated domain name>/static/[0-9][a-z]..jpg. Actuellement, seuls les quatre modèles d'expression régulière suivants sont pris en charge :[0-9]: correspond à n'importe quel chiffre unique (0-9). Exemple : img[0-9].jpg correspond aux fichiers de img0.jpg à img9.jpg.[a-z]: correspond à n'importe quelle lettre minuscule unique (a-z). Exemple : file[a-z].txt correspond aux fichiers de filea.txt à filez.txt.[^/]: correspond à un segment de chemin unique (toute séquence de caractères sauf /). Exemple : cdn.aliyun.com/[^/].js correspond à tous les fichiers JS du répertoire racine..: correspond à n'importe quel segment de chemin (toute séquence de caractères, y compris /). Exemple : cdn.aliyun.com/.* correspond à toutes les ressources du domaine.

Remarque : cette méthode effectue une purge douce. Pour réaliser une purge forcée, utilisez l'API purgeObjectCaches et définissez Force=true. Nous vous recommandons d'utiliser des règles de correspondance précises afin d'éviter toute invalidation de cache involontaire et généralisée. Un compte peut soumettre jusqu'à 20 URL avec expressions régulières par jour.

Comment purger un site entier (purge complète ou purge du répertoire racine)

CDN ne propose pas d'option de purge complète en un clic. Vous pouvez toutefois y parvenir grâce aux méthodes suivantes :

  1. Purge de répertoire : choisissez Directory comme méthode de purge, puis saisissez l'URL du répertoire racine de votre nom de domaine (par exemple, https://<accelerated domain name>/). L'URL doit impérativement se terminer par une barre oblique (/).

  2. Purge forcée (API) : si certains POP continuent de diffuser du contenu obsolète après une purge de répertoire, appelez l'API de purge du cache (RefreshObjectCaches) et définissez le paramètre Force sur true. Une purge forcée supprime inconditionnellement les ressources mises en cache de tous les POP, ce qui contraint le système à récupérer les données auprès de l'origine lors de la requête suivante.

    Remarque

    Le paramètre Force n'est pas disponible dans le formulaire de purge de la console. Pour effectuer une purge forcée, utilisez l'API ou le SDK.

  3. Cliquez sur Submit pour lancer la tâche de purge.

    • Une fois envoyée, une tâche de purge ne peut plus être annulée.

    • La propagation d'une tâche de purge sur l'ensemble du réseau prend généralement entre 5 et 6 minutes. Si le délai d'expiration d'une ressource mise en cache est inférieur à cette durée, aucune purge manuelle n'est nécessaire.

    • Si vous activez la purge automatique du cache CDN dans la console OSS, les tâches de purge automatiques lancées depuis OSS n'apparaissent pas dans la console CDN.

Précharger les ressources

  1. Connectez-vous à la console CDN.

  2. Dans le volet de navigation de gauche, cliquez sur Purge and Prefetch.

  3. Sous l'onglet Purge/Prefetch, sélectionnez Prefetch comme type d'opération.

  4. Dans le champ de saisie d'URL, saisissez les URL complètes des fichiers à précharger, à raison d'une URL par ligne. Le préchargement de répertoires n'est pas pris en charge. Exemple : https://<accelerated domain name>/install/package.zip.

  5. Cliquez sur Submit pour lancer la tâche de préchargement.

    • Une fois envoyée, une tâche de préchargement ne peut plus être annulée.

    • Le temps nécessaire à l'exécution d'une tâche de préchargement dépend de la taille des fichiers, de leur nombre et des performances du serveur d'origine. Comptez généralement entre 5 et 30 minutes.

Remarques relatives au préchargement des fichiers OSS

Lorsque votre serveur d'origine est OSS, respectez les exigences suivantes concernant les URL :

  • Format d'URL : saisissez l'URL complète du nom de domaine accéléré par CDN (par exemple, https://cdn.example.com/path/file.zip). N'utilisez pas l'URL de l'endpoint interne ou public du bucket OSS (par exemple, https://<Origin Domain Name>/...).

  • Paramètres de signature : les URL de préchargement ne doivent contenir aucun paramètre de signature temporaire OSS tel que Expires, OSSAccessKeyId ou Signature. Ces paramètres d'autorisation temporaire entraînent l'échec des tâches de préchargement.

  • Code d'état de réponse du serveur d'origine : une tâche de préchargement exige que le serveur d'origine renvoie le code d'état 200. Si le serveur d'origine retourne une redirection 308 ou tout autre code d'état différent de 200, la tâche échoue. Par exemple, si l'absence de barre oblique finale dans l'URL provoque une redirection, ajoutez cette barre oblique puis renvoyez la tâche.

Paramètre

Description

Type de préchargement

Seul le préchargement d'URL est pris en charge. Le préchargement de répertoires n'est pas disponible.

URL

Les URL doivent inclure le préfixe http:// ou https://. Une URL de préchargement doit correspondre exactement au chemin d'un fichier de ressource. Les répertoires se terminant par / ne sont pas pris en charge. Pour précharger plusieurs URL, saisissez une URL par ligne.

Quota quotidien de préchargement d'URL : par défaut, vous pouvez soumettre jusqu'à 1 000 URL à précharger par jour et par compte. Si la bande passante maximale quotidienne de votre compte dépasse 200 Mbit/s, vous pouvez demander une augmentation de quota. Alibaba Cloud évaluera et configurera votre quota en fonction de vos besoins métier. Chaque tâche de préchargement accepte au maximum 100 URL.

Règle de file d'attente de préchargement : la taille maximale de la file d'attente de préchargement est de 100 000 URL par compte. Les URL sont préchargées dans l'ordre de leur soumission. Lorsque la file atteint 100 000 URL, le système rejette toute nouvelle tâche de préchargement.

Vitesse de préchargement : elle dépend de la taille moyenne des fichiers. Plus les fichiers sont petits, plus le préchargement est rapide.

Automatiser les tâches de purge ou de préchargement

Nous vous recommandons d'utiliser un script automatisé pour purger et précharger les ressources dans les situations suivantes :

  • Vous ne disposez pas de développeurs pour automatiser les tâches, et leur soumission manuelle engendre des coûts opérationnels élevés.

  • Le volume d'URL à purger ou à précharger est trop important pour qu'une soumission par lots reste efficace.

  • Vous devez vérifier manuellement ou par programmation que les tâches de purge et de préchargement s'exécutent correctement.

Vérifier les résultats

  • Requête manuelle

Dans l'onglet Records, consultez l'historique détaillé ainsi que la progression de vos tâches d'actualisation ou de préchargement. Une progression à 100 % indique que la tâche est terminée. L'actualisation ou le préchargement d'un grand nombre de ressources peut allonger le délai d'exécution.

  • Requête par API

Appelez l'opération d'API DescribeRefreshTasks pour interroger l'état d'une tâche d'actualisation ou de préchargement.

  • Vérification en ligne de commande

Exécutez la commande curl -I <URL>. Le résultat obtenu ressemble à l'exemple suivant :

~ % curl -I http://oss.xxx.cn/1.png
HTTP/1.1 200 OK
Server: Tengine
Content-Type: image/png
Content-Length: 1605553
Connection: keep-alive
Date: Sun, 23 Feb 2025 15:33:38 GMT
x-oss-request-id: 67BB3Fxxx32B63123
x-oss-cdn-auth: success
Accept-Ranges: bytes
ETag: "469118F2ACF477CACAF4C9xxx"
Last-Modified: Wed, 12 Feb 2025 03:29:36 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: xxx005350070
x-oss-storage-class: Standard
Content-MD5: RpEY8qz0d8rxxx
x-oss-server-time: 103
Via: cache6.12cn2655[196,195,200-0,M], cache15.12cn2655[197,0], kunlun3.cn192[0,0,200-0,H], kunlun7.cn192[3,0]
Age: 69
Ali-Swift-Global-Savetime: 1740324818
X-Cache: HIT TCP_MEM_HIT dirn:-2:-2
X-Swift-SaveTime: Sun, 23 Feb 2025 15:33:38 GMT
X-Swift-CacheTime: 3600
Timing-Allow-Origin: *
EagleId: 3adad01b1740324887846539le

Si l'en-tête X-Cache est présent :

  • Lorsque la valeur de X-Cache est HIT, la requête a atteint le cache, ce qui confirme la réussite du préchargement.

  • Si cette valeur correspond à MISS, la requête n'a pas touché le cache. La tâche de préchargement est alors inachevée ou a échoué. Relancez le préchargement de la ressource.

En l'absence de l'en-tête X-Cache :

Si l'en-tête X-Cache est absent, cela signifie que la ressource n'est pas accélérée par le CDN. Reportez-vous à la rubrique Ajouter un nom de domaine à Alibaba Cloud CDN pour ajouter le domaine de l'URL à Alibaba Cloud CDN avant de précharger la ressource.

Limites

Les fonctionnalités d'actualisation et de préchargement sont soumises à des quotas. Le système rejette toute tâche dépassant ces limites. Pour demander une augmentation de quota, accédez à Quota Management.

Type d'opération

Méthode

Quota

Gestion du quota

Actualisation

Actualisation d'URL

10 000 URL par compte et par jour

L'examen d'une demande d'augmentation de quota nécessite généralement un jour ouvrable. Pour plus d'informations sur la gestion de vos quotas, consultez la rubrique Gérer les quotas CDN.

Actualisation de répertoire

100 chemins par soumission ; 100 chemins par minute et par domaine

Regular Expression

20 URL par compte et par jour

Préchargement

Préchargement d'URL

100 URL par soumission ; 1 000 URL par compte et par jour

Bonnes pratiques pour le préchargement à grande échelle

  • Préchargement de répertoires non pris en charge : seul le préchargement d'URL de fichiers spécifiques est autorisé. Vous ne pouvez pas envoyer de chemins de répertoires se terminant par une barre oblique (/).

  • Priorité aux fichiers volumineux : si votre serveur d'origine (comme OSS) héberge un grand nombre de fichiers, limitez le préchargement aux fichiers volumineux tels que les packages d'installation et les vidéos. Les petits fichiers sont mis en cache sur les POP dès la première requête utilisateur ; leur préchargement s'avère donc généralement inutile.

  • Quotas et file d'attente : chaque compte dispose d'un quota quotidien par défaut de 1 000 tâches de préchargement d'URL. La file d'attente de préchargement accepte au maximum 100 000 URL. Pour demander une augmentation de quota, reportez-vous à la rubrique Gérer les quotas CDN.

  • Avertissement sur le trafic d'extraction depuis l'origine : un préchargement incite tous les nœuds d'agrégation L2 à récupérer les ressources auprès du serveur d'origine. Cette opération génère un trafic important (approximativement égal à la taille du fichier multipliée par le nombre de nœuds L2). Préchargez uniquement les ressources critiques avant les pics de trafic. Pour les charges de travail vidéo, privilégiez une optimisation de l'extraction par plages plutôt qu'un préchargement intégral du contenu.

Mécanismes d'actualisation du cache CDN

Pour les actualisations de répertoires et celles basées sur des expressions régulières, le CDN propose deux mécanismes : l'actualisation douce et l'actualisation forcée. Leur utilisation dépend du scénario afin de gérer efficacement le contenu mis en cache.

Actualisation douce (politique CDN par défaut)

  • Cas d'usage : mises à jour courantes de contenu, comme la publication de nouvelles versions de fichiers statiques.

  • Fonctionnement : il s'agit du comportement par défaut pour les actualisations de répertoires et d'expressions régulières envoyées via la console. Lorsqu'un nœud de périphérie CDN effectue une extraction depuis l'origine, il inclut un en-tête If-Modified-Since ou If-None-Match dans la requête. Le serveur d'origine s'appuie sur ces en-têtes pour déterminer si la ressource a été modifiée.

  • Effet : si la ressource du serveur d'origine reste inchangée, celui-ci renvoie le code d'état 304 Not Modified. Le nœud de périphérie CDN continue alors de distribuer l'ancienne copie mise en cache, sans consommer de trafic d'extraction. Cette méthode optimisée réduit les coûts et allège la charge du serveur d'origine. Remarque : si vous devez vider intégralement le cache (par exemple pour supprimer un contenu non conforme, appliquer des modifications de configuration ou mettre à jour un fichier portant le même nom), l'actualisation douce peut s'avérer insuffisante. Dans ce cas, optez pour une actualisation forcée.

Actualisation forcée

  • Cas d'usage : suppression urgente de ressources non conformes ou erronées, mise à jour imposée sur l'ensemble du réseau après la correction de configurations d'en-têtes de réponse Cache-Control incorrectes, ou remplacement d'un fichier homonyme sur le serveur d'origine.

  • Fonctionnement : pour déclencher une actualisation forcée, définissez le paramètre Force sur true lors de l'appel de l'opération d'API RefreshObjectCaches. Dans ce mode, le nœud de périphérie CDN invalide systématiquement la ressource mise en cache, sans effectuer de vérification 304.

  • Effet : lors de la requête suivante pour cette ressource, le nœud de périphérie CDN doit extraire la nouvelle version depuis l'origine, même si le fichier du serveur d'origine n'a pas changé.

Exemple de paramètre d'actualisation forcée via l'API :

{
  "ObjectType": "Directory",
  "ObjectPath": "https://<accelerated domain name>/static/",
  "Force": true
}

Description des paramètres clés :

  • ObjectType : spécifiez Directory ou File.

  • ObjectPath : indiquez le chemin complet du répertoire se terminant par /, ou l'URL précise d'un fichier.

  • Force : définissez ce paramètre sur true pour activer l'actualisation forcée. Le cache est ainsi vidé directement, en contournant la validation If-Modified-Since/If-None-Match du serveur d'origine.

Cas d'usage typiques de l'actualisation forcée

Nous recommandons d'utiliser l'actualisation forcée (en appelant l'API d'actualisation du cache avec le paramètre Force=true) dans les situations suivantes :

  • Suppression de contenus non conformes ou de logiciels malveillants : après avoir supprimé des fichiers malveillants du serveur d'origine, appliquez une actualisation forcée ou assurez-vous que le serveur d'origine renvoie le code d'état HTTP approprié (tel que 404) pour l'URL concernée. Sans cela, les POP risquent de continuer à distribuer le contenu non conforme depuis le cache après une revalidation standard.

  • Mise à jour de fichiers homonymes (modifications de configuration) : si vous remplacez un fichier sur le serveur d'origine par une nouvelle version portant le même nom, la revalidation peut renvoyer un code d'état 304 Not Modified et maintenir l'ancien contenu en cache. Recourez à l'actualisation forcée pour garantir la distribution de la dernière version sur tous les POP.

  • Problèmes d'affichage de pages ou boucles sur la page d'accueil : si d'autres pages de votre site affichent systématiquement la page d'accueil ou si les images s'affichent de manière incorrecte, et que l'actualisation d'URL ne résout pas le problème, lancez une actualisation de répertoire avec Force=true via l'API.

FAQ

FAQ sur l'actualisation et le préchargement