View a markdown version of this page

O que você precisa saber ao invalidar tags - Amazon CloudFront

O que você precisa saber ao invalidar tags

Ao especificar uma tag para invalidação, consulte as informações a seguir:

Adesão obrigatória

A invalidação por tag funciona apenas em distribuições com CacheTagConfig configurado. Distribuições sem essa configuração ignoram cabeçalhos de tags de cache enviados pela origem. Para obter mais informações, consulte Invalidar conteúdo por tags de cache.

Prefixo de invalidação por tag

Itens de invalidação por tag devem começar com o caractere #. Por exemplo, para invalidar todos os objetos armazenados em cache com a tag product:electronics, especifique #product:electronics na lista Paths.Items.

Diferenciação entre maiúsculas e minúsculas

Os valores das tags não diferenciam maiúsculas de minúsculas. Por exemplo, #Product:Electronics e #product:electronics referem-se à mesma tag.

Formato de tag

Cada valor de tag deve conter apenas caracteres ASCII visíveis (33 – 126), excluindo vírgulas. O comprimento máximo de uma tag é de 256 caracteres.

Sem suporte a caractere curinga

Diferentemente das invalidações por caminho, itens de invalidação por tag não oferecem suporte ao caractere curinga *. Cada item com prefixo # corresponde exatamente ao valor da tag.

Máximo de tags por objeto armazenado em cache

O CloudFront processa até 50 tags por objeto armazenado em cache. Se uma resposta da origem contiver mais de 50 tags no cabeçalho configurado, as tags adicionais além do limite não serão armazenadas e não poderão ser usadas para invalidação.

Encaminhamento de cookies, cabeçalhos e strings de consulta

Ao invalidar por tag, o CloudFront invalida todas as variantes armazenadas em cache de cada objeto que contém a tag especificada, independentemente de cookies, cabeçalhos ou parâmetros de string de consulta associados. Não é possível invalidar seletivamente algumas variantes e outras não.

Invalidações mistas de caminho e tag

É possível incluir itens de caminho (por exemplo, /images/*) e itens de tag (por exemplo, #brand:acme) no mesmo lote de invalidação em uma solicitação CreateInvalidation. Cada item conta como um caminho de invalidação para fins de limite.

Máximo permitido

Itens de invalidação por tag contam para os mesmos limites de invalidações simultâneas aplicados aos itens de caminho. Cada item de tag conta como um caminho de invalidação. Para obter mais informações, consulte Cotas para invalidações.

Alteração do nome do cabeçalho

Se o HeaderName for alterado em CacheTagConfig, invalidações emitidas para tags extraídas sob o nome antigo do cabeçalho deixarão de ser avaliadas. Antes de alterar o nome do cabeçalho:

  1. Comece a retornar tanto os cabeçalhos antigos quanto os novos de tags de cache da origem.

  2. Emita uma invalidação de caminho (por exemplo, /*) ou invalide as tags existentes.

  3. Atualize CacheTagConfig com o novo HeaderName.

  4. Pare de retornar o cabeçalho antigo da origem.

Locatários da distribuição

A invalidação por tag também é compatível com locatários de distribuição por meio da API CreateInvalidationForDistributionTenant.