全部产品
Search

搜索本产品

    云安全中心：ListAlerts - 获取告警列表

    文档中心

    云安全中心：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.

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

    变更历史

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