次の方法で共有

gRPC API をインポートする

適用対象: Developer | Premium

この記事では、gRPC サービス定義を API として API Management にインポートする方法について説明します。 その後、API Management で API を管理し、アクセスをセキュリティで保護して他のポリシーを適用し、ゲートウェイ経由で gRPC API 要求を gRPC バックエンドに渡すことができます。

gRPC API を API Management に追加するには、次の操作が必要です。

  • API の protobuf (プロトコル バッファー) 定義ファイルを API Management にアップロードします。
  • gRPC サービスの場所を指定します。
  • API Management で API を構成します。

API Management では、単項、サーバー ストリーミング、クライアント ストリーミング、双方向ストリーミングの gRPC サービス メソッドの種類を使用したパススルーがサポートされています。 gRPC の詳細については、「 gRPC の概要」を参照してください。

注

  • 現在、gRPC API はセルフホステッド ゲートウェイでのみサポートされており、API Management インスタンスのマネージド ゲートウェイではサポートされていません。
  • 現在、gRPC API のテストは、Azure portal のテスト コンソールまたは API Management 開発者ポータルではサポートされていません。
  • インポートは、1 つの protobuf (.proto) ファイルに制限されます。

前提条件

gRPC API を追加する

  1. Azure portal で、API Management インスタンスに移動します。

  2. サイド バー メニューの [API] で [API] を選びます。

  3. [新しい API の定義] で、[gRPC] を選択します。

    ポータルでの gRPC API 作成のスクリーンショット。

  4. [gRPC API ウィンドウの作成] で、[完全] を選択します。

  5. gRPC API について、次の設定を指定する必要があります。

    1. 表示名を入力します。

    2. [スキーマのアップロード] で、インポートする API に関連付けられているローカルの .proto ファイルを選択します。

    3. gRPC サーバー URL には、gRPC サービスのアドレスを入力します。 このアドレスは、HTTPS 経由でアクセスできる必要があります。

    4. ゲートウェイの場合は、API を公開するために使用するゲートウェイ リソースを選択します。

      重要

      パブリック プレビューでは、セルフホステッド ゲートウェイのみを選択できます。 マネージド ゲートウェイはサポートされていません。

  6. 残りの設定を入力して API を構成します。 これらの設定については、「チュートリアル: 最初の API のインポートと発行」で説明されています。

  7. ［作成］を選択します

    API が [API] の一覧に追加されます。 API の [設定] タブに移動すると、設定の更新を表示できます。

.NET を使用して gRPC サービスを呼び出す

.NET を使用した gRPC サービスの呼び出しについては、次の記事を参照してください。

その他の API の追加

次のようなさまざまなサービスによって公開された API の中から任意の API を構成できます。

  • OpenAPI の仕様
  • SOAP API
  • GraphQL API
  • Azure App Service でホストされる Web アプリ
  • Azure Functions
  • Azure Logic Apps
  • Azure Service Fabric

注

API をインポートすると、操作が現在の API に追加されます。

既存の API に API を追加するには:

  1. Azure portal で Azure API Management インスタンスに移動します。

    [API Management サービス] ページを示すスクリーンショット。

  2. [概要] ページで [API] を選択するか、左側のメニューで [API]>[API] の順に選択します。

    [概要] ページでの [API] の選択を示すスクリーンショット。

  3. 別の API を追加する API の横にある省略記号 (...) を選択します。

  4. ドロップダウン メニューから [インポート] を選択します。

    [インポート] コマンドを示すスクリーンショット。

  5. API のインポート元のサービスを選択します。

関連コンテンツ

  • Last updated on