Method: projects.locations.services.restore

從備份還原服務。

HTTP 要求

POST https://metastore.googleapis.com/v1beta/{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

詳情請參閱驗證總覽一文。