Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Configure as definições de query string

Última atualização: Jun 29, 2026

Defina como os POPs tratam as query strings ao gerar chaves de cache. A remoção do caractere ? e de todo o conteúdo após esse caractere permite que URLs com parâmetros diferentes compartilhem uma única cópia em cache. Essa abordagem melhora a taxa de acerto do cache e reduz o tempo de carregamento da página.

Como funciona

Os POPs removem o caractere ? e todos os parâmetros após esse caractere das URLs de solicitação. Assim, diferentes usuários que acessam o mesmo arquivo compartilham uma única cópia em cache, independentemente dos parâmetros da URL. Esse comportamento aumenta a taxa de acerto do cache, diminui as buscas na origem e torna a entrega de arquivos mais eficiente.

Ignore as query strings quando as URLs contiverem parâmetros não relacionados ao recurso em cache, como IDs de usuário ou códigos de rastreamento. Por exemplo:

Usuário A: http://example.com/1.jpg?uid=123

Usuário B: http://example.com/1.jpg?uid=654

Sem a filtragem de query strings, o POP trata essas solicitações como distintas e busca o recurso na origem para cada uma delas. Com a filtragem ativada, o POP remove os parâmetros após o ? e utiliza apenas http://example.com/1.jpg como chave de cache.

Procedimento

  1. No console do ESA, selecione Site Management. Na coluna Website, clique em no nome do site desejado.

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

  3. Na área Query String, clique em Configure, selecione um modo de filtragem, ajuste as configurações e clique em OK.

    image

Modos de filtragem

Considere a URL original http://example.com/1.jpg?key1=1&key2=2&key3=3. Dependendo das regras definidas, o ESA processa essa URL da seguinte maneira:

Parâmetro

Descrição

Exemplo

Ignore All

Remove o caractere ? e todas as query strings após esse caractere da URL de solicitação.

A chave de cache é http://example.com/1.jpg.

Retain All

Mantém o caractere ? e todos os parâmetros de query string após esse caractere na URL de solicitação.

A chave de cache é http://example.com/1.jpg?key1=1&key2=2&key3=3.

Ignore Specific Parameters

Exclua parâmetros específicos após o ? na URL de solicitação. Insira os parâmetros a serem ignorados e pressione Enter.

Ao inserir key1 e key3 como parâmetros para exclusão, a chave de cache resultante é http://example.com/1.jpg?key2=2.

Retain Specific Parameters

Preserva apenas os parâmetros de query string especificados após o ?. Insira os parâmetros a serem mantidos e pressione Enter.

Se você definir key1 e key3 como parâmetros para retenção, a chave de cache é http://example.com/1.jpg?key1=1&key3=3.

Configurações no nível do site versus baseadas em regras

As configurações no nível do site aplicam-se a todas as solicitações. Para direcionar solicitações específicas, utilize recursos baseados em regras, que permitem maior precisão por meio de condições correspondentes. O equivalente baseado em regras para a filtragem de query strings é a Chave de Cache Personalizada.