# 变更指定存储库备份过期时间 - UpdateExpirationTime
#### 功能介绍
变更指定存储库备份过期时间
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
PUT /v3/{project_id}/vaults/{vault_id}/update-backup-expiration-time
表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请求Body参数 
| 参数                     | 是否必选 | 参数类型   | 描述                    |
|:---|:---|:---|:---|
| expect_expiration_date | 否    | String | 预期过期日期，格式：YYYY-MM-DD。 |
| time_zone              | 是    | String | 用户所在时区，格式形如 UTC+08:00 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                     | 参数类型    | 描述                        |
|:---|:---|:---|
| affected_backups_count | Integer | 成功修改过期时间的备份数量。            |
| new_expiration_day     | String  | 修改后的备份过期时间，格式：YYYY-MM-DD。 |
| operation_log_id       | String  | 任务ID                      |
   
#### 请求示例
变更指定存储库备份过期时间
```
PUT https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/vaults/a7d007ae-c9bb-493d-8b8e-bc2d7290784a/update-backup-expiration-time
{
  "expect_expiration_date" : "2027-01-01",
  "time_zone" : "UTC+08:00"
}
```
#### 响应示例
**状态码：200**
```
{
  "affected_backups_count" : 30,
  "new_expiration_day" : "2026-01-30",
  "operation_log_id" : "8985df6c-7ba6-46db-abdb-2c6613326b91"
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。
