URL パスベースのルーティングの概要

[アーティクル]
03/30/2023

URL パスベースのルーティングを使用すると、要求の URL パスに基づいてバックエンドサーバープールにトラフィックをルーティングできます。

1 つのシナリオとして、異なる種類のコンテンツの要求を、異なるバックエンドサーバープールにルーティングします。

次の例では、Application Gateway は 3 つのバックエンドサーバープール (VideoServerPool、ImageServerPool、DefaultServerPool など) からの contoso.com のトラフィックを処理します。

imageURLroute

http://contoso.com/video/* の要求は、VideoServerPool にルーティングされ、http://contoso.com/images/* は ImageServerPool にルーティングされます。一致するパスパターンがない場合は、DefaultServerPool が選択されます。

重要

v1、v2 どちらの SKU でも、ポータルに一覧表示される順番でルールを処理します。パスルールを作成するときは、最も限定的でないパス (ワイルドカードを含む) を最後に指定することをお勧めします。ワイルドカードが一番上にあると、後続のパスルールにより限定的な一致がある場合でも、ワイルドカードが優先されます。

基本リスナーが先に表示されていて、なおかつ受信要求と一致した場合、そのリスナーによって要求が処理されます。ただし、基本リスナーを構成する前に、まずマルチサイトリスナーを構成することを強くお勧めします。そうすることで、トラフィックが確実に適切なバックエンドにルーティングされます。

UrlPathMap 構成要素

urlPathMap 要素を使用すると、バックエンドサーバープールのマッピングにパスパターンを指定できます。次のコード例は、テンプレートファイルの urlPathMap 要素のスニペットです。

"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}"
                }
            }
        }]
    }
}]

PathPattern

PathPattern は照合するパスパターンの一覧です。各パスは / で始まる必要があります。ワイルドカード文字として * を使用できます。パス照合に提供する文字列には最初の ? または # の後にテキストを含めません (これらの文字は、ここでは許可されません)。それ以外の場合、URL で許可される文字はすべて PathPattern で許可されます。

パスルールでは大文字と小文字が区別されません。

パスのパターン	サポートされているか
`/images/*`	はい
`/images*`	はい
`/images/*.jpg`	no
`/*.jpg`	no
`/Repos//Comments/`	no
`/CurrentUser/Comments/*`	はい

パスルールは、ポータルでの一覧表示に基づいて順番に処理されます。最も具体性の低いパス (ワイルドカードを含む) は、最後に処理されるように、一覧の末尾に置く必要があります。一覧の先頭にワイルドカードルールが存在する場合は、それらが優先され、最初に処理されます。次のシナリオ例を参照してください。

例

ワイルドカード (*) が使用されている場合のパスベースのルール処理:

例 1:

/master-dev* to contoso.com

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

/master-dev/* to microsoft.com

ワイルドカードパス /master-dev* は、より詳細なパスの上に存在するため、/master-dev を含むすべてのクライアント要求は、特定の /master-dev/api-core/ を含む contoso.com にルーティングされます。クライアント要求が適切なパスにルーティングされるようにするには、ワイルドカードパスの上に詳細なパスを設定する必要があります。

例 2:

/ (default) to contoso.com

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

/master-dev/api to bing.com

/master-dev/* to microsoft.com

パスパターン /master-dev/* を使用するすべてのクライアント要求は、リストに示されている順番で処理されます。パスルール内で一致が検出されない場合、要求は既定のターゲットにルーティングされます。

詳細については、「URL ベースのルーティングを使用した Resource Manager テンプレート」をご覧ください。

PathBasedRouting ルール

タイプ PathBasedRouting の RequestRoutingRule は、リスナーを urlPathMap にバインドする際に使用します。このリスナーで受け取られるすべての要求は、urlPathMap に指定されたポリシーに基づいてルーティングされます。 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}"
    }

}
    }
]

次のステップ

URL ベースのコンテンツルーティングについて理解したら、 URL ベースのルーティングを使用した Application Gateway の作成に関するセクションに移動して、URL ルーティングルールを使ってアプリケーションゲートウェイを作成します。

URL パス ベースのルーティングの概要

UrlPathMap 構成要素

PathPattern

例

PathBasedRouting ルール

次のステップ

その他のリソース

URL パスベースのルーティングの概要