Todos os produtos
Search
Central de documentação

Edge Security Acceleration:Ignorar parâmetros

Última atualização: Jun 29, 2026

Parâmetros em uma solicitação URL após o caractere ? podem afetar a taxa de acerto de cache. Ao ativar o recurso de ignorar parâmetros, os pontos de presença (POPs) do DCDN removem os parâmetros após o ? da URL durante a correspondência de conteúdo no cache. Essa ação aumenta a taxa de acerto de cache e reduz o número de solicitações de retorno à origem.

Observações de uso

Conflitos de recursos

Importante

Os recursos Custom Cachekey e ignorar parâmetros são conflitantes. Não ative ambos simultaneamente.

Quando o recurso de ignorar parâmetros está ativado, os POPs do DCDN modificam os parâmetros na chave de cache tanto no modo Retain Specified Parameters quanto no modo Delete Specified Parameters. Consequentemente, as configurações de parâmetro de solicitação no recurso Custom Cachekey não surtem efeito.

Para usar o Custom Cachekey na configuração da chave de cache, desative o recurso de ignorar parâmetros.

Use o Custom Cachekey como alternativa

O recurso Custom Cachekey inclui todas as funcionalidades do recurso de ignorar parâmetros, mas oferece controle mais flexível. Recomendamos o uso do Custom Cachekey. A tabela a seguir compara as configurações.

Caso de uso

Configuração de ignorar parâmetros

Configuração do Custom Cachekey

Ignorar todos os parâmetros de solicitação na chave de cache.

Defina Passed como Yes e deixe o campo Retain Specified Parameters vazio.

Adicione uma política de tratamento de parâmetro de solicitação: defina a operação como Yes e o nome do parâmetro como qualquer nome inexistente.

Manter apenas o parâmetro de solicitação key1 na chave de cache.

Defina Ignore Parameter como Passed e Retain Specified Parameters como key1

Adicione uma regra de tratamento de parâmetro de solicitação: defina a operação como Yes e o nome do parâmetro como key1.

Excluir apenas o parâmetro de solicitação key1 da chave de cache.

Delete Specified Parameters definido como key1

Adicione uma política de tratamento de parâmetro de solicitação: defina Action como Delete e Parameter Name como key1

Como funciona

O recurso de ignorar parâmetros oferece duas funções: filtragem de parâmetros e retenção de parâmetros para solicitações de retorno à origem.

  • Filtragem de parâmetros

    Se este recurso estiver ativado, um ponto de presença (POP) do DCDN remove os parâmetros após o ? da URL ao buscar no cache. Isso permite que solicitações para o mesmo recurso com parâmetros diferentes atinjam o mesmo arquivo em cache.

    Cenário

    Descrição

    Uma URL contém parâmetros, como IDs de usuário, irrelevantes para o conteúdo do recurso.

    Por exemplo, o Usuário A solicita http://example.com/1.jpg?uid=123 e o Usuário B solicita http://example.com/1.jpg?uid=654. Se você ativar o recurso de ignorar parâmetros, o POP do DCDN usará http://example.com/1.jpg para a busca no cache. Assim, ambas as solicitações atingem o mesmo arquivo em cache.

  • Retenção de parâmetros para solicitações de retorno à origem

    Cenário

    Descrição

    Você ativa a filtragem de parâmetros e precisa passar informações do usuário ao servidor de origem.

    Se você ativar a configuração ignore parameter, o DCDN usa por padrão a URL sem parâmetros nas solicitações de retorno à origem. Caso ative Retain Origin Parameters, o DCDN utiliza a URL original, incluindo os parâmetros após o ?, nas solicitações de retorno à origem para transmitir informações do usuário ao servidor de origem.

Nota

O recurso de assinatura de URL tem precedência sobre o recurso de ignorar parâmetros. Quando se utiliza a assinatura Tipo A, as informações de assinatura constam nos parâmetros da solicitação. O DCDN autentica a solicitação primeiro. Após a autenticação bem-sucedida, o DCDN armazena o recurso em cache em um POP. Para obter mais informações sobre como configurar a assinatura de URL, consulte Configurar assinatura de URL.

