Utilizzo della memorizzazione negativa nella cache

Questa pagina fornisce istruzioni per l'utilizzo della memorizzazione nella cache negativa con Cloud CDN. La memorizzazione nella cache negativa consente di impostare un TTL diverso per ogni codice di stato.

Il motivo è quello di applicare un controllo granulare sulla memorizzazione nella cache per errori o reindirizzamenti comuni. Questo può ridurre il carico sulle origini e migliorare l'esperienza dell'utente finale riducendo la latenza di risposta.

Prima di iniziare

Leggi ulteriori informazioni sulle modalità cache e sui contenuti statici.
Assicurati che Cloud CDN sia abilitato. Per le istruzioni, consulta Utilizzo di Cloud CDN.
Se necessario, esegui l'aggiornamento all'ultima versione di Google Cloud CLI:
```
gcloud components update
```
Nota: assicurati di utilizzare gcloud CLI versione 316.0.0 o successiva.

Codici di stato e TTL predefiniti

La memorizzazione nella cache negativa si applica a specifici codici di stato, elencati nella tabella seguente.

Cloud CDN applica i seguenti TTL predefiniti a questi codici di stato:

Codice di stato	Significato	TTL
HTTP 300	Scelte multiple	10 minuti
HTTP 301 e 308	Reindirizzamenti permanenti	10 minuti
HTTP 302 e 307	Reindirizzamenti temporanei	Non memorizzato nella cache per impostazione predefinita
HTTP 404	Non trovato	120 secondi
HTTP 405	Metodo non trovato	60 secondi
HTTP 410	Gone (Non più disponibile)	120 secondi
HTTP 451	Non disponibile per motivi legali	120 secondi
HTTP 501	Non implementata	60 secondi

Puoi sostituire questi valori predefiniti utilizzando la memorizzazione nella cache negativa per impostare un TTL cache per il codice di stato HTTP specificato.

Configurazione della memorizzazione nella cache negativa

La memorizzazione nella cache negativa consente di configurare il servizio per gli errori della cache e le operazioni riuscite. In questo modo Cloud CDN può proteggere le origini dalle richieste che generano errori (come 404 - pagina non trovata) nello stesso modo in cui protegge le origini dalle richieste che generano risposte riuscite.

Console

Nella console Google Cloud, vai alla pagina Bilanciamento del carico.
Vai alla pagina Bilanciamento del carico
Fai clic sul nome del bilanciatore del carico delle applicazioni esterno.
Fai clic su Modifica .
In Configurazione backend, seleziona un backend e fai clic su Modifica .
Assicurati che l'opzione Abilita Cloud CDN sia selezionata.
Nella parte inferiore della finestra, fai clic su Configurazioni avanzate.
Fai clic su Abilita la memorizzazione nella cache negativa.
Fai clic su Aggiungi criterio di memorizzazione nella cache negativa.
1. Inserisci un codice di stato HTTP.
2. Seleziona un'opzione Durata durata (TTL).
Fai clic su Aggiorna.
Fai di nuovo clic su Aggiorna.

gcloud

Per i bucket di backend, utilizza il comando gcloud compute backend-buckets create o gcloud compute backend-buckets update con il flag --negative-caching.

Per i servizi di backend, utilizza il comando gcloud compute backend-services create o gcloud compute backend-services update con il flag --negative-caching.

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --negative-caching

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --negative-caching

Per attivare la memorizzazione nella cache negativa solo di due risposte di errore specifiche, ad esempio, imposta le risposte con codice di stato 404 da memorizzare nella cache per 60 secondi e le risposte con codice di stato 405 da memorizzare nella cache per 120 secondi.

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --negative-caching \
    --cache-mode=CACHE_ALL_STATIC \
    --default-ttl=86400 \
    --negative-caching-policy='404=60,405=120'

api

Per i bucket di backend, utilizza la chiamata API Method: backendBuckets.insert o Method: backendBuckets.update.

Per i servizi di backend, utilizza la chiamata API Method: backendServices.insert o Method: backendServices.update.

Utilizza una delle seguenti chiamate API:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

Aggiungi il seguente snippet al corpo della richiesta JSON:

"cdnPolicy": {
  "negativeCaching": ON,
  "negativeCachingPolicy": [
    {
      "code": STATUS_CODE,
      "ttl": TTL_SECONDS
    }
  ]
}

La memorizzazione nella cache negativa deve essere abilitata per configurare le impostazioni negativeCachingPolicy. Se ometti il criterio e hai attivato negativeCaching, Cloud CDN utilizza i valori predefiniti elencati in Codici di stato e TTL predefiniti.

Quando specifichi un criterio di memorizzazione nella cache negativa, assicurati di specificare un TTL cache per tutti i codici di risposta che vuoi memorizzare nella cache. Cloud CDN non applica alcuna memorizzazione nella cache negativa predefinita in presenza di un criterio.

Per STATUS_CODE, puoi specificare i seguenti codici di stato HTTP:

300, 301, 302, 307, 308
404, 405, 410, 421, 451
501

Per ogni codice di stato, puoi specificare un numero di secondi per memorizzare le risposte nella cache. Per disabilitare la memorizzazione nella cache negativa per il codice di stato, escludi il codice dal criterio di memorizzazione nella cache negativa.

Il valore massimo consentito è 1800 secondi (30 minuti); tuttavia, gli oggetti a cui si accede raramente potrebbero essere rimossi dalla cache prima del TTL definito.

Quando la modalità cache è impostata su CACHE_ALL_STATIC o USE_ORIGIN_HEADERS, la memorizzazione nella cache negativa viene applicata alle risposte con il codice di risposta specificato prive di intestazioni Cache-Control o Expires.

Quando la modalità cache è impostata su FORCE_CACHE_ALL, la memorizzazione nella cache negativa sostituisce qualsiasi intestazione di memorizzazione nella cache impostata dall'origine e Cloud CDN memorizza nella cache la risposta per il periodo di tempo specificato dal TTL oppure non la memorizza nella cache se non è impostato alcun TTL.

Inoltre, quando la modalità cache è impostata su FORCE_CACHE_ALL, Cloud CDN modificherà anche il valore max-age inviato al client nell'intestazione Cache-Control. In particolare, se per un determinato errore è configurata un'impostazione TTL, Cloud CDN utilizzerà il valore più basso tra l'impostazione TTL e l'impostazione di configurazione client_ttl e invierà un'intestazione Cache-Control: public,max-age=N con tale valore. Se per un determinato errore non è stata configurata un'impostazione TTL, Cloud CDN rimuoverà qualsiasi intestazione Cache-Control inviata dall'origine. Cloud CDN rimuoverà sempre qualsiasi intestazione Expires inviata dall'origine.

Se un'origine ha la memorizzazione nella cache negativa inizialmente abilitata ma poi disabilitata (manualmente o disattivando la memorizzazione nella cache per un determinato codice di risposta), le risposte di errore memorizzate nella cache sono considerate valide solo in base alle rispettive intestazioni Cache-Control o Expires. Di conseguenza, una volta disabilitata la memorizzazione nella cache negativa, una risposta senza direttive di età per la memorizzazione nella cache nelle intestazioni non viene fornita dalla cache.

Cloud CDN memorizza nella cache in risposta alle richieste GET. Per ulteriori informazioni, consulta la sezione Contenuti memorizzabili nella cache.

Ogni voce della cache è identificata da una chiave cache.

Disattiva memorizzazione nella cache negativa