Cloud Functions API 迁移指南

Cloud Functions v1beta2 API 现已弃用。为避免可能会出现的服务中断问题,请改用 Cloud Functions v1 API。本页面说明了如何从 Cloud Functions v1beta2 API 改用 Cloud Functions v1 API。

gcloud CLI

使用 Google Cloud CLI 的客户应升级到最新 gcloud 版本;如需执行此操作,请在终端中发出以下命令:

gcloud components update

有关详细信息,请参阅 gcloud 组件更新参考。

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 Functions 函数说明。
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 Functions 函数和更新掩码。

v1beta2 API 将函数的名称作为输入,而 v1 API 采用的是 CloudFunction 实例。更新掩码包含要更新的所有字段的列表。函数的名称将从 CloudFunction 实例中提取,无需再明确提供。

您可以使用 API Explorer 来试用新的 API。