查标签接口。
接口说明
请求中至少指定以下任一参数,以确定查询对象。
- 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
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 地域 | cn-hangzhou |
| ResourceType | string | 是 | 资源类型 枚举值:
| ResourceGroup |
| ResourceId | array | 否 | 资源 ID,最多 50 个子项 | |
| string | 否 | 资源 ID。一次调用最多支持添加 50 个资源 ID。 | [\"rgrk6hhjpvio3wvj\"] | |
| Tag | array<object> | 否 | 对应新增标签列表,最多包含 20 个子项 | |
| object | 否 | 指定规则所适用的对象标签,可设置多个。 | ||
| Key | string | 否 | 标签键 | TestKey |
| Value | string | 否 | 标签值 | TestValue |
| NextToken | string | 否 | 下一个查询开始 Token | ad31d453a1f3f23ce0b5e8707e68181f |
返回参数
示例
正常返回示例
JSON格式
{
"RequestId": "CE22EE94-8AFE-53B5-9C2C-B36207B1CBF9",
"NextToken": "3iEiu84Yk3TwHLzJV.usagf1Ain49xYKGoB6zffsDqPYZQQ5",
"TagResources": [
{
"TagKey": "tagKey",
"TagValue": "tagValue",
"ResourceId": "rgqssemfn6vjqqev",
"ResourceType": "ResourceGroup"
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 2025-12-09 | 新增 OpenAPI | 查看变更详情 |
