更新时间：2026-10-20 GMT+08:00

添加存储库资源标签 - CreateVaultTags

为指定存储库资源添加标签。

账号具备所有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，如果添加的key已添加到资源上，则覆盖。取值范围： key最大长度为36字符且不能为空，前后空格会被丢弃，不能包含非打印字符（ASCII 0-31）及 = * < > \ , \| /；特定场景下仅允许中文、字母、数字、“-”、“”，其他场景仅允许字母、数字、“”、“-”。默认取值：不涉及
value	是	String	参数解释：用于标识资源的标签值约束限制：添加标签时value值必选取值范围： value最大长度为43个字符，不能包含非打印字符ASCII(0-31)，“=”,“”,“<”,“>”,“\”,“,”,“\|”,“/”但是可以为空字符串，同时，value前后的空格会被丢弃 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

请参见错误码。

父主题： 标签