文档首页/云备份 CBR/API参考/API/存储库/批量修改存储库 - BatchUpdateVault
更新时间：2025-12-05 GMT+08:00
查看PDF
分享

批量修改存储库 - BatchUpdateVault

功能介绍

批量修改项目下所有存储库

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

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

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

URI

PUT /v3/{project_id}/vaults/batch-update

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。默认取值不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

vault

是

VaultBatchUpdate object

存储库修改参数体

表4 VaultBatchUpdate

参数

是否必选

参数类型

描述

smn_notify

否

Boolean

功能说明：是否发送smn通知开关，默认为true

取值范围：

  • true：发送smn通知

  • false：不发送smn通知

threshold

否

Integer

功能说明：存储库容量阈值，存储库已用容量和总容量的百分比超过该值，如果smn_notify为开，将发送相关通知。

取值范围：[1, 100]，默认值为80。

响应参数

状态码：200

表5 响应Body参数

参数

参数类型

描述

updated_vaults_id

Array of strings

已批量修改的存储库ID列表，取值范围不涉及。

请求示例

批量修改所有存储库，容量阈值为60G。

PUT https://{endpoint}/v3/f841e01fd2b14e7fa41b6ae7aa6b0594/vaults/batch-update

{
  "vault" : {
    "smn_notify" : true,
    "threshold" : 60
  }
}

响应示例

状态码：200

OK

{
  "updated_vaults_id" : [ "79bd9daa-884f-4f84-b8fe-235d58cd927d" ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题：存储库

相关文档