功能介绍
指定共享批量添加标签。
一个共享上最多有10个标签。 一个共享上的多个标签的key不允许重复。 此接口为幂等接口:如果要添加的key在共享上已存在,则覆盖更新标签。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
帐号的token |
Content-Type |
是 |
String |
MIME类型 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
是 |
String |
操作标识,取值范围为:create。 为指定共享批量添加标签时使用create。 枚举值:
|
tags |
否 |
标签列表。 用户权限时该字段必选。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
key |
是 |
String |
标签的键。 最大长度36个字符。 key不能为空,不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字,特殊字符"-"和"_"。 最小长度:1 最大长度:36 |
value |
是 |
String |
标签的值。 每个值最大长度43个字符,可以为空字符串。 不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大写字母、小写字母、数字,特殊字符"-"和"_"。 最小长度:0 最大长度:43 |
响应参数
无
请求示例
批量添加共享标签,第一个标签的键为“key1”,值为“value1”;第二个标签的键为“key2”,值为“value1”。
{ "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value1" } ] }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
批量添加共享标签成功 |
错误码
请参见错误码。