执行复制策略

功能介绍

选择备份策略执行复制，为备份策略生成的未进行过复制的备份创建复制。

URI

• URI

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

• 参数说明

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

错误码

请参考错误码。