文档首页/云备份 CBR/API参考/API/备份/同步备份 - ImportBackup
更新时间：2025-12-05 GMT+08:00
编辑
查看PDF
分享

同步备份 - ImportBackup

功能介绍

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有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::Native::Server：本地服务器

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

created_at

是

Integer

备份时间戳，例如1548898428，默认取值不涉及。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

sync

Array of BackupSyncRespBody objects

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

表6 BackupSyncRespBody

参数

参数类型

描述

backup_id

String

备份ID。

获取方法请参见"获取备份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::Nova::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

OK

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

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：备份

相关文档