Eliminazione della cache CDN cdn-purge-cache
La rimozione rimuove un oggetto dalla cache di Adobe CDN, determinando richieste future che procedono all’origine come mancanti nella cache, anziché essere servite dalla cache.
AEM as a Cloud Service consente di configurare un token API di rimozione, che può quindi essere utilizzato nelle chiamate API di rimozione. Leggi Configurazione delle credenziali CDN e dell'autenticazione per scoprire come configurare questo token utilizzando le direttive di autenticazione della pipeline di configurazione di Cloud Manager.
Sono supportate tre varianti di eliminazione:
- Eliminazione URL singolo. Eliminare una singola risorsa alla volta.
- Rimuovi tramite chiave sostitutiva - elimina più risorse contemporaneamente.
- Rimozione completa - elimina tutte le risorse.
Tutte le varianti di eliminazione condividono quanto segue:
- Il metodo HTTP deve essere impostato su
PURGE. - L’URL può essere qualsiasi dominio associato al servizio AEM a cui è destinata la richiesta di eliminazione.
X-AEM-Purge-Keydeve essere fornito in un'intestazione HTTP.
Puoi fare riferimento a un'esercitazione incentrata sulla configurazione delle chiavi di eliminazione e sull'esecuzione dell'eliminazione della cache CDN.
Eliminazione di un singolo URL single-purge
Puoi eliminare una singola risorsa alla volta nel modo seguente:
curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com/resource-path" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H 'X-AEM-Purge: soft'
Come mostrato nell'esempio precedente, è possibile facoltativamente specificare se la rete CDN deve eseguire una rimozione di hard (impostazione predefinita) o di soft sugli oggetti memorizzati in cache.
L’eliminazione rigida predefinita rende il contenuto immediatamente inaccessibile alle nuove richieste fino a quando non viene recuperato dall’origine. La rimozione temporanea contrassegna il contenuto come non aggiornato, ma lo distribuisce comunque ai client, che non devono quindi attendere finché non viene recuperato dall’origine.
Elimina chiave sostitutiva surrogate-key-purge
Le chiavi sostitutive sono identificatori univoci utilizzati per eliminare un set di contenuti. Vengono applicati al contenuto aggiungendo un'intestazione Surrogate-Key alla risposta. È possibile fare riferimento a una o più chiavi sostitutive in una chiamata API di eliminazione.
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
I Surrogate-Key sono separati da spazi. Analogamente all’eliminazione con un singolo URL, puoi configurare un’eliminazione rigida o temporanea.
Pulizia completa full-purge
Puoi eseguire una rimozione completa di tutte le risorse memorizzate in cache come segue:
curl
-X PURGE "https://publish-p1234-e5467.adobeaemcloud.com" \
-H 'X-AEM-Purge-Key: <my_purge_key>' \
-H "X-AEM-Purge: all"
Tenere presente che l'intestazione X-AEM-Purge deve includere il valore 'all'.
Interazione con CDN gestito dal cliente
Nel caso di una rete CDN gestita dal cliente è necessario specificare anche X-Forwarded-Host e X-AEM-Edge-Key:
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>'
Interazioni con il livello Apache/Dispatcher apache-layer
Come descritto in Flusso di distribuzione dei contenuti, la rete CDN recupera il contenuto dal livello Apache/Dispatcher, se la cache è scaduta. Ciò significa che prima di eliminare una risorsa dalla rete CDN, è necessario assicurarsi che una nuova versione del contenuto sia disponibile anche in Dispatcher. Per ulteriori dettagli vedi anche Annullamento della validità della cache di Dispatcher.