Annulla la convalida dei contenuti memorizzati nella cache

Questa pagina descrive come annullare la convalida dei contenuti memorizzati nella cache di Cloud CDN.

Ad esempio, se un file che si trova in /images/file.jpg è stato memorizzato nella cache e deve esserne annullata la convalida, puoi utilizzare diversi metodi per farlo, a seconda che tu voglia intervenire solo su quel file o su un ambito più ampio. In ogni caso, puoi annullare la convalida per tutti i nomi host o solo per uno.

Per scoprire di più sull'annullamento della convalida della cache, consulta Panoramica dell'annullamento della convalida della cache.

Prima di iniziare

Per annullare la convalida dei contenuti, puoi utilizzare Google Cloud CLI o la console Google Cloud .

Puoi accedere a Google Cloud CLI in due modi:

• Installa Google Cloud CLI seguendo le istruzioni riportate in Installazione con apt-get. Se non hai mai utilizzato Google Cloud CLI, esegui prima gcloud init per l'autenticazione.

• Utilizza Cloud Shell, in cui gcloud è già installato.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni o dei seguenti ruoli IAM.

Autorizzazioni

• compute.urlMaps.get
• compute.urlMaps.invalidateCache
• compute.urlMaps.list

Ruoli

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

Per creare un ruolo personalizzato con le autorizzazioni richieste, consulta Crea e gestisci ruoli personalizzati.

Per aggiungere un ruolo predefinito, utilizza la guida rapida di IAM.

Nota: se utilizzi un bilanciatore del carico delle applicazioni esterno globale con riferimento ai servizi tra progetti con VPC condiviso, consulta Annullamento della convalida con riferimento ai servizi tra progetti con VPC condiviso.

Annulla la convalida di un solo file

Console

1. Nella console Google Cloud , vai alla pagina Cloud CDN.

   Vai a Cloud CDN

2. Fai clic su un'origine.

3. Fai clic sulla scheda Annullamento convalida cache.

4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

5. In Specifica gli oggetti di cui annullare la convalida, esegui queste operazioni:

   • In Host, specifica un nome host, a meno che tu non voglia annullare la convalida del percorso di tutti i nomi host.
   • In Percorso, specifica il percorso e il nome file, ad esempio /images/file.jpg.

6. Fai clic su Invalida.

gcloud

Utilizza il comando gcloud compute url-maps invalidate-cdn-cache.

Per specificare un solo file di cui annullare la convalida, utilizza il flag --path con il nome file.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/images/file.jpg"

Sostituisci URL_MAP_NAME con il nome della tua mappa URL. Per elencare le mappe URL, utilizza il comando gcloud compute url-maps list.

Per annullare la convalida di un solo host, aggiungi il flag --host, ad esempio --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/file.jpg"

Per impostazione predefinita, Google Cloud CLI attende il completamento dell'annullamento della convalida. Per eseguire l'annullamento della convalida in background, aggiungi --async alla riga di comando.

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto della console Google Cloud
• URL_MAP_NAME: il nome della mappa URL

Per specificare un file di cui annullare la convalida, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "path": "/images/file.jpg"
}

Per annullare la convalida del file per un solo host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "/images/file.jpg"
}

Annulla la convalida dell'intera directory

Console

1. Nella console Google Cloud , vai alla pagina Cloud CDN.

   Vai a Cloud CDN

2. Fai clic su un'origine.

3. Fai clic sulla scheda Annullamento convalida cache.

4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

