Querying the List of Isolated Files

Function

This API is used to query the list of isolated files.

Calling Method

For details, see Calling APIs.

URI

GET /v5/{project_id}/event/isolated-file

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Tenant project ID

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps.
last_days	No	Integer	Number of days to be queried. This parameter is manually exclusive with begin_time and end_time.
host_name	No	String	Server name
isolation_status	No	String	Isolation status. The options are as follows: isolated restored isolating restoring
offset	No	Integer	Offset, which specifies the start position of the record to be returned. The value must be a number no less than 0. The default value is 0.
limit	No	Integer	Number of records displayed on each page.

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
x-auth-token	Yes	String	User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
total_num	Integer	Total number
data_list	Array of IsolatedFileResponseInfo objects	Isolated file details

**Table 5** IsolatedFileResponseInfo
Parameter	Type	Description
host_id	String	Server ID
host_name	String	Server name
file_hash	String	File hash
file_path	String	File path
isolation_status	String	Isolation status. The options are as follows: isolated restored isolating restoring
file_attr	String	File attribute
update_time	Integer	Update time, in milliseconds

Example Requests

Query the first 10 isolated files.

GET https://{endpoint}/v5/{project_id}/event/isolated-file?limit=10&offset=0&enterprise_project_id=xxx

Example Responses

Status code: 200

Isolated files list

{
  "data_list" : [ {
    "file_attr" : "0",
    "file_hash" : "58693382bc0c9f60ef86e5b37cf3c2f3a9c9ec46936901eaa9131f7ee4a09bde",
    "file_path" : "C:\\Users\\Public\\Public Docker\\system32.exe",
    "host_id" : "5a41ca47-8ea7-4a65-a8fb-950d03d8638e",
    "host_name" : "ecs-wi-800211",
    "isolation_status" : "isolated",
    "update_time" : 1698304933717
  } ],
  "total_num" : 1
}