クラウドネイティブ API ゲートウェイがリクエストを受信すると、そのリクエストをルーティングルールと照合しようとします。ゲートウェイは、優先度の降順でルールをチェックします。ルールが一致すると、ゲートウェイはそのルールで定義されたバックエンドサービスにリクエストを転送します。一致するルールがない場合、ゲートウェイは 404 エラーを返します。
ルーティングの一致優先度
複数のルーティングルールが存在する場合、[関連ドメイン] > [パス] > [ヘッダー] > [クエリ] > [作成時間] の順で優先順位が付けられます。詳細なルールは次のとおりです。
[関連ドメイン]: ドメイン名の文字列が長いほど、優先度が高くなります。
[パス]:
[一致ルール] が異なる場合、優先順位は [完全一致] > [プレフィックス] > [正規表現] の順になります。
[一致ルール] が同じ場合: [パス] の文字列が長いほど、優先度が高くなります。
[ヘッダー]: キーと値のペアが多いほど、優先度が高くなります。
[クエリ]: キーと値のペアが多いほど、優先度が高くなります。
[作成時間]: 作成時間が早いほど、優先度が高くなります。
手順
クラウドネイティブ API ゲートウェイのルートは、インスタンスの外部から、またはインスタンスの内部から、2 つの方法で作成できます。
インスタンスの外部から
クラウドネイティブ API ゲートウェイコンソールにログインします。左側のナビゲーションウィンドウで、[API] を選択します。トップメニューバーで、リージョンを選択します。
ターゲット API をクリックします。ドロップダウンリストから、ターゲットインスタンスまたは [すべてのインスタンス] を選択します。
[ルートの作成] をクリックします。
インスタンスの内部から
クラウドネイティブ API ゲートウェイコンソールにログインします。左側のナビゲーションウィンドウで、[インスタンス] を選択します。トップメニューバーで、リージョンを選択します。
[インスタンス] ページで、ターゲットゲートウェイインスタンスの ID をクリックします。左側のナビゲーションウィンドウで [API] を選択し、ターゲット API をクリックします。
[ルートの作成] をクリックします。
[ルートの作成] ページでパラメーターを設定し、[保存] または [保存して公開] をクリックします。
説明一致ルールは論理 AND で結合されます。追加するルールが多いほど、一致範囲は狭くなります。
ルートの一致優先度は、ルート設定ページに表示される順序に対応します。
設定項目
説明
[ルート名]
ルートのカスタム名を入力します。
[ルートの説明]
[ルートの説明を追加] をクリックし、ルートの説明を入力します。
[ドメイン名]
ルートが一致するドメイン名を 1 つ以上選択します。
新しいドメイン名を作成するには、[ドメイン名の追加] をクリックしてパネルで作成します。
[パス]
HTTP リクエストで一致させる Path パラメーターを設定します。
一致ルールが同じ場合、Path が長いほど優先度が高くなります。
一致ルールが異なる場合、優先順位は [完全一致] > [プレフィックス] > Regular Expression Match となります。
[完全一致]: 完全一致。たとえば、パスは正確に
/userです。[プレフィックス]: プレフィックスに基づいて一致します。たとえば、パスは
/userで始まります。正規表現: 正規表現に基づいて一致します。
[メソッド]
HTTP リクエストで一致させる Method パラメーターを設定します。複数の HTTP メソッドを選択できます。デフォルト値は ANY です。
[ヘッダー]
HTTP リクエストで一致させる Header パラメーターを設定します。一致ルールが同じ場合、パラメーターの数が多いほど優先度が高くなります。
[クエリ]
HTTP リクエストで一致させる Query パラメーターを設定します。一致ルールが同じ場合、パラメーターの数が多いほど優先度が高くなります。
[インスタンス]
ルートが有効になるクラウドネイティブ API ゲートウェイインスタンスを選択します。
[シナリオ]
現在のルートのターゲットサービスタイプを選択します。
基本シナリオ: [単一サービス]
グレースケールリリースシナリオ: [重み付け (マルチサービス)]、[タグ別 (タグベースのルーティング)]
その他のシナリオ: [Mock]、[リダイレクト]
さまざまなタイプのターゲットサービスの詳細については、「ルーティング」をご参照ください。
説明すべてのターゲットサービスのトラフィックの重みの合計は 100% である必要があります。
[バックエンドサービス]
関連付けられたバックエンドサービスとポートを選択します。
説明[サービスの関連付け] をクリックして、パネルでソースとサービスを選択できます。
ソースの種類によって、追加できるソースの数に制限があります。
Container Service: 最大 5 つのソース。
Nacos と Zookeeper: ソースは 1 つのみ。
[タイムアウト (秒)]
タイムアウト期間を入力します。デフォルト値は 60 秒です。値 0 はタイムアウトなしを意味します。
[フォールバック]
フォールバックサービスを設定します。特定のサービスを選択する必要があります。ルートが指すバックエンドサービスにアクティブなノードがない場合、元のリクエストは指定されたフォールバックサービスに送信されます。
説明現在、フォールバック機能は HTTP サービス間でのみサポートされています。
[リトライ]
リトライ回数を入力します。デフォルト値は 2 です。値 0 はリトライを無効にします。
[リトライ条件]
リトライ条件を選択します。
[リトライステータスコード]
リトライをトリガーするステータスコードを 1 つ以上追加します。