ListTagResources - 查询标签列表

查标签接口。

接口说明

请求中至少指定以下任一参数,以确定查询对象。

  • ResourceId.N
  • Tag.N(Tag.N.Key 与 Tag.N.Value)

同时指定下列参数时,返回结果中仅包含同时满足这两个条件的资源。

  • Tag.N 和 ResourceId.N

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /api/v1/tags HTTP/1.1

请求参数

名称类型必填描述示例值
RegionIdstring

地域

cn-hangzhou
ResourceTypestring

资源类型

枚举值:
  • MachineGroupMachineGroup
  • ResourceGroupResourceGroup
ResourceGroup
ResourceIdarray

资源 ID,最多 50 个子项

string

资源 ID。一次调用最多支持添加 50 个资源 ID。

[\"rgrk6hhjpvio3wvj\"]
Tagarray<object>

对应新增标签列表,最多包含 20 个子项

object

指定规则所适用的对象标签,可设置多个。

Keystring

标签键

TestKey
Valuestring

标签值

TestValue
NextTokenstring

下一个查询开始 Token

ad31d453a1f3f23ce0b5e8707e68181f

返回参数

名称类型描述示例值
object
RequestIdstring

请求 id

CE22EE94-8AFE-53B5-9C2C-B36207B1CBF9
NextTokenstring

下一个查询开始 Token

3iEiu84Yk3TwHLzJV.usagf1Ain49xYKGoB6zffsDqPYZQQ5
TagResourcesarray<object>

资源列表

TagResourceobject
TagKeystring

标签键

tagKey
TagValuestring

标签值

tagValue
ResourceIdstring

资源 ID

rgqssemfn6vjqqev
ResourceTypestring

资源类型

ResourceGroup

示例

正常返回示例

JSON格式

{
  "RequestId": "CE22EE94-8AFE-53B5-9C2C-B36207B1CBF9",
  "NextToken": "3iEiu84Yk3TwHLzJV.usagf1Ain49xYKGoB6zffsDqPYZQQ5",
  "TagResources": [
    {
      "TagKey": "tagKey",
      "TagValue": "tagValue",
      "ResourceId": "rgqssemfn6vjqqev",
      "ResourceType": "ResourceGroup"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2025-12-09新增 OpenAPI查看变更详情