Method: projects.locations.instances.backup

• HTTP 要求
• 路徑參數
• 要求主體
  • JSON 表示法
• 回應主體
• 授權範圍
• IAM 權限

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

HTTP 要求

選擇端點：

全球 africa-south1 asia-east1 asia-east2 asia-northeast1 asia-northeast2 asia-northeast3 asia-south1 asia-south2 asia-southeast1 asia-southeast2 asia-southeast3 australia-southeast1 australia-southeast2 europe-central2 europe-north1 europe-north2 europe-southwest1 europe-west1 europe-west10 europe-west12 europe-west15 europe-west2 europe-west3 europe-west4 europe-west6 europe-west8 europe-west9 me-central1 me-central2 me-west1 northamerica-northeast1 northamerica-northeast2 northamerica-south1 southamerica-east1 southamerica-west1 us-central1 us-central2 us-east1 us-east4 us-east5 us-east7 us-south1 us-west1 us-west2 us-west3 us-west4 us-west8

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
• https://www.googleapis.com/auth/memorystore.read-write

IAM 權限

需要 name 資源的下列 IAM 權限：

• memorystore.instances.backup

詳情請參閱 IAM 說明文件。