List all Patches for device
Use this API Call to query our Data Extraction API to extract data gathered by N-sight RMM.This section shows the service name and parameters needed in the API Call query, and provides examples of some queries and system responses. For more information, see Data Extraction API.
Service name: patch_list_all |
|
URL |
https://SERVER/api/?apikey=yourAPIkey&service=patch_list_all &required_parameters=required_parameters [&optional_parameters=optional_parameters] |
Description |
Lists all software patches for the specified device. |
Parameters |
|||||
Post Variable |
Description |
Type |
Required |
Options |
Default |
Optional. Returns a description of the service. |
boolean |
no |
true |
0 |
|
deviceid |
The deviceid must be a valid id. |
number |
yes |
0 |
0 |
Example Service Call =patch_list_all |
https://SERVER/api/?apikey=yourAPIkey&service=patch_list_all&deviceid=DEVICEID |
Example Response |
<?xml version="1.0" ?> <patches> <patch> <patchid>78</patchid> <policy>4</policy> <patchicon>aw-image-patch-installed</patchicon> <status>8</status> <statusLabel>Installed</statusLabel> <patchUrl>http://go.microsoft.com/fwlink/?LinkId=184779</patchUrl> <patchTitle>Security Update for Windows <xxx> (KBxxxxxx)</patchTitle> <product>Windows</product> <severity>4</severity> <severityLabel>Low</severityLabel> <releaseDate>1300471870</releaseDate> <releaseDateText>18-Mar-2011</releaseDateText> <installdate>1303187104</installdate> <installdatetext>19-Apr-2011</installdatetext> </patch> ... more patch nodes ... </patches> </result> |
Field Descriptions |
|||
Field |
Type |
Can Be Empty |
Description |
patchid |
integer |
no |
The unique identifier of the patch |
policy |
integer |
no |
Policy setting: |
patchicon |
string |
yes |
Generalized status icon: |
status |
integer |
no |
The patch status (bit flags) |
statusLabel |
string |
no |
Installation status: |
patchUrl |
string |
yes |
External link to patch description, for example: |
patchTitle |
string |
no |
Title/name of the patch, for example: |
product |
string |
no |
Product identifier, for example: |
severity |
integer |
yes |
The severity of the vulnerability the patch addresses. |
severityLabel |
string |
yes |
Severity level name. |
releaseDate |
int |
yes |
Patch release date/time (timestamp) |
releaseDateText |
datetime |
yes |
Patch release date/time human format, for example: |
installdate |
int |
yes |
Installation date/time (timestamp) |
installdatetext |
datetime |
yes |
Installation date/time human format, for example: |
Example Associated Service Calls | ||
Parameter | Call | URL Format |
DeviceID | list_devices_at_client |
https://SERVER/api/?apikey=yourAPIkey&service=list_devices_at_client&clientid=CLIENTID&devicetype=server |
list_servers |
https://SERVER/api/?apikey=yourAPIkey&service=list_servers&siteid=SITEID |
|
list_workstations |
https://SERVER/api/?apikey=yourAPIkey&service=list_workstations&siteid=SITEID |
|
SiteID | list_sites | https://SERVER/api/?apikey=yourAPIkey&service=list_sites&clientid=CLIENTID |
ClientID | list_clients | https://SERVER/api/?apikey=yourAPIkey&service=list_clients |