【GaussDB】查询实例标签

查询实例标签

功能介绍

查询指定实例的用户标签信息。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

调试

您可以在API Explorer中调试该接口。

URI

GET https://{

Endpoint

}/v3/{project_id}/instances/{instance_id}/tags

表1 参数说明

名称

是否必选

说明

project_id

是

参数解释：

租户在某一Region下的项目ID。

获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

instance_id

是

实例ID。

请求参数

无。

响应参数

表2 参数说明

参数

参数类型

描述

tags

Array of objects

用户标签列表。

详情请参见表3。

total_count

Integer

总记录数。

表3 tags字段数据结构说明

参数

参数类型

描述

key

String

标签键。

value

Array of strings

标签值。

请求示例

GET https://gaussdb-opengauss.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/tags

响应示例

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

状态码

• 正常

  200

• 异常

  请参见状态码。

错误码

请参见错误码。