華為云計(jì)算 云知識(shí) 查詢保護(hù)實(shí)例標(biāo)簽ListProtectedInstanceTags
查詢保護(hù)實(shí)例標(biāo)簽ListProtectedInstanceTags

 

功能介紹

查詢指定保護(hù)實(shí)例的標(biāo)簽信息。

接口約束

無(wú)

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /v1/{project_id}/protected-instances/{protected_instance_id}/tags

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

project_id

String

項(xiàng)目ID。

protected_instance_id

String

保護(hù)實(shí)例的ID。

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

表2 請(qǐng)求Header參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

X-Auth-Token

String

用戶Token。通過(guò)調(diào)用 IAM 服務(wù)獲取用戶Token接口獲?。憫?yīng)消息頭中X-Subject-Token的值)

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

狀態(tài)碼: 200

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

參數(shù)

參數(shù)類型

描述

tags

Array of ResourceTag objects

標(biāo)簽列表。

表4 ResourceTag

參數(shù)

參數(shù)類型

描述

key

String

鍵。同一資源的key值不能重復(fù)。最大長(zhǎng)度為36個(gè)UNICODE字符。key不能為空,不允許為空字符串。不能包含以下字符:非打印字符ASCII(0-31)特殊字符“*”,“<”,“>”,“\”,“=”,“,”,“|”,“/”鍵。不能為空。對(duì)于同一資源鍵值唯一。

value

String

值。最大長(zhǎng)度為43個(gè)UNICODE字符。value不能為空,可以為空字符串。不能包含以下字符:非打印字符ASCII(0-31)特殊字符“*”,“<”,“>”,“\”,“=”,“,”,“|”,“/”。長(zhǎng)度不超過(guò)43個(gè)字符。

狀態(tài)碼: 400

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表6 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 401

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表8 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 403

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表10 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 404

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表12 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

狀態(tài)碼: 500

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

參數(shù)

參數(shù)類型

描述

error

ErrorInfo object

失敗返回結(jié)構(gòu)

表14 ErrorInfo

參數(shù)

參數(shù)類型

描述

message

String

錯(cuò)誤信息

code

String

錯(cuò)誤碼

請(qǐng)求示例

GET https://{Endpoint}/v1/{project_id}/protected-instances/50f5091e-9e9e-473c-a932-2a2cbcbeb1ff/tags

響應(yīng)示例

狀態(tài)碼: 200

OK

{
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  }, {
    "key" : "key2",
    "value" : "value3"
  } ]
}

狀態(tài)碼

狀態(tài)碼

描述

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

錯(cuò)誤碼

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