Updated on 2025-09-24 GMT+08:00

Restoring Isolated Files

Function

This API is used to restore isolated files.

Calling Method

For details, see Calling APIs.

URI

PUT /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.

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.

Table 4 Request body parameters

Parameter

Mandatory

Type

Description

data_list

No

Array of IsolatedFileRequestInfo objects

List of files to be restored

Table 5 IsolatedFileRequestInfo

Parameter

Mandatory

Type

Description

host_id

No

String

Server ID

file_hash

No

String

File hash

file_path

No

String

File path

file_attr

No

String

File attribute

Response Parameters

Status code: 200

successful response

None

Example Requests

Cancel the isolation of the file C:\Users\Public\test.exe on host 5a41ca47-8ea7-4a65-a8fb-950d03d8638e.

PUT https://{endpoint}/v5/{project_id}/event/isolated-file

{
  "data_list" : [ {
    "file_attr" : "0",
    "file_hash" : "58693382bc0c9f60ef86e5b37cf3c2f3a9c9ec46936901eaa9131f7ee4a09bde",
    "file_path" : "C:\\Users\\Public\\test.exe",
    "host_id" : "5a41ca47-8ea7-4a65-a8fb-950d03d8638e"
  } ]
}

Example Responses

None

Status Codes

Status Code

Description

200

successful response

Error Codes

See Error Codes.