# 复制备份
#### 功能介绍
选择单个备份进行复制，如果该备份在目标区域正在生成或者已经生成复制，则无法再次复制。
#### URI
- URI POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoint_items/{checkpoint_item_id}/replicate
  
- 参数说明
  
  | 参数                 | 是否必选 | 参数类型   | 描述                                                                                                                               |
  |:---|:---|:---|:---|
  | project_id         | 是    | String | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0136033750.html)。 |
  | provider_id        | 是    | String | 备份提供商ID，当前取值固定值：fc4d5750-22e7-4798-8a46-f48f62c4c1da。用于区分备份对象是服务器或磁盘。                                                            |
  | checkpoint_item_id | 是    | String | 待复制的备份ID                                                                                                                         |
     
  
 
#### 请求
- 要素说明
  
  | 参数          | 是否必选 | 参数类型              | 描述   |
  |:---|:---|:---|:---|
  | replication | 是    | replication_param | 复制参数 |
     
  

- replication_param 字段数据结构说明
  
  | 参数                     | 是否必选 | 参数类型    | 描述                                                                                            |
  |:---|:---|:---|:---|
  | name                   | 否    | String  | 复制的名称                                                                                         |
  | description            | 否    | String  | 复制的描述                                                                                         |
  | destination_region     | 是    | String  | 复制的目标区域，可通过[查询复制能力](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0104715370.html)接口获取 |
  | destination_project_id | 是    | String  | 复制的目标项目ID                                                                                     |
  | enable_acceleration    | 否    | Boolean | 跨区域复制时，是否启用加速从而缩短复制的时间，如果不指定，默认不启用加速。                                                         |
     
  
- 请求样例
  ```
  POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoint_items/{checkpoint_item_id}/replicate
  {
    "replication" : {
      "destination_region": "cn-east-2",
      "destination_project_id": "e0b97bac-532c-4c51-96fa-4b3a32253be4",
      "name": "rep_from_bd3c8a42-7dd4-4400-b091-2777c51a5c9a",
      "description": "do replication"
    }
  }
  ```
  
 
#### 响应
- 要素说明
  
  | 参数          | 参数类型             | 描述     |
  |:---|:---|:---|
  | replication | replication_resp | 复制返回参数 |
     
  
- replication_resp字段数据结构说明
  
  | 参数                     | 参数类型   | 描述                                                                    |
  |:---|:---|:---|
  | project_id             | String | 执行复制的项目ID                                                             |
  | provider_id            | String | 备份提供商ID，当前取值固定值：fc4d5750-22e7-4798-8a46-f48f62c4c1da。用于区分备份对象是服务器或磁盘。 |
  | checkpoint_item_id     | String | 待复制的备份ID                                                              |
  | source_region          | String | 复制的源区域                                                                |
  | destination_region     | String | 复制的目标区域                                                               |
  | destination_project_id | String | 复制的目标项目ID                                                             |
  | replication_record_id  | String | 复制记录ID                                                                |
     
  
- 响应样例
  ```
  {
    "replication" :{
        "project_id": "4800fde9-66f8-4458-b805-4c01066b9568",
        "provider_id": "fc4d5750-22e7-4798-8a46-f48f62c4c1da",
        "checkpoint_item_id": "c4dfa74c-7e60-4361-86b9-9a3250115ed6",
        "source_region": "cn-north-1",
        "destination_region": "cn-east-2",
        "destination_project_id": "e0b97bac-532c-4c51-96fa-4b3a32253be4",
        "replication_record_id": "042cd047-a7c9-4905-a859-402950ac8440"
    } 
  }
  ```
  
 
#### 状态码
- 正常
  
  | 状态码 | 说明 |
  |:---|:---|
  | 200 | OK |
     
  
- 异常
  
  | 状态码 | 说明      |
  |:---|:---|
  | 400 | 请求参数不合法 |
  | 401 | 鉴权失败    |
  | 403 | 没有操作权限  |
  | 404 | 请求对象不存在 |
  | 500 | 服务内部错误  |
  | 503 | 服务不可用   |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0071888297.html)。