Changing the Status of a Vulnerability

Function

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

Calling Method

For details, see Calling APIs.

URI

PUT /v5/{project_id}/vulnerability/status

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

**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. Minimum: 0 Maximum: 128

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
x-auth-token	Yes	String	iam token Minimum: 32 Maximum: 4096

**Table 4** Request body parameters
Parameter	Mandatory	Type	Description
operate_type	Yes	String	Operation type. ignore not_ignore: unignore immediate_repair: fix verify Minimum: 1 Maximum: 64
remark	No	String	Remarks Minimum: 0 Maximum: 512
select_type	No	String	Select vulnerabilities. all_vul: Select all vulnerabilities. all_host: Select all server vulnerabilities. Minimum: 1 Maximum: 64
type	No	String	Vulnerability type. The default value is linux_vul. The options are as follows: linux_vul: Linux vulnerability windows_vul: Windows vulnerability web_cms: Web-CMS vulnerability app_vul: application vulnerability Minimum: 0 Maximum: 64
data_list	Yes	Array of VulOperateInfo objects	Vulnerability list Array Length: 1 - 500
host_data_list	No	Array of HostVulOperateInfo objects	Vulnerability list in the server dimension Array Length: 1 - 500
backup_info_id	No	String	Specifies the ID of the backup information processed by the vulnerability. If this parameter is not specified, the backup is not performed. Minimum: 1 Maximum: 128
custom_backup_hosts	No	Array of custom_backup_hosts objects	Customize the vault and backup name used by the backup host. For hosts that are not in the list, the system automatically selects the vault with the largest remaining space and generates a backup name. Array Length: 1 - 50

**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

**Table 6** HostVulOperateInfo
Parameter	Mandatory	Type	Description
host_id	Yes	String	Server ID Minimum: 1 Maximum: 64
vul_id_list	Yes	Array of strings	Vulnerability list Minimum: 1 Maximum: 64 Array Length: 1 - 500

**Table 7** custom_backup_hosts
Parameter	Mandatory	Type	Description
host_id	No	String	Host ID Minimum: 1 Maximum: 128
vault_id	No	String	Vault ID Minimum: 1 Maximum: 128
backup_name	No	String	Backup name Minimum: 1 Maximum: 64

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" ]
  } ]
}