Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Limpar cache por URL (ignorar parâmetros)

Última atualização: Jun 29, 2026

Edge Security Acceleration (ESA) armazena em cache as URLs de solicitação separadamente com base nas strings de consulta. A limpeza por URL com parâmetros ignorados remove todos os recursos em cache cujas URLs base correspondam às enviadas, independentemente dos parâmetros de consulta.

Cenários

Controle de versão de arquivos

  • Descrição: Seu site possui recursos estáticos, como imagens, arquivos CSS e JavaScript, cujas URLs contêm parâmetros de consulta para controle de versão ou de cache. Ao atualizar esses recursos, invalide imediatamente o cache relacionado para que os usuários obtenham a versão mais recente.

  • Exemplo: As URLs a seguir apontam para duas versões diferentes do mesmo arquivo.

    • https://www.example.com/assets/style.css?v=1

    • https://www.example.com/assets/style.css?v=2

  • Solução: Envie a URL sem parâmetros de consulta, como https://www.example.com/assets/style.css, para limpar o cache de todas as versões do arquivo.

Processamento de imagens

  • Descrição: Seu site gera variantes de imagem com base em parâmetros de consulta, como miniaturas ou tamanhos diferentes. Após o reprocessamento, limpe o cache relacionado para servir as imagens atualizadas imediatamente.

  • Exemplo: As URLs a seguir apontam para uma imagem em dois tamanhos diferentes.

    • https://www.example.com/images/photo.jpg?size=small

    • https://www.example.com/images/photo.jpg?size=medium

  • Solução: Envie a URL sem parâmetros de consulta, como https://www.example.com/images/photo.jpg, para limpar o cache de todas as versões geradas com diferentes parâmetros.

Limpar cache por URL com parâmetros ignorados

  1. No console ESA, selecione Websites e, na coluna Websites, clique em no site desejado.

  2. No painel de navegação à esquerda, selecione Websites > Website.

  3. Na aba Caching, configure as definições de limpeza.

    • Purge Cache: Selecione Purge Cache.

    • Type: Escolha entre By URL with Parameters Ignored ou Input Method.

      • Manual Input

        Insira uma ou mais URLs sem parâmetros de solicitação, sendo uma URL por linha. É possível enviar até 100 URLs por vez. Exemplo:

        https://www.example.com/cat.jpg
        https://www.example.com/image/cat.jpg
      • Upload File

        Para limpar um grande número de URLs, especifique-as em um arquivo TXT e faça o upload para limpeza em lote. Insira uma URL por linha. O tamanho do arquivo TXT não pode exceder 10 MB.

    • Manual Input: Escolha entre dois métodos: Upload File e Purge Method.

      Método de atualização

      Descrição

      Mark as Expired

      Os nós seguem este fluxo:

      1. O POP do ESA envia uma solicitação à origem com os cabeçalhos If-Modified-Since e If-None-Match.

      2. O servidor de origem compara o horário de modificação do arquivo.

      3. Se o arquivo não tiver sido modificado, o servidor de origem retornará um código de status 304. O POP do ESA usará o arquivo em cache existente para responder à solicitação do cliente.

      4. Caso o arquivo tenha sido modificado, o servidor de origem retornará um código de status 200 e o arquivo mais recente. O POP do ESA entregará o arquivo atualizado ao cliente e armazenará o recurso em cache.

      Delete

      Quando um usuário solicita conteúdo correspondente a um recurso que deve ser atualizado, o POP do ESA busca diretamente o novo recurso na origem, entrega-o ao usuário e o armazena em cache.

    image

  4. Clique em Mark as Expired.

  5. Visualize o progresso da limpeza.

    • Após enviar uma tarefa de limpeza, acompanhe seu progresso na aba Delete. O valor 100% indica conclusão. Tarefas grandes podem levar mais tempo.

    • Se você selecionar Submit, verifique o status de execução do arquivo na aba Purge Records. 'Success' significa que o arquivo foi carregado e a tarefa de limpeza foi iniciada. Monitore cada URL na aba Upload File.

      image

Disponibilidade

Cota

Entrance

Pro

Premium

Enterprise

Tarefas de limpeza por dia

N/A

N/A

N/A

500