调用DescribeHybridMonitorDataList接口查询指定指标仓库中的监控数据。

接口说明

前提条件

请确保您已开通企业云监控。具体操作，请参见开通企业云监控。

使用限制

单次最多返回监控数据 1.5 MB。如果返回数据过大，则查询失败，请您重新设置查询条件。

使用说明

本文将提供一个示例，查询指标仓库default-aliyun中监控指标AliyunEcs_cpu_total在指定时间1653804865（2022-05-29 14:14:25）至1653805225（2022-05-29 14:20:25）内的监控数据。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
Namespace	string	是	指标仓库名称。关于如何获取指标仓库名称，请参见 DescribeHybridMonitorNamespaceList 。	default-aliyun
PromSQL	string	是	监控指标。说明支持 PromQL 查询语句。	AliyunEcs_cpu_total
Start	long	是	开始时间戳。单位：秒。	1653804865
End	long	是	结束时间戳。单位：秒。	1653805225
Period	string	否	监控数据的统计周期。单位：秒。	60

关于公共请求参数的详情，请参见公共参数。

返回参数

名称	类型	描述	示例值
	object	无。
Code	string	状态码。说明 200 表示成功。	200
Message	string	错误信息。	end timestamp must not be before start time.
RequestId	string	请求 ID。	C240412F-3F5F-50E2-ACEC-DE808EF9C4BE
Success	string	操作是否成功。取值： true：成功。 false：失败。	true
TimeSeries	object []	监控指标的时间线列表。
MetricName	string	监控指标名称。	AliyunEcs_cpu_total
Labels	object []	时间维度的标签。
K	string	标签键。	instanceId
V	string	标签值。	i-rj99xc6cptkk64ml****
Values	object []	时间点的值。
V	string	监控指标的值。	0.13
Ts	string	监控指标值对应的时间戳。单位：秒。	1653804865

示例

正常返回示例

JSON格式

{
  "Code": "200",
  "Message": "end timestamp must not be before start time.",
  "RequestId": "C240412F-3F5F-50E2-ACEC-DE808EF9C4BE",
  "Success": "true",
  "TimeSeries": [
    {
      "MetricName": "AliyunEcs_cpu_total",
      "Labels": [
        {
          "K": "instanceId",
          "V": "i-rj99xc6cptkk64ml****"
        }
      ],
      "Values": [
        {
          "V": "0.13",
          "Ts": "1653804865"
        }
      ]
    }
  ]
}

错误码

HTTP status code	错误码	错误信息
400	%s	%s
400	BadRequest	%s
409	%s	Resources already exist.
500	InternalError	%s

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2022-05-30

OpenAPI 错误码发生变更

看变更集

变更项	变更内容
错误码	OpenAPI 错误码发生变更。
	错误码 400 变更
	删除错误码：403
	删除错误码：404
	删除错误码：409
	删除错误码：500

2022-05-24

新增 OpenAPI

看变更集