CDN:Chave de cache personalizada

Comparação de recursos

• A filtragem de parâmetros e a Chave de cache personalizada entram em conflito. A ativação da filtragem de parâmetros remove os parâmetros de query string dos URLs, o que torna ineficazes os parâmetros configurados em uma chave de cache personalizada. Verifique se não há chaves de cache personalizadas criadas antes de ativar esse recurso.

• O CDN oferece três recursos que controlam como as query strings de URL afetam o armazenamento em cache. A tabela a seguir os compara.

  Caso de uso	Filtragem de parâmetros	CacheKey personalizada
  Ignorar todos os parâmetros de consulta na chave de cache	Defina Ignore Parameters como Yes e deixe Retain Specified Parameters em branco.	Adicione uma regra de parâmetro de solicitação: defina Action como Retain e Parameter Name como um valor inexistente, como example-argument.
  Manter apenas key1 na chave de cache	Defina Ignore Parameters como Yes e Retain Specified Parameters como key1.	Adicione uma regra de parâmetro de solicitação: defina Action como Retain e Parameter Name como key1.
  Remover apenas key1 da chave de cache	Defina Remove Specified Parameters como key1.	Adicione uma regra de parâmetro de solicitação: defina Action como Delete e Parameter Name como key1.

• Reescrever parâmetros de origem: para modificar os parâmetros de consulta nas solicitações de origem, use Reescrever parâmetros de origem. A configuração da chave de cache altera apenas o URL da solicitação, sem modificar o URL de origem.

• Limpar cache: após configurar uma chave de cache personalizada, se você limpar recursos por URL, a tarefa pode não corresponder ao conteúdo armazenado em cache. Envie a chave de cache gerada pelo recurso de chave de cache personalizada como o objeto a ser limpo.

Casos de uso

A personalização da chave de cache atende a dois objetivos opostos: consolidar solicitações ou dividi-las.

Consolidar: múltiplas solicitações para o mesmo arquivo possuem URLs diferentes devido a parâmetros variados. Os POPs tratam essas solicitações como arquivos separados e os armazenam em cache individualmente, aumentando as buscas na origem. Uma regra de chave de cache personalizada unifica essas solicitações em uma única chave de cache.

Dividir: múltiplas solicitações compartilham o mesmo URL, mas exigem respostas em cache diferentes — por exemplo, com base em um cabeçalho de tipo de cliente. Sem uma chave de cache personalizada, o CDN serve a todos os clientes o mesmo arquivo em cache. Adicionar o valor do cabeçalho à chave de cache cria entradas de cache separadas por tipo de cliente.

Configurar uma chave de cache personalizada

1. Faça logon no console do CDN.

2. No painel de navegação à esquerda, clique em Domain Names.

3. Na página Domain Names, localize o nome de domínio acelerado e clique em Manage na coluna Actions.

4. No painel de navegação do domínio, clique em Cache.

5. Na aba Custom Cache Key, clique em Configure.

6. Defina as regras de chave de cache usando os parâmetros descritos na tabela a seguir.

   Parâmetro	Descrição
   Rule Condition	Filtra solicitações por atributos de solicitação para determinar a quais solicitações esta regra se aplica. null Quando uma configuração de recurso faz referência a condições de regra configuradas no mecanismo de regras, a ordem de execução segue a ordem de prioridade das condições de regra associadas, não a ordem de prioridade das configurações de recurso. Padrão: não utilizar condições de regra. Para adicionar ou editar condições de regra, acesse o Mecanismo de Regras.
   URIs	Substitui um caminho URI correspondente por um caminho diferente ao construir a chave de cache. Defina Source URI como o padrão do caminho original (deve começar com /, sem prefixo http:// ou domínio; suporta expressões regulares PCRE) e Final URI como o caminho de substituição (deve começar com /, sem prefixo http:// ou domínio). Quando existem múltiplas regras de substituição de URI, elas são correspondidas de cima para baixo e a primeira correspondência se aplica.
   Request Parameter	Modifica os parâmetros de query string na chave de cache. Operações suportadas: Add (adicionar novos parâmetros), Delete (remover parâmetros específicos), Modify (alterar o valor de um parâmetro) e Reserve (manter apenas os parâmetros especificados, descartando o restante). Quando existem múltiplas operações, elas são executadas sequencialmente de cima para baixo. Se múltiplas operações visam o mesmo parâmetro, a ordem de prioridade é: Add > Delete > Reserve > Modify.
   HTTP Headers	Adiciona os valores dos cabeçalhos HTTP de solicitação especificados à chave de cache. Separe múltiplos nomes de cabeçalho com espaços. Os valores dos cabeçalhos são adicionados na ordem listada.
   Custom Variables	Extrai um valor de um parâmetro de solicitação, cabeçalho HTTP, cookie ou caminho URI usando uma expressão regular e adiciona o valor extraído à chave de cache. Para detalhes de uso e exemplos, consulte Exemplos de configuração.

   

7. Clique em OK.

Exemplos de configuração