# 更新回收站策略 - UpdateRecyclePolicy
#### 功能介绍
更新回收站策略。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-evs/evs_04_0009.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-evs/evs_04_0023.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                       | 访问级别  | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | evs:recycle_policy:update | Write | -           | -   | -  | -      |
     
  
 
#### URI
PUT /v3/{project_id}/recycle-bin-volumes/policy
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释** 项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-evs/evs_04_0046.html)。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释** 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制** 不涉及。 **取值范围** 不涉及。 **默认取值** 不涉及。 |
   
表3请求Body参数 
| 参数             | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| switch         | 否    | Boolean | **参数解释** 回收站开关。 **约束限制** 不涉及。 **取值范围** - true：表示打开回收站。   - false：表示关闭回收站。    **默认取值** 不涉及。 |
| threshold_time | 否    | Integer | **参数解释** 回收站门槛时间，云硬盘创建多少天后删除才会放入回收站。 **约束限制** 不涉及。 **取值范围** 1-1000 **默认取值** 7                                                                                                                                                                                                                                                                                            |
| keep_time      | 否    | Integer | **参数解释** 回收站的云硬盘保存期限（天），云硬盘进入回收站后多少天才会被彻底删除。 **约束限制** 不涉及。 **取值范围** 1-365 **默认取值** 7                                                                                                                                                                                                                                                                                     |
   
#### 响应参数
**状态码：200**
No Content
**状态码：400**
表4响应Body参数 
| 参数    | 参数类型                                                 | 描述                                                                                                                                                                                                                                       |
|:---|:---|:---|
| error | [Error] object | **参数解释** 出现错误时，返回的错误码。错误码和其对应的含义请参考[错误码说明](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。 **取值范围** 不涉及。 |
   
 表5Error 
| 参数      | 参数类型   | 描述                                                                                                                                                                                                                                   |
|:---|:---|:---|
| code    | String | **参数解释** 出现错误时，返回的错误码。 **取值范围** 错误码和其对应的含义请参考[错误码说明](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。 |
| message | String | **参数解释** 出现错误时，返回的错误消息。 **取值范围** 描述错误消息的字符串                                                                     |
   
#### 请求示例
```
PUT https://evs.cn-north-1.myhuaweicloud.com/v3/490e121341fc481d95f946ef844cb06a/recycle-bin-volumes/policy
{
"switch": true,
        "threshold_time": 8        
}
```
#### 响应示例
**状态码：400**
Bad Request
```
{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | No Content  |
| 400 | Bad Request |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-evs/evs_04_0038.html)。