文档中心

云搜索服务

资源管理

ListTagsForResources - 查询标签资源

根据标签筛选出对应资源。

调试

API Explorer

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

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ListTagsForResources

要执行的操作，取值：ListTagsForResources。

Version string 必选示例值：2023-01-01

API的版本，取值：2023-01-01。

ResourceType string 可选示例值：instance

资源类型，当前仅支持 instance。

ResourceIds string[] 可选示例值：["o-xxxx", "o-yyyy"]

资源 ID 列表。

TagFilters object[] 可选示例值：[{"Key": "key1", "Values": ["value1", "value2"]}]

标签筛选条件。

Key string 必选示例值：KeyA

标签筛选键。

Values string[] 必选示例值：ValueA

标签值列表。

PageNumber integer 可选示例值：1

分页的页数，最小为 1。

PageSize integer 可选示例值：10

分页的单页条数，最大 100。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

DataList object[] 示例值：[{"ResourceType": "INSTANCE", "ResourceId": "o-xxx", "TagKey": "key1", "TagValue": "value"}]

资源标签列表。

ResourceType string 示例值：INSTANCE

资源类型。

ResourceId string 示例值：o-xyz

资源 ID。

TagKey string 示例值：test-key

标签键。

TagValue string 示例值：value1

标签值。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
200	Unauthorized	unauthorized error	用户无权限调用接口。
200	IllegalParameter	illegal parameter	参数非法。原因可能是参数缺失或不符合接口要求。
200	InternalServerError	服务器内部异常	服务由于异常退出，无法完成接口请求操作。

最近更新时间：2026.04.01 10:05:52

这个页面对您有帮助吗？

有用

无用