批量添加共享标签
功能介绍
指定共享批量添加标签。
一个共享上最多有10个标签。 一个共享上的多个标签的key不允许重复。 此接口为幂等接口：如果要添加的key在共享上已存在，则覆盖更新标签。
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
账号的token |
Content-Type |
是 |
String |
MIME类型 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
action |
是 |
String |
操作标识，取值范围为：create。 为指定共享批量添加标签时使用create。 枚举值：
|
tags |
否 |
Array of ResourceTag objects |
标签列表。 用户权限时该字段必选。如果有op_service权限时，tags和sys_tags二选一。 |
sys_tags |
否 |
Array of ResourceTag objects |
系统标签列表。 op_service权限可以访问，和tags二选一。目前TMS调用时只包含一个resource_tag结构体，key固定为：_sys_enterprise_project_id。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
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 |
批量添加共享标签成功 |
错误码
请参见错误码。
