華為云計(jì)算 云知識(shí) 批量添加共享標(biāo)簽BatchAddSharedTags
批量添加共享標(biāo)簽BatchAddSharedTags

 

功能介紹

指定共享批量添加標(biāo)簽。

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

調(diào)試

您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。

URI

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

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID

share_id

String

共享ID

請(qǐng)求參數(shù)

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

帳號(hào)的token

Content-Type

String

MIME類型

表3 請(qǐng)求Body參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

action

String

操作標(biāo)識(shí),取值范圍為:create。 為指定共享批量添加標(biāo)簽時(shí)使用create。

枚舉值:

  • create

tags

Array of ResourceTag objects

標(biāo)簽列表。 用戶權(quán)限時(shí)該字段必選。

表4 ResourceTag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

標(biāo)簽的鍵。

最大長(zhǎng)度36個(gè)字符。

key不能為空,不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大寫字母、小寫字母、數(shù)字,特殊字符"-"和"_"。

最小長(zhǎng)度:1

最大長(zhǎng)度:36

value

String

標(biāo)簽的值。

每個(gè)值最大長(zhǎng)度43個(gè)字符,可以為空字符串。

不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。只能包含大寫字母、小寫字母、數(shù)字,特殊字符"-"和"_"。

最小長(zhǎng)度:0

最大長(zhǎng)度:43

響應(yīng)參數(shù)

無(wú)

請(qǐng)求示例

批量添加共享標(biāo)簽,第一個(gè)標(biāo)簽的鍵為“key1”,值為“value1”;第二個(gè)標(biāo)簽的鍵為“key2”,值為“value1”。

{
  "action" : "create",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value1"
  } ]
}

響應(yīng)示例

無(wú)

狀態(tài)碼

狀態(tài)碼

描述

204

批量添加共享標(biāo)簽成功

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼。