查询监控指标最新数据点
更新时间：2026-06-26
查询指标值Latest
查询云产品监控指标的最新数据点，该接口返回每条时序曲线的最新一个数据点，可用于实时监控看板展示最新指标状态。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v3/bcm/query?action=DescribeMetricDataLatest HTTP/1.1
2Host: bcm.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "scope": "BCE_BCC",
7 "resourceType": "Instance",
8 "region": "bj",
9 "endDatetime": "2024-10-11T10:25:10Z",
10 "metricName": "CPUUsage",
11 "filters": [
12 {
13 "key": "InstanceId",
14 "op": "=",
15 "value": "i-1234567",
16 "values": []
17 }
18 ],
19 "limit": 10,
20 "offset": 0,
21 "periodSeconds": 60,
22 "aggregationOverTime": ["avg", "max"]
23}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为v3 |
| action | String | 是 | URL参数 | API接口名称，当前取值为DescribeMetricDataLatest |
| scope | String | 是 | RequestBody参数 | 云产品类型，如BCE_BCC |
| resourceType | String | 否 | RequestBody参数 | 云产品资源类型，如Instance。目前不参与查询条件，仅用于检查filters中必需包含resourceType对应的全部identifiers属性 |
| region | String | 是 | RequestBody参数 | 地域 |
| endDatetime | String | 是 | RequestBody参数 | 结束时间，UTC时间，如 2024-10-11T10:25:10Z |
| metricName | String | 是 | RequestBody参数 | 指标名 |
| filters | List<Filter> | 是 | RequestBody参数 | 维度过滤项列表，必须包含该资源类型下所有的Resource.Identifiers维度 |
| limit | Integer | 否 | RequestBody参数 | 若查询命中多条曲线，则最多返回limit条曲线，默认值：10，最大值：100 |
| offset | Integer | 否 | RequestBody参数 | 偏移量，用于翻页查询，默认值：0 |
| periodSeconds | Integer | 否 | RequestBody参数 | 周期，单位：秒，默认值：60 |
| aggregationOverTime | List |
否 | RequestBody参数 | 统计方式（时间轴聚合方式），默认值：["avg"]，可选值：avg / sum / max / min / count |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 状态码 |
| message | String | 若发生错误，返回错误信息 |
| timeseries | List<Timeseries> | 时序数据列表，每条曲线只包含最新的一个数据点 |
请求示例
Plain Text
1POST /v3/bcm/query?action=DescribeMetricDataLatest 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 "endDatetime": "2024-10-11T10:25:10Z",
10 "metricName": "CPUUsage",
11 "filters": [
12 {
13 "key": "InstanceId",
14 "op": "=",
15 "value": "i-1234567",
16 "values": []
17 }
18 ],
19 "limit": 10,
20 "offset": 0,
21 "periodSeconds": 60,
22 "aggregationOverTime": ["avg", "max"]
23}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 2e36e271-8f76-4dfe-b1a0-5daf38a0b21d
3Date: Fri, 11 Oct 2024 10:25: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 "timeseries": [
13 {
14 "metricName": "XGpuUsage",
15 "dimensions": [
16 {
17 "key": "instanceId",
18 "value": "i-1234567"
19 },
20 {
21 "key": "gpu",
22 "value": "gpu1"
23 }
24 ],
25 "dataPoints": [
26 {
27 "timestamp": 1656428160000,
28 "avg": 100,
29 "max": 103,
30 "min": 97,
31 "sum": 200,
32 "count": 2
33 }
34 ]
35 }
36 ]
37}评价此篇文章