分页查询开发机安全告警,支持按时间、状态、级别、告警类型和开发机实例筛选。
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | ListMlpAlarms | 要执行的操作,取值:ListMlpAlarms。 |
Version | String | 是 | 2024-05-08 | API的版本,取值:2024-05-08。 |
WhiteListName | String | 否 | example-name | 关联白名单名称 |
EventReason | String | 否 | example description | 归因逻辑 |
Status | Array of Long | 否 | [0,1] | 处理状态;0未处理 1已处理 |
VirusType | String | 否 | Webshell | 病毒或恶意文件分类,按分类名称模糊匹配(正则),自由文本、无固定枚举(例如 Webshell);非病毒类告警(RASP、文件监控等)通常无该字段。 |
IP | String | 否 | 192.0.2.10 | IP(内外网) 模糊搜索 |
PageNumber | Long | 是 | 1 | 翻页页码,取值范围为 1 及以上 |
TopGroupID | String | 否 | group-id-001 | 根分组 ID,可通过多级分组查询接口获取;不传时不限制根分组 |
AgentGroup | String | 否 | production-hosts | 单个主机主机分组 |
EventID | String | 否 | event-id-001 | 从属安全事件 ID,可从告警列表或告警详情获取 |
EventName | String | 否 | example-name | 从属事件名称 |
LevelList | Array of String | 否 | ["critical","high"] | 告警级别 critical;high;low;medium |
TaskID | String | 否 | task-id-001 | 病毒扫描任务ID(用于查询扫描任务关联告警);病毒扫描告警专用 |
CloudProviders | Array of String | 否 | ["volc"] | 云厂商列表,精确匹配;可选值 volc(火山引擎)、volc_edge(火山边缘云)、ali(阿里云)、tencent(腾讯云)、huawei(华为云)、aws(AWS)、ibm(IBM Cloud)、azure(Azure)、idc(云外主机);不传时不按云厂商筛选 |
Hostname | String | 否 | host-001 | 主机名称 |
LastAlarmTimeEnd | Long | 否 | 1786579199 | 最近一次告警时间范围终点,秒级 Unix 时间戳 |
OperationList | Array of String | 否 | ["write"] | 文件操作列表 |
SortBy | String | 否 | LastHeartbeatTime | 排序字段。支持取值:AlarmTime(告警时间)、HandleTime(处理时间)、LastAlarmTime(最近告警时间);仅以上取值生效。传入其他取值时不生效。未指定时默认按告警时间倒序排列。 |
TimeEnd | Long | 否 | 1761209000 | 告警发生时间范围终点,秒级 Unix 时间戳 |
AlertTags | Array of String | 否 | ["production"] | 告警标签 |
ClusterTags | Array of String | 否 | ["production"] | 集群标签列表;容器集群防护告警专用 |
MlpInstanceID | String | 否 | mlp-instance-id-001 | MLP 开发机实例 ID,可从开发机资产列表获取 |
ClusterName | String | 否 | example-name | 集群名称;容器集群防护告警专用 |
ContainerName | String | 否 | example-name | 容器名 |
SortOrder | String | 否 | Desc | 排序顺序
|
AgentGroupList | Array of String | 否 | ["production"] | 主机分组列表 |
AgentTags | Array of String | 否 | ["production"] | 主机标签列表 |
ClusterID | String | 否 | cluster-id-001 | 集群 ID,容器集群防护告警专用,可从容器集群列表获取 |
DataType | String | 否 | 4000 | 告警数据类型;该参数当前不参与筛选,用于兼容旧版请求。 |
Exe | String | 否 | /var/log/example | 二进制文件名搜索 |
FileHash | String | 否 | d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2 | 文件哈希(MD5);病毒扫描告警专用 |
LastAlarmTimeStart | Long | 否 | 1786492800 | 最近一次告警时间范围起点,秒级 Unix 时间戳 |
Name | String | 否 | 异常登录 | 搜索rule_name 模糊搜索 |
AgentID | String | 否 | agent-id-001 | 主机 Agent ID,可从主机资产列表获取 |
AgentIDList | Array of String | 否 | ["agent-id-001"] | agent id 列表 |
ClusterRegion | String | 否 | cn-beijing | 集群区域;容器集群防护告警专用 |
TimeStart | Long | 否 | 1761208000 | 告警发生时间范围起点,秒级 Unix 时间戳 |
LeafGroupIDs | Array of String | 否 | ["group-id-101","group-id-102"] | 叶子分组 ID 列表,可通过多级分组查询接口获取;不传时不限制叶子分组 |
ProbeHook | String | 否 | java.lang.Runtime.exec | 探针采集点;应用运行时防护专用 |
Type | Array of String | 否 | ["credential_access"] | 告警类别取值列表,精确匹配;可选值:bruteforce 暴力破解、privilege_escalation 提权攻击、persistent 后门驻留、evasion 变形木马、purpose 恶意破坏、static_scan 静态检测、killchain 杀伤链、initial_access 试探入侵、execution 代码执行、credential_access 账密盗用、discovery 资产探测、collection 信息收集、lateral_movement 横向移动、command_control 隐蔽隧道、exfiltration 信息外渗、custom 用户自定义、Code Execution 代码执行、Abnormal File Read/Write 异常文件读写、Abnormal Network Connect 异常网络、Path Traversal 目录遍历、Abnormal Behavior Sequence 异常行为序列、Abnormal Runtime Behavior 异常行为、SQL Injection SQL注入、algorithm_killchain 算法杀伤链、precision_defense 精准防御;不传或为空则不按类型筛选 |
AlarmHandleResultList | Array of Long | 否 | [0,3,25] | 处理结果 0 :未处理 1:已人工处理 3:端上处理中 4:端上处理成功 5:端上处理失败 11:已加白 12:已终止 13:已自动拦截 14:已隔离 15:隔离中 16:隔离失败 17:删除中 18:删除失败 19:已删除 20:终止中 21:终止失败 22: 已封禁 23: 已解除封禁 24:已自动封禁 25:封禁失败 |
AlarmID | String | 否 | 64b000000000000000000002 | 告警 ID,可从对应告警列表获取 |
FilePath | String | 否 | /var/log/example.log | 文件路径;病毒扫描告警专用 |
RaspArgv | String | 否 | ls -la | 参数;应用运行时防护专用 |
WhiteListID | String | 否 | 64b000000000000000000001 | 关联白名单 ID,可从告警白名单列表获取 |
ContainerID | String | 否 | container-id-001 | 容器 ID,可从容器资产列表获取 |
ImageName | String | 否 | example-name | 镜像名 |
PageSize | Long | 是 | 20 | 每页记录数,取值范围为 1~1000 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
TotalCount | Long | 1 | 全部数据条数 |
Data | Array of Object | -- | 分页业务数据,具体元素结构见各接口响应声明 |
PageNumber | Long | 1 | 当前页面 |
PageSize | Long | 20 | 页面大小 |
POST /?Action=ListMlpAlarms&Version=2024-05-08 HTTP/1.1 Host: seccenter.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20241120T080538Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241120/cn-beijing/seccenter/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "AgentGroup": "production-hosts", "AgentGroupList": [ "production" ], "AgentID": "agent-id-001", "AgentIDList": [ "agent-id-001" ], "AgentTags": [ "production" ], "AlarmHandleResultList": [ 0, 3, 25 ], "AlarmID": "64b000000000000000000002", "AlertTags": [ "production" ], "CloudProviders": [ "volc" ], "ClusterID": "cluster-id-001", "ClusterName": "example-name", "ClusterRegion": "cn-beijing", "ClusterTags": [ "production" ], "ContainerID": "container-id-001", "ContainerName": "example-name", "DataType": "4000", "EventID": "event-id-001", "EventName": "example-name", "EventReason": "example description", "Exe": "/var/log/example", "FileHash": "d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2", "FilePath": "/var/log/example.log", "Hostname": "host-001", "IP": "192.0.2.10", "ImageName": "example-name", "LastAlarmTimeEnd": 1786579199, "LastAlarmTimeStart": 1786492800, "LeafGroupIDs": [ "group-id-101", "group-id-102" ], "LevelList": [ "critical", "high" ], "MlpInstanceID": "mlp-instance-id-001", "Name": "异常登录", "OperationList": [ "write" ], "PageNumber": 1, "PageSize": 20, "ProbeHook": "java.lang.Runtime.exec", "RaspArgv": "ls -la", "SortBy": "LastHeartbeatTime", "SortOrder": "Desc", "Status": [ 0, 1 ], "TaskID": "task-id-001", "TimeEnd": 1761209000, "TimeStart": 1761208000, "TopGroupID": "group-id-001", "Type": [ "credential_access" ], "VirusType": "Webshell", "WhiteListID": "64b000000000000000000001", "WhiteListName": "example-name" }
{ "ResponseMetadata": { "RequestId": "20241120165538010234567890", "Action": "ListMlpAlarms", "Version": "2024-05-08", "Service": "seccenter", "Region": "cn-beijing" }, "Result": { "Data": [ { "AgentGroup": "production-hosts", "AgentID": "agent-id-001", "AlarmCount": 1, "AlarmHandleResult": 11, "AlarmHostname": "host-001", "AlarmID": "alarm-id-001", "AlarmTime": 1761208351, "AlertTags": [ "已处理" ], "AnalysisRecordUUID": "sec_intel_risk_analysis_alarm-id-001", "Args": [ "RASP" ], "ArgsList": [ "RASP" ], "ArgvList": [ "java -jar app.jar" ], "AttributionList": [ { "Type": "USER", "Value": "value" } ], "Class": "Webshell", "Cluster": { "ClusterArea": "cn-beijing", "ClusterID": "cluster-id-001", "ClusterName": "example-name", "ClusterTags": [ "production" ], "RuleType1st": "default", "RuleType2nd": "default" }, "Confidence": "8", "DataType": "601", "ErrorReason": "example description", "EventID": "event-id-001", "EventName": "example-name", "Exe": "/usr/bin/bash", "FileDownloadable": true, "FileHash": "d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2", "FilePath": "/var/log/example.log", "GroupPath": "/未分组", "HandleFailReason": "example description", "HandleTime": 1764640425, "Host": { "AgentID": "agent-id-001", "AgentTags": [ "production" ], "Hostname": "host-001", "InnerIPList": [ "192.0.2.10" ], "OuterIPList": [ "192.0.2.10" ] }, "ImageName": "example-name", "InDocker": "true", "LLMAnalysisResult": "success", "LLMProcessed": true, "LastAlarmTime": 1786579199, "Level": "high", "MlpInstanceID": "instance-id-001", "MlpPrivateIP": "192.0.2.10", "Name": "可疑代理程序", "NsPid": "ns-pid-id-001", "OperationList": [ "write" ], "OsType": "linux", "Pid": "32754", "ProbeHook": "java.lang.Runtime.exec", "Region": "cn-shanghai", "SecurityIntelligenceComplete": true, "SecurityIntelligenceError": "model service unavailable", "SecurityIntelligenceResult": "FALSE", "SecurityIntelligenceStatus": "PENDING", "Sid": "sid-id-001", "StackTraceFormat": "RASP", "StackTraceHash": "d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2d2", "Status": 1, "TraceID": "trace_alarm-id-001", "Type": "command_control" } ], "PageNumber": 1, "PageSize": 20, "TotalCount": 1 } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
400 | MissingParameter | 请求参数缺失,请检查参数是否已正确传入。 |
400 | InvalidParameter | 请求参数错误,请检查参数传递内容是否正确。 |
400 | OperationDenied | 不允许的操作,请检查当前资源是否被占用。 |
500 | InternalError | 服务器内部错误,请稍后重试或联系技术支持。 |
500 | DBOperateError | 数据库操作异常,请稍后重试或联系技术支持。 |