Cloud Functions API 遷移指南

Cloud Functions v1beta2 API 已淘汰。為了避免可能的服務中斷情形,請改用 Cloud Functions v1 API。本頁說明如何從 Cloud Functions v1beta2 API 遷移至 Cloud Functions v1 API。

Cloud SDK

使用 gcloud 指令列工具的客戶應在終端機中發出以下指令,以升級至最新的 版本:

gcloud beta components update

詳情請參閱 gcloud components update 參考資料。

Firebase CLI

使用 Firebase CLI 的客戶應升級至最新的 CLI 版本。詳情請參閱 Firebase CLI 參考資料

API

透過 Google API 用戶端程式庫直接使用 API 的客戶應使用以 Cloud Functions v1 API 為基礎的程式庫:

v1 API 與 v1beta2 API 之間的差異非常小。下方列出了所有差異。

v1 API 新增了 v1beta2 API 中沒有的兩個欄位。

v1 API 欄位 說明
CloudFunction.description 讓您可設定使用者容易理解的 Cloud 函式說明。
CloudFunction.source_repository.deployed_url 讓您可在部署時查看原始碼存放區的網址。這個欄位會參照特定修訂版本 ID,即使部署是透過分支版本或標記發生也是如此。

有四個欄位的名稱在 v1 API 中有所改變。

v1beta2 API 欄位 v1 API 欄位
CloudFunction.source_repository_url CloudFunction.source_repository.url
CloudFunction.service_account CloudFunction.service_account_email
ListFunctions.location ListFunctions.parent
EventTrigger.retry_policy EventTrigger.failure_policy

CloudFunction.last_operation 已遭移除。建議您使用 Operations 服務來尋找對特定函式執行的最新作業。

更新函式的語意已從 PUT 變更為 PATCH。更新要求 (UpdateFunctionRequest) 採用兩個參數,分別是 Cloud 函式與更新遮罩。

v1beta2 API 是採用函式名稱做為輸入,v1 API 則是採用 CloudFunction 執行個體。更新遮罩包含要更新的所有欄位清單。函式名稱會從 CloudFunction 執行個體中擷取出來,您不必再明確提供。

您可以使用 APIs Explorer 試用新 API。

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Functions Documentation