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.
# Invalidation de fichiers pour supprimer du contenu
Si vous devez supprimer un fichier des caches CloudFront Edge avant son expiration, vous pouvez effectuer l'une des opérations suivantes :
+ Invalidez le fichier des caches périphériques. La prochaine fois qu'un utilisateur demande le fichier, il CloudFront retourne à l'origine pour récupérer la dernière version du fichier.
+ Utilisez la gestion des versions de fichiers pour offrir une version différente du fichier dont le nom diffère. Pour de plus amples informations, veuillez consulter [Mise à jour des fichiers existants à l’aide de noms de fichiers versionnés](UpdatingExistingObjects.md#ReplacingObjects).
**Topics**
+ [Choix entre invalider des fichiers existants et utiliser des noms de fichier versionnés](#Invalidation_Expiration)
+ [Détermination des fichiers à invalider](invalidation-access-logs.md)
+ [Ce que vous devez savoir lorsque vous invalidez des fichiers](invalidation-specifying-objects.md)
+ [Invalidation de fichiers](Invalidation_Requests.md)
+ [Nombre maximum de requêtes d’invalidation simultanées](InvalidationLimits.md)
+ [Paiement pour une invalidation de fichier](PayingForInvalidation.md)
## Choix entre invalider des fichiers existants et utiliser des noms de fichier versionnés
Pour contrôler les versions de fichiers qui sont offerts à partir de votre distribution, vous pouvez invalider des fichiers ou leur attribuer des noms de fichier versionnés. Si vous souhaitez mettre souvent vos fichiers à jour, nous vous recommandons d’utiliser principalement la gestion des versions de fichiers pour les raisons suivantes :
+ La gestion des versions vous permet de contrôler quel fichier est renvoyé par une requête même lorsque l’utilisateur dispose d’une version en cache en local ou derrière un proxy de mise en cache d’entreprise. Si vous invalidez le fichier, l’utilisateur pourrait continuer de voir l’ancienne version tant qu’elle n’est pas arrivée à expiration dans ces caches.
+ CloudFront les journaux d'accès incluent les noms de vos fichiers, de sorte que la gestion des versions facilite l'analyse des résultats des modifications apportées aux fichiers.
+ La gestion des versions offre un moyen d’offrir des versions différentes de fichiers à des utilisateurs différents.
+ La gestion des versions simplifie la restauration par progression et la restauration entre les révisions de fichier.
+ La gestion des versions est moins chère. Vous devez toujours payer pour CloudFront transférer les nouvelles versions de vos fichiers vers des emplacements périphériques, mais vous n'avez pas à payer pour invalider des fichiers.
Pour plus d’informations sur la gestion des versions de fichiers, consultez [Mise à jour des fichiers existants à l’aide de noms de fichiers versionnés](UpdatingExistingObjects.md#ReplacingObjects).
# Détermination des fichiers à invalider
Si vous souhaitez invalider plusieurs fichiers, par exemple tous les fichiers d’un répertoire ou tous les fichiers commençant par les mêmes caractères, vous pouvez inclure le caractère générique `*` à la fin du chemin d’invalidation. Pour plus d’informations sur l’utilisation du caractère générique `*`, consultez [Invalidation paths](invalidation-specifying-objects.md#invalidation-specifying-objects-paths).
Pour invalider des fichiers, vous pouvez indiquer le chemin pour des fichiers individuels ou un chemin qui se termine par le caractère générique `*` qui peut s’appliquer à un ou plusieurs fichiers, comme illustré dans les exemples suivants :
+ `/images/image1.jpg`
+ `/images/image*`
+ `/images/*`
Si vous souhaitez invalider certains fichiers mais que vos utilisateurs n'ont pas forcément à accès à chaque fichier sur votre origine, vous pouvez déterminer quels fichiers les utilisateurs ont demandés à CloudFront et n'invalider que ces fichiers. Pour déterminer les fichiers demandés par les utilisateurs, activez la journalisation des CloudFront accès. Pour plus d’informations sur les journaux d’accès, consultez [Journaux d'accès (journaux standard)](AccessLogs.md).
# 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 CloudFront distribution déclenche une fonction Lambda lors d'événements de demande du lecteur, et si la fonction modifie l'URI du fichier demandé, nous vous recommandons d'invalider les deux URIs pour supprimer le fichier des CloudFront caches périphériques :
+ L’URI de la demande utilisateur
+ L’URI une fois que la fonction l’a modifié
**Example 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](#invalidation-specifying-objects-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 de plus amples informations, veuillez consulter [Fonctionnement de l'objet racine par défaut](DefaultRootObject.md#DefaultRootObjectHow).
**Transmettre des cookies**
Si vous avez configuré CloudFront pour transférer les cookies vers votre source, les caches CloudFront périphériques peuvent contenir plusieurs versions du fichier. Lorsque vous invalidez un fichier, toutes CloudFront les versions mises en cache du fichier sont invalidées, quels que soient les cookies 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](Cookies.md).
**Transmettre des en-têtes**
Si vous avez configuré CloudFront pour transférer une liste d'en-têtes vers votre origine et pour la mettre en cache en fonction des valeurs des en-têtes, les caches CloudFront périphériques 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 transférer tous les en-têtes vers votre origine, vos fichiers CloudFront ne sont pas mis en cache.) Pour de plus amples informations, veuillez consulter [Mise en cache de contenu basée sur des en-têtes de demandes](header-caching.md).
**Transmission de chaînes de requête**
Si vous avez configuré CloudFront pour transférer les chaînes de requête vers votre origine, vous devez inclure les chaînes de requête lors de l'invalidation de fichiers, comme indiqué 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 \$1 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](#invalidation-specifying-objects-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](QueryStringParameters.md).
Pour déterminer quelles chaînes de requête sont utilisées, vous pouvez activer la journalisation des accès CloudFront. Pour de plus amples informations, veuillez consulter [Journaux d'accès (journaux standard)](AccessLogs.md).
**Maximum autorisé**
Pour plus d’informations sur le nombre maximum d’invalidations autorisées, consultez [Nombre maximum de requêtes d’invalidation simultanées](InvalidationLimits.md).
**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](https://tools.ietf.org/html/rfc1738), encodez ces caractères dans l'URL. N'encodez pas d'URL pour les autres caractères du chemin, car cela CloudFront n'invalidera pas l'ancienne version du fichier mis à jour.
N'utilisez pas le `~` personnage sur votre chemin. CloudFront ne prend pas en charge ce caractère pour les invalidations, qu'il soit codé 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`.
Dans la [console CloudFront](https://console.aws.amazon.com/cloudfront/v4/home), vous pouvez omettre la barre oblique de début dans le chemin, comme ci-après : `images/image2.jpg`. Lorsque vous utilisez directement l' CloudFront API, 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.
Pour utiliser des caractères génériques (\$1) lors de l’invalidation, vous devez placer le caractère générique à la fin du chemin. Les astérisques (\$1) 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 le AWS Command Line Interface (AWS CLI) pour invalider des fichiers et que vous spécifiez un chemin qui inclut le `*` caractère générique, vous devez utiliser des guillemets (`"`) autour du chemin, par exemple. `"/*"`
La longueur maximale d’un chemin est de 4 000 caractères.
**Example Exemple : chemins d’invalidation**
+ Pour invalider tous les fichiers dans un répertoire :
`/`*directory-path*`/*`
+ Pour invalider un répertoire, tous ses sous-répertoires, et tous les fichiers de ce répertoire et ces sous-répertoires :
`/`*directory-path*`*`
+ 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 :
`/`*directory-path*`/`*file-name*`.*`
+ 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 :
`/`*directory-path*`/`*initial-characters-in-file-name*`*`
+ Lorsque vous configurez CloudFront le cache en fonction des paramètres de chaîne de requête et que vous souhaitez invalider toutes les versions d'un fichier :
`/`*directory-path*`/`*file-name*`.`*file-name-extension*`*`
+ 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](#invalidation-lambda-at-edge).
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/`.
**Signé URLs**
Si vous utilisez Signed URLs, invalidez un fichier en incluant uniquement la partie de l'URL située avant le point d'interrogation (?).
# Invalidation de fichiers
Vous pouvez utiliser la CloudFront console pour créer et exécuter une invalidation, afficher la liste des invalidations que vous avez soumises précédemment et afficher des informations détaillées sur une invalidation individuelle. Vous pouvez également copier une invalidation existante, modifier la liste des chemins de fichier et exécuter l’invalidation modifiée. Vous ne pouvez pas supprimer d’invalidations de la liste.
**Contents**
+ [Invalidation de fichiers](#invalidating-objects-console)
+ [Copie, modification et réexécution d’une invalidation existante](#invalidating-objects-copy-console)
+ [Annulation des invalidations](#canceling-invalidations)
+ [Liste des invalidations](#listing-invalidations-console)
+ [Affichage des informations sur une invalidation](#invalidation-details-console)
## Invalidation de fichiers
Pour invalider des fichiers à l'aide de la CloudFront console, procédez comme suit.
------
#### [ Console ]
**Pour invalider des fichiers (console)**
1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Choisissez la distribution pour laquelle vous voulez invalider des fichiers.
1. Choisissez l’onglet **Invalidations**.
1. Sélectionnez **Créer une invalidation**.
1. Pour les fichiers que vous voulez invalider, entrez un chemin d’invalidation par ligne. Pour plus d’informations sur la spécification de chemins d’invalidation, consultez [Ce que vous devez savoir lorsque vous invalidez des fichiers](invalidation-specifying-objects.md).
**Important**
Indiquez les chemins de fichier avec soin. Vous ne pouvez pas annuler une demande d’invalidation après l’avoir commencée.
1. Sélectionnez **Créer une invalidation**.
------
#### [ CloudFront API ]
*Pour en savoir plus sur l'invalidation d'objets et l'affichage d'informations sur les invalidations, consultez les rubriques suivantes dans le manuel Amazon API Reference : CloudFront *
+ [CreateInvalidation](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateInvalidation.html)
+ [ListInvalidations](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListInvalidations.html)
+ [GetInvalidation](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_GetInvalidation.html)
**Note**
Si vous utilisez le AWS Command Line Interface (AWS CLI) pour invalider des fichiers et que vous spécifiez un chemin qui inclut le `*` caractère générique, vous devez placer le chemin entre guillemets (`"`), comme dans l'exemple suivant :
```
aws cloudfront create-invalidation --distribution-id distribution_ID --paths "/*"
```
------
## Copie, modification et réexécution d’une invalidation existante
Vous pouvez copier une invalidation que vous avez créée précédemment, mettre à jour la liste des chemins d’invalidation d’objet et exécuter l’invalidation mise à jour. Vous ne pouvez pas copier une invalidation existante, mettre à jour la liste des chemins d’invalidation, puis enregistrer l’invalidation mise à jour sans l’exécuter.
**Important**
Si vous copiez une invalidation toujours en cours, mettez à jour la liste des chemins d'invalidation, puis exécutez l'invalidation mise à jour, CloudFront sans arrêter ni supprimer l'invalidation que vous avez copiée. Si des chemins d'invalidation apparaissent dans l'original et dans la copie, CloudFront nous essaierons d'invalider les fichiers deux fois, et les deux invalidations seront prises en compte dans votre nombre maximum d'invalidations gratuites pour le mois. Si vous avez déjà atteint le nombre maximal d’invalidations gratuites, les deux invalidations vous seront facturées pour chaque fichier. Pour de plus amples informations, veuillez consulter [Nombre maximum de requêtes d’invalidation simultanées](InvalidationLimits.md).
**Pour copier, modifier et réexécuter une invalidation existante**
1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Sélectionnez la distribution qui contient l’invalidation à copier.
1. Choisissez l’onglet **Invalidations**.
1. Sélectionnez l’invalidation que vous souhaitez copier.
Si vous n’êtes pas sûr de l’invalidation à copier, vous pouvez choisir une invalidation et sélectionner **Afficher les détails** pour afficher des informations détaillées sur cette invalidation.
1. Choisissez **Copier vers un nouvel élément**.
1. Mettez à jour la liste des chemins d’invalidation la cas échéant.
1. Sélectionnez **Créer une invalidation**.
## Annulation des invalidations
Lorsque vous soumettez une demande d'invalidation à CloudFront, CloudFront transfère la demande à tous les emplacements périphériques en quelques secondes, et chaque emplacement périphérique commence immédiatement à traiter l'invalidation. De ce fait, vous ne pouvez pas annuler une invalidation après l’avoir soumise.
## Liste des invalidations
Vous pouvez afficher la liste des 100 dernières invalidations que vous avez créées et exécutées pour une distribution à l'aide de la CloudFront console. Si vous souhaitez obtenir une liste de plus de 100 invalidations, utilisez l’opération d’API `ListInvalidations`. Pour plus d'informations, consultez [ListInvalidations](https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_ListInvalidations.html)le *Amazon CloudFront API Reference*.
**Pour répertorier des invalidations**
1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Sélectionnez la distribution pour laquelle vous voulez afficher une liste d’invalidations.
1. Choisissez l’onglet **Invalidations**.
**Note**
Vous ne pouvez pas supprimer d’invalidations de la liste.
## Affichage des informations sur une invalidation
Vous pouvez afficher des informations détaillées sur une invalidation, notamment l’ID de distribution, l’ID d’invalidation, le statut de l’invalidation, la date et l’heure auxquelles l’invalidation a été créée, et une liste complète des chemins d’invalidation.
**Pour afficher des informations sur une invalidation**
1. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adresse[https://console.aws.amazon.com/cloudfront/v4/home](https://console.aws.amazon.com/cloudfront/v4/home).
1. Sélectionnez la distribution qui contient l’invalidation pour laquelle vous souhaitez afficher des informations détaillées.
1. Choisissez l’onglet **Invalidations**.
1. Choisissez l’ID d’invalidation applicable ou sélectionnez l’ID d’invalidation, puis sélectionnez **Afficher les détails**.
# Nombre maximum de requêtes d’invalidation simultanées
Si vous invalidez des fichiers individuellement, il est possible que des demandes d’invalidation concernant jusqu’à 3 000 fichiers par distribution soient en cours en même temps. Il peut s’agir d’une demande d’invalidation concernant jusqu’à 3 000 fichiers, de 3 000 demandes concernant chacune un fichier, ou d’une autre combinaison ne dépassant pas 3 000 fichiers. Par exemple, vous pouvez soumettre 30 demandes d’invalidation invalidant 100 fichiers chacune. Tant que toutes les 30 demandes d’invalidation sont encore en cours, vous ne pouvez pas soumettre d’autres demandes d’invalidation. Si vous dépassez le maximum, CloudFront renvoie un message d'erreur.
Si vous utilisez le caractère générique \$1, vous pouvez lancer en même temps des demandes concernant jusqu’à 15 chemins d’invalidation. Vous pouvez également lancer en même temps des demandes d’invalidation concernant jusqu’à 3 000 fichiers individuels par distribution, la limite concernant les demandes d’invalidation avec caractères génériques autorisées étant indépendante de la limite applicable à l’invalidation de fichiers individuels.
# Paiement pour une invalidation de fichier
Les premiers 1 000 chemins d’invalidation que vous soumettez par mois sont gratuits ; vous paierez pour chaque chemin d’invalidation au-delà de 1 000 au cours d’un mois. Un chemin d’invalidation peut être un fichier unique (comme `/images/logo.jpg`) ou plusieurs fichiers (comme `/images/*`). Un chemin qui inclut le `*` caractère générique est considéré comme un chemin, même s'il entraîne CloudFront l'invalidation de milliers de fichiers.
Le maximum de 1 000 chemins d’invalidation gratuits par mois s’applique au nombre total de chemins d’invalidation pour toutes les distributions que vous créez avec un Compte AWS. Par exemple, si vous utilisez le Compte AWS `john@example.com` pour créer trois distributions et que vous soumettez 600 chemins d'invalidation pour *chaque distribution* au cours d'un mois donné (pour un total de 1 800 chemins d'invalidation), la différence entre le nombre total de chemins d'invalidation et la limite de 1 000 voies d'invalidation gratuites vous AWS sera facturée. Dans cet exemple, AWS vous facturerait 800 chemins d’invalidation pour ce mois-là.
Les frais pour soumettre un chemin d’invalidation sont les mêmes quel que soit le nombre de fichiers que vous invalidez : un seul fichier (`/images/logo.jpg`) ou tous les fichiers associés à une distribution (`/*`). Étant donné que la facturation est appliquée par chemin dans une demande d’invalidation, regrouper plusieurs chemins dans une même demande ne change rien : chaque chemin est comptabilisé individuellement pour la facturation.
Pour plus d'informations sur les tarifs d'invalidation, consultez [Amazon CloudFront Pricing](https://aws.amazon.com/cloudfront/pricing/). Pour plus d’informations sur les chemins d’invalidation, consultez [Invalidation paths](invalidation-specifying-objects.md#invalidation-specifying-objects-paths).