すべてのプロダクト
Search
ドキュメントセンター

API Gateway:サービス

最終更新日:Jun 03, 2026

クラウドネイティブ API Gateway のサービスは、ゲートウェイがトラフィックをルーティングするバックエンドアップストリームを表します。各サービスは、Kubernetes ワークロード、Nacos に登録されたマイクロサービス、Function Compute 関数、固定 IP エンドポイントなど、実際のバックエンドにマッピングされます。ゲートウェイインスタンスがリクエストをルーティングする前に、少なくとも 1 つのサービスを追加し、ルートの宛先として登録する必要があります。

このトピックでは、サービスのライフサイクル全体 (サービスの作成、更新、カナリアリリース向けのサービスバージョンの管理、トラフィックルールの設定、アクティブヘルスチェックの設定) について説明します。

サービスの作成

クラウドネイティブ API Gateway は、次のサービスソースをサポートしています:

  • Container Service for Kubernetes (ACK) クラスター

  • Microservices Engine (MSE) Nacos インスタンス

  • 固定エンドポイント (IP アドレスまたはホスト名)

  • Domain Name System (DNS) ドメイン名

  • Function Compute

ゲートウェイインスタンスにサービスを追加し、ルートの宛先として登録すると、ルートはそのサービスにトラフィックを転送できます。詳細については、「サービスの作成」をご参照ください。

サービスの管理

固定エンドポイントをバックエンドとするサービスの場合、バックエンドノードの IP アドレスまたはポートが変更されても、ゲートウェイは自動的に検出できません。固定エンドポイントのサービスは、動的なサービスディスカバリソースに登録されていないためです。バックエンドノードのエンドポイントが変更された場合は、サービス設定を手動で更新し、ゲートウェイが正しいアドレスにトラフィックをルーティングするようにしてください。詳細については、「サービスの管理」をご参照ください。

トラフィックルールの管理

トラフィックルールは、ゲートウェイインスタンスからバックエンドサービスへトラフィックを転送する方法を制御します。ルールには次の 2 種類があります:

  • 証明書による暗号化:TLS 証明書を設定し、ゲートウェイとバックエンド間のトラフィックを暗号化。

  • 負荷分散ポリシー:指定したアルゴリズムに基づいて、バックエンドノードにリクエストを分散。

詳細については、「トラフィックルールの管理」をご参照ください。

サービスのアクティブヘルスチェックの設定

アクティブヘルスチェックを使用すると、ゲートウェイは各バックエンドノードを定期的にプローブし、異常なノードを負荷分散プールから自動的に削除します。ノードが復旧すると、ゲートウェイは自動的に再追加します。これにより、複数レプリカのデプロイで稼働するサービスのルート可用性が向上します。

  • サービスのアクティブヘルスチェックを設定します。

  • ヘルスチェック失敗のトラブルシューティングを行います。

詳細については、「サービスのアクティブヘルスチェックの設定」をご参照ください。