Cosa devi sapere per invalidare i file - Amazon CloudFront

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Cosa devi sapere per invalidare i file

Quando specificate un file da invalidare, fate riferimento alle seguenti informazioni:

Distinzione tra lettere maiuscole e minuscole

I percorsi di invalidazione distinguono tra maiuscole e minuscole. Ad esempio, /images/image.jpg /images/Image.jpg specifica due file diversi.

Modifica della funzione URI mediante una funzione Lambda

Se la tua CloudFront distribuzione attiva una funzione Lambda sugli eventi di richiesta del visualizzatore e se la funzione modifica URI il file richiesto, ti consigliamo di invalidare URIs entrambe per rimuovere il file dalle cache edge: CloudFront

  • Nella richiesta del visualizzatore URI

  • Il URI dopo che la funzione l'ha modificata

Esempio

Supponiamo che la funzione Lambda cambi URI il valore di un file da:

https://d111111abcdef8.cloudfront.net/index.html

A un URI che include una directory linguistica:

https://d111111abcdef8.cloudfront.net/en/index.html

Per invalidare il file, devi specificare i seguenti percorsi:

  • /index.html

  • /en/index.html

Per ulteriori informazioni, consulta Invalidation paths.

Oggetti root predefiniti

Per invalidare l'oggetto root predefinito (file), specifica il percorso nello stesso modo in cui specifichi il percorso per qualsiasi altro file. Per ulteriori informazioni, consulta Come funziona un oggetto root predefinito.

Inoltro dei cookie

Se hai configurato CloudFront per inoltrare i cookie all'origine, le cache CloudFront edge potrebbero contenere diverse versioni del file. Quando invalidi un file, CloudFront invalida ogni versione del file memorizzata nella cache indipendentemente dai cookie associati. Non puoi selettivamente invalidare alcune versioni e non altre sulla base del cookie associati. Per ulteriori informazioni, consulta Contenuto della cache basato sui cookie.

Inoltro di intestazioni

Se hai configurato CloudFront l'inoltro di un elenco di intestazioni all'origine e la memorizzazione nella cache in base ai valori delle intestazioni, le cache CloudFront edge potrebbero contenere diverse versioni del file. Quando invalidi un file, CloudFront invalida ogni versione del file memorizzata nella cache indipendentemente dai valori dell'intestazione. Non puoi selettivamente invalidare alcune versioni e non altre sulla base dei valori delle intestazioni. (Se configuri CloudFront per inoltrare tutte le intestazioni all'origine, CloudFront non memorizza nella cache i file). Per ulteriori informazioni, consulta Memorizza i contenuti della cache in base alle intestazioni delle richieste.

Inoltro di stringhe di query

Se hai configurato CloudFront per inoltrare le stringhe di query all'origine, devi includere le stringhe di query quando invalidi i file, come mostrato negli esempi seguenti:

  • /images/image.jpg?parameter1=a

  • /images/image.jpg?parameter1=b

Se le richieste del client includono cinque diverse stringhe di query per lo stesso file, puoi invalidare il file cinque volte, una per ogni stringa di query, oppure utilizzare il carattere jolly * nel percorso di invalidamento, come nell'esempio seguente:

/images/image.jpg*

Per ulteriori informazioni sull'utilizzo di caratteri jolly nel percorso di invalidamento, consulta Invalidation paths.

Per ulteriori informazioni sulle stringhe di query, vedi Contenuto della cache in base ai parametri della stringa di query.

Per determinare quali stringhe di query sono in uso, è possibile abilitare la registrazione. CloudFront Per ulteriori informazioni, consulta Configurazione e utilizzo di log standard (log di accesso).

Massimo consentito

Per ulteriori informazioni sul numero massimo di annullamenti consentiti, vedere. Massima richiesta di invalidamento concorrente

File Microsoft Smooth Streaming

Non puoi invalidare i file multimediali nel formato Microsoft Smooth Streaming se hai abilitato Smooth Streaming per il comportamento della cache corrispondente.

Caratteri non sicuri ASCII o non sicuri nel percorso

Se il percorso include ASCII caratteri non sicuri o non sicuri come definiti nel RFC1738, URL codifica tali caratteri. Non URL codificate nessun altro carattere nel percorso, altrimenti non CloudFront invaliderà la vecchia versione del file aggiornato.

Percorsi di invalidamento

Questo percorso è relativo alla distribuzione. Ad esempio, per invalidare il file in, devi specificare. https://d111111abcdef8.cloudfront.net/images/image2.jpg /images/image2.jpg

Nota

Nella CloudFrontconsole, puoi omettere la barra iniziale nel percorso, in questo modo:. images/image2.jpg Quando si utilizza CloudFront API direttamente, i percorsi di invalidazione devono iniziare con una barra iniziale.

Puoi anche invalidare più file contemporaneamente utilizzando il carattere jolly *. Il carattere *, che sostituisce 0 o più caratteri, deve essere l'ultimo carattere nel percorso di invalidamento.

Importante

Per utilizzare i caratteri jolly (*) nell'invalidazione, è necessario inserire i caratteri jolly alla fine del percorso. Gli asterischi (*) inseriti in qualsiasi altro punto vengono considerati come una corrispondenza letterale tra caratteri anziché come un invalidamento con caratteri jolly.

Se usate il simbolo AWS Command Line Interface (AWS CLI) per invalidare i file e specificate un percorso che include il carattere * jolly, dovete usare le virgolette () attorno al percorso, ad esempio. " "/*"

La lunghezza massima di un percorso è 4.000 caratteri.

Esempio: percorsi di invalidazione

  • Per invalidare tutti i file in una directory:

    /directory-path/*

  • Per invalidare una directory, tutte le relative sottodirectory e tutti i file nella directory e nelle sottodirectory:

    /directory-path*

  • Per invalidare tutti i file con lo stesso nome, ma estensioni di nome di file diverse, ad esempio logo.jpg, logo.png e logo.gif:

    /directory-path/file-name.*

  • Per invalidare tutti i file di una directory il cui nome inizia con gli stessi caratteri (ad esempio tutti i file di un video in HLS formato), indipendentemente dall'estensione del nome del file:

    /directory-path/initial-characters-in-file-name*

  • Quando configurate la cache CloudFront in base ai parametri della stringa di query e desiderate invalidare ogni versione di un file:

    /directory-path/file-name.file-name-extension*

  • Per invalidare tutti i file di una distribuzione:

    /*

Per informazioni sull'invalidazione dei file se si utilizza una funzione Lambda per modificare la, vedere. URI Changing the URI Using a Lambda Function

Se il percorso di invalidamento è una directory e se non hai standardizzato un metodo per specificare le directory - con o senza una barra finale (/), ti consigliamo di invalidare la directory con e senza barre finali, ad esempio, /images e /images/.

Firmato URLs

Se utilizzi signedURLs, invalida un file includendo solo la parte che URL precede il punto interrogativo (?).