共用方式為

匯入 gRPC API

適用於：開發人員 | 進階

本文將說明如何將 gRPC 服務以 API 的形式匯入 APIM。 然後，您可以在 API 管理 中管理 API、保護存取並套用其他原則，以及透過閘道將 gRPC API 要求傳遞至 gRPC 後端。

若要將 gRPC API 新增至 APIM，您需要：

  • 將 API 的 protobuf （通訊協定緩衝區） 定義檔案上傳至 API 管理。
  • 指定 gRPC 服務的位置。
  • 在 API 管理 中設定 API。

APIM 支援使用下列類型的 gRPC 服務方法進行傳遞：一元、伺服器串流、用戶端串流和雙向串流。 若要深入瞭解 gRPC，請參閱 gRPC 簡介。

附註

  • 目前，只有自我裝載閘道才支援 gRPC API，APIM 執行個體的受控閘道並不支援 gRPC API。
  • 目前，Azure 入口網站或 APIM 開發人員入口網站中的測試主控台不支援測試 gRPC API。
  • 匯入僅限於單一 protobuf （.proto） 檔案。

先決條件

新增 gRPC API

  1. 在 Azure 入口網站中，瀏覽至您的 API 管理執行個體。

  2. 在側邊欄功能表的 [API] 底下，選取 [API]。

  3. 在 [定義新的 API] 底下，選取 [gRPC]。

    在入口網站中建立 gRPC API 的螢幕擷取畫面。

  4. 在 [建立 gRPC API] 視窗中，選取 [完整]。

  5. 針對 gRPC API，您必須指定下列設定：

    1. 輸入顯示名稱。

    2. 針對 Upload schema，選擇本機的 .proto 檔案，該檔案需與要匯入的 API 相關聯。

    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 入口網站中移至您的 Azure API 管理實例：

    顯示 [API 管理服務] 頁面的螢幕快照。

  2. 在 [概觀] 頁面上選取 [API]，或選取左側功能表中的 [API]>[API]。

    顯示 [概觀] 頁面上 [API] 選取項目的螢幕快照。

  3. 在要附加至另一個 API 的 API 旁選取省略符號 (...)。

  4. 從下拉選單中選擇匯入：

    顯示 [匯入] 命令的螢幕快照。

  5. 選取要從中匯入 API 的服務。

相關內容

  • Last updated on