Method: projects.locations.instances.backup

備份執行個體。如果這是第一次建立備份，系統會在後端建立備份集合，而備份會屬於這個集合。集合和備份都會有資源名稱。系統會為每個分割區執行備份作業。系統會選取副本 (如果非 HA 則為主要副本) 執行作業。如果有正在進行的備份或更新作業，備份呼叫會遭到拒絕。請注意，在預覽期間，如果執行個體的內部軟體版本過舊，系統會在實際備份前執行重要更新。內部軟體版本更新至備份功能所需的最低版本後，後續備份作業就不需要進行重大更新。預先體驗結束後，備份功能就不會再有重大更新。

HTTP 要求

POST https://memorystore.googleapis.com/v1/{name=projects/*/locations/*/instances/*}:backup

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
name

string

這是必要旗標，執行個體資源名稱，格式為：projects/{projectId}/locations/{locationId}/instances/{instanceId}，其中 locationId 是指 Google Cloud 地區。

要求主體

要求主體包含下列結構的資料：

JSON 表示法 
{
  "ttl": string,
  "backupId": string
}
欄位
ttl

string (Duration format)

(非必要) 備份的存留期限。值的範圍為 1 天到 100 年。如未指定，則預設值為 100 年。

以秒為單位的時間長度，最多可有 9 個小數位數，結尾為「s」，例如："3.5s"。
backupId

string

(非必要) 要建立的備份 ID。如未指定，系統會使用預設值 ([YYYYMMDDHHMMSS]_[Shortened Instance UID])。

回應主體

如果成功，回應主體會包含 Operation 的執行個體。

授權範圍

需要下列 OAuth 範圍：

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

IAM 權限

需要在 name 資源上具備下列 IAM 權限：

  • memorystore.instances.backup

詳情請參閱 身分與存取權管理說明文件。