Method: projects.locations.services.restore

从备份恢复服务。

HTTP 请求

POST https://metastore.googleapis.com/v1/{service}:restore

路径参数

参数
service

string

必需。要运行恢复操作的 Metastore 服务的相对资源名称,格式如下:

projects/{projectId}/locations/{locationId}/services/{serviceId}

必须对指定的资源 service 具有以下 IAM 权限才能进行授权:

  • metastore.services.restore

请求正文

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

JSON 表示法
{
  "backup": string,
  "backupLocation": string,
  "restoreType": enum (RestoreType),
  "requestId": string
}
字段
backup

string

可选。要从中恢复的 Metastore 服务备份的相对资源名称,格式如下:

projects/{projectId}/locations/{locationId}/services/{serviceId}/backups/{backupId}。与 backupLocation 相互排斥,并且必须设置这两者中的一个。

必须对指定的资源 backup 具有以下 IAM 权限才能进行授权:

  • metastore.backups.use
backupLocation

string

可选。一个 Cloud Storage URI,用于指定备份工件的位置,即“avro/”下的备份 avro 文件、backup_metastore.json 和 service.json,格式如下:

gs://<path_to_backup>。与 backup 相互排斥,并且必须设置这两者中的一个。

restoreType

enum (RestoreType)

可选。恢复类型。如果未指定,则默认为 METADATA_ONLY

requestId

string

可选。请求 ID。您可以指定一个唯一的请求 ID,以允许服务器在请求完成后忽略该请求。在第一次请求后的至少 60 分钟内,服务器会忽略提供重复请求 ID 的后续请求。

例如,如果初始请求超时,紧随其后又发出了一个具有相同请求 ID 的请求,服务器会忽略第二个请求,以防止创建重复的提交。

请求 ID 必须是有效的 UUID。不支持全部由零组成的 UUID(即 00000000-0000-0000-0000-000000000000)。

响应正文

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

授权范围

需要以下 OAuth 范围:

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

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