功能介绍
指定共享添加一个标签。 一个共享上最多有10个标签。 一个共享上的多个标签的key不允许重复。 此接口为幂等接口:如果要添加的key在共享上已存在,则覆盖更新标签。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
帐号的token |
Content-Type |
是 |
String |
MIME类型 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
key |
是 |
String |
标签的键。 最大长度36个字符。 key不能为空,不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字,特殊字符"-"和"_"。 最小长度:1 最大长度:36 |
value |
是 |
String |
标签的值。 每个值最大长度43个字符,可以为空字符串。 不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字,特殊字符"-"和"_"。 最小长度:0 最大长度:43 |
响应参数
无
请求示例
创建一个共享标签,标签的键为“key1”,标签的值为“value1”。
{ "tag" : { "key" : "key1", "value" : "value1" } }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
创建共享标签请求下发成功 |
错误码
请参见错误码。