Ce que vous devez savoir lorsque vous invalidez des fichiers - Amazon CloudFront

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ce que vous devez savoir lorsque vous invalidez des fichiers

Lorsque vous indiquez un fichier à invalider, consultez les informations suivantes :

Sensibilité à la casse

Les chemins d’invalidation sont sensibles à la casse. Par exemple, /images/image.jpg et /images/Image.jpg désignent deux fichiers différents.

Modification de l’URI à l’aide d’une fonction Lambda

Si votre distribution CloudFront déclenche une fonction Lambda sur des événements de demande de l’utilisateur et si la fonction modifie l’URI du fichier demandé, nous vous conseillons d’invalider les deux URI pour supprimer le fichier des caches périphériques CloudFront :

  • L’URI de la demande utilisateur

  • L’URI une fois que la fonction l’a modifié

Exemple exemple

Supposons que votre fonction Lambda modifie l’URI d’un fichier, en remplaçant :

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

par un URI qui inclut un répertoire de langue :

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

Pour invalider le fichier, vous devez spécifier les chemins suivants :

  • /index.html

  • /en/index.html

Pour plus d’informations, consultez Invalidation paths.

Objet racine par défaut

Pour invalider l’objet racine (fichier) par défaut, spécifiez le chemin tout comme le chemin pour tout autre fichier. Pour plus d’informations, consultez Fonctionnement de l'objet racine par défaut.

Transmettre des cookies

Si vous avez configuré CloudFront pour transmettre des cookies à votre origine, les caches périphériques CloudFront peuvent contenir plusieurs versions du fichier. Lorsque vous invalidez un fichier, CloudFront invalide chaque version mise en cache du fichier quels que soient les cookies qui lui sont associés. Vous ne pouvez pas invalider de façon sélective certaines versions et pas d’autres en fonction des cookies associés. Pour plus d’informations, consultez Mise en cache de contenu basée sur des cookies.

Transmettre des en-têtes

Si vous avez configuré CloudFront pour transférer une liste d’en-têtes à l’origine et effectuer la mise en cache selon les valeurs des en-têtes, les caches périphériques CloudFront peuvent contenir plusieurs versions du fichier. Lorsque vous invalidez un fichier, CloudFront invalide chaque version mise en cache du fichier, quelles que soient les valeurs des en-têtes. Vous ne pouvez pas invalider de façon sélective certaines versions et pas d’autres en fonction de valeurs d’en-têtes. (Si vous configurez CloudFront pour réacheminer tous les en-têtes vers votre origine, CloudFront ne met pas en cache vos fichiers.) Pour plus d’informations, consultez Mise en cache de contenu basée sur des en-têtes de demandes.

Transmission de chaînes de requête

Si vous avez configuré CloudFront pour transmettre les chaînes de requête à votre origine, vous devez inclure les chaînes de requête lorsque vous invalidez des fichiers, comme illustré dans les exemples suivants :

  • /images/image.jpg?parameter1=a

  • /images/image.jpg?parameter1=b

Si les requêtes client incluent cinq chaînes de requête différentes pour le même fichier, vous pouvez soit invalider le fichier cinq fois (une fois par chaîne de requête), soit utiliser le caractère générique * dans le chemin d’invalidation, comme illustré dans l’exemple suivant :

/images/image.jpg*

Pour plus d’informations sur l’utilisation de caractères génériques dans le chemin d’invalidation, consultez Invalidation paths.

Pour plus d’informations sur les chaînes de requête, consultez Mise en cache de contenu basée sur les paramètres de chaîne de requête.

Pour déterminer quelles chaînes de requête sont utilisées, vous pouvez activer la journalisation des accès CloudFront. Pour plus d’informations, consultez Journaux d'accès (journaux standard).

Maximum autorisé

Pour plus d’informations sur le nombre maximum d’invalidations autorisées, consultez Nombre maximum de requêtes d’invalidation simultanées.

Fichiers Microsoft Smooth Streaming

Vous ne pouvez pas invalider des fichiers multimédias au format Microsoft Smooth Streaming lorsque vous avez activé Smooth Streaming pour le comportement de cache correspondant.

Caractères autres qu’ASCII ou caractères non sûrs dans le chemin

Si le chemin inclut des caractères autres qu'ASCII ou non sûrs, tels que définis dans la RFC 1738, encodez ces caractères dans l'URL. N’encodez pas d’autres caractères par URL dans le chemin, sinon CloudFront n’invalidera pas l’ancienne version du fichier mis à jour.

Important

N’utilisez pas le caractère ~ dans votre chemin. Ce caractère n’est pas pris en charge par CloudFront pour les invalidations, qu’il encodé en URL ou non.

Chemins d’invalidation

Le chemin est relatif par rapport à la distribution. Par exemple, pour invalider le fichier à l’adresse https://d111111abcdef8.cloudfront.net/images/image2.jpg, vous devez spécifier /images/image2.jpg.

Note

Dans la console CloudFront, vous pouvez omettre la barre oblique de début dans le chemin, comme ci-après : images/image2.jpg. Lorsque vous utilisez directement l’API CloudFront, les chemins d’invalidation doivent commencer par une barre oblique.

Vous pouvez également invalider simultanément plusieurs fichiers à l’aide du caractère générique *. Le caractère générique *, qui remplace 0 caractère ou plus, doit être le dernier caractère dans le chemin d’invalidation.

Important

Pour utiliser des caractères génériques (*) lors de l’invalidation, vous devez placer le caractère générique à la fin du chemin. Les astérisques (*) insérés ailleurs sont traités comme une correspondance de caractères littérale au lieu d’une invalidation par un caractère générique.

Si vous utilisez l’AWS Command Line Interface (AWS CLI) pour invalider des fichiers et si vous spécifiez un chemin qui inclut le caractère générique *, vous devez utiliser des guillemets (") dans le chemin d’accès, par exemple "/*".

La longueur maximale d’un chemin est de 4 000 caractères.

Exemple : chemins d’invalidation

  • Pour invalider tous les fichiers dans un répertoire :

    /chemin_répertoire/*

  • Pour invalider un répertoire, tous ses sous-répertoires, et tous les fichiers de ce répertoire et ces sous-répertoires :

    /chemin_répertoire*

  • Pour invalider tous les fichiers qui ont le même nom mais des extensions de nom de fichier différentes, comme logo.jpg, logo.png et logo.gif :

    /chemin_répertoire/nom_fichier.*

  • Pour invalider tous les fichiers d’un répertoire dont le nom de fichier commence par les mêmes caractères (par exemple, tous les fichiers pour une vidéo au format HLS), quelle que soit l’extension du nom de fichier :

    /chemin_répertoire/caractères_initiaux_dans_nom_fichier*

  • Si vous configurez CloudFront pour effectuer la mise en cache en fonction de paramètres de chaîne de requête, et que vous souhaitez invalider chaque version d’un fichier :

    /chemin_répertoire/nom_fichier.extension_nom_fichier*

  • Pour invalider tous les fichiers dans une distribution :

    /*

Pour plus d’informations sur l’invalidation de fichiers si vous utilisez une fonction Lambda pour modifier l’URI, consultez Changing the URI Using a Lambda Function.

Si le chemin d’invalidation est un répertoire et que vous n’avez pas adopté une méthode standardisée pour spécifier les répertoires, avec ou sans barre oblique de fin (/), nous vous recommandons d’invalider le répertoire avec et sans barre oblique de fin, par exemple, /images et /images/.

URL signées

Si vous utilisez des URL signées, invalidez un fichier en n’incluant que la portion de l’URL avant le point d’interrogation (?).