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

同步备份 - ImportBackup

功能介绍

同步线下混合云VMware备份副本

授权信息

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

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

URI

POST /v3/{project_id}/backups/sync

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

sync

是

Array of BackupSync objects

待同步备份副本列表,最小支持1个,最大支持50个。

表4 BackupSync

参数

是否必选

参数类型

描述

backup_id

是

String

参数解释:

备份ID,获取方法请参见获取备份ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

backup_name

是

String

参数解释:

备份名称

约束限制:

不涉及

取值范围:

最大支持64字符,只能由数字、中文、英文大小写字母,以及下划线"_"和中横线 "-" 字符构成

默认取值:

不涉及

bucket_name

是

String

参数解释:

桶名

约束限制:

不涉及

取值范围:

长度限制:[1-255]

默认取值:

不涉及

image_path

是

String

参数解释:

备份链在存储单元上的路径

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

resource_id

是

String

参数解释:

待备份资源id,需要该资源已经绑定到该存储库中,且属于可备份的状态,获取方法请参见查询存储库绑定资源信息,查询资源可保护性

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

resource_name

是

String

参数解释:

备份对象名称

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

resource_type

是

String

参数解释:

备份对象的资源类型

约束限制:

不涉及

取值范围:

  • OS::Native::Server:本地服务器

  • OS::VMware::Server:VMware服务器

默认取值:

OS::Native::Server

created_at

是

Integer

参数解释:

备份时间戳,是标准的 Unix 时间戳,例如1548898428,单位为秒

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

sync

Array of BackupSyncRespBody objects

同步备份副本接口的返回信息

表6 BackupSyncRespBody

参数

参数类型

描述

backup_id

String

参数解释:

备份ID

取值范围:

不涉及

operation_log_id

String

参数解释:

同步任务ID

取值范围:

不涉及

请求示例

同步线下混合云VMware备份副本。

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

{
  "sync" : [ {
    "backup_id" : "1f9e6b47-7655-4a19-b563-21b4ef023025",
    "resource_id" : "96f7512d-239d-3f31-80cf-d1ce041df9a6",
    "resource_name" : "resource_name",
    "resource_type" : "OS::VMware::Server",
    "bucket_name" : "1555230361623e4ce4700dab84b7d8169a5eaec05227d",
    "image_path" : "6abec15e-7baf-4d79-b5a9-6b98a2da7020/cfe0295c-5939-4b31-96cd-161b4725e7ad/cfe0295c-5939-4b31-96cd-161b4725e7ad",
    "created_at" : 1553587260,
    "backup_name" : "backup_name"
  } ]
}

响应示例

状态码:200

{
  "sync" : [ {
    "backup_id" : "1f9e6b47-7655-4a19-b563-21b4ef023025",
    "operation_log_id" : "154f0a9d-ba53-4e91-a3e2-a918710a9e0d"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

相关文档