Se a URL de requisição do usuário contiver parâmetros diferentes dos exigidos pelo servidor de origem, utilize o recurso de reescrita de parâmetros para modificar os parâmetros de consulta na requisição de origem. Esse recurso permite adicionar, excluir, modifique e reservar parâmetros específicos, ou ignorar todos os parâmetros.
Contexto
O recurso de reescrita de parâmetros modifica os parâmetros de consulta da URL de uma requisição de origem. É possível configure várias regras de reescrita. As regras são aplicadas na seguinte ordem de prioridade: Add > Delete > Ignore Parameters e Reserve Only > Modify. Se múltiplas regras tiverem como alvo o mesmo parâmetro, apenas a regra de maior prioridade será aplicada.
As opções Ignore Parameters e Reserve Only são mutuamente exclusivas. Não configure ambos os parâmetros simultaneamente.
Conflitos
O recurso de parameter rewrite pode entrar em conflito com a regra enhance break do recurso de reescrita de URI e com o recurso de filtragem de parâmetros. Evite criar configurações conflitantes. Caso ocorra um conflito, o último recurso configurado terá precedência.
O DCDN processa as regras de parameter rewrite no POP de origem. Isso não afeta o fluxo interno de requisições nem a chave de cache.
O DCDN processa as regras de parameter filtering no POP de borda. Isso afeta o fluxo interno de requisições e altera a chave de cache.
Procedimento
Faça login no console do DCDN.
No painel de navegação à esquerda, clique em Domain Names.
Na página Domain Names, localize o nome de domínio que deseja gerencie e clique em Configure na coluna Actions.
No painel de navegação à esquerda do domínio, clique em Origin Fetch.
Clique na aba Parameter Rewrite.
Na aba Parameter Rewrite, ative a opção Use Parameter Rewrite.
-
Configure suas regras de reescrita.
Defina as regras conforme as necessidades do seu negócio. Para mais detalhes, consulte Exemplos de configuração.
-
Clique em OK para aplicar a configuração.
Também é possível clique em Modify Configuration na página Parameter Rewrite para alterar regras existentes.
Nota: Se você utilizar este recurso como uma ação dentro do Rules Engine, a prioridade da regra defina no Rules Engine substituirá a prioridade de operação interna deste recurso.
Exemplos de configuração
-
Exemplo 1: Ignorar todos os parâmetros.
Parâmetro
Exemplo
Ignore Parameters
Enabled
Add
None
Delete
None
Reserve Only
None
Modify
None
Resultado esperado
Requisição original:
http://example.com/index.html?code1=1&code2=2&code3=3Requisição de origem reescrita:
http://example.com/index.html -
Exemplo 2: Reservar um parâmetro específico.
Parâmetro
Exemplo
Ignore Parameters
None
Add
None
Delete
None
Reserve Only
code2
Modify
None
Resultado esperado
Requisição original:
http://example.com/index.html?code1=1&code2=2&code3=3Requisição de origem reescrita:
http://example.com/index.html?code2=2 -
Exemplo 3: Adicionar, exclua e modifique parâmetros.
Parâmetro
Exemplo
Ignore Parameters
None
Add
code4=4
Delete
code2
Reserve Only
None
Modify
code3=0
Resultado esperado
Requisição original:
http://example.com/index.html?code1=1&code2=2&code3=3Requisição de origem reescrita:
http://example.com/index.html?code1=1&code3=0&code4=4