華為云計(jì)算 云知識(shí) 為指定云硬盤批量添加標(biāo)簽BatchCreateVolumeTags
為指定云硬盤批量添加標(biāo)簽BatchCreateVolumeTags

 

功能介紹

為指定 云硬盤 批量添加標(biāo)簽。

添加標(biāo)簽時(shí),如果云硬盤的標(biāo)簽已存在相同key,則會(huì)覆蓋已有標(biāo)簽。 單個(gè)云硬盤最多支持創(chuàng)建10個(gè)標(biāo)簽。

調(diào)試

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

URI

POST /v2/{project_id}/cloudvolumes/{volume_id}/tags/action

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID。 獲取方法請(qǐng)參見"獲取項(xiàng)目ID"。

volume_id

String

云硬盤ID。

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

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

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)。

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

參數(shù)

是否必選

參數(shù)類型

描述

action

String

操作標(biāo)識(shí),當(dāng)前支持的取值如下:

添加標(biāo)簽:create

缺省值:create

枚舉值:

  • create

tags

Array of Tag objects

標(biāo)簽列表。

表4 Tag

參數(shù)

是否必選

參數(shù)類型

描述

key

String

標(biāo)簽鍵。同一資源的key值不能重復(fù)。 最大長(zhǎng)度36個(gè)字符。 字符集:A-Z,a-z , 0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。

value

String

標(biāo)簽值。 最大長(zhǎng)度43個(gè)字符。 字符集:A-Z,a-z , 0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。

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

狀態(tài)碼: 400

表5 響應(yīng)Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤信息,具體請(qǐng)參見 error參數(shù)說(shuō)明。

表6 Error

參數(shù)

參數(shù)類型

描述

code

String

出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤碼。錯(cuò)誤碼和其對(duì)應(yīng)的含義請(qǐng)參考錯(cuò)誤碼說(shuō)明。

message

String

出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤消息。

請(qǐng)求示例

添加兩個(gè)標(biāo)簽給一個(gè)指定的云硬盤,一個(gè)標(biāo)簽key為key1,value為value1,另一個(gè)標(biāo)簽key為key2,value為value3。

POST https://{endpoint}/v2/{project_id}/cloudvolumes/{volume_id}/tags/action

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

響應(yīng)示例

狀態(tài)碼: 400

Bad Request

{
  "error" : {
    "message" : "XXXX",
    "code" : "XXX"
  }
}

狀態(tài)碼

狀態(tài)碼

描述

204

No Content

400

Bad Request

錯(cuò)誤碼

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