Todos os produtos
Search
Central de documentação

CDN:Reescrita de parâmetros

Última atualização: Jul 03, 2026

Se os parâmetros da URL da solicitação original diferirem dos exigidos pelo servidor de origem, use o recurso Parameter Rewrite para reescrevê-los na URL da solicitação de busca na origem. Esse recurso permite adicionar, excluir, reservar, modificar ou ignorar parâmetros.

Formato dos 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 # seguido de texto. O caractere # direciona o navegador para um local específico na 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 várias operações de reescrita para os parâmetros de consulta na URL da solicitação de busca na origem. A ordem de prioridade é Add > Delete > Reserve Only > Modify. Quando diferentes operações têm como alvo o mesmo parâmetro, apenas a de maior prioridade entra em vigor.

  • Se Ignore Parameters estiver ativado, apenas a operação Add também terá efeito.

Conflitos com outros recursos

O recurso Parameter Rewrite pode entrar em conflito com a regra enhance break do recurso Rewrite Origin Fetch URL e com o recurso Ignore Parameters. Em caso de conflito, prevalece o último recurso configurado.

Impacto na chave de cache

  • O recurso Parameter Rewrite executa no POP de busca na origem. Ele não afeta o roteamento interno da CDN nem reescreve a chave de cache.

  • O recurso Ignore Parameters executa no nó de borda. Ele afeta o roteamento interno da CDN e reescreve a chave de cache.

Importante

Se uma configuração usar 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 Gerencie 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.

    Configure as operações de reescrita conforme necessário. Adicione vários parâmetros na caixa de texto de cada tipo de operação. Para mais informações, consulte Exemplos de configuração.

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

    Para modificar regras existentes, clique em Modifique na página Parameter Rewrite.

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

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

    Solicitação de busca na 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

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

    Solicitação de busca na 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

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

    Solicitação de busca na origem reescrita: http://example.com/index.html?code1=1&code3=0&code4=4