查询数据接口
更新时间：2025-08-20
接口描述
获取指定指标的一个或多个统计数据的时间序列数据。可获取云产品监控数据、站点监控数据或您推送的自定义监控数据。
接口限制
• 一次返回的数据点数目不能超过1440个。
请求参数
| 名称 | 类型 | 描述 | 是否必须 | 参数位置 |
|---|---|---|---|---|
| user_id | String | 租户ID | 是 | URL参数 |
| scope | String，仅限于使用如下字符集合："0~9、A~Z、a~z"、 "_" | 名字空间 | 是 | URL参数 |
| metric_name | String，仅限于使用如下字符集合："0~9、A~Z、a~z"、 "_" | 监控指标名 | 是 | URL参数 |
| statistics | Statistics，按照statistics1,statistics2,statistics3格式，可选值为average,maximum,minimum,sum,sampleCount | 统计方法类型 | 是 | Query参数 |
| dimensions | String，由dimensionName:dimensionValue组成。当监控项具备多个维度时使用分号连接，例如dimensionName:dimensionValue;dimensionName:dimensionValue，相同维度只能指定一个维度值 | 维度列表 | 是 | Query参数 |
| start_time | DateTime,请参考日期与时间，UTC日期表示 | 查询起始时间 | 是 | Query参数 |
| end_time | DateTime,请参考日期与时间，UTC日期表示 | 查询截止时间 | 是 | Query参数 |
| period_in_second | Integer，60的倍数，单位：秒（s） | 统计周期 | 是 | Query参数 |
参数解释
- 名字空间scope、监控项metric、统计方法Statistic、维度Dimension等的概念请参考核心概念。
响应参数
| 名称 | 类型 | 描述 |
|---|---|---|
| request_id | String | 请求标识 |
| code | String | 返回码 |
| message | String | 错误信息 |
| data_points | List（data_point） | 监控指标 |
data_point
| 名称 | 类型 | 描述 |
|---|---|---|
| average | double | 统计周期内监控项的平均值 |
| sum | double | 统计周期内监控项的和值 |
| minimum | double | 统计周期内监控项的最小值 |
| maximum | double | 统计周期内监控项的最大值 |
| sample_count | Integer | 统计周期内监控项数据点数 |
| timestamp | DateTime,请参考日期与时间，UTC日期表示 | 监控项统计周期对应的时间 |
请求示例
Python
1 # params definition
2 user_id = "fakeuser1ba678asdf8as7df6a5sdf67"
3 scope = "BCE_BCC"
4 metric_name = "vCPUUsagePercent"
5 dimensions = "InstanceId:fakeid-2222-8888-1111-13a8469b1fb2"
6 statistics = "average,maximum,minimum"
7 start_time = "2019-04-16T13:55:01Z"
8 end_time = "2019-04-16T14:00:01Z"
9 period_in_second = 60
10
11 # create a bcm client
12 bcm_client = BcmClient(bcm_sample_conf.config)
13
14 # query metric data from bcm interface
15 try:
16 response = bcm_client.get_metric_data(user_id=user_id,
17 scope=scope,
18 metric_name=metric_name,
19 dimensions=dimensions,
20 statistics=statistics,
21 start_time=start_time,
22 end_time=end_time,
23 period_in_second=period_in_second)
24 print(response)
25 except BceHttpClientError as e:
26 if isinstance(e.last_error, BceServerError):
27 __logger.error('send request failed. Response %s, code: %s, msg: %s'
28 % (e.last_error.status_code, e.last_error.code, e.last_error.message))
29 else:
30 __logger.error('send request failed. Unknown exception: %s' % e)