Gestisci la durata della permanenza dei contenuti nella cache (scadenza)

Puoi controllare per quanto tempo i tuoi file rimangono in una CloudFront cache prima di CloudFront inoltrare un'altra richiesta all'origine. Riducendo la durata, puoi distribuire contenuti dinamici. Aumentando la durata, gli utenti otterranno prestazioni migliori, poiché è più probabile che i file vengano distribuiti direttamente dalla cache edge. Una durata maggiore riduce anche il carico sul server di origine.

In genere, CloudFront serve un file da una edge location fino alla scadenza della durata della cache specificata, ovvero fino alla scadenza del file. Dopo la scadenza, la volta successiva che l'edge location riceve una richiesta per il file, CloudFront inoltra la richiesta all'origine per verificare che la cache contenga la versione più recente del file. La risposta dall'origine dipende dall'eventuale modifica del file:

• Se la CloudFront cache ha già la versione più recente, l'origine restituisce un codice di stato. 304 Not Modified

• Se la CloudFront cache non ha la versione più recente, l'origine restituisce un codice di stato 200 OK e la versione più recente del file.

Se un file in una edge location non viene richiesto frequentemente, CloudFront potrebbe eliminarlo, ovvero rimuoverlo prima della data di scadenza, per fare spazio ai file che sono stati richiesti più di recente.

Ti consigliamo di gestire la durata della cache aggiornando la politica di cache della tua distribuzione. Se scegli di non utilizzare una politica di cache, il TTL (Time to Live) predefinito è di 24 ore, ma puoi aggiornare le seguenti impostazioni per sovrascrivere l'impostazione predefinita:

• Per modificare la durata della cache per tutti i file che corrispondono allo stesso modello di percorso, puoi modificare le CloudFront impostazioni di TTL minimo, TTL massimo e TTL predefinito per il comportamento della cache. Per informazioni sulle singole impostazioni, consulta TTL minimo, TTL massimo e TTL predefinito in Riferimento alle impostazioni di distribuzione.

• Per modificare la durata della cache per un singolo file, puoi configurare l'origine e aggiungere un'intestazione Cache-Control con la direttiva max-age o s-maxage oppure un'intestazione Expires al file. Per ulteriori informazioni, consulta Utilizzate le intestazioni per controllare la durata della cache per i singoli oggetti.

Per ulteriori informazioni su come Minimum TTL (TTL minimo), Default TTL (TTL predefinito) e Maximum TTL (TTL massimo) interagiscono con le direttive max-age e s-maxage e il campo intestazione Expires, consulta Specificate la quantità di tempo di memorizzazione degli oggetti nella cache CloudFront .

Puoi anche controllare per quanto tempo gli errori (ad esempio404 Not Found) rimangono in una CloudFront cache prima di CloudFront riprovare a recuperare l'oggetto richiesto inoltrando un'altra richiesta all'origine. Per ulteriori informazioni, consulta In che modo CloudFront elabora i codici di stato HTTP 4xx e 5xx dalla tua origine.

Utilizzate le intestazioni per controllare la durata della cache per i singoli oggetti

Puoi utilizzare le intestazioni Cache-Control e Expires per controllare la durata della permanenza degli oggetti nella cache. Anche le impostazioni per Minimum TTL (TTL minimo), Default TTL (TTL predefinito) e Maximum TTL (TTL massimo) influiscono sulla durata della cache, ma qui di seguito trovi una panoramica su come le intestazioni abbiano un impatto sulla durata della cache:

• La Cache-Control max-age direttiva consente di specificare per quanto tempo (in secondi) un oggetto deve rimanere nella cache prima di CloudFront recuperarlo dal server di origine. Il tempo di scadenza minimo CloudFront supportato è 0 secondi. Il valore massimo è 100 anni. Specifica il valore nel seguente formato:

  Cache-Control: max-age=seconds

  Ad esempio, la seguente direttiva indica CloudFront di mantenere l'oggetto associato nella cache per 3600 secondi (un'ora):

  Cache-Control: max-age=3600

  Se desideri che gli oggetti rimangano nelle cache CloudFront edge per una durata diversa da quella che rimangono nelle cache del browser, puoi usare le direttive Cache-Control max-age and Cache-Control s-maxage insieme. Per ulteriori informazioni, consulta Specificate la quantità di tempo di memorizzazione degli oggetti nella cache CloudFront .

• Il campo intestazione Expires consente di specificare una data di scadenza e un orario utilizzando il formato specificato in RFC 2616, Hypertext Transfer Protocol - HTTP/1.1 Sezione 3.3.1, Data completa, ad esempio:

  Sat, 27 Jun 2015 23:59:59 GMT

