文档首页/ 云备份 CBR/ API参考/ API/ 存储库/ 添加资源 - AddVaultResource
更新时间:2026-10-20 GMT+08:00
分享

添加资源 - AddVaultResource

功能介绍

向存储库添加资源

授权信息

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

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

URI

POST /v3/{project_id}/vaults/{vault_id}/addresources

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

vault_id

是

String

参数解释:

存储库ID,获取方法请参见获取存储库ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

用户Token。

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

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

resources

是

Array of ResourceCreate objects

参数解释:

资源列表,需要包含待添加的资源的ID,类型等信息

约束限制:

不涉及

取值范围:

最小长度:1

最大长度:256

默认取值:

不涉及

表4 ResourceCreate

参数

是否必选

参数类型

描述

extra_info

否

ResourceExtraInfo object

参数解释:

资源附加信息,用于设置需要备份的卷以及不需要备份的卷等属性

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

id

是

String

参数解释:

待备份资源ID,获取方法请参见查询存储库绑定资源信息,查询资源可保护性

约束限制:

需要该资源暂未绑定到存储库中,且属于可备份的状态

取值范围:

不涉及

默认取值:

不涉及

type

是

String

参数解释:

待备份资源的类型,用于指定待备份的资源类型,不同类型对应不同的云服务资源。

约束限制:

不涉及

取值范围:

OS::Nova::Server:云服务器; OS::Cinder::Volume:云硬盘;OS::Ironic::BareMetalServer:裸金属服务器;OS::Sfs::Turbo:SFS Turbo文件系统;OS::Workspace::DesktopV2:云桌面。

默认取值:

不涉及

name

否

String

参数解释:

资源名称

约束限制:

不涉及

取值范围:

长度限制:0-255字符

默认取值:

不涉及

表5 ResourceExtraInfo

参数

是否必选

参数类型

描述

exclude_volumes

否

Array of strings

参数解释:

需要排除备份的卷ID列表,列表元素为String类型的UUID。

约束限制:

仅在多盘备份特性中有效,排除不需要备份的磁盘。当虚拟机新绑定磁盘时,也能继续排除之前设置不用备份的卷。

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表6 响应Body参数

参数

参数类型

描述

add_resource_ids

Array of strings

参数解释:

已添加的资源ID列表,多个资源ID间以英文逗号分隔

取值范围:

资源ID格式为UUID

请求示例

POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/vaults/79bd9daa-884f-4f84-b8fe-235d58cd927d/addresources

{
  "resources" : [ {
    "extra_info" : {
      "exclude_volumes" : [ "bdef09bb-293f-446a-88a4-86e9f14408c4" ]
    },
    "id" : "97595625-198e-4e4d-879b-9d53f68ba551",
    "type" : "OS::Nova::Server"
  } ]
}

响应示例

状态码:200

{
  "add_resource_ids" : [ "97595625-198e-4e4d-879b-9d53f68ba551" ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

相关文档