更新时间：2026-09-22 GMT+08:00

添加存储库资源标签 - CreateVaultTags

添加存储库资源标签，一个资源上最多有10个标签。

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

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

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，获取方法请参见获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
vault_id	是	String	参数解释：存储库id，获取方法可参考查询存储库列表约束限制：不涉及取值范围：不涉及默认取值：不涉及

表2 请求Body参数
参数	是否必选	参数类型	描述
tag	是	TagCreate object	标签

表3 TagCreate
参数	是否必选	参数类型	描述
key	是	String	键。 key最大长度为36个字符。 key不能为空字符串。 key前后空格会被丢弃。 key不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“\|”,“/”。 key只能由中文，字母，数字，“-”，“_”组成。创建时如果请求体中存在重复key则报错。创建时，不允许重复key，如果数据库存在就覆盖。删除时，允许重复key。删除时，如果删除的标签不存在，默认处理成功,删除时不对标签字符集范围做校验。删除时tags结构体不能缺失，key不能为空，或者空字符串。
value	是	String	值。添加标签时value值必选，删除标签时value值可选。 value最大长度为43个字符。 value可以为空字符串。 value前后的空格会被丢弃。 value不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“\|”,“/”。 value只能由中文，字母，数字，“-”，“_”，“.”组成。

状态码：204

无

状态码：400

表4 响应Body参数
参数	参数类型	描述
error_code	String	请参见错误码。
error_msg	String	错误信息

添加存储库标签

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

{
  "tag" : {
    "key" : "key1",
    "value" : "key2"
  }
}

无

状态码	描述
204	No Content
400	Bad Request

请参见错误码。

父主题： 标签