Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Configurar expiração de cache para códigos de status

Última atualização: Jun 29, 2026

Nota

Nota: Quando este recurso utiliza condições de regra do Rules Engine, a ordem de execução segue a prioridade do Rules Engine, e não a prioridade deste recurso.

Casos de uso

Use este recurso para controlar como os nós do DCDN armazenam respostas em cache quando o servidor de origem retorna códigos de status diferentes de 2xx.

Por padrão, o DCDN processa respostas 2xx com base nas regras de cache e prioridades padrão do Alibaba Cloud CDN e DCDN. Se sua origem retornar frequentemente códigos de status não 2xx, defina um TTL para esses códigos. Assim, os nós do DCDN retornarão as respostas diretamente do cache, reduzindo a carga na origem.

Exemplo

Um arquivo foi excluído do servidor de origem, mas os clientes continuam a solicitá-lo. Cada requisição aciona uma busca na origem que retorna um código 4xx, aumentando a carga do servidor. Ao configurar o cache para códigos de status 4xx, o nó do DCDN armazena a resposta 4xx após a primeira busca. As requisições subsequentes dentro do período de cache recebem a resposta 4xx armazenada diretamente.

Prioridade das regras

Quando uma requisição corresponde a múltiplas regras de cache, apenas uma entra em vigor:

  • Ordem de avaliação:

    As regras são avaliadas primeiro por tipo (File Extension > Directory) e depois pela data de criação (mais antiga > mais recente).

  • Prioridade para regras de tipos diferentes: File Extension > Directory.

    Por exemplo, se uma requisição de usuário corresponder a duas regras (ambas configuradas para o código de status 404) dos tipos File Extension e Directory, o tempo de expiração para o código 404 será determinado pela regra File Extension. Para ver um exemplo detalhado, consulte Exemplos de configuração.

  • Prioridade para regras do mesmo tipo: Mais antiga > Mais recente (de cima para baixo na lista de regras).

    Por exemplo, se uma requisição de usuário corresponder a duas regras (ambas configuradas para o código de status 404) do mesmo tipo (ambas File Extension ou ambas Directory), o tempo de expiração para o código 404 será determinado pela regra criada primeiro. Para ver um exemplo detalhado, consulte Exemplos de configuração.

Procedimento

  1. Faça login no console do DCDN.

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

  3. Na página Domain Names, localize o nome de domínio que deseja gerenciar e clique em Configure na coluna Actions.

  4. Na árvore de navegação à esquerda do nome de domínio, clique em Caching.

  5. Clique na aba Status Codes and Expiration Time.

  6. Clique em Add para crie uma regra de cache para códigos de status.

    image

    Tipo

    Observações

    Type

    Selecione um tipo: Directory ou File Extension.

    Nota

    Prioridade para regras de tipos diferentes: File Extension > Directory. Para mais informações, consulte Prioridade das regras.

    Object

    • Se você selecione Directory:

      • Adicione apenas um diretório por vez.

      • Insira o caminho completo do diretório começando com /, por exemplo, /directory/aaa.

    • Se você selecione File Extension:

      • Insira as extensões de arquivo separadas por vírgulas, por exemplo, jpg,txt.

        Nota

        As extensões de arquivo diferenciam maiúsculas de minúsculas. Se você crie regras para as mesmas extensões com casos diferentes (por exemplo, jpg,txt e JPG,TXT), a regra posterior substituirá a regra jpg,txt. Crie regras separadas para txt e jpg para evitar isso.

      • Não use asterisco (*) para corresponder a todos os tipos de arquivo.

    HTTP Status Codes and Expiration Time

    Especifique os códigos de status para armazenar em cache e seus respectivos TTLs em segundos (máximo: 3 anos):

    • Separe vários códigos de status com vírgulas (,).

    • Códigos 2xx e 3xx: apenas códigos individuais. Por exemplo, 201=10 é válido, mas 2xx=12 não é.

    • Códigos 4xx e 5xx: há suporte tanto para códigos individuais quanto para curingas. Por exemplo, 401=10 e 4xx=12 são válidos.

    Honor Origin TTL

    Quando ativado, os cabeçalhos de cache do servidor de origem (Cache-Control, Pragma) têm precedência sobre o TTL configurado.

    Ignore Origin No-Cache Header

    Quando ativado, os nós do DCDN ignoram estes cabeçalhos de não-cache da origem:

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Follow POP TTL

    Quando ativado, o nó do DCDN envia a política de cache efetiva final para o cliente.

    Force Revalidation

    Entra em vigor apenas quando o TTL do cache está definido como 0:

    • Desativado (padrão): Quando o TTL do DCDN é 0, os arquivos não são armazenados em cache nos nós do DCDN. Cada requisição aciona uma busca na origem.

    • Ativado: Quando o TTL do DCDN é 0, os arquivos são armazenados em cache nos nós do DCDN, mas cada requisição aciona uma busca na origem para revalidação.

  7. Clique em OK.

    A nova regra aparece na lista de Status Codes and Expiration Time , onde você pode Modify ou Delete a regra.

Exemplos de configuração

  • Exemplo 1: Regra do tipo Directory

    Crie uma regra Directory conforme mostrado abaixo:Example 1

    Para o diretório /directory/aaa, todos os códigos 4xx são armazenados em cache por 10 segundos e o código 201 por 15 segundos. Dentro do TTL, o DCDN responde diretamente. Após a expiração, as requisições são encaminhadas para a origem.

  • Exemplo 2: Regra do tipo File Extension

    Crie uma regra File Extension conforme mostrado abaixo:Example 2

    Para arquivos .jpg e .txt, o código 403 é armazenado em cache por 10 segundos e o código 404 por 15 segundos. Dentro do TTL, o DCDN responde diretamente. Após a expiração, as requisições são encaminhadas para a origem.

  • Exemplo 3: Prioridade para regras de tipos diferentes

    Uma regra Directory e uma regra File Extension com valores de TTL diferentes são criadas conforme mostrado abaixo:Example 3

    Um cliente solicita http://example.com/directory/aaa/test.jpg. O nó do DCDN busca o recurso na origem, que retorna 404. Esta requisição corresponde tanto à regra Directory quanto à regra File Extension. Como File Extension > Directory, a regra File Extension se aplica e o 404 é armazenado em cache por 20 segundos.

  • Exemplo 4: Prioridade para múltiplas regras do mesmo tipo

    A Regra Directory 1 é criada primeiro para /directory, seguida pela Regra Directory 2 para /directory/aaa, com valores de TTL diferentes conforme mostrado abaixo:Example 4

    Um cliente solicita http://example.com/directory/aaa/test.jpg. A origem retorna 404, que corresponde a ambas as Regras Directory. Como Mais antiga > Mais recente, a Regra Directory 1 se aplica e o 404 é armazenado em cache por 15 segundos.

Operações de API relacionadas

Adicionar nomes de domínio em lote