View a markdown version of this page

Lo que necesita saber cuando se invalidan etiquetas - Amazon CloudFront

Lo que necesita saber cuando se invalidan etiquetas

Al especificar una etiqueta para invalidar, consulte la siguiente información:

Suscripción obligatoria

La invalidación de etiquetas solo funciona en las distribuciones que tienen CacheTagConfig configurada. Las distribuciones sin esta configuración ignoran los encabezados de las etiquetas de caché del origen. Para obtener más información, consulte Invalidación del contenido mediante etiquetas de caché.

Prefijo de invalidación de etiquetas

Los elementos de invalidación de etiquetas deben empezar por el carácter #. Por ejemplo, para invalidar todos los objetos en caché etiquetados con product:electronics, especifique #product:electronics en la lista de Paths.Items.

Sensible a mayúsculas y minúsculas

Los valores de las etiquetas distinguen entre mayúsculas y minúsculas. Por ejemplo, #Product:Electronics y #product:electronics hacen referencia a la misma etiqueta.

Formato de etiqueta

Cada valor de etiqueta debe contener solo caracteres ASCII visibles (33-126), excluidas las comas. La longitud máxima de una etiqueta es 256 caracteres.

Sin compatibilidad del comodín

A diferencia de las invalidaciones de rutas, los elementos de invalidación de etiquetas no admiten el comodín *. Cada elemento con el prefijo # coincide con el valor exacto de la etiqueta.

Número máximo de etiquetas por objeto almacenado en caché

CloudFront procesa hasta 50 etiquetas por objeto almacenado en caché. Si una respuesta de origen contiene más de 50 etiquetas en el encabezado configurado, las etiquetas adicionales que superen el límite no se almacenan y no se pueden usar para la invalidación.

Reenvío de cookies, encabezados y cadenas de consulta

Al invalidar por etiqueta, CloudFront invalida todas las variantes almacenadas en caché de cada objeto que contenga la etiqueta especificada, independientemente de las cookies, los encabezados o los parámetros de cadena de consulta asociados. No puede invalidar de forma selectiva algunas variantes y no otras.

Invalidaciones mixtas de rutas y etiquetas

Puede incluir los elementos de ruta (por ejemplo, /images/*) y los elementos de etiqueta (por ejemplo, #brand:acme) en el mismo lote de invalidación de una solicitud CreateInvalidation. Cada elemento cuenta como una ruta de invalidación para alcanzar los límites.

Máximo permitido

Los elementos de invalidación de etiquetas cuentan para los mismos límites de invalidación simultánea que los elementos de ruta. Cada elemento de etiqueta cuenta como una ruta de invalidación. Para obtener más información, consulte Cuotas de invalidaciones.

Cambio del nombre del encabezado

Si cambia HeaderName en CacheTagConfig, las invalidaciones emitidas para las etiquetas extraídas en el nombre del encabezado anterior no se evaluarán. Antes de cambiar el nombre del encabezado:

  1. Empiece a devolver los encabezados de las etiquetas de caché antiguos y nuevos del origen.

  2. Emita una invalidación de ruta (por ejemplo, /*) o invalide las etiquetas existentes.

  3. Actualice CacheTagConfig con el nuevo HeaderName.

  4. Deje de devolver el encabezado anterior desde el origen.

Inquilinos de distribución

Los arrendatarios de distribución también admiten la invalidación de etiquetas a través de la API CreateInvalidationForDistributionTenant.