全部產品
Search

搜尋本產品

    Cloud Monitor：DescribeMetricData - 查詢指定雲產品的某個監控項的監控資料

    文件中心

    Cloud Monitor：DescribeMetricData - 查詢指定雲產品的某個監控項的監控資料

    更新時間：Dec 24, 2025

    調用DescribeMetricData介面查詢指定雲產品的某個監控項的監控資料。

    介面說明

    使用限制

    • 調用 DescribeMetricLast、DescribeMetricList、DescribeMetricData 和 DescribeMetricTop 的介面，有 100 萬次/月免費額度（總計），當免費額度用完且您沒有開通基礎CloudMonitor隨用隨付時，將無法正常使用該 API。如果您已開通基礎CloudMonitor的隨用隨付，當免費調用額度用完時，該 API 仍然可以正常使用，超出免費額度部分將自動按使用量計費。開通方法詳見開通隨用隨付。

    • 單個 API 的調用次數限制為 10 次/秒。一個阿里雲帳號及該帳號下的 RAM 使用者共用 10 次/秒。

    使用說明

    說明

    與 DescribeMetricList 不同，本介面具有統計功能（即Dimension={"instanceId": "i-abcdefgh12****"}），將該帳號下的所有監控資料進行彙總統計。

    本文將提供一個樣本，查詢雲產品acs_ecs_dashboard監控項cpu_idle的監控資料。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Namespace

    string

    是

    雲產品的資料命名空間。

    關於雲產品的資料命名空間，請參見雲產品監控項。

    acs_ecs_dashboard
    MetricName

    string

    是

    雲產品的監控項名稱。

    關於雲產品的監控項名稱，請參見雲產品監控項。

    cpu_idle
    Period

    string

    否

    監控項的統計周期。

    取值：15、60、900 和 3600。

    單位：秒。

    說明

    • 如果不設定統計周期，則按照註冊監控項時申請的上報周期來查詢監控資料。

    60
    StartTime

    string

    否

    查詢監控資料的開始時間。

    • 當您未設定StartTime和EndTime時，查詢目前時間最近一個統計周期Period的監控資料。

    • 當您同時設定StartTime和EndTime時，查詢指定時間段內距離EndTime最近一個統計周期Period的監控資料。具體如下：

      • 當Period設定為 15 秒時，指定時間段必須小於或等於 20 分鐘。例如：StartTime 為 2021-05-08 08:10:00，EndTime 為 2021-05-08 08:30:00，統計距離 2021-05-08 08:30:00 最近一個 15 秒的監控資料。

      • 當Period設定為 60 秒或 900 秒時，指定時間段必須小於或等於 2 小時。例如：Period 為 60 秒，StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-08 10:00:00，統計距離 2021-05-08 10:00:00 最近一個 60 秒的監控資料。

      • 當Period設定為 3600 秒時，指定時間段必須小於或等於 2 天。例如：StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-10 08:00:00，統計距離 2021-05-10 08:00:00 最近一個 3600 秒的監控資料。

    開始時間支援的格式：

    • Unix 時間戳記：從 1970 年 1 月 1 日開始所經過的毫秒數。

    • Format 格式：YYYY-MM-DDThh:mm:ssZ。

    說明

    • StartTime如果設定過早，則無效。

    • 建議您使用 Unix 時間戳記，避免時區的問題。

    1618368900000
    EndTime

    string

    否

    查詢監控資料的結束時間。

    • 當您未設定StartTime和EndTime時，查詢目前時間最近一個統計周期Period的監控資料。

    • 當您同時設定StartTime和EndTime時，查詢指定時間段內距離EndTime最近一個統計周期Period的監控資料。具體如下：

      • 當Period設定為 15 秒時，指定時間段必須小於或等於 20 分鐘。例如：StartTime 為 2021-05-08 08:10:00，EndTime 為 2021-05-08 08:30:00，統計距離 2021-05-08 08:30:00 最近一個 15 秒的監控資料。

      • 當Period設定為 60 秒或 900 秒時，指定時間段必須小於或等於 2 小時。例如：Period 為 60 秒，StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-08 10:00:00，統計距離 2021-05-08 10:00:00 最近一個 60 秒的監控資料。

      • 當Period設定為 3600 秒時，指定時間段必須小於或等於 2 天。例如：StartTime 為 2021-05-08 08:00:00，EndTime 為 2021-05-10 08:00:00，統計距離 2021-05-10 08:00:00 最近一個 3600 秒的監控資料。

    結束時間支援的格式：

    • Unix 時間戳記：從 1970 年 1 月 1 日開始所經過的毫秒數。

    • Format 格式：YYYY-MM-DDThh:mm:ssZ。

    說明

    建議您使用 Unix 時間戳記，避免時區的問題。

    1618368960000
    Dimensions

    string

    否

    維度 Map，用於查詢指定資源的監控資料。

    格式：key-value 索引值對形式的集合，常用的 key-value 集合為instanceId:i-2ze2d6j5uhg20x47****。

    說明

    單次請求最多支援批量查詢 50 個執行個體。

    [{"instanceId": "i-abcdefgh12****"}]
    Express

    string

    否

    對查詢出的現有結果進行Realtime Compute的運算式。

    說明

    目前僅支援groupby（類似資料庫groupby語句）。

    {"groupby":["userId","instanceId"]}
    Length

    string

    否

    每頁顯示的記錄條數，用於分頁查詢。

    預設值：1000。

    說明

    單次請求 Length 的最大值為 1440。

    1000

    關於公用請求參數的詳情，請參見公用參數。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    無。

    Code

    string

    狀態代碼。

    說明

    200 表示成功。

    200
    Message

    string

    錯誤資訊。

    The specified resource is not found.
    RequestId

    string

    請求 ID。

    6A5F022D-AC7C-460E-94AE-B9E75083D027
    Datapoints

    string

    監控資料列表。包括如下資訊：

    • timestamp：發生警示的時間戳記。

    • userId：發生警示的使用者識別碼。

    • instanceId：發生警示的執行個體 ID。

    • Minimum、Average、Maximum：警示規則。

    [{\"timestamp\":1618368900000,\"Average\":95.8291666666667,\"Minimum\":65.48,\"Maximum\":100.0},{\"timestamp\":1618368960000,\"Average\":95.8683333333333,\"Minimum\":67.84,\"Maximum\":100.0}]
    Period

    string

    監控資料的統計周期。

    取值：15、60、900 和 3600。

    單位：秒。

    60

    樣本

    正常返回樣本

    JSON格式

    {
  "Code": "200",
  "Message": "The specified resource is not found.",
  "RequestId": "6A5F022D-AC7C-460E-94AE-B9E75083D027",
  "Datapoints": "[{\\\"timestamp\\\":1618368900000,\\\"Average\\\":95.8291666666667,\\\"Minimum\\\":65.48,\\\"Maximum\\\":100.0},{\\\"timestamp\\\":1618368960000,\\\"Average\\\":95.8683333333333,\\\"Minimum\\\":67.84,\\\"Maximum\\\":100.0}]",
  "Period": "60"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 ParameterInvalid Illegal parameters.
    500 InternalError The request processing has failed due to some unknown error.
    403 AccessForbidden User not authorized to operate on the specified resource.
    404 ResourceNotFound The specified resource is not found. 未找到指定資源。

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

    變更歷史

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