華為云計算 云知識 復制備份CopyBackup
復制備份CopyBackup

 

功能介紹

跨區(qū)域復制備份。

調試

您可以在API Explorer中調試該接口,支持自動認證鑒權。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調試功能。

URI

POST /v3/{project_id}/backups/{backup_id}/replicate

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

backup_id

String

復制的備份ID

project_id

String

項目ID

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調用 IAM 服務獲取用戶Token接口獲?。憫㈩^中X-Subject-Token的值)。

表3 請求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

replicate

BackupReplicateReqBody object

復制參數(shù)

表4 BackupReplicateReqBody

參數(shù)

是否必選

參數(shù)類型

描述

description

String

復制的描述

最小長度:0

最大長度:255

destination_project_id

String

復制的目標項目ID

destination_region

String

復制的目標區(qū)域

最小長度:0

最大長度:255

destination_vault_id

String

復制的目標區(qū)域的存儲庫ID

enable_acceleration

Boolean

跨區(qū)域復制時,是否啟用加速從而縮短復制的時間,如果不指定,默認不啟用加速。

缺省值:false

name

String

復制名稱

最小長度:1

最大長度:64

響應參數(shù)

狀態(tài)碼: 200

表5 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

replication

BackupReplicateRespBody object

復制返回參數(shù)

表6 BackupReplicateRespBody

參數(shù)

參數(shù)類型

描述

backup_id

String

待復制的備份ID

destination_project_id

String

復制的目標項目ID

destination_region

String

復制的目標區(qū)域

destination_vault_id

String

復制的目標區(qū)域存儲庫ID

project_id

String

執(zhí)行復制的項目ID

provider_id

String

資源類型id

replication_record_id

String

復制記錄ID

source_region

String

復制的源區(qū)域

請求示例

復制一個備份從源備份存儲庫到目標備份存儲庫。

POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/backups/a5200268-74a5-4806-acc6-95793ab0228b/replicate

{
  "replicate" : {
    "description" : "backup_description",
    "destination_project_id" : "68589cac08274b82b4e254268a3862d8",
    "destination_region" : "region2",
    "destination_vault_id" : "0ca3eb86-8800-46da-9c37-9d657a825274",
    "enable_acceleration" : false,
    "name" : "backup_name"
  }
}

響應示例

狀態(tài)碼: 200

OK

{
  "replication" : {
    "destination_vault_id" : "0ca3eb86-8800-46da-9c37-9d657a825274",
    "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66",
    "backup_id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d",
    "destination_project_id" : "68589cac08274b82b4e254268a3862d8",
    "destination_region" : "region2",
    "source_region" : "region1",
    "project_id" : "4229d7a45436489f8c3dc2b1d35d4987",
    "replication_record_id" : "1579a71e-8d8d-41e6-85dc-d77f5ce8d91a"
  }
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

錯誤碼

請參見錯誤碼