功能介紹
指定共享添加一個標(biāo)簽。 一個共享上最多有10個標(biāo)簽。 一個共享上的多個標(biāo)簽的key不允許重復(fù)。 此接口為冪等接口:如果要添加的key在共享上已存在,則覆蓋更新標(biāo)簽。
請求參數(shù)
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
帳號的token |
Content-Type |
是 |
String |
MIME類型 |
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
---|---|---|---|
key |
是 |
String |
標(biāo)簽的鍵。 最大長度36個字符。 key不能為空,不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大寫字母、小寫字母、數(shù)字,特殊字符"-"和"_"。 最小長度:1 最大長度:36 |
value |
是 |
String |
標(biāo)簽的值。 每個值最大長度43個字符,可以為空字符串。 不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大寫字母、小寫字母、數(shù)字,特殊字符"-"和"_"。 最小長度:0 最大長度:43 |
響應(yīng)參數(shù)
無
請求示例
創(chuàng)建一個共享標(biāo)簽,標(biāo)簽的鍵為“key1”,標(biāo)簽的值為“value1”。
{ "tag" : { "key" : "key1", "value" : "value1" } }
響應(yīng)示例
無
狀態(tài)碼
狀態(tài)碼 |
描述 |
---|---|
204 |
創(chuàng)建共享標(biāo)簽請求下發(fā)成功 |
錯誤碼
請參見錯誤碼。