# 设置存储库策略 - AssociateVaultPolicy
#### 功能介绍
存储库设置策略
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v3/{project_id}/vaults/{vault_id}/associatepolicy
表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参数 
| 参数                   | 是否必选 | 参数类型             | 描述                                                                                                                                                                                          |
|:---|:---|:---|:---|
| destination_vault_id | 否    | String           | 目标端存储库ID，只有设置复制策略时使用，而且必传。默认取值不涉及。 获取方法请参见"[获取存储库ID](https://support.huaweicloud.com/api-cbr/ListVault.html)"。其中project_id需填写目标区域的project_id        |
| policy_id            | 否    | String           | 策略ID。默认取值不涉及。policy_id字段与add_policy_ids字段在一次请求中有且只有一个。 获取方法请参见"[获取备份策略ID](https://support.huaweicloud.com/api-cbr/ListPolicies.html)"。              |
| add_policy_ids       | 否    | Array of strings | 多策略场景下，绑定新策略的id列表。policy_id字段与add_policy_ids字段在一次请求中有且只有一个。默认取值不涉及。 获取方法请参见"[获取备份策略ID](https://support.huaweicloud.com/api-cbr/ListPolicies.html)"。 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数               | 参数类型                                                                      | 描述     |
|:---|:---|:---|
| associate_policy | [VaultPolicyResp] object | 绑定策略详情 |
   
 表5VaultPolicyResp 
| 参数                   | 参数类型   | 描述                                                                                                                                                                             |
|:---|:---|:---|
| destination_vault_id | String | 目标region的vault ID，仅设置复制策略时有。 获取方法请参见"[获取存储库ID](https://support.huaweicloud.com/api-cbr/ListVault.html)"。其中project_id需填写目标区域的project_id |
| policy_id            | String | 设置的策略ID，取值范围不涉及。                                                                                                                                                               |
| vault_id             | String | 设置策略的存储库ID，取值范围不涉及。                                                                                                                                                            |
   
#### 请求示例
设置存储库的备份策略。
```
POST https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/vaults/79bd9daa-884f-4f84-b8fe-235d58cd927d/associatepolicy
{
  "policy_id" : "7075c397-25a0-43e2-a83a-bb16eaca3ee5"
}
```
#### 响应示例
**状态码：200**
```
{
  "associate_policy" : {
    "vault_id" : "2402058d-8373-4b0a-b848-d3c0dfdc71a8",
    "policy_id" : "7075c397-25a0-43e2-a83a-bb16eaca3ee5"
  }
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。