文档首页/ 云备份 CBR/ API参考/ API/ 标签/ 批量添加或删除存储库资源标签 - BatchCreateAndDeleteVaultTags
更新时间:2026-10-20 GMT+08:00
分享

批量添加或删除存储库资源标签 - BatchCreateAndDeleteVaultTags

功能介绍

为指定实例批量添加或删除标签

授权信息

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

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

URI

POST /v3/{project_id}/vault/{vault_id}/tags/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

vault_id

是

String

参数解释:

存储库id,获取方法可参考查询存储库列表

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

否

Array of BulkCreateAndDeleteTags objects

参数解释:

标签列表。

约束限制:

tags不允许为空列表,最多包含10个key且tags中key不允许重复。

取值范围:

不涉及

默认取值:

不涉及

sys_tags

否

Array of SysTagCreate objects

参数解释:

系统标签列表。

约束限制:

op_service权限可以访问,tags和sys_tags必须二选一、不能同时为空,且现在仅支持create操作。

取值范围:

不涉及

默认取值:

不涉及

action

是

String

参数解释:

用于指定对标签执行的操作类型

约束限制:

不涉及

取值范围:

  • create: 创建

  • delete: 删除

默认取值:

不涉及

表3 BulkCreateAndDeleteTags

参数

是否必选

参数类型

描述

key

是

String

参数解释:

用于标识资源的标签键

约束限制:

创建时请求体中不允许重复key,如果添加的key已添加到资源上,则覆盖,删除时允许重复key且不做字符集校验,但tags结构体不能缺失且key不能为空,不存在的标签默认删除成功。

取值范围:

key最大长度为36字符且不能为空,前后空格会被丢弃,不能包含非打印字符(ASCII 0-31)及 = * < > \ , | /;特定场景下仅允许中文、字母、数字、“-”、“”,其他场景仅允许字母、数字、“”、“-”。

默认取值:

不涉及

value

否

String

参数解释:

用于标识资源的标签值

约束限制:

添加标签时value值必选,删除标签时value值可选

取值范围:

value最大长度为43个字符,不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”但是可以为空字符串,同时,value前后的空格会被丢弃

value只能由中文,字母,数字,“-”,“_”,“.”组成。

默认取值:

不涉及

表4 SysTagCreate

参数

是否必选

参数类型

描述

key

是

String

参数解释:

系统标签的键

约束限制:

从白名单中取,不能随意定义。目前仅支持 _sys_enterprise_project_id字段,对应的value为企业项目ID。

取值范围:

不涉及

默认取值:

不涉及

value

是

String

参数解释:

系统标签的值

约束限制:

目前仅会用到企业项目ID,其中默认的企业项目ID为“0”。

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:204

无

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

请参见错误码。

error_msg

String

错误信息

请求示例

批量创建tag

POST https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags/action

{
  "tags" : [ {
    "key" : "string",
    "value" : "string"
  }, {
    "key" : "string1",
    "value" : "string2"
  } ],
  "action" : "create"
}

响应示例

无

状态码

状态码

描述

204

No Content

400

Bad Request

错误码

请参见错误码。

相关文档