getInstalledPatches
调用此方法可获取与特定终端或公司关联的已安装补丁列表
这些是公共API所有方法均可使用的通用参数
|
参数 |
描述 |
请求包含项 |
类型 |
取值 |
|---|---|---|---|---|
|
|
该参数为请求添加标识符，将其与对应响应关联。 目标方在响应中返回相同值，便于调用追踪。 |
必填 |
字符串 |
无额外要求 |
|
|
发送请求时所调用的方法名称。 |
必填 |
字符串 |
必须是有效的方法名。 |
|
|
请求与响应所使用的JSON-RPC版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置的对象。 |
必填 |
对象 |
无额外要求。 |
|
在
|
||||
|
|
结果页码。 |
可选 |
整数 |
默认值：
|
|
|
每页显示的结果数量。 |
可选 |
整数 |
每页上限为100项。
默认值：
|
参数
|
参数 |
描述 |
是否包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
需要获取补丁信息的终端ID。 |
必填 |
数组 |
无额外要求。 |
|
|
决定响应中应包含的补丁类型。 |
可选 |
对象 |
默认值：若请求中未包含此参数，则返回所有过滤器，无论其类型或严重级别。 |
对象
filters
|
参数 |
描述 |
是否包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
希望响应中包含的补丁类型。 |
可选 |
整数 |
可选值：
默认值：若未指定，则响应中包含所有补丁类型。 |
|
|
希望响应中包含的补丁严重级别 |
可选 |
整数 |
可选值：
默认值：若未指定，则响应中包含所有补丁严重级别。 |
有关查看补丁设置的更多信息，请参阅 查看补丁详情 .
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串 |
安装补丁的终端ID。 |
|
|
字符串 |
补丁名称。 |
|
|
字符串 |
补丁发布的日期。 |
|
|
字符串 |
与此补丁关联的公告URL。 |
|
|
字符串数组 |
与该补丁关联的CVE ID列表。 |
|
|
字符串 |
与此补丁关联的Microsoft知识库(KB)文章。 |
|
|
字符串数组 |
与该补丁关联的供应商列表。 |
|
|
整数 |
补丁适用的操作系统。 可能取值：
|
|
|
补丁的类型。 |
补丁的类型。 可能取值：
|
示例
请求 :
请求特定公司的补丁列表：
{
"params": {
"companyId": "67bc4346c9c8243e9c0f6314",
"filters":{
"type": 0,
"severity": 1
},
"page": 1,
"perPage": 5
},
"jsonrpc": "2.0",
"method": "getInstalledPatches",
"id": "301f7b05-ec02-481b-9ed6-c07b97de2b7b"
}
请求端点列表的补丁列表：
{
"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
}
}