System Report


This API lists report for patches in a given system.

  • Functionality
  • Retrieve the list of patches and their status for a system.
  • HTTP Method 
  • GET
  • API URI
  • api/1.4/patch/systemreport?resid={resource_id}
  • Scope
  • PatchManagerPlusCloud.PatchMgmt.READ
  • Filters
  • platformfilter={String}:

    Windows/Mac

    patchstatusfilter={Numeric}:

    201 - Installed
    202 - Missing

    approvalstatusfilter={Numeric}:

    211 - Approved
    210 - Not Approved

    severityfilter={Numeric}:

    0 - Unrated
    1 - Low
    2 - Moderate
    3 - Important
    4 - Critical
  • Response Parameters
  • patch_noreboot:

    0 - Not Required
    1 - Reboot Required

    severity:

    0 - Unrated
    1 - Low
    2 - Moderate
    3 - Important

    patch_status:

    211 - Approved
    212 - Declined
    0 - Not Approved

    affected_patch_status:

    201 - Approved
    202 - Declined
    0 - Not Approved

    download_status_id:

    221 - Downloaded
    "--" - Yet to download

Response Data

 { 	"message_type": "systemreport", 	"message_response": { 		"total": 64, 		"systemreport": [ 			{ 				"update_id": 0, 				"installstatusdefn.label": "dc.common.INSTALLED", 				"installpatchstatus.patch_id": 9110, 				"install_error_code": -1, 				"bulletin_id": "MS10-063", 				"patch_noreboot": 0, 				"update_name": "Security Updates", 				"platform": 1, 				"configstatusdefn.image_name": "/images/approved_icon.gif", 				"deploy_remarks": "dc.db.agent.config.patchscan.success", 				"patch_released_time": 1284402600000, 				"customerpatchstatus.patch_id": 9110, 				"patch_uninstall_status": 1, 				"download_status": 221, 				"platform_name": "Windows", 				"affectedpatchstatusdefn.image_name": "/images/success.gif", 				"patch_type": 0, 				"pmseverity.name": "Critical", 				"patch_status": 211, 				"affected_patch_status": 201, 				"severity": 4, 				"patchstorestatusdefn.label": "dc.common.SUCCESS", 				"configstatusdefn.label": "dc.common.APPROVED", 				"patch_id": 9110, 				"patch_name": "office2007-kb2288621-fullfile-x86-glb.exe", 				"collection.collection_name": "MyTask682", 				"patch_description": "Security Update for the 2007 Microsoft Office System (KB2288621)", 				"vendor_name": "Microsoft", 				"deployment_status": 209, 				"superceded_by": "NA", 				"severity_name": "dc.common.CRITICAL", 				"installpatchstatus.resource_id": 301, 				"deployer.first_name": "admin", 				"patchstorestatusdefn.image_name": "/images/download_success.png", 				"installstatusdefn.image_name": "/images/success.png", 				"patch_supported_time": 1284402600000, 				"affectedpatchstatusdefn.label": "dc.common.INSTALLED", 				"resource_id": 301, 				"customer_id": 1, 				"deploy_remarks_args": "--", 				"installed_time": 1544818523000 			},  		], 		"limit": 25, 		"page": 1 	}, 	"message_version": "1.0", 	"status": "success", 	"response_code": 200 }