All Systems 


This API lists the status of all the computers.

  • Functionality
  • Retrieve the all system list.
  • HTTP Method 
  • GET
  • API URI
  • api/1.4/patch/allsystems
  • Scope
  • PatchManagerPlusCloud.PatchMgmt.READ
  • Filters
  • domainfilter={String}:
    Get domain list from api/1.4/desktop/serverproperties

    branchofficefilter={String}:
    Get branch office list from api/1.4/desktop/serverproperties

    customgroupfilter={String}:
    Get Custom Group list from api/1.4/desktop/serverproperties

    platformfilter={String}:
    Windows/Mac

    resid={Numeric}:
    Filter for system with a resource id

    healthfilter={Numeric}:
    0 - Unknown
    1 - Healthy
    2 - Vulnerable
    3 - Highly Vulnerable
  • Response Parameters
  • computer_live_status:

    1 - Live
    2 - Down

    scan_status:

    226 - Failed
    227 - In Progress
    228 - Success
    229 - Not Scanned

    resource_health_status:

    0 - Unknown
    1 - Healthy
    2 - Vulnerable
    3 - Highly Vulnerable

Response Data

     { 	"message_type": "allsystems", 	"message_response": { 		"allsystems": [ 			{ 				"resource_health_status": 3, 				"os_language": 1, 				"branchmemberresourcerel.resource_id": 301, 				"branch_office_id": 1, 				"last_patched_time": 1553069752000, 				"os_platform_name": "Windows", 				"pmreshealthstatus.resource_id": 301, 				"installed_tp_patches": 9, 				"installed_ms_patches": 12, 				"important_patch_count": 2, 				"service_pack": "Windows 10 Version 1809 (x64)", 				"resourcetorebootdetails.resource_id": "--", 				"pmresourcepatchcount.resource_id": 301, 				"resourcetorebootdetails.reboot_req_status": "--", 				"os_language_abbr": "en", 				"resourcedeploymentstatus.resource_id": 301, 				"scan_remarks": "dc.patch.util.Scanning_completedsuccessfully", 				"os_platform": 1, 				"agent_logged_on_users": "XXXX-1234", 				"total_ms_patches": 14, 				"osflavor_id": 0, 				"search_tag": "--", 				"status_label": "dc.db.config.status.failed", 				"owner_email_id": "--", 				"missing_ms_patches": 2, 				"last_action_initiated_on": "--", 				"missing_tp_patches": 3, 				"low_patch_count": 0, 				"patchmgmtosinfo.resource_id": 301, 				"last_successful_scan": 1553073465582, 				"computer_status_update_time": 1553063563662, 				"branch_office_name": "Local Office", 				"agent_last_contact_time": 1553069591000, 				"total_tp_patches": 12, 				"description": "--", 				"critical_patch_count": 2, 				"domain_netbios_name": "ZOHOCORP", 				"mac_address": "1a:aa:1a:1a:11:1a", 				"resource.resource_id": 301, 				"shutdown_status_update_time": "--", 				"moderate_patch_count": 1, 				"owner": "--", 				"scan_status": 228, 				"timezone_offset": "330", 				"oslanguage.languageid": 1, 				"last_sync_time": 1553074057839, 				"deployment_status": 206, 				"oslanguage.i18n": "dc.patch.patchinfo.English", 				"ip_address": "XXX.XXX.XXX.XXX", 				"shutdown_status": "--", 				"agent_last_bootup_time": 1552885231000, 				"resource_id": 301, 				"os_name": "Windows 10 Professional Edition (x64)", 				"location": "--", 				"computer_live_status": 1, 				"resource_name": "XXXX-YYYY", 				"last_scan_time": 1553073465582, 				"remarks": "--", 				"last_operation": "--", 				"status_image": "/images/failureicon.gif" 			}, 		], 		"total": 2, 		"limit": 25, 		"page": 1 	}, 	"message_version": "1.0", 	"status": "success", 	"response_code": 200 }