Li, Qiao a5e72d5590 HSS API 20240206 version

Reviewed-by: Belejkanic, Lukas <lukas.belejkanic@t-systems.com>
Reviewed-by: Drobnak, David <david.drobnak@t-systems.com>
Co-authored-by: Li, Qiao <qiaoli@huawei.com>
Co-committed-by: Li, Qiao <qiaoli@huawei.com>

2024-05-28 20:54:21 +00:00

10 KiB

Raw Permalink Blame History

Changing the Status of a Vulnerability

Function

This API is used to change the status of a vulnerability.

URI

PUT /v5/{project_id}/vulnerability/status

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID Minimum: 1 Maximum: 256

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	Enterprise project ID. The value 0 indicates the default enterprise project. To query all enterprise projects, set this parameter to all_granted_eps. Default: 0 Minimum: 0 Maximum: 128

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token. Minimum: 32 Maximum: 4096
Content-Type	No	String	Default value: application/json; charset=utf-8 Minimum: 0 Maximum: 128

**Table 4** Request body parameters
Parameter	Mandatory	Type	Description
operate_type	Yes	String	Operation type. Its value can be: ignore not_ignore: unignore immediate_repair: fix verify
data_list	Yes	Array of VulOperateInfo objects	Vulnerability list Array Length: 1 - 500

**Table 5** VulOperateInfo
Parameter	Mandatory	Type	Description
vul_id	Yes	String	Vulnerability ID Minimum: 1 Maximum: 64
host_id_list	Yes	Array of strings	Server list Minimum: 1 Maximum: 64 Array Length: 1 - 500

Response Parameters

None

Example Requests

Change the vulnerability status of the server whose ID is 71a15ecc-049f-4cca-bd28-5e90aca1817f. Change the status of EulerOS-SA-2021-1894 to ignored.

{
  "operate_type" : "ignore",
  "data_list" : [ {
    "vul_id" : "EulerOS-SA-2021-1894",
    "host_id_list" : [ "71a15ecc-049f-4cca-bd28-5e90aca1817f" ]
  } ]
}

Example Responses

None

Status Codes

Status Code	Description
200	Successful

Error Codes

See Error Codes.

Parent topic: Vulnerability Management

10 KiB Raw Permalink Blame History