托管 Prometheus
托管 Prometheus
托管 Prometheus
文档指南
请输入
产品动态
Prometheus 基础知识
用户指南
工作区
告警中心
接入指南
容器与自建集群接入
自建 Kubernetes 集群接入
最佳实践
Prometheus 数据采集与接入
资源与业务监控
工作区数据写入和查询
多渠道告警通知
API 参考
工作区
告警中心
联系人
告警规则
告警静默策略
SDK 参考
指标参考
容器服务指标
常见问题
视频帮助
- 文档首页
托管 PrometheusAPI 参考资源标签ListTagsForResources
复制全文
下载 pdfListTagsForResources
文档反馈
问问助手获取资源的标签列表。
请求说明
- 请求方式：POST
- 请求地址：https://vmp.cn-beijing.volcengineapi.com?Action=ListTagsForResources&Version=2021-03-03
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
Action | String | 是 | ListTagsForResources | 接口名称。当前 API 的名称为 ListTagsForResources。 |
Version | String | 是 | 2021-03-03 | 接口版本。当前 API 的版本为 2021-03-03。 |
TagFilters | 否 | - | 标签过滤条件。 | |
ResourceType | String | 是 | Workspace | 资源类型，当前仅支持Workspace，即工作区。 |
ResourceIds | Array of String | 否 | ["e28ae750-bbb8-4ff4-abf4***"] | 资源 ID。 |
NextToken | String | 否 | 1 | 当前页数，最小值或默认值均为 1。 |
MaxResults | Long | 否 | 10 | 单页数量:
|
TagFilter
参数 | 类型 | 是否必选 | 示例值 | 描述 |
参数 | 类型 | 是否必选 | 示例值 | 描述 |
Key | String | 是 | doc | 标签的 Key。 |
Values | Array of String | 否 | demo | 标签的 Vlaue。 |
请求示例
POST https://vmp.cn-beijing.volcengineapi.com?Action=ListTagsForResources&Version=2021-03-03
Content-Type: application/json
{
"TagFilters": [
{
"Key": "doc",
"Values": [
""
]
}
],
"ResourceType": "Workspace",
"ResourceIds": [
"e28ae750-bbb8-4ff4-abf4***"
],
"NextToken": "1",
"MaxResults": 10
}
返回参数
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
NextToken | String | 1 | 当前页数，最小值或默认值均为 1。 |
ResourceTags | - | 符合筛选条件的资源和标签。 |
ResourceTag
参数 | 类型 | 示例值 | 描述 |
参数 | 类型 | 示例值 | 描述 |
TagKey | String | doc | 标签的 Key。 |
TagValue | String | demo | 标签的 Value。 |
ResourceID | String | ["e28ae750-bbb8-4ff4-abf4***"] | 资源 ID。 |
ResourceType | String | workspace | 资源类型，当前仅支持workspace，即工作区。 |
返回示例
HTTP/1.1: 200 OK
Content-Type: application/json
{
"ResponseMetadata": {
"RequestId": "20230604110420****100232280022D31",
"Action": "ListTagsForResources",
"Version": "2021-03-03",
"Service": "vmp",
"Region": "cn-beijing"
},
"Result": {
"NextToken": "1",
"ResourceTags": [
{
"TagKey": "doc",
"TagValue": "demo",
"ResourceID": "["e28ae750-bbb8-4ff4-abf4***"]",
"ResourceType": "workspace"
}
]
}
}
错误码
HTTP 状态码 | 错误码 | 错误信息 | 说明 |
HTTP 状态码 | 错误码 | 错误信息 | 说明 |
403 | ProductUnsubscribed | You are not subscribed to VMP. Please go to the VMP console web page to subscribe to the service | 当前账号未订阅 VMP 服务。 |
400 | InvalidParameter.{{parameter}} | The specified parameter {{parameter}} is invalid. | 输入不合法，如工作区名称不合法等。 |
400 | MissingParameter.{{parameter}} | The required parameter {{parameter}} is missing. | 缺少必要的参数。 |
最近更新时间：2025.11.05 17:12:27
这个页面对您有帮助吗？
有用
有用
无用
无用