# 执行复制策略
#### 功能介绍
选择备份策略执行复制，为备份策略生成的未进行过复制的备份创建复制。
#### URI
- URI POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoints/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。用于区分备份对象是服务器或磁盘。                                                            |
     
  
 
#### 请求
- 要素说明
  
  | 参数          | 是否必选 | 参数类型              | 描述   |
  |:---|:---|:---|:---|
  | replication | 是    | replication_param | 复制参数 |
     
  

- replication_param 字段数据结构说明
  
  | 参数                     | 是否必选 | 参数类型    | 描述                                                                                            |
  |:---|:---|:---|:---|
  | policy_id              | 是    | String  | 备份策略ID                                                                                        |
  | auto_trigger           | 否    | Boolean | 本次复制是否自动触发，默认为false，代表手动触发                                                                    |
  | 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}/checkpoints/replicate
  {
    "replication" : {
      "policy_id": "d4acdab5-6d4d-42d8-8c56-ae94e53bfe87",
      "auto_trigger" : false,
      "destination_region": "cn-east-2",
      "destination_project_id": "e0b97bac-532c-4c51-96fa-4b3a32253be4"
    }
  }
  ```
  
 
#### 响应
- 要素说明
  
  | 参数          | 参数类型             | 描述     |
  |:---|:---|:---|
  | replication | replication_resp | 复制返回参数 |
     
  
- replication_resp字段数据结构说明
  
  | 参数                     | 参数类型                        | 描述                                                                    |
  |:---|:---|:---|
  | project_id             | String                      | 执行复制的项目ID                                                             |
  | provider_id            | String                      | 备份提供商ID，当前取值固定值：fc4d5750-22e7-4798-8a46-f48f62c4c1da。用于区分备份对象是服务器或磁盘。 |
  | policy_id              | String                      | 备份策略ID                                                                |
  | source_region          | String                      | 复制的源区域                                                                |
  | destination_region     | String                      | 复制的目标区域                                                               |
  | destination_project_id | String                      | 复制的目标项目ID                                                             |
  | checkpoint_items       | List\<checkpointitem_resp\> | 待复制的备份列表                                                              |
     
  
- checkpointitem_resp字段数据结构说明
  
  | 参数                    | 参数类型   | 描述       |
  |:---|:---|:---|
  | checkpoint_item_id    | String | 待复制的备份ID |
  | replication_record_id | String | 复制记录ID   |
     
  

- 响应样例
  ```
  {
    "replication" :{
        "project_id": "4800fde9-66f8-4458-b805-4c01066b9568",
        "provider_id": "fc4d5750-22e7-4798-8a46-f48f62c4c1da",
        "policy_id": "d4acdab5-6d4d-42d8-8c56-ae94e53bfe87",
        "source_region": "cn-north-1",
        "destination_region": "cn-east-2",
        "destination_project_id": "e0b97bac-532c-4c51-96fa-4b3a32253be4",
        "checkpoint_items": [
          {"checkpoint_item_id": "c4dfa74c-7e60-4361-86b9-9a3250115ed6",
           "replication_record_id": "6f55d79b-9f01-4d3d-b4fb-a63e3070ea12"},
          {"checkpoint_item_id": "0eaf4230-854e-41ea-bf0c-392d4c26c8b5",
           "replication_record_id": "5d850404-bc98-45b2-9f0b-6ff2f77d2b6b"}] 
    } 
  }
  ```
  
 
#### 状态码
- 正常
  
  | 状态码 | 说明 |
  |:---|:---|
  | 200 | OK |
     
  
- 异常
  
  | 状态码 | 说明      |
  |:---|:---|
  | 400 | 请求参数不合法 |
  | 401 | 鉴权失败    |
  | 403 | 没有操作权限  |
  | 404 | 请求对象不存在 |
  | 500 | 服务内部错误  |
  | 503 | 服务不可用   |
     
  
 
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-csbs/zh-cn_topic_0071888297.html)。