Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Configure custom cache tags

Última atualização: Jun 29, 2026

Quando os pontos de presença (POPs) do Edge Security Acceleration (ESA) recebem um recurso de um servidor de origem, eles verificam a existência de uma tag de cache, identificada por padrão no cabeçalho Cache-Tag. Ao configurar tags de cache personalizadas, é possível alterar o nome da tag e ignorar a diferenciação entre maiúsculas e minúsculas nos valores.

Introdução

Como funciona a interação do filtro

Ao enviar uma tarefa de Limpar cache por tag, o ESA atualiza o conteúdo em cache com base nas tags de cache e na configuração de sensibilidade a maiúsculas e minúsculas. O processo de atualização ocorre da seguinte forma:

Nota

A resposta do servidor de origem deve incluir uma tag de cache. Caso contrário, este recurso não funcionará.

  1. Verificar se a resposta do servidor de origem inclui uma tag de cache

    • Sem tag de cache: Não é possível utilizar o recurso de limpeza por tag.

    • Tag de cache presente: Prossiga para verificar a configuração de tags de cache do site.

  2. Verificar a configuração de tags de cache do site

    • Nenhum nome personalizado configurado

      • A resposta do servidor de origem inclui a tag de cache padrão (Cache-Tag):

        • Modo sem distinção entre maiúsculas e minúsculas desativado: Os recursos armazenados em cache nos nós do ESA recebem a tag Cache-Tag: Cat,Dog. Utilize os valores Cat ou Dog para atualizar o cache.

        • Com o modo sem distinção entre maiúsculas e minúsculas ativado, o recurso armazenado nos nós do ESA recebe a tag Cache-Tag: cat,dog, permitindo o uso dos valores cat ou dog para atualizar o cache.

      • Se a resposta do servidor de origem contiver uma tag de cache personalizada, como Edge-Cache-Tag, o recurso de atualização de cache por tag não estará disponível, pois essa tag não é adicionada quando o recurso é armazenado em um nó do ESA.

    • Nome personalizado configurado (por exemplo, Edge-Cache-Tag)

      • Os recursos na resposta do servidor de origem possuem a tag de cache padrão (Cache-Tag). Quando esses recursos são armazenados em cache nos nós do ESA, essa tag não é adicionada. Consequentemente, não é possível usar o recurso de atualização de cache por tag.

      • A resposta do servidor de origem inclui a tag de cache com nome personalizado (por exemplo, Edge-Cache-Tag):

        • Correspondência sem distinção entre maiúsculas e minúsculas desativada: Ao armazenar recursos nos nós do ESA, o sistema adiciona a tag Edge-Cache-Tag: Cat,Dog. Use os valores Cat ou Dog para atualizar o cache.

        • Modo sem distinção entre maiúsculas e minúsculas ativado: Ao armazenar recursos nos nós do ESA, a tag Edge-Cache-Tag: cat,dog é adicionada, permitindo o uso dos valores cat ou dog para atualizar o cache.

Principais definições de configuração

As tags de cache possuem os seguintes parâmetros:

Nome da tag de cache

  • O nome padrão é Cache-Tag.

  • Um nome de tag de cache personalizado deve ter entre 1 e 64 caracteres.

  • O nome personalizado pode conter letras maiúsculas (A–Z), letras minúsculas (a–z), dígitos (0–9) e hifens (-).

Ignore Case

  • Este recurso vem desativado por padrão, fazendo com que o ESA trate CAT e cat como valores distintos durante uma operação de atualização de cache.

  • Após ativar este recurso, o ESA converte os valores das tags de cache nas respostas de origem para minúsculas, tratando CAT e cat como valores idênticos durante a atualização de cache.

Configurar tags de cache

Procedimento

  1. No console do ESA, acesse Websites. Na coluna Website, clique em o site desejado.

  2. No painel de navegação à esquerda, selecione Caching > Settings.

  3. Na seção Cache Tag, clique em o botão Configuration à direita.

    image

  4. Defina o Tag Name e o parâmetro de insensibilidade a maiúsculas e minúsculas para os valores da tag:

    • Tag Name: Selecione Use Custom Cache Tag Name e insira o nome personalizado da tag ESA-Cache-Tag.

    • Ignore Case: Ative ou desative esta configuração conforme necessário.

    image

Exemplos

Ao atualizar imagens ou páginas em um site de e-commerce, talvez seja necessário limpar o cache correspondente do ESA. Para imagens com múltiplas versões recortadas, enumerar cada variante é impraticável; em vez disso, limpe em lote o cache do ESA para todas as variantes usando o nome da imagem. Da mesma forma, ao iterar em páginas de eventos, limpe todo o cache relacionado do ESA pela tag de versão:

Limpeza por nome de imagem

Cenário

As três imagens a seguir são versões recortadas de dog.jpg. A origem adiciona a tag ESA-Cache-Tag:dog.jpg a todas elas:

  • dog_100_200.jpg

  • dog_200_200.jpg

  • dog_300_200.jpg

As três imagens abaixo são versões recortadas de cat.jpg. A origem adiciona a tag ESA-Cache-Tag:cat.jpg a todas elas:

  • cat_100_200.jpg

  • cat_200_200.jpg

  • cat_300_200.jpg

Exclua as imagens originais para limpar todas as variantes em cache simultaneamente.

Exemplo de configuração

  1. No console do ESA, acesse Site Management. Na coluna Website, clique em o site desejado.

  2. No painel de navegação à esquerda, selecione Caching > Settings.

  3. Na seção Cache Tag, clique em o botão Configuration à direita.

  4. Defina o Tag Name e o parâmetro de insensibilidade a maiúsculas e minúsculas para os valores da tag:

    • Tag Name: Selecione Use Custom Cache Tag Name e insira o nome personalizado da tag ESA-Cache-Tag.

    • Ignore Case: Ative ou desative esta configuração conforme necessário.

    image

  5. No painel de navegação à esquerda, selecione Caching > Purge Cache.

  6. Na aba Purge Cache, configure a regra de limpeza e clique em Submit:

    • Type: Selecione By Tag.

    • Purge Method: Selecione Delete.

    • Purge Content: Insira os valores das tags a serem limpas: cat.jpg,dog.jpg.

    image

Limpeza por número de versão

Cenário

As seis imagens a seguir foram geradas para a versão v0820. A origem adiciona a tag ESA-Cache-Tag:v0820 a todas elas:

  • dog_100_200_v0820.jpg

  • dog_200_200_v0820.jpg

  • dog_300_200_v0820.jpg

  • cat_100_200_v0820.jpg

  • cat_200_200_v0820.jpg

  • cat_300_200_v0820.jpg

Exemplo de configuração

  1. No console do ESA, acesse Site Management. Na coluna Website, clique em o site desejado.

  2. No painel de navegação à esquerda, selecione Caching > Settings.

  3. Na seção Cache Tag, clique em o botão Configuration à direita.

  4. Defina o Tag Name e o parâmetro de insensibilidade a maiúsculas e minúsculas para os valores da tag:

    • Tag Name: Selecione Use Custom Cache Tag Name e insira o nome personalizado da tag ESA-Cache-Tag.

    • Ignore Case: Ative ou desative esta configuração conforme necessário.

    image

  5. No painel de navegação à esquerda, selecione Caching > Purge Cache.

  6. Na aba Purge Cache, configure a regra de limpeza e clique em Submit:

    • Type: Selecione By Tag.

    • Purge Method: Selecione Delete.

    • Purge Content: Insira o valor da tag a ser limpo: v0820.

    image