# 修改紧急漏洞已读状态 - SetEmergencyVulnerabilityReadStatus
#### 功能介绍
修改紧急漏洞已读状态，支持全部标记和部分标记
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-secmaster/secmaster_03_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-secmaster/secmaster_03_0023.html)。
#### URI
POST /v1/{project_id}/workspaces/{workspace_id}/sa/vulnerability/read-status
表1路径参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| project_id   | 是    | String | **参数解释：** 项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。[获取项目ID](https://support.huaweicloud.com/api-secmaster/secmaster_03_0014.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| 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体 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-secmaster/ErrorCode.html)。