華為云計(jì)算 云知識(shí) 查詢特定資源標(biāo)簽ShowResourceTagsga
查詢特定資源標(biāo)簽ShowResourceTagsga

 

功能介紹

查詢特定資源標(biāo)簽。

調(diào)用方法

請(qǐng)參見(jiàn)如何調(diào)用API。

URI

GET /v1/{resource_type}/{resource_id}/tags

表1 路徑參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

resource_type

Object

資源類(lèi)型。

resource_id

String

資源ID。

最小長(zhǎng)度:1

最大長(zhǎng)度:36

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

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

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

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ù)類(lèi)型

描述

tags

Array of ResourceTag objects

標(biāo)簽列表。

request_id

String

請(qǐng)求ID。

表4 ResourceTag

參數(shù)

參數(shù)類(lèi)型

描述

key

String

標(biāo)簽鍵,規(guī)則:

  • 1.key不能為空,長(zhǎng)度1~128個(gè)字符(中文也可以輸入128個(gè)字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : = + - @。

  • 3._sys_開(kāi)頭屬于系統(tǒng)標(biāo)簽,租戶不能輸入。

最小長(zhǎng)度:1

最大長(zhǎng)度:128

value

String

標(biāo)簽值,規(guī)則:

  • 1.長(zhǎng)度0~255個(gè)字符(中文也可以輸入255個(gè)字符)。

  • 2.可用 UTF-8 格式表示的字母(包含中文)、數(shù)字和空格,以及以下字符_ . : / = + - @。

  • 3.資源標(biāo)簽值可以為空(empty or null)。

最小長(zhǎng)度:0

最大長(zhǎng)度:255

請(qǐng)求示例

查詢特定資源標(biāo)簽

GET https://{ga_endpoint}/v1/{resource_type}/{resource_id}/tags

響應(yīng)示例

狀態(tài)碼: 200

操作成功

{
  "tags" : [ {
    "key" : "tagKey",
    "value" : "tagValue"
  } ],
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

狀態(tài)碼

狀態(tài)碼

描述

200

操作成功

錯(cuò)誤碼

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