Descrição geral do Encaminhamento Baseado em Caminhos de URL

O Roteamento Baseado em Caminho de URL permite rotear o tráfego para pools de servidores de back-end com base nos Caminhos de URL da solicitação.

Um dos cenários consiste em encaminhar pedidos de diferentes tipos de conteúdo para diversos agrupamentos de servidores de back-end.

No exemplo a seguir, o Application Gateway está servindo tráfego para contoso.com de três pools de servidores back-end, por exemplo: VideoServerPool, ImageServerPool e DefaultServerPool.

Os pedidos para http://contoso.com/video/* são encaminhados para VideoServerPool e os pedidos para http://contoso.com/images/* são encaminhados para ImageServerPool. O DefaultServerPool é selecionado se nenhum dos padrões de caminho corresponder.

Nota

Quando a solicitação é roteada, o caminho de URL completo é enviado para o pool de back-end. Se os recursos solicitados estiverem em um caminho diferente (por exemplo, se uma solicitação para http://contoso.com/video/* exigir que os vídeos sejam servidos a partir da raiz do site por trás do VideoServerPool), você também precisará configurar uma Regra de Reconfiguração de URL ou substituir o caminho de back-end em suas configurações de back-end.

Importante

Para as SKUs v1 e v2, as regras são processadas na ordem em que são listadas no portal. A prática recomendada ao criar regras de caminho é ter o caminho menos específico (aqueles com curingas) no final. Se os curingas estiverem no topo, eles terão prioridade, mesmo que haja uma correspondência mais específica nas regras de caminho subsequentes.

Se um ouvinte básico for o primeiro e corresponder a um pedido de entrada, o pedido é processado por esse ouvinte. No entanto, é altamente recomendável configurar ouvintes multissite antes de configurar um ouvinte básico. Desta forma, assegura que o tráfego é encaminhado para o back-end correto.

Elemento de configuração UrlPathMap

O elemento urlPathMap é usado para especificar padrões Path para mapeamentos de pool de servidores back-end. O seguinte exemplo de código é o fragmento do elemento UrlPathMap do ficheiro de modelo.

"urlPathMaps": [{
    "name": "{urlpathMapName}",
    "id": "/subscriptions/{subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/urlPathMaps/{urlpathMapName}",
    "properties": {
        "defaultBackendAddressPool": {
            "id": "/subscriptions/    {subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/backendAddressPools/{poolName1}"
        },
        "defaultBackendHttpSettings": {
            "id": "/subscriptions/{subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/backendHttpSettingsCollection/{settingname1}"
        },
        "pathRules": [{
            "name": "{pathRuleName}",
            "properties": {
                "paths": [
                    "{pathPattern}"
                ],
                "backendAddressPool": {
                    "id": "/subscriptions/{subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/backendAddressPools/{poolName2}"
                },
                "backendHttpsettings": {
                    "id": "/subscriptions/{subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/backendHttpSettingsCollection/{settingName2}"
                }
            }
        }]
    }
}]

PadrãoDeCaminho

PathPattern é uma lista de padrões de caminho a que se deve corresponder. Cada caminho deve começar com / e pode usar * como um caractere curinga. A string fornecida para o matcher de caminho não inclui nenhum texto após o primeiro ? ou #, e esses caracteres não são permitidos aqui. Caso contrário, quaisquer caracteres permitidos em uma URL são permitidos em PathPattern.

As regras de caminho são insensíveis a maiúsculas e minúsculas.

Padrão de caminho	Está suporte disponível?
/images/*	sim
/images*	sim
/images/*.jpg	não
/*.jpg	não
/Repos/*/Comments/*	não
/CurrentUser/Comments/*	sim

As regras de percurso são processadas por ordem, com base na forma como estão listadas no portal. O caminho menos específico (com caracteres universais) deve estar no final da lista, para que seja processado por último. Se as regras coringa estiverem presentes no topo da lista, elas terão prioridade e serão processadas primeiro. Consulte os seguintes cenários de exemplo.

Exemplos

Processamento de regras baseado em caminho quando caracteres universais (*) são utilizados.

Exemplo 1:

/master-dev* to contoso.com

/master-dev/api-core/ to fabrikam.com

/master-dev/* to microsoft.com

Como o caminho curinga /master-dev* está presente acima de caminhos mais granulares, todas as solicitações de cliente que contêm /master-dev são roteadas para contoso.com, inclusive as específicas /master-dev/api-core/. Para garantir que as solicitações do cliente sejam roteadas para os caminhos apropriados, é fundamental ter os caminhos granulares acima dos caminhos curinga.

Exemplo 2:

/ (default) to contoso.com

/master-dev/api-core/ to fabrikam.com

/master-dev/api to bing.com

/master-dev/* to microsoft.com

Todas as solicitações de cliente com o padrão /master-dev/* de caminho são processadas na ordem listada. Se não houver correspondência nas regras de caminho, a solicitação será roteada para o destino padrão.

Para obter mais informações, consulte Modelo do Gerenciador de Recursos usando roteamento baseado em URL.

Regra de Roteamento Baseado em Caminho

A RequestRoutingRule do tipo PathBasedRouting é utilizada para vincular um ouvinte a um urlPathMap. Todos os pedidos que são recebidos para este serviço de escuta são encaminhados com base na política especificada no urlPathMap. Fragmento da regra PathBasedRouting:

"requestRoutingRules": [
    {

"name": "{ruleName}",
"id": "/subscriptions/{subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/requestRoutingRules/{ruleName}",
"properties": {
    "ruleType": "PathBasedRouting",
    "httpListener": {
        "id": "/subscriptions/{subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/httpListeners/<listenerName>"
    },
    "urlPathMap": {
        "id": "/subscriptions/{subscriptionId}/../microsoft.network/applicationGateways/{gatewayName}/urlPathMaps/{urlpathMapName}"
    }

}
    }
]

Próximos passos

Depois de saber mais sobre o encaminhamento de conteúdo baseado em URL, aceda a Criar um gateway de aplicação com encaminhamento baseado em URL para criar um gateway de aplicação com regras de encaminhamento do URL.