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