功能介紹
為指定 云硬盤 批量添加標(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
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項(xiàng)目ID。 獲取方法請(qǐng)參見"獲取項(xiàng)目ID"。 |
|
volume_id |
是 |
String |
云硬盤ID。 |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用戶Token。 通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
action |
是 |
String |
操作標(biāo)識(shí),當(dāng)前支持的取值如下: 添加標(biāo)簽:create 缺省值:create 枚舉值:
|
|
tags |
是 |
標(biāo)簽列表。 |
響應(yīng)參數(shù)
狀態(tài)碼: 400
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
error |
出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤信息,具體請(qǐng)參見 error參數(shù)說(shuō)明。 |
|
參數(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ò)誤碼。
