華為云計算 云知識 創(chuàng)建共享標簽CreateSharedTag
創(chuàng)建共享標簽CreateSharedTag

 

功能介紹

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

調試

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

URI

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

表1 路徑參數

參數

是否必選

參數類型

描述

project_id

String

操作用戶的項目ID

share_id

String

共享ID

請求參數

表2 請求Header參數

參數

是否必選

參數類型

描述

X-Auth-Token

String

帳號的token

Content-Type

String

MIME類型

表3 請求Body參數

參數

是否必選

參數類型

描述

tag

ResourceTag object

resource_tag字段說明

表4 ResourceTag

參數

是否必選

參數類型

描述

key

String

標簽的鍵。

最大長度36個字符。

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

最小長度:1

最大長度:36

value

String

標簽的值。

每個值最大長度43個字符,可以為空字符串。

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

最小長度:0

最大長度:43

響應參數

請求示例

創(chuàng)建一個共享標簽,標簽的鍵為“key1”,標簽的值為“value1”。

{
  "tag" : {
    "key" : "key1",
    "value" : "value1"
  }
}

響應示例

狀態(tài)碼

狀態(tài)碼

描述

204

創(chuàng)建共享標簽請求下發(fā)成功

錯誤碼

請參見錯誤碼。