Exporting Vulnerability Reports
Function
This API is used to query the forensics information about a specific event.
Authorization Information
Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.
- If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
- If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.
URI
GET /v5/{project_id}/event/forensic
Parameter | Mandatory | Type | Description |
|---|---|---|---|
project_id | Yes | String | Definition Project ID, which is used to specify the project that an asset belongs to. After the project ID is configured, you can query assets in the project using the project ID. For details about how to obtain it, see Obtaining a Project ID. Constraints N/A Range The value can contain 1 to 256 characters. Default Value N/A |
Parameter | Mandatory | Type | Description |
|---|---|---|---|
enterprise_project_id | No | String | Definition Enterprise project ID, which is used to filter assets in different enterprise projects. For details, see Obtaining an Enterprise Project ID. To query assets in all enterprise projects, set this parameter to all_granted_eps. Constraints You need to set this parameter only after the enterprise project function is enabled. Range The value can contain 1 to 256 characters. Default Value 0: default enterprise project. |
event_type | Yes | Integer | Definition Event type Constraints N/A Range Default Value N/A |
event_id | Yes | String | Definition Case code. Constraints N/A Range The value can contain 1 to 128 characters. Default Value N/A |
occur_time | Yes | Long | Definition Time when the event was generated. Constraints N/A Range N/A Default Value N/A |
category | No | String | Definition Event type. Constraints N/A Range Default Value N/A |
Request Parameters
Parameter | Mandatory | Type | Description |
|---|---|---|---|
X-Auth-Token | Yes | String | Definition User token, which contains user identity and permissions. The token can be used for identity authentication when an API is called. For details about how to obtain the token, see Obtaining a User Token. Constraints N/A Range The value can contain 1 to 32,768 characters. Default Value N/A |
Response Parameters
Status code: 200
Parameter | Type | Description |
|---|---|---|
event_type | Integer | Definition Event type Constraints N/A Range |
event_class_id | String | Definition Event Category Range
|
support_download_file | Boolean | Definition Whether alarm source file download is supported. Range |
malware_file_hash | String | Definition Hash value of the malicious file. Currently, the value is sha256. Range N/A |
event_forensic_info | EventForensicInfo object | Definition Incident investigation and forensics information Range N/A |
Parameter | Type | Description |
|---|---|---|
occur_time | Long | Definition Occurrence time, accurate to milliseconds Range N/A |
file_forensic_list | Array of FileForensicInfo objects | Definition File forensics information list. Range N/A |
process_chain_forensic | Array of ProcessChainList objects | Definition Process chain forensics information Range N/A |
network_forensic | network_forensic object | Definition Network Forensics Range N/A |
user_forensic | user_forensic object | Definition User Forensics Range N/A |
registry_forensic | registry_forensic object | Definition Registry Forensics Range N/A |
abnormal_login_forensic | abnormal_login_forensic object | Definition Abnormal Login Forensics Range N/A |
container_forensic | container_forensic object | Definition Container Alarm Forensics Range N/A |
malware_forensic | malware_forensic object | Definition Malware Forensics Range N/A |
auto_launch_forensic | auto_launch_forensic object | Definition Auto-started Item Forensics Range N/A |
kernel_forensic_list | Array of KernelForensicInfo objects | Definition Kernel Forensics Range N/A |
geo_forensic | geo_forensic object | Definition Geographical Location Forensics Range N/A |
stack_forensic | stack_forensic object | Definition Stack Forensics Range N/A |
image_block_forensic | image_block_forensic object | Definition Container Image Blocking Forensics Range N/A |
honey_forensic | Array of HoneyForensicInfo objects | Definition Honeypot Forensics Range N/A |
Parameter | Type | Description |
|---|---|---|
file_path | String | Definition File path. Range N/A |
file_new_path | String | Definition New File Path Range N/A |
file_name | String | Definition File name. Range N/A |
file_sha256 | String | Definition SHA256 value of the file. Range N/A |
file_action | String | Definition File action. Range N/A |
file_operation | Integer | Definition File operation type. Range N/A |
file_size | Integer | Definition File Size Range N/A |
file_hash | String | Definition File hash. The current value is sha256. Range N/A |
file_desc | String | Definition File description. Range N/A |
is_dir | Boolean | Definition Whether it is a directory. Range N/A |
file_mtime | Long | Definition Last file modification time (ms). Range N/A |
file_atime | Long | Definition Last file access time (ms) Range N/A |
file_ctime | Long | Definition Time when the file status last changed (ms) Range N/A |
file_alias | String | Definition File alias. Range N/A |
file_md5 | String | Definition File MD5 value. Range N/A |
file_type | String | Definition File type Range N/A |
file_key_word | String | Definition File keyword. Range N/A |
Parameter | Type | Description |
|---|---|---|
[items] | Array of ProcessForensicInfo objects | Process chain list |
Parameter | Type | Description |
|---|---|---|
process_name | String | Definition Process name. Range N/A |
process_path | String | Definition Process file path. Range N/A |
process_pid | Integer | Definition Process ID. Range N/A |
process_uid | Integer | Definition User ID associated with the process. Range N/A |
process_gid | Integer | Definition Process group ID. Range N/A |
process_egid | Integer | Definition Valid process group ID. Range N/A |
process_euid | Integer | Definition Valid user ID of a process. Range N/A |
process_username | String | Definition Process username. Range N/A |
process_cmdline | String | Definition Process file command line. Range N/A |
process_start_time | Long | Definition Process start time Range N/A |
process_file_hash | String | Definition Process file hash. Range N/A |
ancestor_process_pid | Integer | Definition Grandparent process ID. Range N/A |
ancestor_process_cmdline | String | Definition Grandparent process command line. Range N/A |
ancestor_process_path | String | Definition Grandparent process path. Range N/A |
session_id | Integer | Definition Session ID Range N/A |
event_num | Integer | Definition Number of threat events Range N/A |
type | String | Definition Node Type Range |
Parameter | Type | Description |
|---|---|---|
local_address | String | Definition Local IP address Range N/A |
local_port | Integer | Definition Local port Range N/A |
src_ip | String | Definition Source IP address. Range N/A |
remote_address | String | Definition Remote IP address (attacker IP address) Range N/A |
remote_port | Integer | Definition Remote Port Range N/A |
protocol | String | Definition Protocol Range N/A |
app_protocol | String | Definition Application-Layer Protocol Range N/A |
flow_direction | String | Definition Traffic Direction Range N/A |
count | Integer | Definition Connections Range N/A |
first_time | Long | Definition First connection time (ms) Range N/A |
last_time | Long | Definition Last Connection Time (ms) Range N/A |
request_method | String | Definition Request Methods Range N/A |
request_url | String | Definition Request URL. Range N/A |
query_string | String | Definition Query string Range N/A |
request_params | String | Definition Request parameters. Range N/A |
request_header | String | Definition Request header. Range N/A |
Parameter | Type | Description |
|---|---|---|
user_id | Integer | Definition User ID (UID). Range N/A |
user_gid | Integer | Definition User GID. Range N/A |
user_name | String | Definition Username. Range N/A |
user_group_name | String | Definition User group name. Range N/A |
user_home_dir | String | Definition User home directory. Range N/A |
login_ip | String | Definition User login IP address Range N/A |
service_type | String | Definition Login Service Type Range N/A |
service_port | Integer | Definition Login service port. Range N/A |
login_mode | Integer | Definition Login mode. Range N/A |
login_last_time | Long | Definition Last login time of a user. Range N/A |
login_fail_count | Integer | Definition Number of failed login attempts. Range N/A |
Parameter | Type | Description |
|---|---|---|
reg_key | String | Definition Registry key Range N/A |
reg_value | String | Definition Registry value Range N/A |
reg_new_key | String | Definition New key in the registry Range N/A |
reg_op_type | String | Definition Registry key/value operation type Range N/A |
Parameter | Type | Description |
|---|---|---|
ip | String | Definition IP Range N/A |
user | String | Definition User Range N/A |
country | String | Definition Country/Region Range N/A |
sub_division | String | Definition Province Range N/A |
city | String | Definition City Range N/A |
city_id | Integer | Definition Login Source (Mapping Location Name) Range N/A |
Parameter | Type | Description |
|---|---|---|
container_id | String | Definition Container ID Range N/A |
container_status | String | Definition Container Status. Range N/A |
pod_uid | String | Definition pod uid Range N/A |
pod_name | String | Definition pod name Range N/A |
namespace | String | Definition namespace Range N/A |
cluster_id | String | Definition Cluster ID. Constraints N/A Range Length: 1 to 64 characters Default Value N/A |
cluster_name | String | Definition Cluster name Constraints N/A Range The value can contain 1 to 256 characters. Default Value N/A |
image_id | String | Definition Image ID. Range N/A |
image_name | String | Definition Image name. Range N/A |
priviledged | Boolean | Definition Privileged Container Range N/A |
pid_mode | String | Definition Container PID Namespace Mode Range N/A |
ipc_mode | String | Definition Container IPC Namespace Mode Range N/A |
network_mode | String | Definition Container Network Namespace Mode Range N/A |
publish_allports | Boolean | Definition Open All Container Ports Range N/A |
capabilities | String | Definition Container Capability Range N/A |
security_opts | String | Definition Container Security Option Range N/A |
ports | String | Definition Container Open Port Range N/A |
mounts | String | Definition Container Mount Point Range N/A |
sys_call | String | Definition System call Range N/A |
container_name | String | Definition Container name. Range N/A |
Parameter | Type | Description |
|---|---|---|
malware_family | String | Definition Malware family. Range N/A |
malware_name | String | Definition Malware name Range N/A |
malware_type | String | Definition Malware type Range N/A |
confidence | Integer | Definition Credibility Range N/A |
Parameter | Type | Description |
|---|---|---|
event | Integer | Definition Event Range N/A |
type | Integer | Definition Type. Range N/A |
owner | String | Definition User Range N/A |
name | String | Definition Command Range N/A |
run_interval | String | Definition Running Interval Range N/A |
hash | String | Definition hash Range N/A |
mtime | String | Definition hash Range N/A |
description | String | Definition Startup Items Range N/A |
path | String | Definition Process file command line. Range N/A |
Parameter | Type | Description |
|---|---|---|
read_addr | Integer | Definition Address Range N/A |
syscall_num | Integer | Definition System call ID Range N/A |
function | String | Definition System function Range N/A |
module | String | Definition Kernel modules Range N/A |
ext_info | String | Definition Extended information. Range N/A |
Parameter | Type | Description |
|---|---|---|
src_country | String | Definition Source Country Range N/A |
src_city | String | Definition Source city. Range N/A |
src_latitude | Integer | Definition Source Latitude Range N/A |
src_longitude | Integer | Definition Source Longitude Range N/A |
dest_country | String | Definition Destination Country Range N/A |
dest_city | String | Definition Destination City Range N/A |
dest_latitude | Integer | Definition Destination Latitude Range N/A |
dest_longitude | Integer | Definition Destination Longitude Range N/A |
Parameter | Type | Description |
|---|---|---|
attack_input_value | String | Definition Attack Payload Range N/A |
app_stack | String | Definition Stack Information Range N/A |
chk_probe | Integer | Definition Attack probe Range N/A |
chk_rule | Integer | Definition Feature rule Range N/A |
plugin_name | Integer | Definition Rule Range N/A |
Parameter | Type | Description |
|---|---|---|
type | String | Definition Block type. Range N/A |
msg | String | Definition Reason for Blocking Range N/A |
path | String | Definition Path Range N/A |
image | String | Definition Image name. Range N/A |
version | Boolean | Definition Image tag. Range N/A |
result | String | Definition Blocking result Range N/A |
time | String | Definition Occurred On Range N/A |
Parameter | Type | Description |
|---|---|---|
attack_ip | String | Definition Attack source IP address Range N/A |
sandbox_name | String | Definition Sandbox Name Range N/A |
service_name | String | Definition Spoofing service Range N/A |
attack_type | String | Definition Attack Type Range |
attack_method_desc | String | Definition Attack methods Range N/A |
attack_desc | String | Definition Attack behavior Range N/A |
Example Requests
None
Example Responses
Status code: 200
Request succeeded.
{
"event_type" : 1001,
"event_class_id" : "av_1008",
"support_download_file" : true,
"malware_file_hash" : "d36b44b1cd6d5767f788ba326",
"event_forensic_info" : {
"occur_time" : 1615564800000,
"network_forensic" : {
"local_address" : "1.1.1.1",
"local_port" : 0,
"src_ip" : "1.1.1.2",
"remote_address" : "1.1.1.3",
"remote_port" : 0,
"count" : 1,
"first_time" : 1615564800000,
"last_time" : 1615564800000
}
}
} Status Codes
Status Code | Description |
|---|---|
200 | Request succeeded. |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot
