全部產品
Search

搜尋本產品

    Cloud Monitor：DescribeHybridMonitorDataList - 查詢指定指標倉庫中的監控資料

    文件中心

    Cloud Monitor：DescribeHybridMonitorDataList - 查詢指定指標倉庫中的監控資料

    更新時間：Mar 21, 2026

    調用DescribeHybridMonitorDataList介面查詢指定指標倉庫中的監控資料。

    介面說明

    前提條件

    請確保您已開通企業CloudMonitor。具體操作，請參見開通企業CloudMonitor。

    使用限制

    單次最多返回監控資料 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.

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。