查询某告警事件的相同告警列表 - ListSameEvents
功能介绍
查询某告警事件的相同告警列表
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v5/{project_id}/event/same-events
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID。 约束限制: 不涉及 取值范围: 字符长度1-256位 默认取值: 不涉及 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
enterprise_project_id |
否 |
String |
参数解释: 企业项目ID,用于过滤不同企业项目下的资产。获取方式请参见获取企业项目ID。 如需查询所有企业项目下的资产请传参“all_granted_eps”。 约束限制: 开通企业项目功能后才需要配置企业项目ID参数。 取值范围: 字符长度1-256位 默认取值: 0,表示默认企业项目(default)。 |
|
event_id |
是 |
String |
事件编号 |
|
event_class_id |
是 |
String |
事件标识,包含如下:
|
|
occur_time |
否 |
Long |
事件发生时间 |
|
offset |
否 |
Integer |
偏移量:指定返回记录的开始位置 |
|
limit |
否 |
Integer |
每页显示个数 |
请求参数
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
total_num |
Integer |
参数解释: 告警事件总数 取值范围: 最小值0,最大值2147483647 |
|
data_list |
Array of EventManagementResponseInfo objects |
事件列表详情 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
event_id |
String |
参数解释: 事件ID 取值范围: 字符长度1-64位 |
|
event_class_id |
String |
参数解释: 事件分类 取值范围:
|
|
event_type |
Integer |
参数解释: 事件类型 取值范围:
|
|
event_name |
String |
参数解释: 事件名称 取值范围: 字符长度1-256位 |
|
severity |
String |
参数解释: 威胁等级 取值范围:
|
|
container_name |
String |
参数解释: 容器实例名称,只有容器类型的告警有 取值范围: 字符长度1-256位 |
|
image_name |
String |
参数解释: 镜像名称,只有容器类型的告警有 取值范围: 字符长度1-256位 |
|
host_name |
String |
参数解释: 服务器名称 取值范围: 字符长度1-256位 |
|
host_id |
String |
参数解释: 主机ID 取值范围: 字符长度1-64位 |
|
private_ip |
String |
参数解释: 服务器私有IP 取值范围: 字符长度1-128位 |
|
public_ip |
String |
参数解释: 弹性公网IP地址 取值范围: 字符长度1-256位 |
|
os_type |
String |
参数解释: 操作系统类型 取值范围:
|
|
host_status |
String |
参数解释: 服务器状态 取值范围:
|
|
agent_status |
String |
参数解释: Agent状态 取值范围:
|
|
protect_status |
String |
参数解释: 防护状态 取值范围:
|
|
asset_value |
String |
参数解释: 资产重要性 取值范围:
|
|
attack_phase |
String |
参数解释: 攻击阶段 取值范围:
|
|
attack_tag |
String |
参数解释: 攻击标识 取值范围:
|
|
occur_time |
Integer |
参数解释: 发生时间,毫秒 取值范围: 最小值0,最大值9223372036854775807 |
|
handle_time |
Integer |
参数解释: 处置时间,毫秒,已处理的告警才有 取值范围: 最小值0,最大值9223372036854775807 |
|
handle_status |
String |
参数解释: 处理状态 取值范围:
|
|
handle_method |
String |
参数解释: 处理方式,已处理的告警才有 取值范围:
|
|
handler |
String |
参数解释: 备注信息,已处理的告警才有 取值范围: 字符长度1-256位 |
|
operate_accept_list |
Array of strings |
支持的处理操作 |
|
operate_detail_list |
Array of EventDetailResponseInfo objects |
操作详情信息列表(页面不展示) |
|
forensic_info |
Object |
取证信息,json格式 |
|
resource_info |
EventResourceResponseInfo object |
资源信息 |
|
geo_info |
Object |
地理位置信息,json格式 |
|
malware_info |
Object |
恶意软件信息,json格式 |
|
network_info |
Object |
网络信息,json格式 |
|
app_info |
Object |
应用信息,json格式 |
|
system_info |
Object |
系统信息,json格式 |
|
extend_info |
Object |
事件扩展信息,json格式 |
|
recommendation |
String |
参数解释: 处置建议 取值范围: 字符长度1-256位 |
|
description |
String |
参数解释: 告警说明 取值范围: 字符长度0-1024位 |
|
event_abstract |
String |
参数解释: 告警摘要 取值范围: 字符长度0-512位 |
|
process_info_list |
Array of EventProcessResponseInfo objects |
进程信息列表 |
|
user_info_list |
Array of EventUserResponseInfo objects |
用户信息列表 |
|
file_info_list |
Array of EventFileResponseInfo objects |
文件信息列表 |
|
event_details |
String |
参数解释: 事件信息的简述 取值范围: 字符长度0-204800位 |
|
tag_list |
Array of strings |
标签列表 |
|
event_count |
Integer |
参数解释: 事件发生次数 取值范围: 最小值0,最大值2147483647 |
|
operate_type |
String |
参数解释: 操作类型 取值范围:
|
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
agent_id |
String |
参数解释: Agent ID 约束限制: 不涉及 取值范围: 字符长度1-64位 默认取值: 不涉及 |
|
process_pid |
Integer |
参数解释: 进程ID 取值范围: 最小值0,最大值2147483647 |
|
is_parent |
Boolean |
参数解释: 是否是父进程 取值范围:
|
|
file_hash |
String |
参数解释: 文件哈希 取值范围: 字符长度1-256位 |
|
file_path |
String |
参数解释: 文件路径 取值范围: 字符长度1-256位 |
|
file_attr |
String |
参数解释: 文件属性 取值范围: 字符长度1-256位 |
|
private_ip |
String |
参数解释: 服务器私有IP 取值范围: 字符长度1-128位 |
|
login_ip |
String |
参数解释: 登录源IP 取值范围: 字符长度1-256位 |
|
login_user_name |
String |
参数解释: 登录用户名 取值范围: 字符长度1-256位 |
|
keyword |
String |
告警事件关键字,仅用于告警白名单 |
|
hash |
String |
告警事件hash,仅用于告警白名单 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
domain_id |
String |
参数解释: 租户账号ID 取值范围: 字符长度1-256位 |
|
project_id |
String |
参数解释: 项目ID 取值范围: 字符长度1-256位 |
|
enterprise_project_id |
String |
参数解释: 企业项目ID 取值范围: 字符长度1-256位 |
|
region_name |
String |
参数解释: Region名称 取值范围: 字符长度1-256位 |
|
vpc_id |
String |
参数解释: VPC ID 取值范围: 字符长度1-256位 |
|
cloud_id |
String |
参数解释: 云主机ID 取值范围: 字符长度1-256位 |
|
vm_name |
String |
参数解释: 虚拟机名称 取值范围: 字符长度1-256位 |
|
vm_uuid |
String |
参数解释: 虚拟机UUID,即主机ID 取值范围: 字符长度1-256位 |
|
container_id |
String |
参数解释: 容器ID 取值范围: 字符长度1-256位 |
|
container_status |
String |
参数解释: 容器状态 取值范围: 字符长度1-256位 |
|
pod_uid |
String |
参数解释: pod uid 取值范围: 字符长度1-256位 |
|
pod_name |
String |
参数解释: pod name 取值范围: 字符长度1-256位 |
|
namespace |
String |
参数解释: namespace 取值范围: 字符长度1-256位 |
|
cluster_id |
String |
参数解释: 集群ID 取值范围: 字符长度1-256位 |
|
cluster_name |
String |
参数解释: 集群名称 取值范围: 字符长度1-256位 |
|
image_id |
String |
参数解释: 镜像ID 取值范围: 字符长度1-256位 |
|
image_name |
String |
参数解释: 镜像名称 取值范围: 字符长度1-256位 |
|
host_attr |
String |
参数解释: 主机属性 取值范围: 字符长度1-256位 |
|
service |
String |
参数解释: 业务服务 取值范围: 字符长度1-256位 |
|
micro_service |
String |
参数解释: 微服务 取值范围: 字符长度1-256位 |
|
sys_arch |
String |
参数解释: 系统CPU架构 取值范围: 字符长度1-256位 |
|
os_bit |
String |
参数解释: 操作系统位数 取值范围: 字符长度1-256位 |
|
os_type |
String |
参数解释: 操作系统类型 取值范围: 字符长度1-256位 |
|
os_name |
String |
参数解释: 操作系统名称 取值范围: 字符长度1-256位 |
|
os_version |
String |
参数解释: 操作系统版本 取值范围: 字符长度1-256位 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
process_name |
String |
参数解释: 进程名称 取值范围: 字符长度1-256位 |
|
process_path |
String |
参数解释: 进程文件路径 取值范围: 字符长度1-256位 |
|
process_pid |
Integer |
参数解释: 进程ID 取值范围: 最小值0,最大值2147483647 |
|
process_uid |
Integer |
参数解释: 进程用户ID 取值范围: 最小值0,最大值2147483647 |
|
process_username |
String |
参数解释: 运行进程的用户名 取值范围: 字符长度1-256位 |
|
process_cmdline |
String |
参数解释: 进程文件命令行 取值范围: 字符长度1-256位 |
|
process_filename |
String |
参数解释: 进程文件名 取值范围: 字符长度1-256位 |
|
process_start_time |
Long |
参数解释: 进程启动时间 取值范围: 最小值0,最大值9223372036854775807 |
|
process_gid |
Integer |
参数解释: 进程组ID 取值范围: 最小值0,最大值2147483647 |
|
process_egid |
Integer |
参数解释: 进程有效组ID 取值范围: 最小值0,最大值2147483647 |
|
process_euid |
Integer |
参数解释: 进程有效用户ID 取值范围: 最小值0,最大值2147483647 |
|
ancestor_process_path |
String |
参数解释: 祖父进程文件路径 取值范围: 字符长度1-256位 |
|
ancestor_process_pid |
Integer |
参数解释: 祖父进程ID 取值范围: 最小值0,最大值2147483647 |
|
ancestor_process_cmdline |
String |
参数解释: 祖父进程文件命令行 取值范围: 字符长度1-512位 |
|
parent_process_name |
String |
参数解释: 父进程名称 取值范围: 字符长度1-256位 |
|
parent_process_path |
String |
参数解释: 父进程文件路径 取值范围: 字符长度1-256位 |
|
parent_process_pid |
Integer |
参数解释: 父进程ID 取值范围: 最小值0,最大值2147483647 |
|
parent_process_uid |
Integer |
参数解释: 父进程用户ID 取值范围: 最小值0,最大值2147483647 |
|
parent_process_cmdline |
String |
参数解释: 父进程文件命令行 取值范围: 字符长度1-512位 |
|
parent_process_filename |
String |
参数解释: 父进程文件名 取值范围: 字符长度1-256位 |
|
parent_process_start_time |
Long |
参数解释: 父进程启动时间 取值范围: 最小值0,最大值9223372036854775807 |
|
parent_process_gid |
Integer |
参数解释: 父进程组ID 取值范围: 最小值0,最大值2147483647 |
|
parent_process_egid |
Integer |
参数解释: 父进程有效组ID 取值范围: 最小值0,最大值2147483647 |
|
parent_process_euid |
Integer |
参数解释: 父进程有效用户ID 取值范围: 最小值0,最大值2147483647 |
|
child_process_name |
String |
参数解释: 子进程名称 取值范围: 字符长度1-256位 |
|
child_process_path |
String |
参数解释: 子进程文件路径 取值范围: 字符长度1-256位 |
|
child_process_pid |
Integer |
参数解释: 子进程id 取值范围: 最小值0,最大值2147483647 |
|
child_process_uid |
Integer |
参数解释: 子进程用户id 取值范围: 最小值0,最大值2147483647 |
|
child_process_cmdline |
String |
参数解释: 子进程文件命令行 取值范围: 字符长度1-256位 |
|
child_process_filename |
String |
参数解释: 子进程文件名 取值范围: 字符长度1-256位 |
|
child_process_start_time |
Long |
参数解释: 子进程启动时间 取值范围: 最小值0,最大值9223372036854775807 |
|
child_process_gid |
Integer |
参数解释: 子进程组ID 取值范围: 最小值0,最大值2147483647 |
|
child_process_egid |
Integer |
参数解释: 子进程有效组ID 取值范围: 最小值0,最大值2147483647 |
|
child_process_euid |
Integer |
参数解释: 子进程有效用户ID 取值范围: 最小值0,最大值2147483647 |
|
virt_cmd |
String |
参数解释: 虚拟化命令 取值范围: 字符长度1-256位 |
|
virt_process_name |
String |
参数解释: 虚拟化进程名称 取值范围: 字符长度1-256位 |
|
escape_mode |
String |
参数解释: 逃逸方式 取值范围: 字符长度1-256位 |
|
escape_cmd |
String |
参数解释: 逃逸后执行的命令 取值范围: 字符长度1-256位 |
|
process_hash |
String |
参数解释: 进程启动文件hash 取值范围: 字符长度1-256位 |
|
process_file_hash |
String |
参数解释: 进程文件hash 取值范围: 字符长度1-256位 |
|
parent_process_file_hash |
String |
参数解释: 父进程文件hash 取值范围: 字符长度1-256位 |
|
block |
Integer |
是否阻断成功,1阻断成功 0阻断失败 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
user_id |
Integer |
参数解释: 用户uid 取值范围: 最小值0,最大值2147483647 |
|
user_gid |
Integer |
参数解释: 用户gid 取值范围: 最小值0,最大值2147483647 |
|
user_name |
String |
参数解释: 用户名称 取值范围: 字符长度1-256位 |
|
user_group_name |
String |
参数解释: 用户组名称 取值范围: 字符长度1-256位 |
|
user_home_dir |
String |
参数解释: 用户home目录 取值范围: 字符长度1-256位 |
|
login_ip |
String |
参数解释: 用户登录IP 取值范围: 字符长度1-256位 |
|
service_type |
String |
参数解释: 服务类型 取值范围:
|
|
service_port |
Integer |
参数解释: 登录服务端口 取值范围: 最小值0,最大值2147483647 |
|
login_mode |
Integer |
参数解释: 登录方式 取值范围: 最小值0,最大值2147483647 |
|
login_last_time |
Long |
参数解释: 用户最后一次登录时间 取值范围: 最小值0,最大值9223372036854775807 |
|
login_fail_count |
Integer |
参数解释: 用户登录失败次数 取值范围: 最小值0,最大值2147483647 |
|
pwd_hash |
String |
参数解释: 口令hash 取值范围: 字符长度1-256位 |
|
pwd_with_fuzzing |
String |
参数解释: 匿名化处理后的口令 取值范围: 字符长度1-256位 |
|
pwd_used_days |
Integer |
参数解释: 密码使用的天数 取值范围: 最小值0,最大值2147483647 |
|
pwd_min_days |
Integer |
参数解释: 口令的最短有效期限 取值范围: 最小值0,最大值2147483647 |
|
pwd_max_days |
Integer |
参数解释: 口令的最长有效期限 取值范围: 最小值0,最大值2147483647 |
|
pwd_warn_left_days |
Integer |
参数解释: 口令无效时提前告警天数 取值范围: 最小值0,最大值2147483647 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
file_path |
String |
参数解释: 文件路径 取值范围: 字符长度1-256位 |
|
file_alias |
String |
参数解释: 文件别名 取值范围: 字符长度1-256位 |
|
file_size |
Integer |
参数解释: 文件大小 取值范围: 最小值0,最大值2147483647 |
|
file_mtime |
Long |
参数解释: 文件最后一次修改时间 取值范围: 最小值0,最大值9223372036854775807 |
|
file_atime |
Long |
参数解释: 文件最后一次访问时间 取值范围: 最小值0,最大值9223372036854775807 |
|
file_ctime |
Long |
参数解释: 文件最后一次状态改变时间 取值范围: 最小值0,最大值9223372036854775807 |
|
file_hash |
String |
参数解释: 文件hash,当前为sha256 取值范围: 字符长度1-256位 |
|
file_md5 |
String |
参数解释: 文件md5 取值范围: 字符长度1-256位 |
|
file_sha256 |
String |
参数解释: 文件sha256 取值范围: 字符长度1-256位 |
|
file_type |
String |
参数解释: 文件类型 取值范围: 字符长度1-256位 |
|
file_content |
String |
参数解释: 文件内容 取值范围: 字符长度1-256位 |
|
file_attr |
String |
参数解释: 文件属性 取值范围: 字符长度1-256位 |
|
file_operation |
Integer |
参数解释: 文件操作类型 取值范围: 最小值0,最大值2147483647 |
|
file_action |
String |
参数解释: 文件动作 取值范围: 字符长度1-256位 |
|
file_change_attr |
String |
参数解释: 变更前后的属性 取值范围: 字符长度1-256位 |
|
file_new_path |
String |
参数解释: 新文件路径 取值范围: 字符长度1-256位 |
|
file_desc |
String |
参数解释: 文件描述 取值范围: 字符长度1-256位 |
|
file_key_word |
String |
参数解释: 文件关键字 取值范围: 字符长度1-256位 |
|
is_dir |
Boolean |
参数解释: 是否目录 取值范围:
|
|
fd_info |
String |
参数解释: 文件句柄信息 取值范围: 字符长度1-256位 |
|
fd_count |
Integer |
参数解释: 文件句柄数量 取值范围: 最小值0,最大值2147483647 |
请求示例
查询告警事件event id为0009bae0-8700-11eb-bb3f-fa163e01e338,event_class_id为container_1001相同告警列表
GET https://{endpoint}/v5/{project_id}/event/same-events?enterprise_project_id=all_granted_eps&event_id=0009bae0-8700-11eb-bb3f-fa163e01e338&event_class_id=container_1001
响应示例
状态码:200
请求已成功
{
"total_num" : 1,
"data_list" : [ {
"attack_phase" : "exploit",
"attack_tag" : "abnormal_behavior",
"event_class_id" : "lgin_1002",
"event_id" : "d8a12cf7-6a43-4cd6-92b4-aabf1e917",
"event_name" : "different locations",
"event_type" : 4004,
"forensic_info" : {
"country" : "中国",
"city" : "兰州市",
"ip" : "127.0.0.1",
"user" : "zhangsan",
"sub_division" : "甘肃省",
"city_id" : 3110
},
"handle_status" : "unhandled",
"host_name" : "xxx",
"occur_time" : 1661593036627,
"operate_accept_list" : [ "ignore" ],
"operate_detail_list" : [ {
"agent_id" : "c9bed5397db449ebdfba15e85fcfc36accee125c68954daf5cab0528bab59bd8",
"file_hash" : "e8b50f0b91e3dce0885ccc5902846b139d28108a0a7976c9b8d43154c5dbc44d",
"file_path" : "/usr/test",
"process_pid" : 3123,
"file_attr" : 33261,
"keyword" : "file_path=/usr/test",
"hash" : "e8b50f0b91e3dce0885ccc5902846b139d28108a0a7976c9b8d43154c5dbc44d",
"login_ip" : "127.0.0.1",
"private_ip" : "127.0.0.2",
"login_user_name" : "root",
"is_parent" : false
} ],
"private_ip" : "127.0.0.1",
"resource_info" : {
"region_name" : "",
"project_id" : "",
"enterprise_project_id" : "0",
"os_type" : "Linux",
"os_version" : "2.5",
"vm_name" : "",
"vm_uuid" : "71a15ecc",
"cloud_id" : "",
"container_id" : "",
"container_status" : "running / terminated",
"image_id" : "",
"pod_uid" : "",
"pod_name" : "",
"namespace" : "",
"cluster_id" : "",
"cluster_name" : ""
},
"severity" : "Medium",
"extend_info" : "",
"os_type" : "Linux",
"agent_status" : "online",
"asset_value" : "common",
"protect_status" : "opened",
"host_status" : "ACTIVE",
"event_details" : "file_path:/root/test",
"user_info_list" : [ {
"login_ip" : "",
"service_port" : 22,
"service_type" : "ssh",
"user_name" : "zhangsan",
"login_mode" : 0,
"login_last_time" : 1661593024,
"login_fail_count" : 0
} ],
"description" : "",
"abstract" : "",
"label_list" : [ "热点事件" ]
} ]
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求已成功 |
错误码
请参见错误码。