Qualys Cloud Platform 2.10 (PM) API Notification 1
Table of Contents
A new release of Qualys Cloud Platform 2.10 (PM) includes updated APIs which is targeted for release in April 2024. The specific day will differ depending on the platform. See platform release dates on the Qualys Status page. This API notification provides an early preview into the coming API, allowing you to identify use cases that can leverage this updated API.
What’s New
In this release, we have introduced 2 new APIs and updated 5 APIs with new parameters. The new APIs will be useful while working with Patch Management assets and custom patch download URLs, whereas the updated APIs will help you manage the deployment jobs more effectively.
Newly Added APIs
Get a List of All Patch Management Assets
POST /pm/v1/assets
Using this API, you can get a list of more than ten thousand assets enabled for your Patch Management subscription.
Fetch Custom Patch Download URLs
GET /pm/v1/configurationDetails/customPatchDownloadUrls
Using this API, you can get a list of configured custom patch download URLs.
Updated APIs
The below listed APIs are updated with following capabilities.
- The
patchTuesdayPlusXDays
parameter now also supports values within the day range of -27 to -1 days for Windows and Linux jobs. - The
customPatchURLId
parameter is introduced to support using the “Download Patches from the Internal Repository” option while creating the Windows or Mac deployment job.
Create a Deployment Job
POST /pm/v1/deploymentjob
Request and Response will have the above-mentioned parameters.
Update a Deployment Job
PATCH /pm/v1/deploymentjob/update/{deploymentJobId}
Request and Response will have the above-mentioned parameters.
Get Deployment by Job ID
GET /pm/v1/deploymentjob/{deploymentJobId}
Response will have the above-mentioned parameters.
Similarly, the below listed APIs are updated to include a new osIdentifier
field in the response.
Get Deployment Job Result Summary
GET /pm/v1/deploymentjob/{deploymentJobId}/deploymentjobresult/summary
Get Deployment Job Result Summary (Provision to Manually Include 50 to 100 assets to the Job)
POST /pm/v1/deploymentjob/{deploymentJobId}/deploymentjobresult/summary
Please refer the detailed release notes here: https://cdn2.qualys.com/docs/release-notes/qualys-patch-management-2.10-api-release-notes.pdf