获取已安装补丁
调用此方法可请求获取与特定终端或公司关联的已安装补丁列表。
这些是公共API所有方法均可使用的通用参数。
|
参数 |
说明 |
包含于请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
该参数为请求添加标识符，使其与对应响应建立关联。 目标端在响应中返回相同值，便于调用追踪。 |
必填 |
字符串 |
无额外要求 |
|
|
用于发送请求的方法名称。 |
必填 |
字符串 |
必须是有效的方法名。 |
|
|
请求和响应所使用的JSON-RPC版本。 |
必填 |
整数 |
可选值：
|
|
|
包含请求配置的对象。 |
必填 |
对象 |
无额外要求。 |
|
在
|
||||
|
|
结果页码。 |
可选 |
整数 |
默认值：
|
|
|
每页显示的结果数量。 |
可选 |
整数 |
每页上限为100项。
默认值：
|
参数
|
参数 |
描述 |
包含在请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
需要获取补丁信息的终端ID。 |
必填 注意
请求中必须包含
二者互斥 |
数组 |
无额外要求。 |
|
|
需要获取补丁信息的公司ID。 |
字符串 |
无额外要求。 |
|
|
|
决定响应中应包含的补丁类型。 |
可选 |
对象 |
默认值：若请求未包含此参数，将返回所有过滤器，无论严重等级类型。 |
对象
filters
|
参数 |
描述 |
包含于请求中 |
类型 |
取值 |
|---|---|---|---|---|
|
|
希望响应中包含的补丁类型。 |
可选 |
整数 |
可选值：
默认值：若未指定，则响应包含所有补丁类型。 |
|
|
希望包含在响应中的补丁严重级别 |
可选 |
整数 |
可选值：
默认值：若未指定，则响应包含所有补丁严重级别。 |
有关查看补丁设置的更多信息，请参阅 查看补丁详情 .
返回值
|
属性 |
类型 |
描述 |
|---|---|---|
|
|
字符串 |
安装该补丁的终端点ID。 |
|
|
字符串 |
补丁名称。 |
|
|
字符串 |
补丁发布日期。 |
|
|
字符串 |
该补丁关联公告的URL。 |
|
|
字符串数组 |
与该补丁关联的CVE ID列表。 |
|
|
字符串 |
该补丁关联的微软知识库(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
}
}