查询指标维度值
更新时间：2026-06-26
查询指标维度值
查询指定指标的维度可选值列表，该接口支持级联查询，可用于构建监控维度的联动选择器。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v3/bcm/query?action=DescribeDimensionValues HTTP/1.1
2Host: bcm.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "scope": "BCE_BCC",
7 "resourceType": "Instance",
8 "region": "bj",
9 "beginDatetime": "2024-10-11T10:10:10Z",
10 "endDatetime": "2024-10-11T10:10:10Z",
11 "metricName": "XGpuUsage",
12 "dimensionKey": "gpu",
13 "filters": [
14 {
15 "key": "InstanceId",
16 "op": "=",
17 "value": "i-1234567",
18 "values": []
19 }
20 ]
21}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为v3 |
| action | String | 是 | URL参数 | API接口名称，当前取值为DescribeDimensionValues |
| scope | String | 是 | RequestBody参数 | 云产品类型，如BCE_BCC |
| resourceType | String | 否 | RequestBody参数 | 云产品资源类型，如Instance |
| region | String | 否 | RequestBody参数 | 地域 |
| beginDatetime | String | 是 | RequestBody参数 | 开始时间，UTC时间，如 2024-10-11T10:10:10Z |
| endDatetime | String | 是 | RequestBody参数 | 结束时间，UTC时间，如 2024-10-11T10:10:10Z |
| metricName | String | 是 | RequestBody参数 | 指标名 |
| dimensionKey | String | 是 | RequestBody参数 | 维度名，要查询的维度key |
| filters | List<Filter> | 是 | RequestBody参数 | 过滤项列表，填入已选的指标维度值，用于级联查询 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 状态码 |
| message | String | 若发生错误，返回错误信息 |
| values | List |
维度值列表 |
请求示例
Plain Text
1POST /v3/bcm/query?action=DescribeDimensionValues HTTP/1.1
2HOST bcm.bj.baidubce.com
3Authorization bce-auth-v1/afncsdk2bsfs/2024-10-11T10:10:10Z/1800/host/xxx
4
5{
6 "scope": "BCE_BCC",
7 "resourceType": "Instance",
8 "region": "bj",
9 "beginDatetime": "2024-10-11T10:10:10Z",
10 "endDatetime": "2024-10-11T10:10:10Z",
11 "metricName": "XGpuUsage",
12 "dimensionKey": "gpu",
13 "filters": [
14 {
15 "key": "InstanceId",
16 "op": "=",
17 "value": "i-1234567",
18 "values": []
19 }
20 ]
21}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 2e36e271-8f76-4dfe-b1a0-5daf38a0b21d
3Date: Fri, 11 Oct 2024 10:10:10 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "success": true,
10 "code": "OK",
11 "message": "",
12 "values": [
13 "gpu0",
14 "gpu1"
15 ]
16}评价此篇文章