華為云計算 云知識 批量添加共享標簽BatchAddSharedTags
批量添加共享標簽BatchAddSharedTags

 

功能介紹

指定共享批量添加標簽。

一個共享上最多有10個標簽。 一個共享上的多個標簽的key不允許重復。 此接口為冪等接口:如果要添加的key在共享上已存在,則覆蓋更新標簽。

調試

您可以在API Explorer中調試該接口,支持自動認證鑒權。API Explorer可以自動生成SDK代碼示例,并提供SDK代碼示例調試功能。

URI

POST /v1/{project_id}/sfs-turbo/{share_id}/tags/action

表1 路徑參數

參數

是否必選

參數類型

描述

project_id

String

項目ID

share_id

String

共享ID

請求參數

表2 請求Header參數

參數

是否必選

參數類型

描述

X-Auth-Token

String

帳號的token

Content-Type

String

MIME類型

表3 請求Body參數

參數

是否必選

參數類型

描述

action

String

操作標識,取值范圍為:create。 為指定共享批量添加標簽時使用create。

枚舉值:

  • create

tags

Array of ResourceTag objects

標簽列表。 用戶權限時該字段必選。

表4 ResourceTag

參數

是否必選

參數類型

描述

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

批量添加共享標簽成功

錯誤碼

請參見錯誤碼