分页查询受指定漏洞影响的用户终端设备及其修复状态。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| CurrentPage |
integer |
是 |
分页查询时显示的当前页的页码。取值：1~10000。 |
1 |
| PageSize |
integer |
是 |
分页查询时设置的每页数量。取值：1~1000。 |
10 |
| UpdateId |
string |
否 |
漏洞对应的补丁包 ID。长度不超过 64 个字符。取值来源：
|
9f8c1d2e-4b7a-4c31-9e05-6d2f8a71**** |
| Username |
string |
否 |
用户名，支持模糊查询。长度不超过 128 个字符，支持中文、大小写英文字母、数字及半角句点（.）、下划线（_）、星号（*）、连字符（-）、@、空格、中间点（·）、圆括号。 |
王先生 |
| SaseUserId |
string |
否 |
用户 ID，精确匹配。取值来源：
|
su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d**** |
| Department |
string |
否 |
部门名称，匹配用户所属组织架构中的任一层级部门。填写部门名称本身，不需要填写组织架构的完整路径。 |
研发部 |
| DevTag |
string |
否 |
用户终端设备的唯一标识，精确匹配。长度不超过 64 个字符。取值来源：
|
36efa42d-2c32-c4dc-e3fc-8541e33a**** |
| DevType |
string |
否 |
用户终端设备的操作系统类型。取值：
枚举值：
|
windows |
| Hostname |
string |
否 |
用户终端设备的主机名，支持模糊查询。长度不超过 64 个字符。 |
DESKTOP-8A3F |
| Status |
string |
否 |
按修复状态过滤。取值：
枚举值：
|
Pending |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
本次请求的 ID。 |
3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7 |
| TotalNum |
integer |
符合查询条件的用户终端设备总数。 |
37 |
| Devices |
array<object> |
用户终端设备列表。 |
|
|
object |
受该漏洞影响的用户终端设备及其修复状态。 |
||
| DevType |
string |
用户终端设备的操作系统类型。取值：
枚举值：
|
windows |
| DevTag |
string |
用户终端设备的唯一标识。 |
36efa42d-2c32-c4dc-e3fc-8541e33a**** |
| Hostname |
string |
用户终端设备的主机名。 |
DESKTOP-8A3F |
| SaseUserId |
string |
用户 ID。 |
su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d**** |
| Username |
string |
用户名。 |
王先生 |
| Department |
string |
用户所属部门名称，多个部门用半角逗号（,）分隔。取组织架构中距离用户最近的一级部门名称，不返回完整路径。 |
研发部,安全组 |
| ScanTime |
integer |
首次在该用户终端设备上检出此漏洞的时间，秒级 Unix 时间戳。 |
1786291200 |
| Status |
string |
修复状态。取值：
枚举值：
|
Pending |
| LastFixTime |
integer |
最近一次对该用户终端设备下发修复的时间，秒级 Unix 时间戳。从未下发过修复时返回 0。 |
1786291200 |
| FixTaskId |
string |
最近一次修复该漏洞的漏洞修复任务 ID。从未下发过修复时返回空字符串。 |
vul-fix-task-2f5c8e1a7b94**** |
| IsExpired |
boolean |
最近一次修复是否已超时。Status 取值为 Downloading 或 Installing，且距 LastFixTime 已超过 24 小时时返回 true，表示终端长时间未上报修复结果，需要重新下发修复。取值：
枚举值：
|
false |
示例
正常返回示例
JSON格式
{
"RequestId": "3D7EC0AF-DB2A-5D9C-90EC-F090A6BAAEA7",
"TotalNum": 37,
"Devices": [
{
"DevType": "windows",
"DevTag": "36efa42d-2c32-c4dc-e3fc-8541e33a****",
"Hostname": "DESKTOP-8A3F",
"SaseUserId": "su_e8f218fb171edd167c2ad917d21f53148bdefc510ca1f3c3cc0249d3643d****",
"Username": "王先生",
"Department": "研发部,安全组",
"ScanTime": 1786291200,
"Status": "Pending",
"LastFixTime": 1786291200,
"FixTaskId": "vul-fix-task-2f5c8e1a7b94****",
"IsExpired": false
}
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。