DescribeGroupedVul
Description
Get the information of the specified vulnerability group. Vulnerability management supports displaying detected vulnerability records in the form of vulnerability groups, which contain all host assets detected by Server Guard.
Request Method
POST
Request Path
/apsara/route/Sas/DescribeGroupedVul
Request Parameters Common Parameters
Name | Location | Type | Required | Sample value | Description |
---|---|---|---|---|---|
OrderBy | BODY | string | No | No sample value for this parameter. | sort fields, which can be sorted by specifying other request parameter fields. |
LastTsStart | BODY | long | No | No sample value for this parameter. | the detection start time of the last detection discovery time of the vulnerability. |
PageSize | BODY | integer | No | No sample value for this parameter. | specifies the maximum number of records per page in the returned result. default value: 20 |
StatusList | BODY | string | No | No sample value for this parameter. | vulnerability status, value range: 1: indicates not repaired 2: indicates that the repair failed 3: indicates rollback failure 4: indicates that it is being repaired 5: means rollback 6: indicates that verification is in process 7: indicates that the repair was successful 8: indicates that the repair is successful and needs to be restarted 9: indicates successful rollback 10: indicates that it has been ignored 11: indicates a successful rollback to be restarted 12: indicates that the vulnerability no longer exists 20: indicates that the vulnerability has expired Description Separate multiple states. |
Necessity | BODY | string | No | No sample value for this parameter. | Vulnerability repair necessity, value range: asap: indicates that it needs to be repaired as soon as possible later: indicates that the repair can be delayed nntf: indicates that it can not be repaired for the time being |
Product | BODY | string | No | No sample value for this parameter. | the product corresponding to the vulnerability. |
PatchId | BODY | long | No | No sample value for this parameter. | the patch ID corresponding to the vulnerability. |
Dealed | BODY | string | No | No sample value for this parameter. | whether the vulnerability has been processed. Y: indicates processed N: indicates unprocessed |
Direction | BODY | string | No | No sample value for this parameter. | Vulnerability grouping sorting method, value range: asc: indicates sequential arrangement desc: indicates reverse order |
version | BODY | string | No | 2016-01-01 | version of api |
Name | BODY | string | No | No sample value for this parameter. | vulnerability name. |
LastTsEnd | BODY | long | No | No sample value for this parameter. | the detection end time of the last detection discovery time of the vulnerability. |
Type | BODY | string | No | No sample value for this parameter. | vulnerability type. |
CurrentPage | BODY | integer | No | No sample value for this parameter. | specifies the number of pages currently returned. default value: 1 |
regionId | BODY | string | Yes | No sample value for this parameter. | region id |
Level | BODY | string | No | No sample value for this parameter. | vulnerability level, value range: serious: indicates serious high: indicates high risk medium: indicates medium risk low: indicates low risk |
Uuids | BODY | string | No | No sample value for this parameter. | host asset UUID, specifying multiple host asset UUIDs separated. |
Return data
Name | Type | Sample value | Description |
---|---|---|---|
PendingCount | integer | no demo value | number of unhandled vulnerabilities. |
RequestId | string | no demo value | request ID. |
PageSize | integer | no demo value | page displays the maximum number of records. |
GmtLast | long | no demo value | the last discovery time of the vulnerability. |
Stauts | integer | no demo value | vulnerability status. |
AsapCount | integer | no demo value | the number of assets that need to be repaired as soon as possible. |
Product | string | no demo value | products affected by the vulnerability. |
Count | integer | no demo value | total number of vulnerabilities. |
Name | string | no demo value | vulnerability name. |
TotalCount | integer | no demo value | total number of vulnerabilities. |
Type | string | no demo value | vulnerability type. |
CurrentPage | integer | no demo value | currently returns page number. |
HandledCount | integer | no demo value | number of handled vulnerabilities. |
GroupedVulItems | array | no demo value | vulnerability grouping information, see the following parameter description for specific sub-items. |
AliasName | string | no demo value | vulnerability alias. |
Level | string | no demo value | vulnerability level. |
Example
Successful Response example
{
"PendingCount":"no demo value",
"RequestId":"no demo value",
"PageSize":"no demo value",
"GmtLast":"no demo value",
"Stauts":"no demo value",
"AsapCount":"no demo value",
"Product":"no demo value",
"Count":"no demo value",
"Name":"no demo value",
"TotalCount":"no demo value",
"Type":"no demo value",
"CurrentPage":"no demo value",
"HandledCount":"no demo value",
"GroupedVulItems":"no demo value",
"AliasName":"no demo value",
"Level":"no demo value"
}
Failed Response example
{
"errorSample":
{
"resultCode":-1,
"resultMsg":"system error",
"result":null
}
}