使用 Azure Functions 的無伺服器 REST API
Azure Functions 是您用來建置無伺服器 REST 型 API 的基本計算服務。 HTTP 觸發程序會公開用戶端可以呼叫的 REST 端點,例如瀏覽器、行動應用程式和其他後端服務。 透過路由的原生支援,單一 HTTP 觸發的函式可以公開高效能的 REST API。 函式也會提供其自己的基本金鑰型授權配置,以協助限制僅存取特定的用戶端。 如需詳細資訊,請參閱 Azure Functions HTTP 觸發程序
在某些情況下,您可能需要 API 來支援一組更複雜的 REST 行為。 例如,您可能需要將多個 HTTP 函式端點結合成單一 API。 您也需要將要求傳遞至一或多個後端 REST 型服務。 最後,您的 API 可能需要更高程度的安全性,讓您透過使用來獲利。
目前,根據函式建置更複雜且健全 API 的建議方法是使用 Azure API 管理所提供的全方位 API 服務。 API 管理會使用以原則為基礎的模型,讓您控制路由、安全性和 OpenAPI 整合。 其也支援進階原則,例如速率限制創造營收。 舊版 Functions 執行階段使用舊版的 Functions Proxy 功能。
重要
Azure Functions Proxy 是 Azure Functions 執行階段 1.x 版到 3.x 版的舊版功能。 可以在 4.x 版中重新啟用對 Proxy 的支援,以便您成功將函數應用程式升級至最新的執行階段版本。 您應儘快切換為將函數應用程式與 Azure API 管理整合。 APIM 可讓您利用一組更完整的功能,來定義、保護、管理以 Functions 為基礎的 API 並從中獲利。 如需詳細資訊,請參閱 API 管理整合。
若要了解如何在 Functions 4.x 版中重新啟用 Proxy 支援,請參閱在 Functions 第 4.x 版中重新啟用 Proxy。
從 Functions Proxy 移至 API 管理
從 Functions Proxy 移至使用 API 管理時,您必須將函數應用程式與 API 管理執行個體整合,然後將 API 管理執行個體設定為像先前的 Proxy 一樣。 下一節提供相關文章的連結,可協助您成功搭配使用 API 管理與 Azure Functions。
如果您難以移動 Proxy,或如果 Azure APIM 無法處理特定情節,請在 APIM 意見反應論壇中張貼要求。
API 管理整合
API 管理可讓您匯入現有的函數應用程式。 匯入之後,每個 HTTP 觸發的函式端點都會變成可供您修改及管理的 API。 匯入之後,您也可以使用 API 管理為您的 API 產生 OpenAPI 定義檔。 在匯入期間,會忽略具有admin
授權層級的任何端點。 如需使用 Functions 進行 API 管理的詳細資訊,請參閱下列文章:
文章 | 描述 |
---|---|
使用 Azure APIM 從 HTTP 端點公開無伺服器 API | 示範如何從 Azure 入口網站中的現有函數應用程式建立新的 API 管理執行個體。 支援所有語言。 |
使用 Azure Functions 和 API 管理整合在 Visual Studio 中建立無伺服器 API | 示範如何利用 Visual Studio 建立使用 OpenAPI 擴充功能的 C# 專案。 OpenAPI 擴充功能可讓您直接將屬性套用至 C# 程式碼,藉此定義您的 .NET API。 |
快速入門:使用 Azure 入口網站建立新的 Azure APIM 服務執行個體 | 在入口網站中建立新的 API 管理執行個體。 建立 API 管理執行個體之後,您可以將其連線到函數應用程式。 支援其他非入口網站建立方法。 |
在 Azure API 管理中匯入 Azure 函式應用程式作為 API | 示範如何匯入現有的函數應用程式,以將現有的 HTTP 觸發程序端點公開為受控 API。 本文支援建立新的 API,以及將端點新增至現有的受控 API。 |
使用 API 管理公開函數應用程式端點之後,下列文章提供關於如何在 API 管理執行個體中管理函式型 API 的一般資訊。
文章 | 描述 |
---|---|
編輯 API | 示範如何使用裝載於 API 管理的現有 API。 |
Azure API 管理中的原則 \(部分機器翻譯\) | 在 API 管理中,發行者可以使用原則透過設定來變更 API 行為。 原則是陳述式的集合,會因 API 的要求或回應循序執行。 |
API 管理原則參考 | 詳述所有支援 API 管理原則的參考。 |
API 管理原則範例 | 在主要案例中使用 API 管理原則的實用範例集合。 |
舊版 Functions Proxy
舊版 Functions Proxy 功能也提供一組 3.x 版和舊版 Functions 執行階段的基本 API 功能。
重要
Azure Functions Proxy 是 Azure Functions 執行階段 1.x 版到 3.x 版的舊版功能。 可以在 4.x 版中重新啟用對 Proxy 的支援,以便您成功將函數應用程式升級至最新的執行階段版本。 您應儘快切換為將函數應用程式與 Azure API 管理整合。 APIM 可讓您利用一組更完整的功能,來定義、保護、管理以 Functions 為基礎的 API 並從中獲利。 如需詳細資訊,請參閱 API 管理整合。
若要了解如何在 Functions 4.x 版中重新啟用 Proxy 支援,請參閱在 Functions 第 4.x 版中重新啟用 Proxy。
有關如何使用 API 管理執行對等工作的一些基本提示已新增至 Functions Proxy 一文。 我們目前沒有文件或工具可協助您將現有的 Functions Proxy 實作遷移至 API 管理。