View a markdown version of this page

Ce que vous devez savoir lors de l'invalidation de balises - 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 lors de l'invalidation de balises

Lorsque vous spécifiez une balise à invalider, reportez-vous aux informations suivantes :

Opt-in requis

L'invalidation des balises ne fonctionne que sur les distributions CacheTagConfig configurées. Les distributions dépourvues de cette configuration ignorent les en-têtes des balises de cache dès l'origine. Pour de plus amples informations, veuillez consulter Invalidation du contenu par des balises de cache.

Préfixe d'invalidation des balises

Les éléments d'invalidation des balises doivent commencer par le # caractère. Par exemple, pour invalider tous les objets mis en cache marqués avecproduct:electronics, spécifiez-les #product:electronics dans la Paths.Items liste.

Sensibilité à la casse

Les valeurs des balises ne distinguent pas les majuscules des minuscules. Par exemple, #Product:Electronics et #product:electronics faites référence à la même balise.

Format de balise

Chaque valeur de balise doit contenir uniquement des caractères ASCII visibles (33 à 126), à l'exception des virgules. La longueur maximale d'une balise est de 256 caractères.

Pas de support pour les jokers

Contrairement aux invalidations de chemins, les éléments d'invalidation de balises ne prennent pas en charge le caractère générique. * Chaque élément # préfixé correspond à la valeur exacte de la balise.

Nombre maximum de balises par objet mis en cache

CloudFront traite jusqu'à 50 balises par objet mis en cache. Si une réponse d'origine contient plus de 50 balises dans l'en-tête configuré, les balises supplémentaires au-delà de la limite ne sont pas stockées et ne peuvent pas être utilisées pour l'invalidation.

Transfert de cookies, d'en-têtes et de chaînes de requête

Lorsque vous invalidez par balise, toutes les variantes mises en cache de chaque objet portant la balise spécifiée sont CloudFront invalidées, quels que soient les cookies, les en-têtes ou les paramètres de chaîne de requête associés. Vous ne pouvez pas invalider certaines variantes de manière sélective et pas d'autres.

Invalidations mixtes de chemins et de balises

Vous pouvez inclure à la fois des éléments de chemin (par exemple,/images/*) et des éléments de balise (par exemple,#brand:acme) dans le même lot d'invalidation dans une CreateInvalidation demande. Chaque élément compte comme une voie d'invalidation pour atteindre vos limites.

Maximum autorisé

Les éléments d'invalidation des balises sont pris en compte dans les mêmes limites d'invalidation simultanée que les éléments de chemin. Chaque élément de balise compte comme un chemin d'invalidation. Pour de plus amples informations, veuillez consulter Quotas sur les invalidations.

Modification du nom de l'en-tête

Si vous modifiez l'entréeCacheTagConfig, HeaderName les invalidations émises contre les balises extraites sous l'ancien nom d'en-tête ne seront plus évaluées. Avant de modifier le nom de l'en-tête :

  1. Commencez à renvoyer les anciens et nouveaux en-têtes de balises de cache depuis votre origine.

  2. Émettez une invalidation de chemin (par exemple,/*) ou invalidez des balises existantes.

  3. Mettez à jour CacheTagConfig avec le nouveauHeaderName.

  4. Arrêtez de renvoyer l'ancien en-tête depuis votre origine.

Locataires de distribution

L'invalidation des balises est également prise en charge pour les locataires de distribution via l' CreateInvalidationForDistributionTenantAPI.