Todos os produtos
Search

Este produto

    Edge Security Acceleration:Configure o TTL de cache para códigos de status

    Central de documentação

    Edge Security Acceleration:Configure o TTL de cache para códigos de status

    Última atualização: Oct 14, 2026

    Quando um servidor de origem retorna um código de status diferente de 2xx, os pontos de presença (POPs) do Edge Security Acceleration (ESA) podem armazenar o código de status em cache e responder diretamente às solicitações subsequentes dentro do período de validade do cache. Isso reduz as solicitações repetidas à origem e diminui a carga no servidor de origem.

    Cenários

    Normalmente, um POP do ESA armazena um recurso em cache apenas quando o servidor de origem retorna um código de status 2xx. Se o servidor de origem retornar um código de status diferente de 2xx, como 404 ou 502, você pode configurar um tempo de vida (TTL) de cache para esse código de modo que o POP do ESA responda diretamente, sem encaminhar todas as solicitações para a origem.

    Cenário típico

    O Arquivo A foi excluído do servidor de origem, mas os clientes continuam a acessá-lo. Como o POP do ESA não armazenou o Arquivo A em cache, todas as solicitações para esse arquivo são enviadas ao servidor de origem, que responde com um código de status 404. Isso aumenta significativamente a carga no servidor de origem.

    Se você configurar o POP do ESA para armazenar o código de status 404 em cache, o POP fará esse cache após a primeira busca na origem. As solicitações subsequentes receberão uma resposta 404 diretamente do POP do ESA até que o cache expire, evitando buscas desnecessárias na origem.

    Procedimento

    1. No console do ESA, selecione Site Management. Na coluna Website, clique no site de destino.

    2. No painel de navegação à esquerda, escolha Rules > Cache Rules.

    3. Crie uma regra: clique em Create Rule e insira um Rule Name.

    4. Na área If requests match..., defina os atributos de solicitação a serem correspondidos. Para obter mais informações sobre a configuração de regras, consulte Composition of rule expressions.

    5. Na seção Cache Eligibility, especifique se deve ignorar o cache. Para obter mais informações, consulte Cache eligibility.

    6. Na área Edge Status Code Cache TTL, clique em Configure.

    7. Na seção Status Code Cache Rule, clique em Add, configure os parâmetros a seguir e clique em OK:

      • Status Code: O código de status HTTP a ser armazenado em cache. Há suporte para códigos de status 4xx (erro do cliente) e 5xx (erro do servidor), como 404, 502 e 503.

      • Expired At: O período durante o qual o POP armazena o código de status em cache. O valor pode variar de 1 segundo a 31.536.000 segundos (1 ano). Após a expiração do TTL, o POP busca o código de status no servidor de origem novamente.

    Exemplos de configuração

    Cenário 1: Armazenar erros 404 em cache para recursos estáticos

    Necessidade do negócio: As imagens na pasta de imagens do site podem ser excluídas, mas a página de frontend ainda referencia os caminhos antigos.

    Configuração:

    • Condição de correspondência: O caminho da URL contém /images

    • Código de status: 404

    • TTL de cache: 600 segundos (10 minutos)

    Resultado: Na primeira solicitação de uma imagem inexistente, o POP busca uma resposta 404 na origem e a armazena em cache por 10 minutos. Durante esse período, as solicitações subsequentes para a mesma imagem recebem uma resposta 404 diretamente do POP, sem uma busca na origem.

    Cenário 2: Cache de curta duração para falha do servidor de origem

    Necessidade do negócio: O servidor de origem fica ocasionalmente indisponível e retorna erros 5xx. O objetivo é reduzir o impacto nos usuários finais durante a interrupção.

    Configuração:

    • Condição de correspondência: All Requests

    • Código de status: 5xx

    • TTL de cache: 60 segundos (1 minuto)

    Resultado: Quando o servidor de origem falha, o POP armazena o código de status 5xx em cache por 1 minuto, impedindo que um pico de solicitações aumente ainda mais a carga da origem. Após 1 minuto, o POP faz uma nova busca na origem para verificar se o servidor se recuperou.

    Verifique a configuração

    Após concluir a configuração, verifique se ela entrou em vigor usando um dos métodos a seguir.

    Método 1: Use o comando curl

    1. Limpe o cache local e envie a primeira solicitação:

      curl -I https://example.com/non-existent-page

      O cabeçalho de resposta deve conter x-site-cache-status: MISS. Isso indica a primeira busca na origem.

    2. Solicite imediatamente a mesma URL novamente:

      curl -I https://example.com/non-existent-page

      O cabeçalho de resposta deve conter x-site-cache-status: HIT, o que indica um acerto de cache. O valor de idade do cache também deve incrementar a cada solicitação subsequente.

    Método 2: Use as ferramentas de desenvolvedor do navegador

    1. Abra o Chrome DevTools (pressione F12), mude para a guia Network e marque a opção Preserve log.

    2. Acesse um recurso inexistente, como https://example.com/test404.

    3. Em seguida, visualize os Response Headers nos detalhes da solicitação. A primeira solicitação mostra x-site-cache-status: MISS. As solicitações subsequentes mostram x-site-cache-status: HIT, e o valor de idade do cache incrementa a cada solicitação.

    Perguntas frequentes

    Documentação relacionada

    Os recursos relacionados a regras variam em prioridade efetiva, reentrância e granularidade efetiva. Para obter detalhes, consulte Characteristics of rule-based features.