更新时间：2026-09-30 GMT+08:00

修改紧急漏洞已读状态 - SetEmergencyVulnerabilityReadStatus

功能介绍

修改紧急漏洞已读状态，支持全部标记和部分标记

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。

URI

POST /v1/{project_id}/workspaces/{workspace_id}/sa/vulnerability/read-status

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取项目ID 约束限制：不涉及取值范围：不涉及默认取值：不涉及
workspace_id	是	String	参数解释：工作空间id。约束限制：不涉及取值范围：不涉及默认取值：不涉及

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
mode	是	String	参数解释：操作模式，指定标记已读状态的范围。约束限制：不涉及取值范围： all：全部标记 part：部分标记默认取值：不涉及
vulnerability_ids	否	Array of strings	参数解释：漏洞ID列表，当mode为part时必填。约束限制：当mode为part时，该字段不能为空。
status	是	Integer	参数解释：已读状态值。约束限制：不涉及取值范围： 0：未读 1：已读默认取值：不涉及

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
code	String	参数解释：错误码。取值范围：不涉及
message	String	参数解释：错误信息。取值范围：不涉及
data	String	参数解释：返回结果，成功时返回success。取值范围：不涉及

状态码：400

表4 响应Body参数
参数	参数类型	描述
code	String	参数解释: 错误码取值范围: 不涉及
message	String	参数解释: 错误描述取值范围: 不涉及

请求示例

https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/sa/vulnerability/read-status

{
  "mode" : "part",
  "vulnerability_ids" : [ "KB*****5" ],
  "status" : 1
}

响应示例

状态码：200

{
  "code" : "00000000",
  "message" : "",
  "data" : "success"
}

状态码

状态码	描述
200	修改紧急漏洞已读状态返回体
400	修改紧急漏洞已读状态错误返回body体

错误码

请参见错误码。

父主题：漏洞管理