全部產品
Search

搜尋本產品

    Security Center：ListAlerts

    文件中心

    Security Center：ListAlerts

    更新時間：Jul 03, 2026

    取得告警列表。

    介面說明

    入參 JsonConfig 是一個非常複雜的 JSON 配置，為此我們提供了輔助工具類別幫助具體配置示例，請參考 Demo 。

    調試

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

    調試

    授權資訊

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

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    否

    威脅分析的資料管理中心所在地。您需要根據資產所在地域，選擇管理中心所在地。取值：

    • cn-hangzhou：資產屬於中國內地與中國香港，選擇該項。

    • ap-southeast-1：資產屬於海外地域，選擇該項。

    cn-shanghai
    Lang

    string

    否

    返回訊息的語言類型。取值：

    • zh（預設）：中文。

    • en：英文。

    zh
    AlertLevel

    array

    否

    告警威脅等級。取值：

    • 5：嚴重。

    • 4：高危。

    • 3：中危。

    • 2：低危。

    • 1：資訊。

    string

    否

    告警威脅等級。取值：

    • 5：嚴重。

    • 4：高危。

    • 3：中危。

    • 2：低危。

    • 1：資訊。

    1
    AlertUuid

    string

    否

    事件關聯告警 ID。

    sas_71e24437d2797ce8fc59692905a4****
    QueryViewId

    string

    否

    查詢視圖的唯一標識。

    qv-a1b2c3d4e5f6g7****
    QueryCondition

    string

    否

    查詢過濾條件，JSON 格式，取值如下：

    • {"Type":"maxCost", "Value":"100"}：耗時最長的 100 個查詢。

    • {"Type":"status","Value":"finished"}：已完成的查詢。

    • {"Type":"status","Value":"running"}：執行中的查詢。

    • {"Type":"cost","Min":"30","Max":"50"}：自訂耗時查詢，您可以自訂設定查詢的最短耗時和最長耗時，Min 表示最短耗時；Max 表示最長耗時，單位為毫秒（ms）。

      • 僅設定 Min 表示查詢執行耗時大於該值的查詢。

      • 僅設定 Max 表示查詢執行耗時小於該值的查詢。

      • 設定 Min 和 Max 表示查詢耗時大於等於 Min 的值且小於等於 Max 的值的查詢。

    {\"Type\":\"cost\",\"Max\":\"200\"}
    StartTime

    integer

    否

    告警首次發生時間。

    2025-09-30T02:23:00Z
    EndTime

    integer

    否

    告警結束時間。

    1766801904000
    OrderFieldName

    string

    否

    排序欄位。取值：

    • GmtCreate：建立時間。

    • GmtModified：更新時間。

    GmtModified
    OrderDirection

    string

    否

    排序方向，取值為：

    • asc（預設值）：正序。

    • desc：倒序。

    asc
    PageNumber

    integer

    是

    分頁參數：目前頁碼。

    1
    PageSize

    integer

    是

    分頁參數：每頁顯示筆數。

    10
    RoleFor

    integer

    否

    資源目錄成員帳號 ID。

    113091674488****
    RoleType

    integer

    否

    視圖類型。

    • 0：目前阿里雲帳號視圖。

    • 1：企業下所有帳號的視圖。

    1
    MaxResults

    integer

    否

    本次讀取的最大資料量。

    50
    NextToken

    string

    否

    是否擁有下一次查詢的權杖（Token）。取值：第一次查詢和沒有下一次查詢時，均無需填寫。如果有下一次查詢，取值為上一次 API 呼叫返回的 NextToken 值。

    AAAAAUqcj6VO4E3ECWIrFczs****

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Schema of Response

    RequestId

    string

    請求 ID。

    6276D891-*****-55B2-87B9-74D413F7****
    Alerts

    array<object>

    警告資訊詳情。

    object

    警告資訊詳情。

    AlertUuid

    string

    告警 UUID。

    798341271677187
    AlertRecord

    string

    告警詳情內容。

    {"alert_uuid":"a3f8c2e1-9b7d-4f6a-8c2e-1d5b9a7f****"}
    PageSize

    integer

    分頁參數：每頁顯示筆數。

    10
    PageNumber

    integer

    分頁參數：目前頁碼。

    1
    TotalCount

    integer

    記錄總數。

    57
    MaxResults

    integer

    本次讀取的最大資料量。

    50
    NextToken

    string

    下一個查詢開始 Token。

    AAAAAUqcj6VO4E3ECWIrFczs****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "6276D891-*****-55B2-87B9-74D413F7****",
  "Alerts": [
    {
      "AlertUuid": "798341271677187",
      "AlertRecord": "{\"alert_uuid\":\"a3f8c2e1-9b7d-4f6a-8c2e-1d5b9a7f****\"}"
    }
  ],
  "PageSize": 10,
  "PageNumber": 1,
  "TotalCount": 57,
  "MaxResults": 50,
  "NextToken": "AAAAAUqcj6VO4E3ECWIrFczs****"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IdempotentParameterMismatch The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.

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

    變更歷史

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