功能介绍
一个资源上最多有10个标签。 此接口为幂等接口:创建时,如果创建的标签已经存在(key相同),则覆盖。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v3/{project_id}/vault/{vault_id}/tags
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目id |
vault_id |
是 |
String |
资源id |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
key |
是 |
String |
键。 key最大长度为36个字符。 key不能为空字符串。 key前后空格会被丢弃。 key不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 key只能由中文,字母,数字,“-”,“_”组成。 |
value |
是 |
String |
值。 添加标签时value值必选,删除标签时value值可选。 value最大长度为43个字符。 value可以为空字符串。 value前后的空格会被丢弃。 value不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 value只能由中文,字母,数字,“-”,“_”,“.”组成。 |
请求示例
添加存储库标签
POST https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags { "tag" : { "key" : "key1", "value" : "key2" } }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
No Content |
400 |
Bad Request |
错误码
请参见错误码。