文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 标签管理/ 查询实例标签
更新时间：2024-08-20 GMT+08:00
查看PDF
分享

查询实例标签

功能介绍

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

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.ap-southeast-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in14/tags

响应示例

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

状态码

错误码

请参见错误码。

父主题： 标签管理