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/valueanexados a uma URL após o caractere?, no formatoname=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#segmentaponta para o localsegmentna páginaindex.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.
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
Faça login no CDN console.
No painel de navegação à esquerda, clique em Domain Names.
Na página Domain Names, localize o nome de domínio desejado e clique em Manage na coluna Actions.
No painel de navegação à esquerda do nome de domínio, clique em Origin Fetch.
Clique na aba Parameter Rewrite.
Ative a opção Feature Switch.
-
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.
-
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=3Requisiçã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=3Requisiçã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=3Requisição de retorno à origem reescrita:
http://example.com/index.html?code1=1&code3=0&code4=4