È consigliabile utilizzare la direttiva Cache-Control max-age invece del campo dell'intestazione Expires per controllare la memorizzazione nella cache dell'oggetto. Se specifichi i valori sia per Cache-Control max-age sia per Expires, CloudFront utilizza solo il valore di Cache-Control max-age.

Per ulteriori informazioni, consulta Specificate la quantità di tempo di memorizzazione degli oggetti nella cache CloudFront .

Non è possibile utilizzare i campi HTTP Cache-Control o di Pragma intestazione in una GET richiesta di un visualizzatore per CloudFront forzare il ritorno al server di origine dell'oggetto. CloudFront ignora quei campi di intestazione nelle richieste dei visualizzatori.

Per ulteriori informazioni sui campi delle intestazioni Cache-Control e Expires, consulta le seguenti sezioni in RFC 2616, Hypertext Transfer Protocol - HTTP/1.1:

• Section 14.9 Controllo della cache

• Section 14.21 Scadenze

Pubblica contenuti non aggiornati (scaduti)

CloudFront supporta le direttive di controllo Stale-While-Revalidate e Stale-If-Error cache. È possibile utilizzare queste direttive per specificare per quanto tempo i contenuti non aggiornati devono rimanere disponibili per gli utenti.

Argomenti

• Stale-While-Revalidate

• Stale-If-Error

• Usa entrambe le direttive

Stale-While-Revalidate

Questa direttiva consente di CloudFront fornire contenuti obsoleti dalla cache mentre recupera in modo CloudFront asincrono una nuova versione dall'origine. Ciò migliora la latenza in quanto gli spettatori ricevono le risposte immediatamente dalle postazioni periferiche senza dover attendere il recupero in background. I nuovi contenuti vengono caricati in background per le richieste future.

Esempio: Stale-While-Revalidate

CloudFront esegue le seguenti operazioni quando si imposta l'Cache-Controlintestazione per utilizzare queste direttive.

Cache-Control: max-age=3600, stale-while-revalidate=600

1. CloudFront memorizzerà nella cache una risposta per un'ora ()max-age=3600.

2. Se viene effettuata una richiesta dopo tale periodo, CloudFront serve il contenuto non aggiornato e contemporaneamente invia una richiesta all'origine per riconvalidare e aggiornare il contenuto memorizzato nella cache.

3. Mentre il contenuto viene riconvalidato, CloudFront serve il contenuto obsoleto per un massimo di 10 minuti (). stale-while-revalidate=600

Nota

CloudFront offrirà il contenuto non aggiornato fino al valore della stale-while-revalidate direttiva o al valore del TTL CloudFront massimo, a seconda di quale sia inferiore. Dopo la durata massima del TTL, l'oggetto obsoleto non sarà disponibile dalla cache edge, indipendentemente dal valore. stale-while-revalidate

Stale-If-Error

Questa direttiva consente di CloudFront fornire contenuti obsoleti dalla cache se l'origine non è raggiungibile o restituisce un codice di errore compreso tra 500 e 600. Ciò garantisce che i visualizzatori possano accedere ai contenuti anche durante un'interruzione dell'origine.

Esempio: Stale-If-Error

CloudFront esegue quanto segue quando si imposta l'Cache-Controlintestazione per utilizzare queste direttive.

Cache-Control: max-age=3600, stale-if-error=86400

1. CloudFront memorizza nella cache la risposta per un'ora (). max-age=3600

2. Se l'origine non è attiva o restituisce un errore dopo tale periodo, CloudFront continua a fornire il contenuto non aggiornato per un massimo di 24 ore () stale-if-error=86400

3. Se hai configurato risposte di errore personalizzate, CloudFront tenterà di fornire il contenuto non aggiornato se si verifica un errore entro la durata specificatastale-if-error. Se il contenuto obsoleto non è disponibile, CloudFront fornirà le risposte di errore personalizzate configurate per il codice di stato dell'errore corrispondente. Per ulteriori informazioni, consulta Generazione di risposte di errore personalizzate.

Note

• CloudFront offrirà il contenuto non aggiornato fino al valore della stale-if-error direttiva o al valore del TTL CloudFront massimo, a seconda di quale sia inferiore. Dopo la durata massima del TTL, l'oggetto obsoleto non sarà disponibile dalla cache edge, indipendentemente dal valore. stale-if-error

• Se non configuri stale-if-error o personalizzi le risposte di errore, CloudFront restituirà l'oggetto non aggiornato o inoltrerà la risposta di errore al visualizzatore, a seconda che l'oggetto richiesto si trovi o meno nella cache edge. Per ulteriori informazioni, consulta Come CloudFront elabora gli errori se non hai configurato pagine di errore personalizzate.

