功能介紹
查詢指定實例的標(biāo)簽信息 標(biāo)簽管理服務(wù)需要使用該接口查詢指定實例的全部標(biāo)簽數(shù)據(jù)
調(diào)試
您可以在API Explorer中調(diào)試該接口，支持自動認(rèn)證鑒權(quán)。API Explorer可以自動生成SDK代碼示例，并提供SDK代碼示例調(diào)試功能。
URI
GET /v3/{project_id}/vault/{vault_id}/tags
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
項目id |
|
vault_id |
是 |
String |
資源id |
請求參數(shù)
無
響應(yīng)參數(shù)
狀態(tài)碼： 200
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
tags |
標(biāo)簽列表 tags中key不重復(fù) |
|
|
sys_tags |
僅op_service權(quán)限才可以獲取此字段： 目前只包含一個resource_tag結(jié)構(gòu)體 key：_sys_enterprise_project_id value：企業(yè)項目id。0表示默認(rèn)企業(yè)項目 非op_service場景不能返回此字段。 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
key |
String |
鍵。 key最大長度為36個字符。 key不能為空字符串。 key前后空格會被丟棄。 key不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 key只能由中文，字母，數(shù)字，“-”，“_”組成。 |
|
value |
String |
值。 添加標(biāo)簽時value值必選，刪除標(biāo)簽時value值可選。 value最大長度為43個字符。 value可以為空字符串。 value前后的空格會被丟棄。 value不能包含非打印字符ASCII(0-31)，“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”。 value只能由中文，字母，數(shù)字，“-”，“_”，“.”組成。 |
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
key |
String |
鍵。 系統(tǒng)標(biāo)簽的key，從白名單中取，不能隨意定義。 目前僅支持 _sys_enterprise_project_id字段，對應(yīng) 的value為企業(yè)項目ID。 |
|
value |
String |
值。 目前僅會用到企業(yè)項目ID，其中默認(rèn)的企業(yè)項目ID為“0”。 |
狀態(tài)碼： 400
|
參數(shù) |
參數(shù)類型 |
描述 |
|---|---|---|
|
error_code |
String |
請參見錯誤碼。 |
|
error_msg |
String |
錯誤信息 |
請求示例
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 |
錯誤碼
請參見錯誤碼。
