全部產品
Search

搜尋本產品

    Cloud Monitor：DescribeAlertLogCount - 統計警示歷史

    文件中心

    Cloud Monitor：DescribeAlertLogCount - 統計警示歷史

    更新時間：Mar 21, 2026

    調用DescribeAlertLogCount介面統計警示歷史。

    介面說明

    該介面只能統計到最近一年的警示歷史。

    本文將提供一個樣本，從雲端服務product維度查詢 ECS 的警示統計歷史。

    調試

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

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    cms:DescribeAlertLogCount

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    StartTime

    integer

    否

    查詢警示歷史的開始時間戳。

    單位：毫秒。

    您只能查詢最近一年的警示歷史，如果查詢時間大於一年，則參數AlertLogCount的傳回值為空白。

    說明

    開始時間（StartTime）和結束時間（EndTime）之間必須小於等於 15 天，並且需要同時填寫或同時不填寫。如果不填，則預設查詢最近 15 分鐘的警示歷史。

    1609988009694
    EndTime

    integer

    否

    查詢警示歷史的結束時間戳記。

    單位：毫秒。

    您只能查詢最近一年的警示歷史，如果查詢時間大於一年，則參數AlertLogCount的傳回值為空白。

    說明

    開始時間（StartTime）和結束時間（EndTime）之間必須小於等於 15 天，並且需要同時填寫或同時不填寫。如果不填，則預設查詢最近 15 分鐘的警示歷史。

    1610074409694
    PageNumber

    integer

    否

    頁碼。預設值：1。

    1
    PageSize

    integer

    否

    每頁顯示記錄條數。預設值：10。

    10
    SearchKey

    string

    否

    統計警示歷史的搜尋索引鍵。

    test
    Namespace

    string

    否

    雲端服務的命名空間。

    說明

    關於雲端服務的命名空間，請參見雲端服務監控項。

    acs_ecs_dashboard
    GroupId

    string

    否

    應用分組 ID。

    7301****
    Product

    string

    否

    雲端服務名稱縮寫。

    ECS
    Level

    string

    否

    警示的層級和通知方式。取值：

    • P4：郵件+DingTalk機器人。

    • OK：無警示。

    P4
    SendStatus

    string

    否

    警示狀態。取值：

    • 0：發生警示或警示恢複正常。

    • 1：非生效期。

    • 2：通道沉默周期。

    • 3：主機重啟中。

    • 4：不發送警示。

    當警示狀態為 0 時，如果 Level 的取值為 P4，則發生警示；如果 Level 的取值為 OK，則警示恢複正常。

    0
    ContactGroup

    string

    否

    警示連絡人群組。

    ECS_Group
    RuleName

    string

    否

    警示規則名稱。

    test123
    MetricName

    string

    否

    監控項名稱。

    說明

    關於雲端服務的監控項，請參見雲端服務監控項。

    cpu_total
    LastMin

    string

    否

    擷取日誌的周期。單位：分鐘。

    360
    GroupBy

    string

    是

    對資料進行空間維度彙總，相當於 SQL 中的 Group By。取值：

    • product：按照雲端服務統計。

    • level：按照警示層級統計。

    • groupId：按照應用分組統計。

    • contactGroup：按照警示連絡人群組統計。

    • product,metricName：按照雲端服務和監控項統計。

    product
    SourceType

    string

    否

    該參數已廢棄，無需關注。

    無
    EventType

    string

    否

    警示類型。取值：

    • TRIGGERED：警示觸發。

    • RESOLVED：警示恢複。

    TRIGGERED
    RuleId

    string

    否

    警示規則 ID。

    關於如何擷取警示規則 ID，請參見 DescribeMetricRuleList 。

    bfae2ca5b4e07d2c7278772e***********

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

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Code

    string

    狀態代碼。

    說明

    200 表示成功。

    200
    Message

    string

    錯誤資訊。

    The specified resource is not found.
    RequestId

    string

    請求 ID。

    1C4A3709-BF52-42EE-87B5-7435F0929585
    Success

    boolean

    操作是否成功。取值：

    • true：成功。

    • false：失敗。

    true
    AlertLogCount

    array<object>

    警示歷史數量統計。

    array<object>

    Count

    integer

    警示歷史統計的數量。

    1
    Logs

    array<object>

    警示歷史統計的數量詳情。

    object

    Name

    string

    警示歷史統計的欄位名稱。

    product
    Value

    string

    警示歷史統計的欄位值。

    ECS

    樣本

    正常返回樣本

    JSON格式

    {
  "Code": "200",
  "Message": "The specified resource is not found.",
  "RequestId": "1C4A3709-BF52-42EE-87B5-7435F0929585",
  "Success": true,
  "AlertLogCount": [
    {
      "Count": 1,
      "Logs": [
        {
          "Name": "product",
          "Value": "ECS"
        }
      ]
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 ParameterInvalid Parameter invalid. 非法參數
    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. 未找到指定資源。
    409 ResourceConflict Concurrent modification of resources.
    409 ResourceExist Resources already exist.

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

    變更歷史

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