# 复制备份还原点 - CopyCheckpoint #### 功能介绍 将备份还原点复制到其他存储库 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。 - 如果使用身份策略授权，当前API调用无需身份策略权限。 #### URI POST /v3/{project_id}/checkpoints/replicate 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目ID，默认取值不涉及。 获取方法请参见"[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html)"。 | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。默认取值不涉及。 | 表3请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | replicate | 是 | [CheckpointReplicateParam] object | 执行备份复制请求体参数 | 表4CheckpointReplicateParam | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | auto_trigger | 否 | Boolean | 是否自动触发。默认为false。 - true：自动触发 - false：非自动触发 | | destination_project_id | 是 | String | 复制的目标区域项目ID，默认取值不涉及。 获取方法请参见"[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html)"。 | | destination_region | 是 | String | 复制的目标区域id，默认取值不涉及。 获取方法请参见"[地区和终端节点查询](https://console.huaweicloud.com/apiexplorer/#/endpoint/CBR)"。 | | destination_vault_id | 是 | String | 目标区域的存储库ID，默认取值不涉及。 获取方法请参见"[获取存储库ID](https://support.huaweicloud.com/api-cbr/ListVault.html)"。其中project_id需填写目标区域的project_id | | enable_acceleration | 否 | Boolean | 跨region复制时，是否启用加速从而缩短复制的时间，如果不指定，默认不启用加速。如果启用加速，会额外收取加速的费用。 - true：启用加速复制。 - false：不启用加速复制。 | | vault_id | 是 | String | 存储库ID: uuid。默认取值不涉及。 获取方法请参见"[获取存储库ID](https://support.huaweicloud.com/api-cbr/ListVault.html)"。 | #### 响应参数 **状态码：200** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | replication | [CheckpointReplicateRespBody] object | 复制备份还原点响应对象。 | 表6CheckpointReplicateRespBody | 参数 | 参数类型 | 描述 | |:---|:---|:---| | backups | Array of [CheckpointReplicateRespbackups] objects | 待复制的备份列表 | | destination_project_id | String | 复制的目标项目ID。 获取方法请参见"[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html)"，"[查询支持region信息](https://support.huaweicloud.com/usermanual-cbr/cbr_03_0009.html)" | | destination_region | String | 复制的目标区域。 获取方法请参见"[地区和终端节点查询](https://console.huaweicloud.com/apiexplorer/#/endpoint/CBR)"。 | | destination_vault_id | String | 目标区域的存储库ID。 获取方法请参见"[获取存储库ID](https://support.huaweicloud.com/api-cbr/ListVault.html)"。其中project_id需填写目标区域的project_id | | project_id | String | 执行复制的项目ID | | provider_id | String | 备份提供商ID | | source_region | String | 复制的源区域。 获取方法请参见"[地区和终端节点查询](https://console.huaweicloud.com/apiexplorer/#/endpoint/CBR)"。 | | vault_id | String | 存储库ID | 表7CheckpointReplicateRespbackups | 参数 | 参数类型 | 描述 | |:---|:---|:---| | backup_id | String | 待复制的备份ID。 获取方法请参见"[获取备份ID](https://support.huaweicloud.com/api-cbr/ListBackups.html)"。 | | replication_record_id | String | 复制记录ID | #### 请求示例 手动跨区域复制一个备份副本从源区域到目标区域。 ``` POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/checkpoints/replicate { "replicate" : { "auto_trigger" : false, "destination_project_id" : "68589cac08274b82b4e254268a3862d8", "destination_region" : "region2", "destination_vault_id" : "0ca3eb86-8800-46da-9c37-9d657a825274", "enable_acceleration" : false, "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce" } } ``` #### 响应示例 **状态码：200** ``` { "replication" : { "destination_vault_id" : "0ca3eb86-8800-46da-9c37-9d657a825274", "provider_id" : "0daac4c5-6707-4851-97ba-169e36266b66", "source_region" : "region1", "vault_id" : "3b5816b5-f29c-4172-9d9a-76c719a659ce", "destination_region" : "region2", "destination_project_id" : "68589cac08274b82b4e254268a3862d8", "backups" : [ { "replication_record_id" : "de128dfa-5451-4905-9c11-8fc842b2f41e", "backup_id" : "7558e1a3-7046-4787-95cd-14b0ad0642a8" }, { "replication_record_id" : "892a7d1e-17c8-4751-ad75-cfbed7051857", "backup_id" : "6df2b54c-dd62-4059-a07c-1b8f24f2725d" }, { "replication_record_id" : "8bf5ce8f-bfa1-4d57-98de-d6159ab9d86d", "backup_id" : "aa00034d-ef40-443d-ab7a-dc846d988cdf" } ], "project_id" : "4229d7a45436489f8c3dc2b1d35d4987" } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。