getInstalledPatches
使用此方法可请求获取与特定终端或公司相关联的已安装补丁列表。
这些是公共API所有方法均可使用的通用参数。
|
参数 |
描述 |
包含于请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
该参数为请求添加标识符，使其与对应响应建立关联。 目标端在响应中返回相同值，便于调用追踪。 |
必填 |
字符串 |
无额外要求 |
|
|
用于发送请求的方法名称。 |
必填 |
字符串 |
必须是有效的方法名称。 |
|
|
请求和响应所使用的JSON-RPC版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置的对象。 |
必填 |
对象 |
无额外要求。 |
|
在
|
||||
|
|
结果页码。 |
可选 |
整数 |
默认值：
|
|
|
每页显示的结果数量。 |
可选 |
整数 |
每页上限为100项。
默认值：
|
参数
|
参数 |
描述 |
包含于请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
需获取补丁信息的端点ID。 |
可选 |
数组 |
无额外要求。 默认值：若请求未包含此参数，则返回公司所有受管端点的结果。 |
|
|
决定响应中应包含的补丁类型。 |
可选 |
对象 |
默认值：若请求未包含此参数，将返回所有筛选器（无论类型或严重级别）。 |
对象
筛选器
|
参数 |
描述 |
是否包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
指定响应中需包含的补丁类型。 |
可选 |
整数 |
可选值：
默认值：若未指定，则响应包含所有补丁类型。 |
|
|
指定响应中需包含的补丁严重级别 |
可选 |
整数 |
可选值：
默认值：若未包含此参数，则响应中将包含所有补丁严重性等级。 |
有关查看补丁设置的更多信息，请参阅 查看补丁详情 .
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串 |
安装补丁的终端ID。 |
|
|
字符串 |
补丁名称。 |
|
|
字符串 |
补丁发布日期。 |
|
|
字符串 |
与此补丁关联的公告URL。 |
|
|
字符串数组 |
与该补丁关联的CVE ID列表。 |
|
|
字符串 |
与该补丁关联的Microsoft知识库(KB)文章。 |
|
|
字符串数组 |
与该补丁关联的供应商列表。 |
|
|
整数 |
补丁适用的操作系统。 可选值：
|
|
|
补丁类型。 |
补丁类型。 可选值：
|
示例
请求 :
请求获取端点列表的补丁列表：
{
"params": {
"filters":{
"type": 1
},
"page": 2
},
"jsonrpc": "2.0",
"method": "getInstalledPatches",
"id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
}
响应 :
{
"id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b",
"jsonrpc": "2.0",
"result": {
"items": [
{
"endpointId": "67bc4a36bf64962c160eb6e0",
"name": "Windows6.0-SP2-KB973768-x64.msu",
"releaseDate": null,
"bulletinUrl": "http://technet.microsoft.com/security/bulletin/ms09-037",
"cves": [
"CVE-2008-0015",
"CVE-2009-0901",
"CVE-2009-2493",
"CVE-2009-2494",
"CVE-2008-0020"
],
"kbNumber": "Q973768",
"vendorNames": [
"Microsoft"
],
"operatingSystem": 1,
"type": 0
}
],
"total": 99,
"page": 1,
"perPage": 1,
"pagesCount": 99
}
}