更新时间:2024-04-02 GMT+08:00

复制备份

功能介绍

跨区域复制备份。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

backup_id

String

复制的备份ID

project_id

String

项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

replicate

BackupReplicateReqBody object

复制参数

表4 BackupReplicateReqBody

参数

是否必选

参数类型

描述

description

String

复制的描述

最小长度:0

最大长度:255

destination_project_id

String

复制的目标项目ID

destination_region

String

复制的目标区域

最小长度:0

最大长度:255

destination_vault_id

String

复制的目标区域的存储库ID

enable_acceleration

Boolean

跨区域复制时,是否启用加速从而缩短复制的时间,如果不指定,默认不启用加速。

缺省值:false

name

String

复制名称

最小长度:1

最大长度:64

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

replication

BackupReplicateRespBody object

复制返回参数

表6 BackupReplicateRespBody

参数

参数类型

描述

backup_id

String

待复制的备份ID

destination_project_id

String

复制的目标项目ID

destination_region

String

复制的目标区域

destination_vault_id

String

复制的目标区域存储库ID

project_id

String

执行复制的项目ID

provider_id

String

资源类型id

replication_record_id

String

复制记录ID

source_region

String

复制的源区域

请求示例

复制一个备份从源备份存储库到目标备份存储库。

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"
  }
}

响应示例

状态码: 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"
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码