Controlar o comportamento de cache da Rede de Distribuição de Conteúdo com regras de cache
Importante
A CDN do Azure Standard (clássica) será desativada em 30 de setembro de 2027. Para evitar qualquer interrupção de serviço, é importante migrar seus perfis da CDN do Azure Standard (clássica) para a camada Azure Front Door Standard ou Premium até 30 de setembro de 2027. Para obter mais informações, confira CDN do Azure Standard (clássica).
O CDN do Azure da Edgio será desativado em 15 de janeiro de 2025. Você deve migrar sua carga de trabalho para o Azure Front Door antes desta data para evitar interrupção do serviço.. Para obter mais informações, veja Perguntas frequentes sobre a aposentadoria do CDN do Azure da Edgeo.
Este artigo descreve como você pode usar as regras de cache da rede de distribuição de conteúdo para definir ou modificar o comportamento padrão de expiração do cache. Essas regras de cache podem ser globais ou com condições personalizadas, como um caminho de URL e uma extensão de arquivo.
Observação
As regras de armazenamento em cache estão disponíveis apenas para perfis CDN do Azure Standard da Edgio. Para perfis da CDN do Azure da Microsoft, você deve usar o Mecanismo de regras Standard. Para os perfis da CDN do Azure Premium da Edgio, você deve usar o Mecanismo de regras Premium da Edgio no portal Gerenciar a fim de obter uma funcionalidade semelhante.
A Rede de Distribuição de Conteúdo do Microsoft Azure oferece duas maneiras de controlar como seus arquivos são armazenados em cache:
Regras de cache: a Rede de Distribuição de Conteúdo do Microsoft Azure fornece dois tipos de regras de cache: global e personalizada.
Regras globais de cache: você pode definir uma regra global de cache para cada ponto de extremidade em seu perfil, o que afeta todas as solicitações para o ponto de extremidade. A regra de cache global substitui todos os cabeçalhos de diretiva de cache HTTP, se configurado.
Regras de cache personalizadas: você pode definir uma ou mais regras de cache personalizadas para cada ponto de extremidade em seu perfil. As regras de cache personalizadas correspondem a caminhos e extensões de arquivo específicos, são processadas em ordem e substituem a regra de cache global, se definida.
Cache da cadeia de caracteres de consulta: é possível ajustar a forma como a Rede de Distribuição de Conteúdo do Microsoft Azure trata o armazenamento em cache para solicitações com cadeias de caracteres de consulta. Para obter informações, consulte Controlar o comportamento de cache da Rede de Distribuição de Conteúdo do Azure com cadeias de caracteres de consulta. Se o arquivo não puder ser armazenado em cache, a configuração do cache da cadeia de caracteres de consulta não terá efeito, com base nas regras de cache e nos comportamentos padrão da rede de distribuição de conteúdo.
Para obter informações sobre o comportamento de cache padrão e os cabeçalhos de diretivas de cache, consulte Como funciona o cache.
Acessando regras de cache da Rede de Distribuição de Conteúdo do Microsoft Azure
Abra o portal do Azure, selecione um perfil de rede de distribuição de conteúdo e selecione um ponto de extremidade.
No painel esquerdo em Configurações, selecione Regras de cache.
A página Regras de cache é exibida.
Configurações de comportamento do cache
Para regras de cache globais e personalizadas, é possível especificar as seguintes configurações de Comportamento do cache:
Ignorar o cache: não armazenar em cache e ignorar cabeçalhos de diretiva de cache fornecidos pela origem.
Substituir: Ignora as durações de cache fornecidas pela origem; em vez disso, utiliza a duração do cache fornecida. Essa configuração não substitui controle de cache: nenhum cache.
Observação
Para perfis da CDN do Azure da Microsoft, a substituição de expiração de cache só é aplicável aos códigos de status 200 e 206.
- Definir se ausente: aceita os cabeçalhos de diretiva de cache fornecidos pela origem, se existirem; caso contrário, usa a duração do cache fornecida.
Duração da expiração do cache
Para regras de cache globais e personalizadas, é possível especificar a duração da expiração do cache em dias, horas, minutos e segundos:
Para as configurações Substituir, Definir se ausente e Comportamento do cache, as durações de cache válidas variam entre 0 segundos e 366 dias. Por um valor de 0 segundos, a rede de distribuição de conteúdo armazena em cache o conteúdo, mas deve revalidar cada solicitação com o servidor de origem.
Para a configuração Ignorar cache, a duração do cache é definida automaticamente para 0 segundo, o que não é um valor modificável.
As regras de cache personalizadas correspondem condições
Para regras de cache personalizadas, há duas condições de correspondência:
Caminho: essa condição corresponde ao caminho da URL, excluindo o nome de domínio e fornece suporte ao símbolo curinga (*). Por exemplo, /myfile.html, /my/folder/**, and /my/images/.jpg. O comprimento máximo é de 260 caracteres.
Extensão: essa condição corresponde à extensão do arquivo solicitado. Você pode fornecer uma lista de extensões de arquivo separadas por vírgulas para corresponder. Por exemplo, .jpg, .mp3 ou .png. O número máximo de extensões é 50 e o número máximo de caracteres por extensão é 16.
Ordem de processamento global e personalizado de regras
As regras de cache globais e personalizadas são processadas na seguinte ordem:
As regras de cache globais têm precedência sobre o comportamento de cache padrão da rede de distribuição de conteúdo (configurações de cabeçalho de diretiva de cache HTTP).
As regras de cache personalizadas têm precedência sobre as regras de cache globais, onde elas se aplicam. As regras de cache personalizadas são processadas na ordem de cima para baixo. Ou seja, se uma solicitação corresponder às duas condições, as regras na parte inferior da lista prevalecem sobre as regras na parte superior da lista. Portanto, é necessário colocar mais regras específicas na lista.
Exemplo:
Regra de cache global:
- Comportamento do cache: Substituir
- Duração da expiração do cache: um dia
Regra de cache individual Nº 1:
- Condição de correspondência: Caminho
- Valor de correspondência: /home/*
- Comportamento do cache: Substituir
- Duração de expiração do cache: dois dias
Regra de cache personalizada Nº 2:
- Condição de correspondência: Extensão
- Valor de correspondência: .html
- Comportamento do cache: Definir se ausente
- Duração da expiração do cache: três dias
Quando você define essas regras, uma solicitação para o <nome do host do ponto de extremidade>.azureedge.net/home/index.html dispara a regra de cache personalizada #2, que é definida como: definir se ausente e 3 dias. Portanto, se o arquivo index.html tiver Cache-Control ou Expires cabeçalhos HTTP, eles serão honrados; caso contrário, se você não definir esses cabeçalhos, o arquivo será armazenado em cache por três dias.
Observação
Os arquivos que são armazenados em cache antes de uma alteração de regra mantêm a configuração da duração do cache de origem. Para reiniciar as durações de cache, será necessário limpar o arquivo.
As alterações de configuração da Rede de Distribuição de Conteúdo do Microsoft Azure podem levar algum tempo para serem propagadas pela rede:
- Para perfis da CDN do Azure Standard da Edgio, a propagação geralmente é concluída em 10 minutos.