Usa entrambe le direttive

Entrambe stale-while-revalidate stale-if-error sono direttive di controllo della cache indipendenti che è possibile utilizzare insieme per ridurre la latenza e aggiungere un buffer per la risposta o il ripristino dell'origine.

Esempio: utilizzo di entrambe le direttive

CloudFront esegue le seguenti operazioni quando si imposta l'Cache-Controlintestazione per utilizzare le seguenti direttive.

Cache-Control: max-age=3600, stale-while-revalidate=600, stale-if-error=86400

1. CloudFront memorizza la risposta nella cache per un'ora (). max-age=3600

2. Se viene effettuata una richiesta dopo tale periodo, CloudFront serve il contenuto non aggiornato per un massimo di 10 minuti (stale-while-revalidate=600) mentre il contenuto viene riconvalidato.

3. Se il server di origine restituisce un errore durante il CloudFront tentativo di riconvalidare il contenuto, CloudFront continuerà a fornire il contenuto non aggiornato per un massimo di 24 ore (). stale-if-error=86400

Il caching è un equilibrio tra prestazioni e dati aggiornati. L'uso di direttive come stale-while-revalidate e stale-if-error può migliorare le prestazioni e l'esperienza utente, ma è necessario assicurarsi che le configurazioni siano in linea con l'aggiornamento desiderato dei contenuti. Le direttive sui contenuti non aggiornati sono più adatte per i casi d'uso in cui i contenuti devono essere aggiornati ma la disponibilità della versione più recente non è essenziale. Inoltre, se i contenuti non cambiano o cambiano raramente, stale-while-revalidate potrebbe aggiungere richieste di rete non necessarie. Prendere invece in considerazione l'impostazione di una lunga durata della cache.

Specificate la quantità di tempo di memorizzazione degli oggetti nella cache CloudFront

Per controllare il periodo di tempo che CloudFront mantiene un oggetto nella cache prima di inviare un'altra richiesta all'origine, puoi:

• Imposta i valori TTL minimo, massimo e predefinito nel comportamento della cache di una CloudFront distribuzione. È possibile impostare questi valori in una policy di cache collegata al comportamento della cache (scelta consigliata) o nelle impostazioni della cache legacy.

• Includere l'intestazione Cache-Control o Expires nelle risposte dall'origine. Queste intestazioni aiutano anche a determinare per quanto tempo un browser conserva un oggetto nella cache del browser prima di inviare un'altra richiesta a. CloudFront

Nella tabella seguente viene illustrato come le intestazioni Cache-Control e Expires inviate dall'origine funzionano insieme alle impostazioni TTL in un comportamento di cache per influire sulla memorizzazione nella cache.

