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: Aug 14, 2026

    Os parâmetros após o caractere ? em uma requisição de url podem afetar a taxa de acerto de 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 back-to-origin.

    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 ative Ignore Parameters simultaneamente, a configuração de Custom Cachekey no nível de regra terá precedência sobre a configuração global de Ignore Parameters. O recurso Ignore Parameters não se aplica a 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 configuração da string de consulta no nível da regra prevalece sobre a definição global de Ignore Parameters. Consequentemente, o recurso Ignore Parameters torna-se ineficaz para requisições associadas 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 Ignore Parameters

    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.

    Como funciona

    O recurso de ignorar parâmetros inclui duas definiçõ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 de 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ê ative ignore parameters, o POP da DCDN usa http://example.com/1.jpg para a consulta de 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 ative Ignore Parameters, a DCDN usa por padrão a url sem parâmetros para requisições back-to-origin. Ao ative Retain Parameters in Back-to-origin Requests, a DCDN utiliza a url original, incluindo os parâmetros após o ?, nas requisições back-to-origin para transmitir 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 configure 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

        image

        Parâmetro

        Descrição

        Exemplo

        Parameter Filtering

        • Passed: Remove os parâmetros da url após o ? para melhorar a taxa de acerto de 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 back-to-origin

          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 back-to-origin: http://example.com/1.jpg

        • Reter parâmetros especificados e usar a url processada para requisições back-to-origin

          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 back-to-origin: http://example.com/1.jpg?key1=1

        • Ignorar todos os parâmetros e usar a url original para requisições back-to-origin

          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 back-to-origin: http://example.com/1.jpg?key1=1&key2=2&key3=3

        • Reter parâmetros especificados e usar a url original para requisições back-to-origin

          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 back-to-origin: http://example.com/1.jpg?key1=1&key2=2&key3=3

        Retain Specified Parameters

        Configure até 10 parâmetros para reter, separando-os 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 back-to-origin inclui todos os parâmetros da url original.

        • Rejected: Os parâmetros na requisição back-to-origin são iguais aos da chave de cache. Apenas os parâmetros especificados são retidos.

        Compare as urls back-to-origin 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 back-to-origin

          Configuração: Defina Delete Specified Parameters como key1 e configure Retain Parameters in Back-to-origin Requests como Rejected.

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

          url back-to-origin: http://example.com/1.jpg?key2=2&key3=3

        • Excluir parâmetros especificados e usar a url original para requisições back-to-origin

          Configuração: Defina Delete Specified Parameters como key1 e configure Retain Parameters in Back-to-origin Requests como Passed.

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

          url back-to-origin: http://example.com/1.jpg?key1=1&key2=2&key3=3

        Retain Origin Parameters

        • Passed: A requisição back-to-origin inclui todos os parâmetros da url original.

        • Rejected: Os parâmetros na requisição back-to-origin são iguais aos da chave de cache. Os parâmetros especificados são excluídos.

        Compare as urls back-to-origin no primeiro e segundo exemplos acima.

    6. Clique em OK.