文档中心

云数据库 MySQL 版

实例管理

DescribeTagsByResource - 查询实例的标签

DescribeTagsByResource - 查询实例的标签

调用 DescribeTagsByResource 接口查询一个或多个 MySQL 实例的标签。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

参数	类型	是否必选	示例值	描述
InstanceIds	Array of String	是	["mysql-46609cf2**","mysql-5564bc65**"]	实例 ID。
TagFilters	Array of TagFilterObject	否	请参见请求示例。	用于查询筛选的标签键值对数组。说明单次最多支持同时传入 10 组标签键值对进行查询筛选。
PageNumber	Integer	是	1	当前页页码。取值最小为 1。
PageSize	Integer	是	10	每页记录数。最小值为 1，最大值不超过 100。

TagFilterObject

参数	类型	是否必选	示例值	描述
Key	String	是	ExampleKey	用于查询筛选的标签键。
Value	String	否	ExampleValue	用于查询筛选的标签值。说明若绑定标签时，设置了标签值，则筛选时该参数必填。
Values	Array of String	否	["ExampleValue1","ExampleValue2"]	用于查询筛选的标签值。说明如果 Value 和 Values 同时存在，优先以 Values 为准。

返回参数

参数	类型	示例值	描述
Total	Integer	2	标签总数。
TagResources	Array of TagResourceObject	请参见返回示例。	实例的标签列表。

TagResourceObject

参数	类型	示例值	描述
InstanceId	String	mysql-d4942fd7****	实例 ID。
Key	String	table1	实例绑定的标签键。
Value	String	table2	实例绑定的标签值。

示例

请求示例

返回示例

错误码

更多详情，请参见错误码。

最近更新时间：2026.04.09 11:58:29

这个页面对您有帮助吗？

有用

有用

无用

无用