批量添加共享标签BatchAddSharedTags
.jpg)
.jpg)
.jpg)
.jpg)
功能介绍
指定共享批量添加标签。
一个共享上最多有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 |
批量添加共享标签成功 |
错误码
请参见错误码。
