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 dell'URI utilizzando una funzione Lambda

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

  • L'URI nella richiesta del visualizzatore

  • L'URI dopo la modifica eseguita dalla funzione

Esempio

Supponiamo che la funzione Lambda cambi l'URI 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 memorizzata nella cache del file stesso, a prescindere dai valori delle intestazioni. 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 Contenuto 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 quale stringhe di query sono in uso, puoi abilitare la registrazione di log di CloudFront. Per ulteriori informazioni, consulta Registrazione standard (registri di accesso).

Massimo consentito

Per ulteriori informazioni sul numero massimo di invalidazioni consentite, 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 ASCII o non sicuri nel percorso

Se il percorso include caratteri non ASCII o caratteri non sicuri come indicato in RFC 1738, è necessario codificare tali caratteri in formato URL. Non codificate come URL nessun altro carattere nel percorso, altrimenti la vecchia versione del file CloudFront aggiornato non verrà invalidata.

Importante

Non usare il carattere nel ~ tuo percorso. CloudFront non supporta questo carattere per le invalidazioni, indipendentemente dal fatto che sia codificato con URL o meno.

Percorsi di invalidamento

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

Nota

Nella console CloudFront, puoi omettere la barra iniziale nel percorso, in questo modo: images/image2.jpg. Quando utilizzate direttamente l' CloudFront API, 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 in una directory per i quali il nome file inizia con gli stessi caratteri (ad esempio tutti i file per un video in formato HLS), indipendentemente dall'estensione del nome file:

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

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

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

  • Per invalidare tutti i file di una distribuzione:

    /*

Per ulteriori informazioni su come invalidare i file utilizzando una funzione Lambda per modificare l'URI, consulta 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/.

Signed URLs (Firmato)

Se utilizzi signed URLs, invalida un file includendo solo la parte dell'URL prima del punto interrogativo (?).