View a markdown version of this page

Ce que vous devez savoir lorsque vous invalidez des 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 lorsque vous invalidez des 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 qui ont été CacheTagConfig configurées. Les distributions sans cette configuration ignorent les en-têtes de balises de cache depuis l'origine. Pour plus d’informations, consultez Invalidation de contenu par des balises de cache.

Préfixe d'invalidation des balises

Les éléments d'invalidation des balises doivent commencer par le # personnage. 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 et minuscules. Par exemple, #Product:Electronics et #product:electronics faites référence à la même étiquette.

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 caractères génériques

Contrairement aux invalidations de chemin, les éléments d'invalidation des 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, CloudFront invalide chaque variante mise en cache de chaque objet qui porte la balise spécifiée, 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 d'une CreateInvalidation demande. Chaque élément compte comme un chemin d'invalidation vers vos limites.

Maximum autorisé

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

Changer le nom de l'en-tête

Si vous modifiez l'entréeCacheTagConfig, HeaderName les invalidations émises pour 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 les nouveaux en-têtes de balises de cache depuis votre origine.

  2. Invalidez un chemin (par exemple/*) ou invalidez les 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 à l'aide de l' CreateInvalidationForDistributionTenantAPI.