# 添加资源 - AddVaultResource
#### 功能介绍
存储库添加资源
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v3/{project_id}/vaults/{vault_id}/addresources
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                             |
|:---|:---|:---|:---|
| project_id | 是    | String | 项目ID，默认取值不涉及。 获取方法请参见"[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html)"。 |
| vault_id   | 是    | String | 存储库ID，默认取值不涉及。 获取方法请参见"[获取存储库ID](https://support.huaweicloud.com/api-cbr/ListVault.html)"。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。默认取值不涉及。 |
   
表3请求Body参数 
| 参数        | 是否必选 | 参数类型                                                                         | 描述                                                                                           |
|:---|:---|:---|:---|
| resources | 是    | Array of [ResourceCreate] objects | 资源列表 最小长度：1 最大长度：256 |
   
 表4ResourceCreate 
| 参数         | 是否必选 | 参数类型                                                                     | 描述                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| extra_info | 否    | [ResourceExtraInfo] object | 资源附加信息                                                                                                                                                                                                                                   |
| id         | 是    | String                                                                   | 待备份资源id，需要该资源暂未绑定到存储库中，且属于可备份的状态。默认取值不涉及。 获取方法请参见"[查询存储库绑定资源信息](https://support.huaweicloud.com/api-cbr/ShowVault.html)"，"[查询资源可保护性](https://support.huaweicloud.com/api-cbr/ShowProtectable.html)"。 |
| type       | 是    | String                                                                   | 待备份资源的类型: OS::Nova::Server：云服务器； OS::Cinder::Volume：云硬盘；OS::Ironic::BareMetalServer：裸金属服务器；OS::Sfs::Turbo：SFS Turbo文件系统；OS::Workspace::DesktopV2：云桌面。默认取值不涉及。                                                                            |
| name       | 否    | String                                                                   | 资源名称，长度限制：0-255字符。默认取值不涉及。                                                                                                                                                                                                               |
   
 表5ResourceExtraInfo 
| 参数              | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                |
|:---|:---|:---|:---|
| exclude_volumes | 否    | Array of strings | **参数解释：** 需要排除备份的卷id。仅在多盘备份特性中有效，排除不需要备份的磁盘。当虚拟机新绑定磁盘时，也能继续排除之前设置不用备份的卷 **取值范围：** 不涉及 |
   
#### 响应参数
**状态码：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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。
