病毒查杀隔离信任删除操作接口
更新时间 2025-12-24 17:17:35
最近更新时间: 2025-12-24 17:17:35
接口功能介绍
病毒查杀-病毒查杀隔离信任删除操作。
接口约束
此功能为收费功能。确认已经购买服务器配额,并且开启服务器防护。如果没有购买配额,可按照页面提示进行购买。如果没有开启防护,请在服务器列表页开启机器防护。
URI
POST /v1/virus/handle
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| processType | 是 | String | 处理方式 IGNORE-忽略 ISOLATE-隔离 ADD_WHITE-加白 DELETE-删除 | ISOLATE | |
| effectScope | 否 | String | 适用于其他主机作用范围 ALL-所有主机 OPTIONAL-自选主机 | ALL | |
| agentGuids | 否 | Array of Strings | 适用于其他主机主机的guid列表 effectScope=OPTIONAL时必填 | [] | |
| eventIds | 是 | Array of Strings | 需要加入白名单的原告警数据条目id | [] | |
| remark | 否 | String | 备注 | test-remark |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| error | String | 返回码 | ||
| CTCSSCN_000000:成功 | ||||
| CTCSSCN_000001:失败 | ||||
| CTCSSCN_000003:用户未签署协议,安全卫士系统无法正常使用 | ||||
| CTCSSCN_000004:鉴权错误 | ||||
| CTCSSCN_000005:用户没有付费版配额,功能不可用 | CTCSSCN_000000 | |||
| message | String | 返回信息 | success | |
| returnObj | String | 返回对象 | ||
| traceId | String | traceId | 211111111111111111111 | |
| statusCode | String | 状态码 200-成功 | 200 |
枚举参数
无
请求示例
请求url
无
请求头header
{"Content-Type": "application/json"}
请求体body
{"processType": "ISOLATE", "effectScope": "ALL", "agentGuids": [], "eventIds": [], "remark": "test-remark"}
响应示例
{"message": "success", "traceId": "211111111111111111111", "statusCode": "200", "error": "CTCSSCN_000000", "returnObj": ""}
状态码
请参考 状态码
错误码
请参考 错误码