文档中心

表格数据库 HBase 版

标签管理

DescribeTagsByResource

DescribeTagsByResource

调用 DescribeTagsByResource 接口查询实例已绑定的标签信息。

请求类型

同步请求。

请求参数

参数	类型	是否必选	示例值	描述
InstanceIds	Array of String	是	[ "hb-cncqbedcce3c**", "hb-cncqbedcce3c**" ]	需要查询已绑定标签的实例 ID。说明支持一次传入多个实例 ID，多个实例之间用英文逗号（,）分隔。最多同时传入 50 个实例 ID。您可以调用 DescribeDBInstances 接口查询目标地域下所有 HBase 实例的基本信息，包括实例 ID。
TagFilters	Array of TagFilterObject	否	请参见请求示例。	用于查询筛选的标签键值对数组。说明当需要使用标签对查询结果进行筛选时，标签键（Key）必填，标签值（Value）可不填，不填标签值表示不对标签值作限制，会搜索所有绑定了指定标签键的实例。单次最多支持同时传入 10 组标签键值对进行查询筛选。
PageSize	Integer	是	10	每页记录数，取值范围为 1~1000。
PageNumber	Integer	是	1	实例标签信息列表的页码，取值为不超过 Integer 数据类型的最大值，起始值为 1。

TagFilterObject

参数	类型	是否必选	示例值	描述
Key	String	是	instancetype	用于查询筛选的标签键。说明如需使用标签对实例进行查询筛选，该参数必填。允许传入重复的标签键。单次最多支持同时传入 10 个标签进行查询筛选。
Value	String	否	cluster	用于查询筛选的标签键所对应的标签值。说明若该参数留空，表示不对标签值作限制，会筛选所有绑定了指定标签键的实例。若传入空字符串，表示筛选对应标签键下，标签值为空的实例。

返回参数

参数	类型	示例值	描述
Total	Integer	3	符合查询条件的结果总数。
TagResources	Array of TagResource	请参见返回示例。	实例绑定的标签信息。

TagResource

参数	类型	示例值	描述
Key	String	instancetype	实例所绑定的标签键。
Value	String	cluster	实例所绑定标签键对应的值。
InstanceId	String	hb-cn019f341d51****	实例 ID。

示例

请求示例

返回示例

最近更新时间：2025.09.02 20:34:28

这个页面对您有帮助吗？

有用

有用

无用

无用