Todos os produtos
Search

Este produto

    Edge Security Acceleration:Ignorar parâmetros

    Central de documentação

    Edge Security Acceleration:Ignorar parâmetros

    Última atualização: Oct 27, 2026

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

    Observações de uso

    Conflitos de recursos

    Importante

    Se você configurar o método de processamento de string de consulta no recurso Custom Cachekey e ativar a opção Ignore Parameters simultaneamente, a configuração de Custom Cachekey no nível da regra terá precedência sobre a configuração global de Ignore Parameters. O recurso Ignore Parameters não se aplica às requisições que correspondem à regra de cache.

    Quando uma regra de cache tem o método de processamento de string de consulta configurado no recurso Custom Cachekey, a definição de string de consulta no nível da regra prevalece sobre a configuração global de Ignore Parameters. Assim, o recurso Ignore Parameters torna-se ineficaz para requisições que atendem a essa regra de cache.

    Para garantir que o recurso Ignore Parameters funcione corretamente, verifique se nenhuma regra de cache tem o método de processamento de string de consulta configurado no recurso Custom Cachekey.

    Use Custom Cachekey como alternativa

    O recurso Custom Cachekey oferece controle de parâmetros mais flexível e replica todas as configurações de chave de cache do recurso de ignorar parâmetros. Recomendamos o uso do Custom Cachekey como alternativa. A tabela a seguir compara os métodos de configuração dos dois recursos.

    Caso de uso

    Configuração de ignorar parâmetros

    Configuração de Custom Cachekey

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

    Defina ignore parameters como Passed e deixe Retain Specified Parameters vazio.

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

    Reter apenas o parâmetro de requisição key1 na chave de cache.

    Defina ignore parameters como Passed e configure Retain Specified Parameters como key1.

    Adicione uma política de processamento de parâmetro de requisição: defina a ação como Yes e o nome do parâmetro como key1.

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

    Defina Delete Specified Parameters como key1.

    Adicione uma política de processamento de parâmetro de requisição: defina a ação como Delete e o nome do parâmetro como key1.

    Funcionamento

    O recurso de ignorar parâmetros inclui duas configurações: ignore parameters e Retain Parameters in Back-to-origin Requests.

    • Ignore parameters

      Quando ativado, os POPs da DCDN removem os parâmetros após o ? na URL durante as consultas ao cache. Isso permite que requisições para o mesmo recurso correspondam à mesma entrada de cache, mesmo com parâmetros diferentes.

      Caso de uso

      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 ignore parameters, o POP da DCDN usará http://example.com/1.jpg para a consulta ao cache. Assim, ambas as requisições atingem o mesmo arquivo em cache.

    • Retain Parameters in Back-to-origin Requests

      Caso de uso

      Descrição

      Você ativou ignore parameters, mas precisa passar informações do usuário ao servidor de origem.

      Após ativar Ignore Parameters, a DCDN usa por padrão a URL sem parâmetros nas requisições de retorno à origem. Ao ativar Retain Parameters in Back-to-origin Requests, a DCDN utiliza a URL original, incluindo os parâmetros após o ?, nas requisições de retorno à origem para transmitir as informações do usuário ao servidor de origem.

    O recurso de ignorar parâmetros possui dois modos: Retain Specified Parameters e Delete Specified Parameters. O fluxograma a seguir ilustra como a DCDN processa as requisições quando ignore parameters está ativado.

    image
    Nota

    O recurso de assinatura de URL tem precedência sobre o recurso de ignorar parâmetros. A DCDN executa a validação de assinatura de URL antes de aplicar as regras de ignorar parâmetros, pois a assinatura para autenticação Tipo A é calculada com os parâmetros originais da requisição. Para obter mais informações sobre como configurar a assinatura de URL, consulte Configure URL signing.

    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, selecione um modo e conclua a configuração conforme necessário.

      Nota

      A troca de modos exclui a configuração existente.

      • Modo: Retain Specified Parameters

        Parâmetro

        Descrição

        Exemplo

        Parameter Filtering

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

          Nota

          Se você definir Parameter Filtering como Yes, mas deixar Retain Specified Parameters vazio, todos os parâmetros após o ? serão removidos.

        • Rejected: Corresponde exatamente aos parâmetros após o ? na URL.

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

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

          Configuração: Defina Parameter Filtering como Passed, deixe Retain Specified Parameters vazio e defina Retain Parameters in Back-to-origin Requests 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 requisições de retorno à origem

          Configuração: Defina Parameter Filtering como Passed, configure Retain Specified Parameters como key1 e defina Retain Parameters in Back-to-origin Requests 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 requisições de retorno à origem

          Configuração: Defina Parameter Filtering como Passed, deixe Retain Specified Parameters vazio e defina Retain Parameters in Back-to-origin Requests 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 requisições de retorno à origem

          Configuração: Defina Parameter Filtering como Passed, configure Retain Specified Parameters como key1 e defina Retain Parameters in Back-to-origin Requests 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

        Configure até 10 parâmetros para reter, separados por vírgula (,).

        Se você definir Retain Specified Parameters como key1, apenas o parâmetro key1 na URL será usado para correspondência de cache.

        Retain Origin Parameters

        • Passed: A requisição de retorno à origem inclui todos os parâmetros da URL original.

        • Rejected: Os parâmetros na requisição de retorno à origem são iguais aos da chave de cache. Apenas os parâmetros especificados são retidos.

        Compare as URLs de retorno à origem no terceiro e quarto exemplos acima.

      • 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.

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

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

          Configuração: Defina Delete Specified Parameters como key1 e defina Retain Parameters in Back-to-origin Requests 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 requisições de retorno à origem

          Configuração: Defina Delete Specified Parameters como key1 e defina Retain Parameters in Back-to-origin Requests 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: A requisição de retorno à origem inclui todos os parâmetros da URL original.

        • Rejected: Os parâmetros na requisição de retorno à origem são iguais aos da chave de cache. Os parâmetros especificados são excluídos.

        Compare as URLs de retorno à origem no primeiro e segundo exemplos acima.

    6. Clique em OK.