文档首页/ 云备份 CBR/ API参考/ API/ 存储库/ 变更指定存储库备份过期时间 - UpdateExpirationTime
更新时间:2026-07-21 GMT+08:00
分享

变更指定存储库备份过期时间 - UpdateExpirationTime

功能介绍

变更指定存储库备份过期时间

授权信息

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

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

URI

PUT /v3/{project_id}/vaults/{vault_id}/update-backup-expiration-time

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,默认取值不涉及。

获取方法请参见"获取项目ID"。

vault_id

String

存储库ID,默认取值不涉及。

获取方法请参见"获取存储库ID"。

请求参数

表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

请求示例

响应示例

状态码:200

OK

{
  "affected_backups_count" : 30,
  "new_expiration_day" : "2026-01-30",
  "operation_log_id" : "8985df6c-7ba6-46db-abdb-2c6613326b91"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档