导入漏洞 - ImportVulnerabilities
功能介绍
批量导入漏洞,根据template下载的模板填写漏洞,漏洞的所有字段根据是否必填来限制,参照:安全事件数据对象定义中的类型和说明来确定, 后台实现时需要校验
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/workspaces/{workspace_id}/soc/vulnerability/import
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| workspace_id | 是 | String | 参数解释: 工作空间id。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| uploadFile | 是 | File | 导入漏洞文件 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 错误码 |
| message | String | 错误信息 |
| data | data object | 漏洞导入结果返回数据 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| code | String | 参数解释: 错误码 取值范围: 不涉及 |
| message | String | 参数解释: 错误描述 取值范围: 不涉及 |
请求示例
https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/soc/vulnerability/import
file stream 响应示例
状态码:200
{
"code" : "000000",
"message" : "",
"data" : {
"ids" : [ "b779*****b1", "c880*****c2", "d991*****d3" ]
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 导入漏洞返回body体 |
| 400 | 导入漏洞错误返回body体 |
错误码
请参见错误码。