更新时间:2024-04-02 GMT+08:00

复制备份还原点

功能介绍

执行复制

URI

POST /v3/{project_id}/checkpoints/replicate

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

replicate

CheckpointReplicateParam object

Parameters in the request body of performing a replication

表4 CheckpointReplicateParam

参数

是否必选

参数类型

描述

auto_trigger

Boolean

Whether to automatically trigger replication this time. The default value is false, indicating the replication needs to be manually triggered.

destination_project_id

String

ID of the replication destination project

destination_region

String

ID of the replication destination region

最小长度:0

最大长度:255

destination_vault_id

String

ID of the vault in the replication destination region

enable_acceleration

Boolean

Whether to enable the acceleration function to shorten the time spent on cross-region replication.

vault_id

String

Vault ID (UUID)

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

replication

CheckpointReplicateRespBody object

Restore point replication objects in the response

表6 CheckpointReplicateRespBody

参数

参数类型

描述

backups

Array of CheckpointReplicateRespbackups objects

List of backups to be replicated

destination_project_id

String

ID of the replication destination project

destination_region

String

Replication destination region

destination_vault_id

String

ID of the vault in the replication destination region

project_id

String

ID of the project where replication is performed

provider_id

String

Backup provider ID, which specifies whether the backup object is a server or disk

source_region

String

Replication source region

vault_id

String

Vault ID

表7 CheckpointReplicateRespbackups

参数

参数类型

描述

backup_id

String

ID of the source backup used for replication

replication_record_id

String

Replication record ID

请求示例

手动跨区域复制一个备份副本从源区域到目标区域。

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

错误码

请参见错误码