備份 Redis 叢集。如果這是第一次建立備份,系統會在後端建立備份集合,而這個備份項目會屬於這個集合。集合和備份都會有資源名稱。系統會為每個分片執行備份作業。系統會選取副本 (如果不是高可用性,則為主要副本) 執行作業。如果正在進行備份或更新作業,系統會拒絕備份呼叫。請注意,在預覽期間,如果叢集的內部軟體版本過舊,系統會在實際備份前執行重大更新。將內部軟體版本更新至備份功能所需的最低版本後,後續備份作業就不需要進行重大更新。預先體驗期結束後,備份功能就不需要重大更新。
HTTP 要求
POST https://redis.googleapis.com/v1beta1/{name=projects/*/locations/*/clusters/*}:backup
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
name |
這是必要旗標,Redis 叢集資源名稱,格式為: |
要求主體
要求主體包含下列結構的資料:
JSON 表示法 |
---|
{ "ttl": string, "backupId": string } |
欄位 | |
---|---|
ttl |
(選用步驟) 備份的存留時間。有效值的範圍為 1 天到 100 年,如未指定,預設值為 100 年。 時間長度以秒為單位,最多可有 9 個小數位數,並應以「 |
backupId |
(選用步驟) 要建立的備份 ID。如未指定,系統會使用預設值 ([YYYYMMDDHHMMSS]_[Shortened Cluster UID])。 |
回應主體
如果成功,回應主體會包含 Operation
的執行個體。
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/cloud-platform
詳情請參閱Authentication Overview。