共用方式為


使用 Azure API 管理從 HTTP 端點公開無伺服器 API

Azure Functions 與入口網站中的 Azure API 管理整合,可讓您將 HTTP 觸發程式函式端點公開為 REST API。 這些 API 是使用 OpenAPI 定義來描述。 此 JSON (或 YAML) 檔案包含 API 中有哪些作業可用的相關信息。 其中包含 API 要求和回應數據結構的詳細數據。 藉由整合函式應用程式,您可以讓 API 管理產生這些 OpenAPI 定義。

本文說明如何將函式應用程式與 API 管理整合。 此整合適用於以任何 支援的語言開發的函式應用程式。 您也可以 從 Azure API 管理匯入函式應用程式

針對 C# 類別庫函式,您也可以 使用 Visual Studio 來建立和發佈與 API 管理整合的無伺服器 API。

建立 API 管理實例

若要建立 API 管理實例並連接到您的功能應用程式:

  1. 選取函式應用程式,從左側功能表中選擇 [API 管理],然後選取 [API 管理] 下的 [新建]。

  2. 使用下表中指定的 API 管理設定:

    設定 建議的值 說明
    訂閱 您的訂用帳戶 創建此新資源所需的訂閱。
    資源群組 我的資源群組 與函式應用程式相同的資源,應該會為您設定。
    區域 服務的位置 請考慮選擇與函式應用程式相同的位置。
    資源名稱 全域唯一名稱 根據您的功能應用程式的名稱產生一個名稱。
    組織名稱 Contoso 開發人員入口網站和電子郵件通知中使用的組織名稱。
    系統管理員電子郵件 您的電子郵件 從 API 管理接收系統通知的電子郵件。
    定價層 消費 部分地區無法使用消費層。 如需完整的定價詳細數據,請參閱 API 管理定價頁面
  3. 選擇 [檢閱 + 建立 ],然後選擇 [ 建立 ] 以建立 API 管理實例,這可能需要幾分鐘的時間。

匯入函式

建立 API 管理實例之後,您可以匯入 HTTP 觸發的函式端點。 此範例會匯入名為 TurbineRepair 的端點。

  1. 在 [API 管理] 頁面中,選取 [ 連結 API]。

  2. Azure Functions 匯入後隨即開啟,並醒目提示 TurbineRepair 函式。 選擇 [選取 ] 繼續。

  3. 在 [ 從函式應用程式建立 ] 頁面中,接受預設值,然後選取 [ 建立]。 Azure 會建立函式的 API。

下載 OpenAPI 定義

匯入函式之後,您可以從 API 管理實例下載 OpenAPI 定義。

  1. 選取頁面頂端的 [下載 OpenAPI 定義 ]。

    下載 OpenAPI 定義

  2. 儲存下載的 JSON 檔案,然後開啟它。 查看定義。

後續步驟

您現在可以在入口網站中的 API 管理中精簡定義。 您也可以 深入瞭解 API 管理