Intestazioni di origine	TTL minimo = 0	TTL minimo = 0
L'origine aggiunge una direttiva Cache-Control: max-age all’oggetto	CloudFront memorizzazione nella cache CloudFront memorizza nella cache l'oggetto con il valore minore tra il valore della Cache-Control: max-age direttiva o il valore del CloudFront TTL massimo. Caching del browser I browser memorizzano nella cache l’oggetto per il valore della direttiva Cache-Control: max-age.	CloudFront memorizzazione nella cache CloudFront la memorizzazione nella cache dipende dai valori del TTL CloudFront minimo e del TTL massimo e dalla direttiva: Cache-Control max-age Se TTL minimo < max-age < TTL massimo, memorizza nella CloudFront cache l'oggetto per il valore della direttiva. Cache-Control: max-age Se max-age < TTL minimo, memorizza nella CloudFront cache l'oggetto per il valore del TTL minimo. CloudFront Se max-age > TTL massimo, memorizza l'oggetto nella CloudFront cache per il valore del TTL massimo. CloudFront Caching del browser I browser memorizzano nella cache l’oggetto per il valore della direttiva Cache-Control: max-age.
L'origine non aggiunge una direttiva Cache-Control: max-age all’oggetto	CloudFront memorizzazione nella cache CloudFront memorizza nella cache l'oggetto per il valore del TTL CloudFront predefinito. Caching del browser Dipende dal browser.	CloudFront memorizzazione nella cache CloudFront memorizza l'oggetto nella cache per il valore maggiore tra il TTL CloudFront minimo o il TTL predefinito. Caching del browser Dipende dal browser.
L'origine aggiunge le direttive Cache-Control: max-age e Cache-Control: s-maxage all’oggetto	CloudFront memorizzazione nella cache CloudFront memorizza nella cache l'oggetto con il valore minore tra il valore della Cache-Control: s-maxage direttiva o il valore del CloudFront TTL massimo. Caching del browser I browser memorizzano nella cache l’oggetto per il valore della direttiva Cache-Control max-age.	CloudFront memorizzazione nella cache CloudFront la memorizzazione nella cache dipende dai valori del TTL CloudFront minimo e del TTL massimo e dalla direttiva: Cache-Control: s-maxage Se TTL minimo < s-maxage < TTL massimo, memorizza nella CloudFront cache l'oggetto per il valore della direttiva. Cache-Control: s-maxage Se s-maxage < TTL minimo, memorizza nella CloudFront cache l'oggetto per il valore del TTL minimo. CloudFront Se s-maxage > TTL massimo, memorizza l'oggetto nella CloudFront cache per il valore del TTL massimo. CloudFront Caching del browser I browser memorizzano nella cache l’oggetto per il valore della direttiva Cache-Control: max-age.
L'origine aggiunge un'intestazione Expires all’oggetto	CloudFront memorizzazione nella cache CloudFront memorizza l'oggetto nella cache fino alla data indicata nell'Expiresintestazione o per il valore del TTL CloudFront massimo, a seconda di quale dei due eventi si verifichi prima. Caching del browser I browser memorizzano nella cache l’oggetto fino alla data presente nell'intestazione Expires.	CloudFront memorizzazione nella cache CloudFront la memorizzazione nella cache dipende dai valori del TTL CloudFront minimo e del TTL massimo e dall'intestazione: Expires Se TTL minimo < Expires < TTL massimo, memorizza l'oggetto nella CloudFront cache fino alla data e all'ora indicate nell'intestazione. Expires Se Expires < TTL minimo, memorizza l'oggetto nella CloudFront cache per il valore del TTL minimo. CloudFront Se Expires > TTL massimo, memorizza l'oggetto nella CloudFront cache per il valore del TTL massimo. CloudFront Caching del browser I browser memorizzano nella cache l’oggetto fino alla data e all'ora presenti nell'intestazione Expires.
L'origine aggiunge le direttive Cache-Control: no-cache, no-store e/o private all’oggetto	CloudFront e i browser rispettano le intestazioni.	CloudFront memorizzazione nella cache CloudFront memorizza nella cache l'oggetto per il valore del TTL CloudFront minimo. Consulta l'avviso sotto questa tabella. Caching del browser I browser rispettano le intestazioni.

avvertimento

Se il TTL minimo è maggiore di 0, CloudFront utilizza il TTL minimo della policy di cache, anche se le private direttive Cache-Control: no-cacheno-store, e/o sono presenti nelle intestazioni di origine.

Se l'origine è raggiungibile, CloudFront ottiene l'oggetto dall'origine e lo restituisce al visualizzatore.

Se l'origine non è raggiungibile e il valore TTL minimo o massimo è maggiore di 0, CloudFront servirà l'oggetto che ha ottenuto dall'origine in precedenza.

Per evitare questo comportamento, includere la direttiva Cache-Control: stale-if-error=0 con l'oggetto restituito dall'origine. Ciò fa sì che CloudFront venga restituito un errore in risposta alle richieste future se l'origine non è raggiungibile, anziché restituire l'oggetto ottenuto dall'origine in precedenza.

Per informazioni su come modificare le impostazioni per le distribuzioni utilizzando la CloudFront console, vedere. Aggiornamento di una distribuzione Per informazioni su come modificare le impostazioni per le distribuzioni utilizzando l' CloudFront API, vedere. UpdateDistribution

Aggiungi intestazioni ai tuoi oggetti utilizzando la console Amazon S3

Puoi aggiungere il campo di Expires intestazione Cache-Control o ai tuoi oggetti Amazon S3. A tale scopo, modifichi i campi di metadati per l'oggetto.

Per aggiungere un campo Cache-Control o un campo di Expires intestazione agli oggetti Amazon S3

1. Segui la procedura nella sezione Sostituzione dei metadati definiti dal sistema sull'argomento Modifica dei metadati degli oggetti nella console Amazon S3 della Amazon S3 User Guide.

2. Per Key (Chiave), scegli il nome dell'intestazione che stai aggiungendo (Cache-Control o Expires (Scadenze)).

3. In Value (Valore)immetti un valore di intestazione. Ad esempio, per un'intestazione Cache-Control, è possibile immettere max-age=86400. Per Expires, è possibile inserire una data di scadenza e un'ora ad esempio Wed, 30 Jun 2021 09:28:00 GMT.

4. Segui il resto della procedura per salvare le modifiche ai metadati.