功能介紹
指定共享批量添加標簽。
一個共享上最多有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" } ] }
響應示例
無
狀態(tài)碼
狀態(tài)碼 |
描述 |
---|---|
204 |
批量添加共享標簽成功 |
錯誤碼
請參見錯誤碼。