Procedimento

  1. Faça login no DCDN console.

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

  3. Na página Domain Names, localize o nome de domínio desejado e clique em Configure.

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

  5. Na seção Ignore Parameters, clique em Modify. Em seguida, selecione um modo e configure os parâmetros conforme suas necessidades comerciais.

    Nota

    Ao alternar entre modos, o sistema exclui as configurações existentes.

    • Modo: Retain Specified Parameters

      image

      Parâmetro

      Descrição

      Exemplo

      Parameter Filtering

      • Passed: remove os parâmetros após o ? da URL para melhorar a taxa de acerto de cache.

        Nota

        Se você configurar apenas Ignore Parameter e não definir Retain Specified Parameters, todos os parâmetros após o caractere ? serão removidos.

      • Rejected: Os parâmetros após o ? na URL devem corresponder exatamente.

      Suponha que a URL original seja http://example.com/1.jpg?key1=1&key2=2&key3=3.

      • Ignorar todos os parâmetros e usar a URL processada para solicitações de retorno à origem

        Configurações: Defina Parameter Filtering como Passed, deixe o campo Retain Specified Parameters vazio e defina Retain Origin Parameters como Rejected.

        Chave de cache: http://example.com/1.jpg

        URL de retorno à origem: http://example.com/1.jpg

      • Reter parâmetros especificados e usar a URL processada para solicitações de retorno à origem

        Configurações: Defina Parameter Filtering como Passed, defina Retain Specified Parameters como key1 e defina Retain Origin Parameters como Rejected.

        Chave de cache: http://example.com/1.jpg?key1=1

        URL de retorno à origem: http://example.com/1.jpg?key1=1

      • Ignorar todos os parâmetros e usar a URL original para solicitações de retorno à origem

        Configurações: Defina Parameter Filtering como Passed, deixe o campo Retain Specified Parameters vazio e defina Retain Origin Parameters como Passed.

        Chave de cache: http://example.com/1.jpg

        URL de retorno à origem: http://example.com/1.jpg?key1=1&key2=2&key3=3

      • Reter parâmetros especificados e usar a URL original para solicitações de retorno à origem

        Configurações: Defina Parameter Filtering como Passed, defina Retain Specified Parameters como key1 e defina Retain Origin Parameters como Passed.

        Chave de cache: http://example.com/1.jpg?key1=1

        URL de retorno à origem: http://example.com/1.jpg?key1=1&key2=2&key3=3

      Retain Specified Parameters

      Especifique os parâmetros a serem retidos. É possível especificar até 10 parâmetros, separados por vírgulas (,).

      Após definir Retain Specified Parameters como key1, apenas o parâmetro key1 na URL é mantido para correspondência de cache.

      Retain Origin Parameters

      • Passed: Todos os parâmetros da URL original são retidos nas solicitações de retorno à origem.

      • Rejected: Os parâmetros das solicitações de retorno à origem correspondem aos da chave de cache, ou seja, apenas os parâmetros especificados são retidos.

      Para mais informações, compare as URLs de retorno à origem no segundo e no quarto exemplos da coluna Exemplo.

    • Modo: Delete Specified Parameters

      Parâmetro

      Descrição

      Exemplo

      Delete Specified Parameters

      Especifique os parâmetros a serem excluídos. É possível especificar até 10 parâmetros, separados por espaços.

      Suponha que a URL original seja http://example.com/1.jpg?key1=1&key2=2&key3=3.

      • Excluir parâmetros especificados e usar a URL processada para solicitações de retorno à origem

        Configurações: Defina Delete Specified Parameters como key1 e defina Retain Origin Parameters como Rejected.

        Chave de cache: http://example.com/1.jpg?key2=2&key3=3

        URL de retorno à origem: http://example.com/1.jpg?key2=2&key3=3

      • Excluir parâmetros especificados e usar a URL original para solicitações de retorno à origem

        Configurações: Defina Delete Specified Parameters como key1 e defina Retain Origin Parameters como Passed.

        Chave de cache: http://example.com/1.jpg?key2=2&key3=3

        URL de retorno à origem: http://example.com/1.jpg?key1=1&key2=2&key3=3

      Retain Origin Parameters

      • Passed: Todos os parâmetros da URL original são retidos nas solicitações de retorno à origem.

      • Rejected: Os parâmetros das solicitações de retorno à origem correspondem aos da chave de cache, ou seja, os parâmetros especificados são excluídos.

      Para mais informações, veja a diferença na URL de retorno à origem entre o Cenário 1 e o Cenário 2.

  6. Clique em OK.