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
describe	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" ?>

<patch>

<patchicon>aw-image-patch-installed</patchicon>

<statusLabel>Installed</statusLabel>

<patchUrl>http://go.microsoft.com/fwlink/?LinkId=184779</patchUrl>

<patchTitle>Security Update for Windows <xxx> (KBxxxxxx)</patchTitle>

<product>Windows</product>

</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: 0 - No policy exists 1 - Install feature/patch 2 - Do not install feature/patch 3 - Inherit policy from parent
patchicon	string	yes	Generalized status icon: aw-image-patch-failed aw-image-patch-installed aw-image-patch-missing aw-image-patch-pending aw-image-patch-installing aw-image-patch-ignored
status	integer	no	The patch status (bit flags) 0x01 - Missing 0x02 - Pending 0x04 - Queued 0x08 - Installed 0x10 - Failed 0x20 - Ignored
selectpatch	string	yes	Will be empty if the patch status is : Missing Pending Ignored Failed otherwise will show as 'checkhide' for all other statuses
statusLabel	string	no	Installation status: Missing Pending Queued Installed Failed Ignored
patchUrl	string	yes	External link to patch description, for example: http://support.microsoft.com/kb/979441
patchTitle	string	no	Title/name of the patch, for example: Security Update for Microsoft Office InfoPath 2007 (KB979441)
product	string	no	Product identifier, for example: Office
severity	integer	yes	The severity of the vulnerability the patch addresses. 1 (Critical) 2 (Important) 3 (Moderate) 4 (Low) See [http://www.microsoft.com/technet/security/bulletin/rating.mspx Microsoft Security Response Center Security Bulletin Severity Rating System]
severityLabel	string	yes	Severity level name. Critical Important Moderate Low See [http://www.microsoft.com/technet/security/bulletin/rating.mspx Microsoft Security Response Center Security Bulletin Severity Rating System]
releaseDate	int	yes	Patch release date/time (timestamp)
releaseDateText	datetime	yes	Patch release date/time human format, for example: 28-Jul-2011
installdate	int	yes	Installation date/time (timestamp)
installdatetext	datetime	yes	Installation date/time human format, for example: 28-Jul-2011

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