Method: projects.defaultLocation.finalize

为指定的 FirebaseProject 设置默认 Google Cloud Platform (GCP) 资源位置。

此方法会在指定的 locationId 中创建一个具有默认 Cloud Storage 存储分区的 App Engine 应用。此位置必须是可用的 GCP 资源位置之一。

默认 GCP 资源位置最终确定后或已设置后,便无法更改。指定 FirebaseProject 的默认 GCP 资源位置可能已经设置,因为底层 GCP Project 已有 App Engine 应用,或者 defaultLocation.finalize 之前已使用指定的 locationId 调用。使用其他指定的 locationIddefaultLocation.finalize 进行的任何新调用都将返回 409 错误。

此调用的结果是 Operation,可用于跟踪配置过程。Operationresponse 类型为 google.protobuf.Empty

可以使用 operations.get 通过其 name 轮询 Operation,直到 done 为 true 为止。当 done 为 true 时,Operation 要么成功,要么失败。如果 Operation 执行成功,其 response 将设置为 google.protobuf.Empty;如果 Operation 失败,其 error 将设置为 google.rpc.Status。完成后,系统会自动删除 Operation,因此无需调用 operations.delete

请求正文中列出的所有字段都是必填字段。

如需调用 defaultLocation.finalize,成员必须是项目所有者。

HTTP 请求

POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}/defaultLocation:finalize

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

要为之设置默认 GCP 资源位置的 FirebaseProject 的资源名称,格式如下:

projects/PROJECT_IDENTIFIER

请参阅 FirebaseProject name 字段,详细了解 PROJECT_IDENTIFIER 值。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "locationId": string
}
字段
locationId

string

项目的默认 GCP 资源位置的 ID。该位置必须是某个可用的 GCP 资源位置

响应正文

如果成功,则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围之一:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

如需了解详情,请参阅身份验证概览