すべてのプロダクト
Search

このプロダクト

    API Gateway:ルートの作成

    ドキュメントセンター

    API Gateway:ルートの作成

    最終更新日:Jun 05, 2026

    Cloud-native API Gateway は、優先度の高いものから順にルーティングルールを評価します。リクエストがルールに一致した場合、ゲートウェイはそのリクエストを設定済みのバックエンドサービスに転送します。一致するルールがない場合、ゲートウェイは 404 エラーを返します。

    ルートのマッチング優先度

    複数のルーティングルールが存在する場合、優先度は次のようになります：[Associated Domain Name] > [Path] > [Header] > [Query Parameters] > [Created At]。

    1. [Associated Domain Name]：ドメイン文字列が長いほど、優先度が高くなります。

    2. [Path]：

      • [Match Rule]が異なる場合、優先度は [Equals To] > [Prefix] > [Regular Expression Match] の順になります。

      • [Match Rule]が同じ場合、[Path]の値が長いほど優先度が高くなります。

    3. [Header]：キーと値のペアが多いほど、優先度が高くなります。

    4. [Query Parameters]：キーと値のペアが多いほど、優先度が高くなります。

    5. [Created At]：作成日時が早いほど、優先度が高くなります。

    操作手順

    説明

    • ルートは、HTTP/1.0、HTTP/1.1、HTTP/2.0、gRPC、および WebSocket をサポートしています。

    • ルートのスコープは、作成されたインスタンスに限定されます。

    1. ゲートウェイインスタンスの外部または内部からルートを作成できます。

      インスタンスの外部

      1. Cloud-native API Gateway コンソールにログインします。左側のナビゲーションペインで [API] をクリックし、リージョンを選択します。

      2. 対象の API をクリックし、ドロップダウンリストから対象のインスタンスまたは All Instances を選択します。image

      3. Create Route をクリックします。

      インスタンスの内部

      1. Cloud-native API Gateway コンソールにログインします。左側のナビゲーションペインで Instance をクリックし、リージョンを選択します。

      2. Instance ページで、対象のゲートウェイインスタンス ID をクリックします。左側のナビゲーションペインで [API] をクリックし、対象の API をクリックします。

      3. Create Route をクリックします。

    2. Create Route ページでパラメーターを設定し、Save または Save and Publish をクリックします。

      説明

      • 一致条件は論理 AND を使用します。条件が多いほど、マッチングの範囲は狭くなります。

      • ルートの優先度は、設定ページの表示順に従います。

      パラメーター

      説明

      [Route Name]

      ルートの任意の名前です。

      [Route Description]

      Add Route Description をクリックして、ルートの説明を追加します。

      [Domain Name]

      • マッチングするドメインを 1 つ以上選択します。

      • ドメインを追加するには、[ドメインの追加] をクリックし、画面の指示に従います。

      [Path]

      マッチング対象のリクエストパスです。

      • 同じマッチルールの場合、パスが長いほど優先度が高くなります。

      • 異なるマッチルールの場合、優先度は [Equals To] > [Prefix] > [Regular Expression Match] の順になります。

        • [Equals To]：/user のように、パスに完全に一致します。

        • [Prefix]：/user で始まるパスのように、パスのプレフィックスに一致します。

        • [Regular Expression Match]：正規表現パターンに一致します。

      [Method]

      マッチング対象の HTTP メソッドです。複数のメソッドを選択できます。デフォルト：ANY。

      [Header]

      マッチング対象のリクエストヘッダーです。

      [Query Parameters]

      マッチング対象のクエリパラメーターです。

      [Instance]

      このルートが属するゲートウェイインスタンスです。

      [Scenario]

      ルートのバックエンドサービスのタイプです。

      • 基本シナリオ：Single Service

      • カナリアリリースシナリオ：By Percentage (Multi-service)、Tag (Tag-based Routing)

      • その他のシナリオ：[モック]、Redirect

      バックエンドサービスのタイプについては、「ルート」で説明されています。

      説明

      すべてのバックエンドサービスのトラフィックの重みの合計は 100% にする必要があります。

      [Backend Services]

      このルートがリクエストを転送するバックエンドサービスとポートです。

      説明

      • Associated Service をクリックして、ソースとサービスを選択します。

      • ソースの最大数は、ソースタイプによって異なります。

        • Container Service：最大 5 ソース。

        • Nacos および Zookeeper：1 ソースのみ。

      [Timeout Period (seconds)]

      リクエストのタイムアウト期間 (秒) です。デフォルト：60。タイムアウトを無効にするには 0 に設定します。

      フォールバック

      プライマリバックエンドに利用可能なノードがない場合にリクエストを受信するサービスです。

      説明

      フォールバックは HTTP サービスでのみサポートされています。

      [Retry Times]

      リトライ回数です。デフォルト：2。リトライを無効にするには 0 に設定します。

      [Retry Condition]

      リトライをトリガーする条件です。

      [Retry Status Code]

      リトライをトリガーするステータスコードです。