Cloud Functions API 遷移指南

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

Cloud SDK

使用 gcloud 指令列工具的客戶應透過在終端機中發出下列指令來升級至最新的 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