Bereinigen des CDN-Caches cdn-purge-cache

Durch die Bereinigung wird ein Objekt aus dem Adobe-CDN-Cache entfernt, was dazu führt, dass zukünftige Anfragen als Cache-Fehler an die Quelle weitergeleitet werden, anstatt aus dem Cache bereitgestellt zu werden.
Mit AEM as a Cloud Service können Sie ein Bereinigungs-API-Token konfigurieren, das dann in Aufrufen der Bereinigungs-API verwendet werden kann. Lesen Sie den Artikel Konfigurieren der CDN-Anmeldeinformationen und der Authentifizierung, um zu erfahren, wie Sie dieses Token mithilfe der Authentifizierungsanweisungen der Cloud Manager-Konfigurations-Pipeline konfigurieren.

Es werden drei Bereinigungsvarianten unterstützt:

Alle Bereinigungsvarianten vereint Folgendes:

  • Als HTTP-Methode muss PURGE festgelegt sein.
  • Die URL kann eine beliebige Domain sein, die mit dem AEM-Dienst verknüpft ist, für den die Bereinigungsanfrage bestimmt ist.
  • Der X-AEM-Purge-Key muss in einem HTTP-Header angegeben werden.
CAUTION
Die Bereinigung des CDN-Caches, insbesondere mit Hardflag, erhöht den Traffic an der Quelle und kann zu einem Ausfall führen, sofern die Ausführung nicht ordnungsgemäß erfolgt.

Sie können ein Tutorial durchlaufen, das sich auf die Konfiguration von Bereinigungsschlüsseln und die Durchführung der CDN-Cache-Bereinigung konzentriert.

Einzelne URL-Bereinigung single-purge

Sie können jeweils eine einzelne Ressource wie folgt bereinigen:

curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com/resource-path" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H 'X-AEM-Purge: soft'

Wie im obigen Beispiel gezeigt, können Sie optional festlegen, ob das CDN die standardmäßige endgültige (harte) Bereinigung oder eine vorläufige (weiche) Bereinigung der zwischengespeicherten Objekte durchführen soll.

Bei der standardmäßigen endgültigen Bereinigung wird der Inhalt sofort für neue Anfragen unzugänglich; er muss dann von der Quelle abgerufen werden. Bei der weichen Bereinigung werden Inhalte als veraltet markiert, sie werden jedoch trotzdem Clients bereitgestellt, sodass sie nicht warten müssen, bis der Inhalt von der Quelle abgerufen wird.

Bereinigung durch Ersatzschlüssel surrogate-key-purge

Ersatzschlüssel sind eindeutige Kennungen, mit denen Sie einen Satz von Inhalten bereinigen können. Sie werden auf Inhalte angewendet, indem der Antwort ein Surrogate-Key-Header hinzugefügt wird. Ein oder mehrere Ersatzschlüssel können in einem Bereinigungs-API-Aufruf referenziert werden.

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

Die Surrogate-Key(s) werden durch Leerzeichen voneinander getrennt. Ähnlich wie bei der einzelnen URL-Bereinigung können Sie entweder eine endgültige oder vorläufige Bereinigung konfigurieren.

Vollständige Bereinigung full-purge

Sie können alle zwischengespeicherten Ressourcen wie folgt vollständig bereinigen:

curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H "X-AEM-Purge: all"

Beachten Sie, dass der X-AEM-Purge-Header den Wert „all“ enthalten muss.

Interaktion mit kundenverwaltetem CDN

Im Fall eines vom Kunden verwalteten CDN müssen auch die X-Forwarded-Host und X-AEM-Edge-Key angegeben werden:

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>'

Interaktionen mit der Apache-/Dispatcher-Ebene apache-layer

Wie im Artikel Ablauf der Inhaltsbereitstellung beschrieben, ruft das CDN Inhalte von der Apache-/Dispatcher-Ebene ab, wenn der Cache abgelaufen ist. Dies bedeutet, dass Sie vor dem Bereinigen einer Ressource im CDN sicherstellen sollten, dass auch eine neue Version des Inhalts beim Dispatcher verfügbar ist. Weitere Informationen finden Sie unter Dispatcher-Cache-Invalidierung.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab