编辑白名单
更新时间 2025-12-25 09:24:55
最近更新时间: 2025-12-25 09:24:55
接口功能介绍
基线检测-编辑白名单
接口约束
无
URI
POST /v1/sca/check/update
路径参数 无
Query参数 无
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| checkidList | 否 | Array of Integers | 检查项Id数据,需要加白的检测项id | [160001] | |
| osType | 否 | String | 操作系统类型 Linux/Windows | Linux | |
| id | 是 | Integer | 待编辑的白名单条目id | 10001 | |
| effectScope | 是 | String | 作用范围 ALL-全选 OPTIONAL-自选 | ALL | |
| agentGuids | 否 | Array of Strings | guid列表 effectScope=OPTIONAL-自选必填 | ["111-111"] | |
| description | 否 | String | 白名单描述 | test |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| error | String | 返回码 | ||
| CTCSSCN_000000:成功 | ||||
| CTCSSCN_000001:失败 | ||||
| CTCSSCN_000003:用户未签署协议,安全卫士系统无法正常使用 | ||||
| CTCSSCN_000004:鉴权错误 | ||||
| CTCSSCN_000005:用户没有付费版配额,功能不可用 | CTCSSCN_000000 | |||
| message | String | 返回信息 | success | |
| returnObj | Object | 返回对象 | ||
| traceId | String | traceId | asaadasd11111 | |
| statusCode | String | 状态码 200-成功 | 200 |
枚举参数
无
请求示例
请求url
无
请求头header
{"Content-Type": "application/json"}
请求体body
{"checkidList": [160001], "osType": "Linux", "id": 10001, "effectScope": "ALL", "agentGuids": ["111-111"], "description": "test"}
响应示例
{"message": "success", "traceId": "asaadasd11111", "statusCode": "200", "error": "CTCSSCN_000000", "returnObj": ""}
状态码
请参考 状态码
错误码
请参考 错误码