文档首页/ 数据仓库服务 DWS/ 更多文档/ API参考（联盟区域）/ API说明/ 主机监控/ 查询历史监控数据
更新时间：2025-12-10 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询历史监控数据

功能介绍

查询历史监控数据。

调用方法

请参见如何调用API。

URI

GET /v1.0/{project_id}/dms/metric-data

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID。获取方法请参见获取项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

from

是

String

参数解释：

开始时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

to

是

String

参数解释：

结束时间。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

function

否

String

参数解释：

取值方法。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

period

否

String

参数解释：

取值周期。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

indicator_name

是

String

参数解释：

指标名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

dim0

是

String

参数解释：

第一层级。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

dim1

否

String

参数解释：

第二层级。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

无

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

[数组元素]

Array of TrendQueryDataResp objects

参数解释：

历史监控数据响应。

取值范围：

不涉及。
表4 TrendQueryDataResp

参数

参数类型

描述

query_time

Long

参数解释：

查询时间。

取值范围：

不涉及。

indicator_name

String

参数解释：

监控指标名称。

取值范围：

不涉及。

object_id

String

参数解释：

监控对象ID。

取值范围：

不涉及。

unit

String

参数解释：

单位。

取值范围：

不涉及。

sub_object_id

String

参数解释：

次级监控ID。

取值范围：

不涉及。

data_points

Array of TrendQueryData objects

参数解释：

节点数据。

取值范围：

不涉及。
表5 TrendQueryData

参数

参数类型

描述

result

String

参数解释：

查询结果。

取值范围：

不涉及。

timestamp

Long

参数解释：

时间戳。

取值范围：

不涉及。

请求示例

https://{Endpoint}/v1.0/05f2cff45100d5112f4bc00b794ea08e/dms/metric-data

响应示例

状态码：200

查询历史监控数据成功。

[ {
  "query_time" : 1671160536504,
  "indicator_name" : "cluster cpu_usage",
  "object_id" : "de658e95-5284-4adf-b6aa-7729b563dcb7",
  "unit" : "percentage",
  "data_points" : [ {
    "result" : "10.20",
    "timestamp" : 1671058114000
  }, {
    "result" : "10.20",
    "timestamp" : 1671058144000
  } ]
} ]

状态码

状态码

描述

200

查询历史监控数据成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。
父主题： 主机监控