文档首页/ 云备份 CBR/ API参考/ API/ 还原点/ 同步备份还原点 - ImportCheckpoint
更新时间:2026-10-20 GMT+08:00
分享

同步备份还原点 - ImportCheckpoint

功能介绍

针对存储库同步备份副本

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /v3/{project_id}/checkpoints/sync

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方法和含义,请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

sync

是

SyncParam object

参数解释:

用于将混合云备份还原点从本地同步至云上

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 SyncParam

参数

是否必选

参数类型

描述

auto_trigger

是

Boolean

参数解释:

是否自动触发。

约束限制:

不涉及

取值范围:

  • true:自动触发

  • false:非自动触发

默认取值:

false

vault_id

是

String

参数解释:

混合云存储库ID,用于指定需要同步还原点的混合云存储库。

获取方法请参见"获取存储库ID"。

约束限制:

不涉及

取值范围:

格式为UUID

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

sync

SyncRespBody object

参数解释:

返回同步还原点操作的结果信息,包括同步任务ID和存储库ID。

取值范围:

不涉及

表5 SyncRespBody

参数

参数类型

描述

operation_log_id

String

参数解释:

同步任务ID。

可在此处查询任务详情"查询任务详情"。

取值范围:

格式为UUID

vault_id

String

参数解释:

混合云存储库ID。

获取方法请参见"获取存储库ID"。

取值范围:

格式为UUID

请求示例

手动将混合云备份同步到存储库。

POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/checkpoints/sync

{
  "sync" : {
    "vault_id" : "8d3a8b28-a697-41e2-8d5d-903669f8a02d",
    "auto_trigger" : false
  }
}

响应示例

状态码:200

{
  "sync" : {
    "operation_log_id" : "60baed87-7e30-4bd8-b71c-89e4a4f7547d",
    "vault_id" : "8d3a8b28-a697-41e2-8d5d-903669f8a02d"
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

相关文档