Reescrever URL
O Azure Front Door fornece suporte para regravação de URL, permitindo que você modifique o caminho da solicitação que está sendo roteado para sua origem. Esse poderoso recurso permite definir condições que determinam quando a URL ou os cabeçalhos especificados devem ser reescritos. Estas condições baseiam-se nas informações presentes no pedido e na resposta.
Ao usar a regravação de URL, você tem a capacidade de redirecionar seus usuários finais para diferentes origens com base em fatores como o tipo de dispositivo ou o tipo de arquivo solicitado. A ação de reconfiguração de URL pode ser facilmente configurada dentro do conjunto de regras, fornecendo controle refinado sobre seu comportamento de roteamento.
Padrão de origem
O padrão de origem representa o caminho da URL na solicitação inicial que você deseja substituir. Atualmente, o padrão de origem utiliza uma abordagem de correspondência baseada em prefixo. Para corresponder a todos os caminhos de URL, você pode especificar uma barra (/) como o valor para o padrão de origem.
No contexto de uma ação de reconfiguração de URL, somente o caminho após os padrões a serem correspondidos na configuração de rota é levado em consideração para o padrão de origem. Por exemplo, o conjunto de regras considera apenas /source-pattern como o padrão de origem a ser reescrito se você tiver um formato de URL de entrada de contoso.com/pattern-to-match/source-pattern. Depois que a reconfiguração de URL for aplicada, o formato de URL de saída será contoso.com/pattern-to-match/destination.
Nos casos em que você precisa remover o /pattern-to-match segmento da URL, você pode definir o caminho de origem para o grupo de origem na configuração de rota como /.
Destino
O caminho de destino representa o caminho que substitui o padrão de origem. Por exemplo, se o caminho da URL da solicitação for contoso.com/foo/1.jpg, e o padrão de origem for /foo/, especificar o destino como /bar/ resultado no conteúdo que está sendo servido a partir da contoso.com/bar/1.jpg origem.
Preservar caminho incomparável
Preservar caminho incomparável permite controlar como o caminho restante após o padrão de origem é manipulado. Ao definir preservar caminho incomparável como Sim, o caminho restante é anexado ao novo caminho. Por outro lado, defini-lo como Não (padrão) removerá o caminho restante após o padrão de origem.
Aqui está um exemplo mostrando o comportamento de preservar caminho incomparável:
| Preservar caminho incomparável | Padrão de origem | Destino | Pedido recebido | Conteúdo veiculado desde a origem |
|---|---|---|---|---|
| Sim | / | /foo/ | contoso.com/sub/1.jpg | /foo/sub/1.jpg |
| Sim | /sub/ | /foo/ | contoso.com/sub/image/1.jpg | /foo/imagem/1.jpg |
| Não | /sub/ | /foo/2.jpg | contoso.com/sub/image/1.jpg | /foo/2.jpg |
Importante
O Azure Front Door (clássico) será desativado em 31 de março de 2027. Para evitar qualquer interrupção do serviço, é importante migrar seus perfis do Azure Front Door (clássico) para a camada Azure Front Door Standard ou Premium até março de 2027. Para obter mais informações, consulte Aposentadoria (clássica) do Azure Front Door.
O Azure Front Door (clássico) fornece suporte para reconfiguração de URL configurando um caminho de encaminhamento personalizado ao configurar a regra de tipo de roteamento de encaminhamento. Por padrão, se apenas uma barra (/*) for definida, o Front Door replicará o caminho da URL de entrada na solicitação encaminhada. O cabeçalho do host usado na solicitação encaminhada é baseado na configuração do back-end selecionado. Para obter informações mais detalhadas, consulte a documentação do cabeçalho do host de back-end.
O principal aspeto da reescrita de URL reside na capacidade de copiar qualquer parte correspondente do caminho de entrada para o caminho encaminhado ao usar um caminho de encaminhamento personalizado com uma correspondência curinga. A tabela a seguir ilustra um exemplo de uma solicitação de entrada e o caminho encaminhado correspondente ao utilizar um caminho de encaminhamento personalizado de /fwd/. A seção indicada como a/b/c representa a parte que substitui a correspondência curinga.
| Caminho da URL de entrada | Caminho de correspondência | Caminho de encaminhamento personalizado | Caminho encaminhado |
|---|---|---|---|
| /foo/a/b/c | /foo/* | /fwd/ | /fwd/a/b/c |
Exemplo de reescrita de URL
Considere uma regra de roteamento com a seguinte combinação de hosts frontend e caminhos configurados:
| Anfitriões | Caminhos |
|---|---|
| www.contoso.com | /* |
| /foo | |
| /foo/* | |
| /foo/bar/* |
A tabela a seguir ilustra exemplos de solicitações de entrada e suas rotas correspondentes de correspondência mais específicas. Ele também fornece exemplos de caminhos de encaminhamento personalizados e os caminhos encaminhados resultantes.
Por exemplo, considere a segunda linha da tabela. Se a solicitação de entrada for www.contoso.com/sub, e o caminho de encaminhamento personalizado estiver definido como /, o caminho encaminhado será /sub. No entanto, se o caminho de encaminhamento personalizado estiver definido como /fwd/, o caminho encaminhado será /fwd/sub. As partes enfatizadas dos caminhos indicam as partes que fazem parte da correspondência curinga.
| Pedido recebido | Caminho de correspondência mais específico | / | /fwd/ | /foo/ | /foo/bar/ |
|---|---|---|---|---|---|
| www.contoso.com/ | /* | / | /fwd/ | /foo/ | /foo/bar/ |
| www.contoso.com/ sub | /* | /sub | /fwd/sub | /foo/sub | /foo/bar/sub |
| www.contoso.com/ a/b/c | /* | /a/gc | /fwd/a/b/c | /foo/a/b/c | /foo/bar/a/b/c |
| www.contoso.com/foo | /foo | / | /fwd/ | /foo/ | /foo/bar/ |
| www.contoso.com/foo/ | /foo/* | / | /fwd/ | /foo/ | /foo/bar/ |
| www.contoso.com/foo/ bar | /foo/* | /bar | /fwd/bar | /foo/bar | /foo/bar/bar |
Nota
O Azure Front Door (clássico) suporta apenas a reescrita de URL de um caminho estático para outro caminho estático. Preservar caminho incomparável é suportado com o Azure Front Door Standard e Premium. Para obter mais informações, consulte Preservar caminho incomparável.
Configurações opcionais
Configuração de cache - Se desabilitada ou não especificada, as solicitações que correspondem a essa regra de roteamento não tentam usar conteúdo armazenado em cache e, em vez disso, sempre buscam no back-end. Para obter mais informações, consulte Armazenamento em cache com o Azure Front Door.
Próximos passos
- Saiba como criar um perfil do Azure Front Door.
- Saiba mais sobre o conjunto de regras do Azure Front Door
- Saiba mais sobre a arquitetura de roteamento do Azure Front Door.