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 の概要」を参照してください。

Note

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

前提条件

gRPC API を追加する

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

  2. 左側のメニューで、[API]>[+ API の追加] を選択します。

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

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

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

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

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

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

    3. [ゲートウェイ] で、API の公開に使用するゲートウェイ リソースを選択します。

      重要

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

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

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

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

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

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

その他の API の追加

次のように、各種サービスで公開される API を構成できます。

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

次の手順に従って、既存の API に別の API を追加します。

Note

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

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

    Azure API Management インスタンスに移動する

  2. [概要] ページまたは左側のメニューから [API] を選択します。

    [API] を選択する

  3. 別の API を追加する API の隣の [...] をクリックします。

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

    [インポート] を選択する

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

    サービスを選択する