DocumentationExperience Cloud KCS

Purge de grands ensembles de contenu AEM mis en cache lorsque des clés de substitution sont manquantes

Dernière mise à jour : 3 octobre 2026

Cet article décrit les options disponibles pour invalider le contenu mis en cache dans le réseau CDN d’Adobe Experience Manager as a Cloud Service lorsque les objets précédemment mis en cache ne contiennent pas l’en-tête Surrogate-Key et que la purge par préfixe de chemin d’accès est requise.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service
  • Réseau CDN géré par Adobe
  • Un jeu volumineux de contenu mis en cache dont les objets plus anciens n’ont pas d’en-tête Surrogate-Key

Problème/Symptômes

  • Après la mise à jour de la configuration du cache, les anciens objets mis en cache ne comportent pas le nouvel en-tête Surrogate-Key.
  • La purge par la nouvelle clé de substitution n’invalide pas ces objets plus anciens.
  • Vous devez invalider de nombreuses URL sans effacer le contenu mis en cache non associé.
  • Une purge complète du réseau CDN n’est pas souhaitable, car elle efface toutes les ressources mises en cache.

Cause

Les objets mis en cache avant l’ajout de l’en-tête Surrogate-Key ne disposent pas de cette clé et ne peuvent donc pas être purgés en tant que groupe à l’aide de la nouvelle clé. Le réseau CDN géré par Adobe prend en charge la purge à URL unique, la purge par clé de substitution et la purge complète. Il ne prend pas en charge la purge par préfixe de chemin d’accès ou caractère générique.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Examinez les méthodes de purge du réseau CDN prises en charge :

    • La purge d’une seule URL invalide une ressource.
    • La purge de la clé de substitution invalide les ressources mises en cache avec l’en-tête Surrogate-Key spécifié.
    • La purge complète invalide toutes les ressources mises en cache.
    • Les purges de préfixe de chemin et de caractère générique ne sont pas prises en charge.

  2. Purge des ressources nouvellement mises en cache par clé de substitution. Pour les ressources mises en cache après le changement de configuration qui possèdent le nouveau Surrogate-Key, envoyez une requête de purge de clé de substitution avec les en-têtes appropriés. Cela invalide tous les objets CDN avec cette clé.

  3. Pour les anciens objets mis en cache qui ne disposent pas de la clé de substitution, choisissez l’une des options suivantes :

    • Option A : envoyer une purge réversible pour chaque URL.

      • Générer une liste des URL concernées.
      • Utilisez un script pour envoyer une demande de purge réversible individuelle pour chaque URL.
      • Cela cible le contenu requis et évite une purge complète.
      • Avant la purge, assurez-vous que le contenu le plus récent est disponible au niveau Dispatcher ou Publication. Sinon, le réseau CDN peut à nouveau mettre en cache le contenu obsolète.

    • Option B : effectuer une purge complète unique du réseau CDN.

      • N’utilisez cette option que si l’effacement de tous les objets mis en cache est acceptable.
      • Une purge complète invalide tout le contenu mis en cache, et pas seulement les pages ciblées.
      • Attendez-vous à une augmentation temporaire du trafic d’origine pendant le remplissage du cache.

    • Option C : autoriser les TTL de cache précédentes à expirer.

      • Cette option ne nécessite aucune purge manuelle, mais il se peut que les utilisateurs ne voient pas le contenu mis à jour avant l’expiration des objets mis en cache.

  4. Après la purge ou l’attente de l’expiration des TTL, ouvrez les URL concernées et confirmez qu’elles affichent le contenu mis à jour.

recommendation-more-help
experience-cloud-kcs-help-kbarticles