Purge du cache du réseau CDN cdn-purge-cache
La purge supprime un objet du cache du réseau CDN d’Adobe, ce qui entraîne le traitement des futures requêtes vers l’origine en tant qu’absence de cache, plutôt que leur traitement à partir du cache.
AEM as a Cloud Service vous permet de configurer un jeton API de purge, qui peut ensuite être utilisé dans les appels API de purge. Lisez Configuration des informations d’identification et de l’authentification du réseau CDN pour savoir comment configurer ce jeton à l’aide des directives d’authentification du pipeline de configuration Cloud Manager.
Trois variations de purge sont prises en charge :
- Purge d’URL unique - purgez une seule ressource à la fois.
- Purge par clé de substitution - purge simultanée de plusieurs ressources.
- Purge complète - purge de toutes les ressources.
Toutes les variations de purge partagent les éléments suivants :
- La méthode HTTP doit être définie sur
PURGE. - L’URL peut être n’importe quel domaine associé au service AEM auquel la requête de purge est destinée.
- Le
X-AEM-Purge-Keydoit être fourni dans un en-tête HTTP.
Vous pouvez consulter un tutoriel axé sur la configuration des clés de purge et l’exécution de la purge du cache du réseau CDN.
Purge d’URL unique single-purge
Vous pouvez purger une seule ressource à la fois comme suit :
curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com/resource-path" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H 'X-AEM-Purge: soft'
Comme illustré dans l’exemple ci-dessus, vous pouvez éventuellement indiquer si le réseau de diffusion de contenu doit effectuer une purge hard (par défaut) ou soft sur les objets mis en cache.
La purge irréversible par défaut rend le contenu immédiatement inaccessible aux nouvelles requêtes jusqu’à ce que le contenu soit récupéré à partir de l’origine. La purge réversible marque le contenu comme obsolète, mais le diffuse toujours aux clients afin qu’ils n’aient pas besoin d’attendre que le contenu soit récupéré à partir de l’origine.
Purge de la clé de substitution surrogate-key-purge
Les clés de substitution sont des identifiants uniques que vous utilisez pour purger un ensemble de contenu. Elles sont appliquées au contenu en ajoutant un en-tête Surrogate-Key à la réponse. Une ou plusieurs clés de substitution peuvent être référencées dans un appel API de purge.
curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H "Surrogate-Key: my-surrogate-key"
-H "X-AEM-Purge: soft" #optional
Le ou les Surrogate-Key sont séparés par des espaces. De la même manière que pour la purge d’URL unique, vous pouvez configurer une purge réversible ou partielle.
Purge complète full-purge
Vous pouvez effectuer une purge complète de toutes les ressources mises en cache comme suit :
curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H "X-AEM-Purge: all"
N’oubliez pas que l’en-tête X-AEM-Purge doit inclure la valeur « all ».
Interaction avec le réseau CDN géré par le client
Dans le cas d’un réseau de diffusion de contenu géré par le client Customer Managed CDN les X-Forwarded-Host et X-AEM-Edge-Key doivent également être fournis :
curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com/resource-path" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H 'X-AEM-Edge-Key: <my_edge_key>' \
-H 'X-Forwarded-Host: <my_forwarded_domain>'
Interactions avec la couche Apache/Dispatcher apache-layer
Comme indiqué dans la section Flux de diffusion de contenu, le réseau CDN récupère le contenu de la couche Apache/Dispatcher, si le cache a expiré. Cela signifie qu’avant de purger une ressource sur le réseau CDN, vous devez vous assurer qu’une nouvelle version du contenu est également disponible sur le Dispatcher. Pour plus d’informations, consultez également la section Invalidation du cache de .