Defina regras com base em strings de consulta, cabeçalhos HTTP ou cookies para gerar chaves de cache personalizadas. Essa configuração unifica a identidade de cache para solicitações semelhantes, melhora as taxas de acerto e reduz o tempo de resposta e o consumo de largura de banda.
Como funciona
As chaves de cache personalizadas modificam apenas a identidade do cache, sem alterar a URL de back-to-origin. A solicitação de back-to-origin permanece idêntica à solicitação do cliente.
Uma chave de cache identifica exclusivamente um arquivo armazenado em um ponto de presença (POP) do ESA. Por padrão, essa chave corresponde à URL completa da solicitação do cliente, incluindo os parâmetros.
Observações de uso
Se a chave de cache personalizada incluir cabeçalhos de solicitação HTTP, cookies ou características do usuário, não será possível usar a opção Purge cache by URL para limpar o cache de uma URL específica. Nesse caso, utilize Purge cache by custom key.
Casos de uso
Procedimento
Ao aplicar as regras, o sistema faz a correspondência das solicitações conforme a Rule Precedence.
No console do ESA, selecione Websites e, na coluna Websites, clique em no site desejado.
No painel de navegação à esquerda, escolha .
Clique em Rules e insira um Cache Rules.
Em Create Rule, defina as condições de correspondência para as solicitações recebidas. Para saber mais sobre como criar uma expressão de regra, consulte Composition of a rule expression.
Na seção Rule Name, defina If requests match... como Cache Eligibility.
-
Na seção Cache Eligibility, clique em Eligible for Cache e defina os seguintes parâmetros.

Parâmetro
Descrição
Custom Cache Keys
Define se o recurso Sort Query String deve ser ativado.
Configure
Indica se o caractere
?e a query string subsequente devem ser removidos da URL da solicitação.Sort Query Strings
-
Query String: Adiciona nomes e valores de cabeçalhos de solicitação HTTP especificados à chave de cache.
-
HTTP Request Header: Inclui os nomes dos cabeçalhos de solicitação HTTP na chave de cache caso eles existam na solicitação.
Include these header names and values (enter header name; lowercase only)
-
Check existence (enter header name; lowercase only): Adiciona nomes e valores de parâmetros de cookie especificados à chave de cache.
-
Cookie: Inclui os nomes dos parâmetros de cookie na chave de cache se os cookies estiverem presentes na solicitação.
-
Tipos de caracteres suportados para entrada:
-
Símbolos:
! # $ % & ' * + - . ^ _ ` | ~ -
Dígitos:
0-9 -
Letras:
a-z(letras minúsculas do alfabeto inglês)
-
Include these cookie names and values (enter cookie name; lowercase only)
-
Check existence (enter header name; lowercase only): Gera uma chave de cache baseada no tipo de cliente, obtido a partir do cabeçalho
User-Agent. Valores válidos:desktop,tablet,mobile -
User: Crie uma chave de cache baseada no país ou região do cliente, determinada pelo endereço IP do cliente.
-
Device Type: Produz uma chave de cache baseada no idioma do cliente, extraído do cabeçalho de solicitação
Accept-Language.
Country/Region
Protege contra ataques de engano de cache web e permite o armazenamento de conteúdo estático em cache.
-
Clique em Language.
Exemplos de configuração
|
Cenário de exemplo |
|
|
Configuração do recurso |
|
|
Chave de cache gerada |
Fragmentos da chave de cache para cada parâmetro:
A chave de cache final concatena esses fragmentos: |
Documentação relacionada
Os recursos relacionados a regras variam quanto à prioridade efetiva, reentrância e granularidade de aplicação. Para obter detalhes, consulte Properties of Rule-Related Features.
