全部产品
Search

搜索本产品

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

    文档中心

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

    更新时间：Jan 23, 2026

    调用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对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    cms:DescribeCustomMetricDataPoint

    list

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    Namespace

    string

    是

    指标仓库名称。

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

    default-aliyun
    PromSQL

    string

    是

    监控指标。

    说明

    支持 PromQL 查询语句。

    AliyunEcs_cpu_total
    Start

    integer

    是

    开始时间戳。

    单位：秒。

    1653804865
    End

    integer

    是

    结束时间戳。

    单位：秒。

    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

    array<object>

    监控指标的时间线列表。

    array<object>

    无。

    MetricName

    string

    监控指标名称。

    AliyunEcs_cpu_total
    Labels

    array<object>

    时间维度的标签。

    object

    无。

    K

    string

    标签键。

    instanceId
    V

    string

    标签值。

    i-rj99xc6cptkk64ml****
    Values

    array<object>

    时间点的值。

    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 Bad request. 错误参数请求
    500 InternalError %s
    403 %s %s
    404 %s %s
    409 %s Resources already exist.

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

    变更历史

    更多信息，参考变更详情。