查询漏洞管理统计数据 - ShowVulStatics
功能介绍
查询漏洞管理统计数据
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v5/{project_id}/vulnerability/statistics
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
enterprise_project_id |
否 |
String |
主机所属的企业项目ID。 开通企业项目功能后才需要配置企业项目。 企业项目ID默认取值为“0”,表示默认企业项目。如果需要查询所有企业项目下的主机,请传参“all_granted_eps”。如果您只有某个企业项目的权限,则需要传递该企业项目ID,查询该企业项目下的主机,否则会因权限不足而报错。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值) |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
need_urgent_repair |
Integer |
需紧急修复的漏洞数 |
|
unrepair |
Integer |
未完成修复的漏洞数 |
|
existed_vul_hosts |
Integer |
存在漏洞的服务器数 |
|
today_handle |
Integer |
今日处理漏洞数 |
|
all_handle |
Integer |
累计处理漏洞数 |
|
supported |
Integer |
已支持漏洞数 |
|
vul_library_update_time |
Long |
漏洞库更新时间 |
请求示例
查询project_id为2b31ed520xxxxxxebedb6e57xxxxxxxx的漏洞统计数据
GET https://{endpoint}/v5/2b31ed520xxxxxxebedb6e57xxxxxxxx/vulnerability/statistics
响应示例
状态码:200
请求已成功
{
"need_urgent_repair" : 22,
"unrepair" : 23,
"existed_vul_hosts" : 33,
"today_handle" : 77,
"all_handle" : 44,
"supported" : 78,
"vul_library_update_time" : 1692170925188
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求已成功 |
错误码
请参见错误码。