Querying Vulnerability Management Statistics

Function

This API is used to query vulnerability management statistics.

URI

GET /v5/{project_id}/vulnerability/statistics

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	Enterprise user 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.

Response Parameters

Status code: 200

**Table 4** Response body parameters
Parameter	Type	Description
need_urgent_repair	Integer	Number of vulnerabilities that need to be fixed urgently
unrepair	Integer	Number of vulnerabilities not fixed
existed_vul_hosts	Integer	Number of servers with vulnerabilities
today_handle	Integer	Vulnerabilities handled today
all_handle	Integer	Total handled vulnerabilities
supported	Integer	Supported vulnerabilities
vul_library_update_time	Long	Vulnerability library updated

Example Requests

Query vulnerability statistics whose project_id is 2b31ed520xxxxxxebedb6e57xxxxxxxx.

GET https://{endpoint}/v5/2b31ed520xxxxxxebedb6e57xxxxxxxx/vulnerability/statistics

Example Responses

Status code: 200

Request succeeded.

{
  "need_urgent_repair" : 22,
  "unrepair" : 23,
  "existed_vul_hosts" : 33,
  "today_handle" : 77,
  "all_handle" : 44,
  "supported" : 78,
  "vul_library_update_time" : 1692170925188
}