5. In Specifica gli oggetti di cui annullare la convalida, esegui queste operazioni:

   • In Host, specifica un nome host, a meno che tu non voglia annullare la convalida del percorso di tutti i nomi host.
   • In Percorso, specifica il percorso e un asterisco come carattere jolly, ad esempio /images/*.

6. Fai clic su Invalida.

gcloud

Utilizza il comando gcloud compute url-maps invalidate-cdn-cache.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/images/*"

Sostituisci URL_MAP_NAME con il nome della tua mappa URL.

Per annullare la convalida di un solo host, aggiungi il flag --host, ad esempio --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/*"

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto della console Google Cloud
• URL_MAP_NAME: il nome della mappa URL

Per specificare una directory di cui annullare la convalida, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "path": "/images/*"
}

Per annullare la convalida di una directory per un solo host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "/images/*"
}

Annulla la convalida in base ai tag della cache

Console

1. Nella console Google Cloud , vai alla pagina Cloud CDN.

   Vai a Cloud CDN

2. Fai clic su un'origine.

3. Fai clic sulla scheda Annullamento convalida cache.

4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

5. In Specifica gli oggetti di cui annullare la convalida, per Tag della cache, specifica uno o più tag di cui annullare la convalida. Utilizza spazi o virgole per separare i tag.

6. Fai clic su Invalida.

gcloud

Utilizza il comando gcloud beta compute url-maps invalidate-cdn-cache.

gcloud beta compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --tags=TAGS

Sostituisci quanto segue:

• URL_MAP_NAME: il nome della mappa URL
• TAGS: un tag o un elenco di tag separati da virgole; in alternativa, puoi specificare questo flag fino a 10 volte

Ad esempio, se la risposta del backend include un'intestazione Cache-Tag con un ID utente opaco, come un UUID4 o un altro tipo di GUID, puoi annullare la convalida di tutti i contenuti per un utente specifico utilizzando il flag tag. Inoltre, per annullare la convalida dei contenuti di un solo host, ad esempio per l'ambiente di gestione temporanea, aggiungi il flag --host.

gcloud beta compute url-maps invalidate-cdn-cache url_map_1 \
    --tags="1115b8f4-f804-4861-9629-8cb9aecdeeb3" \
    --host="host1.com"

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto della console Google Cloud
• URL_MAP_NAME: il nome della mappa URL

Per specificare i tag della cache di cui annullare la convalida, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "cacheTags": [
    "tag1",
    "tag2"
  ]
}

Puoi specificare un singolo tag o un elenco di tag separati da virgole.

Per annullare la convalida in base ai tag della cache per un solo host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "tag1,tag2"
}

Annulla la convalida di tutti i contenuti

Puoi annullare la convalida di tutti i contenuti, ma è un'operazione potenzialmente rischiosa. Valuta attentamente le tue esigenze prima di procedere.

Console

1. Nella console Google Cloud , vai alla pagina Cloud CDN.

   Vai a Cloud CDN

2. Fai clic su un'origine.

3. Fai clic sulla scheda Annullamento convalida cache.

4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

5. In Specifica gli oggetti di cui annullare la convalida, esegui queste operazioni:

   • In Host, specifica un nome host, a meno che tu non voglia annullare la convalida del percorso di tutti i nomi host.
   • Per Percorso, utilizza un asterisco, ad esempio /*.

6. Fai clic su Invalida e poi su Conferma per indicare che Cloud CDN deve annullare la convalida di tutti i contenuti.

gcloud

Utilizza il comando gcloud compute url-maps invalidate-cdn-cache.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/*"

Sostituisci quanto segue:

• URL_MAP_NAME: il nome della mappa URL
• /*: il percorso dell'URL di cui annullare la convalida; non include il nome host; il percorso può utilizzare un nome file esplicito o un asterisco come carattere jolly

Per annullare la convalida di un solo host, aggiungi il flag --host, ad esempio --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/*"

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto della console Google Cloud
• URL_MAP_NAME: il nome della mappa URL

Per specificare un percorso dell'URL di cui annullare la convalida, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "path": "/*"
}

Per annullare la convalida del percorso dell'URL per un solo host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "/*"
}

Visualizza lo stato della richiesta di annullamento della convalida

Cloud CDN genera due righe di log per ogni operazione di annullamento della convalida: una quando l'operazione viene accettata e l'altra quando viene completata. La prima contiene le informazioni su host e percorso.

Per visualizzare lo stato della tua richiesta di annullamento della convalida o trovare un elenco definitivo delle richieste inviate di recente, puoi utilizzare Cloud Logging o Cloud Monitoring.

Console

1. Nella console Google Cloud , vai alla pagina Cloud CDN.

   Vai a Cloud CDN

2. Fai clic su un'origine.

3. Fai clic sulla scheda Annullamento convalida cache.

4. Per visualizzare lo stato e i risultati della richiesta di annullamento della convalida, fai clic su Vai a Cloud Logging.

gcloud

Di seguito è riportato un comando di esempio che utilizza Cloud Logging:

gcloud logging read 'protoPayload.methodName="v1.compute.urlMaps.invalidateCache"' \
    --limit=10

Di seguito è riportato un esempio di query che utilizza Cloud Monitoring:

protoPayload.serviceName="compute.googleapis.com"
protoPayload.methodName="v1.compute.urlMaps.invalidateCache"

Passaggi successivi

• Per verificare se Cloud CDN gestisce le risposte dalla cache, consulta Visualizzazione dei log.
• Per scoprire quali contenuti sono memorizzabili nella cache o meno, consulta Panoramica della memorizzazione nella cache.