复制备份

功能介绍

选择单个备份进行复制，如果该备份在目标区域正在生成或者已经生成复制，则无法再次复制。

URI

• URI

  POST https://{endpoint}/v1/{project_id}/providers/{provider_id}/checkpoint_items/{checkpoint_item_id}/replicate

• 参数说明

  参数	是否必选	参数类型	描述
  project_id	是	String	项目ID。 获取方法请参见获取项目ID。
  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	复制的目标区域，可通过查询复制能力接口获取
  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	服务不可用

错误码

请参考错误码。