功能介绍
执行复制
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v3/{project_id}/checkpoints/replicate
| 
 参数  | 
 是否必选  | 
 参数类型  | 
 描述  | 
|---|---|---|---|
| 
 project_id  | 
 是  | 
 String  | 
 项目ID  | 
请求参数
| 
 参数  | 
 是否必选  | 
 参数类型  | 
 描述  | 
|---|---|---|---|
| 
 X-Auth-Token  | 
 是  | 
 String  | 
 用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。  | 
| 
 参数  | 
 是否必选  | 
 参数类型  | 
 描述  | 
|---|---|---|---|
| 
 auto_trigger  | 
 否  | 
 Boolean  | 
 本次复制是否自动触发,默认为false,代表手动触发  | 
| 
 destination_project_id  | 
 是  | 
 String  | 
 复制的目标项目ID  | 
| 
 destination_region  | 
 是  | 
 String  | 
 复制的目标区域id 最小长度:0 最大长度:255  | 
| 
 destination_vault_id  | 
 是  | 
 String  | 
 目标区域存储库ID  | 
| 
 enable_acceleration  | 
 否  | 
 Boolean  | 
 跨区域复制时,是否启用加速从而缩短复制的时间,如果不指定,默认不启用加速,如果启用加速,会额外收取加速的费用。  | 
| 
 vault_id  | 
 是  | 
 String  | 
 存储库ID: uuid  | 
响应参数
状态码: 200
请求示例
手动跨区域复制一个备份副本从源区域到目标区域。
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
OK
{
  "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  | 
错误码
请参见错误码。
  
    