Todos os produtos
Search
Central de documentação

CDN:Reescrita de parâmetros

Última atualização: Oct 29, 2026

Se os parâmetros da URL da requisição original diferirem dos exigidos pelo servidor de origem, use o recurso Parameter Rewrite para reescrever os parâmetros na URL da requisição de retorno à origem. Esse recurso permite adicionar, excluir, reservar, modificar ou ignorar parâmetros.

Formato de parâmetros de URL

  • Os parâmetros de URL consistem em um ou mais pares name/value anexados a uma URL após o caractere ?, no formato name=value. Vários parâmetros são separados por &.

  • Uma URL também pode conter um caractere # e o texto subsequente. O # direciona o navegador para um local específico em uma página web.

    Por exemplo, em http://www.example.com/index.html#segment, a parte #segment aponta para o local segment na página index.html. Após carregar a página, o navegador rola automaticamente até esse local.改写参数图

Prioridade das operações

  • O recurso Parameter Rewrite permite configurar múltiplas operações de reescrita para os parâmetros de consulta na URL de requisição de retorno à origem. A ordem de prioridade é Add > Delete > Reserve Only > Modify. Quando diferentes operações têm como alvo o mesmo parâmetro, apenas aquela com a maior prioridade entra em vigor.

  • Se Ignore Parameters estiver ativado, Add será a única outra operação a surtir efeito.

Conflitos com outros recursos

O recurso Parameter Rewrite pode entrar em conflito com a regra enhance break do Rewrite Origin Fetch URL e com o recurso Ignore parameters. Caso ocorra um conflito, o último recurso configurado terá precedência.

Impacto na chave de cache

  • O recurso Parameter Rewrite é executado no POP de retorno à origem. Ele não afeta o roteamento interno do CDN nem reescreve a chave de cache.

  • Já o recurso Ignore parameters é executado no nó de borda. Ele afeta o roteamento interno do CDN e reescreve a chave de cache.

Importante

Se uma configuração utilizar uma condição de regra do mecanismo de regras, a prioridade da condição determinará a ordem de execução, substituindo a ordem de configuração do recurso.

Procedimento

  1. Faça login no CDN 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 Manage na coluna Actions.

  4. No painel de navegação à esquerda do nome de domínio, clique em Origin Fetch.

  5. Clique na aba Parameter Rewrite.

  6. Ative a opção Feature Switch.

  7. Configure os parâmetros a serem reescritos.

    Defina as operações de reescrita conforme necessário. Você também pode adicionar vários parâmetros na caixa de texto de cada tipo de operação. Para mais informações, consulte Configuration examples.

  8. Clique em OK para aplicar a configuração.

    Você também pode clicar em Modify na página Parameter Rewrite para alterar as regras existentes.

Exemplos de configuração

  • Exemplo 1: Ignorar todos os parâmetros

    Parâmetro

    Valor

    Ignore Parameters

    Enabled

    Add

    None

    Delete

    None

    Reserve Only

    None

    Modify

    None

    Rule Condition

    Not used

    Resultado

    Requisição original: http://example.com/index.html?code1=1&code2=2&code3=3

    Requisição de retorno à origem reescrita: http://example.com/index.html

  • Exemplo 2: Manter um parâmetro específico

    Parâmetro

    Valor

    Ignore Parameters

    Disabled

    Add

    None

    Delete

    None

    Reserve Only

    code2

    Modify

    None

    Rule Condition

    Not used

    Resultado

    Requisição original: http://example.com/index.html?code1=1&code2=2&code3=3

    Requisição de retorno à origem reescrita: http://example.com/index.html?code2=2

  • Exemplo 3: Adicionar, excluir e modificar parâmetros

    Parâmetro

    Valor

    Ignore Parameters

    Disabled

    Add

    code4=4

    Delete

    code2

    Reserve Only

    None

    Modify

    code3=0

    Rule Condition

    Not used

    Resultado

    Requisição original: http://example.com/index.html?code1=1&code2=2&code3=3

    Requisição de retorno à origem reescrita: http://example.com/index.html?code1=1&code3=0&code4=4