華為云計(jì)算 云知識(shí) 查詢存儲(chǔ)庫(kù)資源標(biāo)簽ShowVaultTag
查詢存儲(chǔ)庫(kù)資源標(biāo)簽ShowVaultTag

 

功能介紹

查詢指定實(shí)例的標(biāo)簽信息 標(biāo)簽管理服務(wù)需要使用該接口查詢指定實(shí)例的全部標(biāo)簽數(shù)據(jù)

調(diào)試

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

URI

GET /v3/{project_id}/vault/{vault_id}/tags

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目id

vault_id

String

資源id

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

無(wú)

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

tags

Array of Tag objects

標(biāo)簽列表 tags中key不重復(fù)

sys_tags

Array of SysTag objects

僅op_service權(quán)限才可以獲取此字段: 目前只包含一個(gè)resource_tag結(jié)構(gòu)體 key:_sys_enterprise_project_id value:企業(yè)項(xiàng)目id。0表示默認(rèn)企業(yè)項(xiàng)目 非op_service場(chǎng)景不能返回此字段。

表3 Tag

參數(shù)

參數(shù)類型

描述

key

String

鍵。

key最大長(zhǎng)度為36個(gè)字符。

key不能為空字符串。

key前后空格會(huì)被丟棄。

key不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

key只能由中文,字母,數(shù)字,“-”,“_”組成。

value

String

值。

添加標(biāo)簽時(shí)value值必選,刪除標(biāo)簽時(shí)value值可選。

value最大長(zhǎng)度為43個(gè)字符。

value可以為空字符串。

value前后的空格會(huì)被丟棄。

value不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。

value只能由中文,字母,數(shù)字,“-”,“_”,“.”組成。

表4 SysTag

參數(shù)

參數(shù)類型

描述

key

String

鍵。 系統(tǒng)標(biāo)簽的key,從白名單中取,不能隨意定義。 目前僅支持 _sys_enterprise_project_id字段,對(duì)應(yīng) 的value為企業(yè)項(xiàng)目ID。

value

String

值。 目前僅會(huì)用到企業(yè)項(xiàng)目ID,其中默認(rèn)的企業(yè)項(xiàng)目ID為“0”。

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error_code

String

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

error_msg

String

錯(cuò)誤信息

請(qǐng)求示例

GET  https://{endpoint}/v3/{project_id}/vault/{vault_id}/tags

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "tags" : [ {
    "key" : "string",
    "value" : ""
  } ]
}

狀態(tài)碼: 400

Bad Request

{
  "error_code" : "BackupService.9900",
  "error_msg" : "Invalid vault_id provided."
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

錯(cuò)誤碼

請(qǐng)參見(jiàn)錯(cuò)誤碼