DescribeHybridMonitorDataList - 查询指定指标仓库中的监控数据

调用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暂无授权信息透出。

请求参数

名称类型必填描述示例值
Namespacestring

指标仓库名称。

关于如何获取指标仓库名称,请参见 DescribeHybridMonitorNamespaceList

default-aliyun
PromSQLstring

监控指标。

说明 支持 PromQL 查询语句。
AliyunEcs_cpu_total
Startlong

开始时间戳。

单位:秒。

1653804865
Endlong

结束时间戳。

单位:秒。

1653805225
Periodstring

监控数据的统计周期。

单位:秒。

60

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

返回参数

名称类型描述示例值
object

无。

Codestring

状态码。

说明 200 表示成功。
200
Messagestring

错误信息。

end timestamp must not be before start time.
RequestIdstring

请求 ID。

C240412F-3F5F-50E2-ACEC-DE808EF9C4BE
Successstring

操作是否成功。取值:

  • true:成功。

  • false:失败。

true
TimeSeriesarray<object>

监控指标的时间线列表。

object

无。

MetricNamestring

监控指标名称。

AliyunEcs_cpu_total
Labelsarray<object>

时间维度的标签。

object

无。

Kstring

标签键。

instanceId
Vstring

标签值。

i-rj99xc6cptkk64ml****
Valuesarray<object>

时间点的值。

object

无。

Vstring

监控指标的值。

0.13
Tsstring

监控指标值对应的时间戳。

单位:秒。

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
400BadRequest%s
409%sResources already exist.
500InternalError%s

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

变更历史

变更时间变更内容概要操作
2022-05-30OpenAPI 错误码发生变更查看变更详情
2022-05-24新增 OpenAPI查看变更详情