功能介紹
查詢指定 云硬盤 的標(biāo)簽信息。
調(diào)試
您可以在API Explorer中調(diào)試該接口,支持自動(dòng)認(rèn)證鑒權(quán)。API Explorer可以自動(dòng)生成SDK代碼示例,并提供SDK代碼示例調(diào)試功能。
URI
GET /v2/{project_id}/cloudvolumes/{volume_id}/tags
參數(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。 通過調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)。 |
響應(yīng)參數(shù)
狀態(tài)碼: 200
參數(shù) |
參數(shù)類型 |
描述 |
---|---|---|
key |
String |
標(biāo)簽鍵。同一資源的key值不能重復(fù)。 最大長度36個(gè)字符。 字符集:A-Z,a-z , 0-9,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。 |
value |
String |
標(biāo)簽值。 最大長度43個(gè)字符。 字符集:A-Z,a-z , 0-9,‘.’,‘-’,‘_’,UNICODE字符(\u4E00-\u9FFF)。 |
狀態(tài)碼: 400
參數(shù) |
參數(shù)類型 |
描述 |
---|---|---|
error |
出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤信息,具體請(qǐng)參見 error參數(shù)說明。 |
參數(shù) |
參數(shù)類型 |
描述 |
---|---|---|
code |
String |
出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤碼。錯(cuò)誤碼和其對(duì)應(yīng)的含義請(qǐng)參考錯(cuò)誤碼說明。 |
message |
String |
出現(xiàn)錯(cuò)誤時(shí),返回的錯(cuò)誤消息。 |
請(qǐng)求示例
GET https://{endpoint}/v2/{project_id}/cloudvolumes/{volume_id}/tags
響應(yīng)示例
狀態(tài)碼: 200
標(biāo)簽列表。
{ "tags" : [ { "value" : "value1", "key" : "key1" }, { "value" : "value2", "key" : "key2" } ] }
狀態(tài)碼: 400
Bad Request
{ "error" : { "message" : "XXXX", "code" : "XXX" } }
狀態(tài)碼
狀態(tài)碼 |
描述 |
---|---|
200 |
標(biāo)簽列表。 |
400 |
Bad Request |
錯(cuò)誤碼
請(qǐng)參見錯(cuò)誤碼。