華為云計算 云知識 查詢云硬盤標簽ShowVolumeTags
查詢云硬盤標簽ShowVolumeTags

 

功能介紹

查詢指定 云硬盤 的標簽信息。

調(diào)試

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

URI

GET /v2/{project_id}/cloudvolumes/{volume_id}/tags

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項目ID。 獲取方法請參見"獲取項目ID"。

volume_id

String

云硬盤ID

請求參數(shù)

表2 請求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。 通過調(diào)用 IAM 服務獲取用戶Token接口獲?。憫㈩^中X-Subject-Token的值)。

響應參數(shù)

狀態(tài)碼: 200

表3 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

tags

Array of Tag objects

標簽列表。

表4 Tag

參數(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

表5 響應Body參數(shù)

參數(shù)

參數(shù)類型

描述

error

Error object

出現(xiàn)錯誤時,返回的錯誤信息,具體請參見 error參數(shù)說明。

表6 Error

參數(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

錯誤碼

請參見錯誤碼。