nav-img
Advanced

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
}

Status Codes

Status Code

Description

200

Request succeeded.

Error Codes