Qualys Cloud Platform 3.3 (AM/WAS) API notification 1

A new release of Qualys Cloud Platform 3.3 (AM/WAS) includes an updated API which is targeted for release in November 2020. 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

AM API: Automatic Update for Asset Name
/qps/rest/2.0/search/am/hostasset/
A host asset name is derived based on the key attributes (such as DNS, NETBIOS, INSTANCE_ID, IP address). Currently, if an attribute name changed, then it did not automatically reflect in the host asset name. Users had to manually rename such host assets.

To avoid this manual and tedious task, we have now introduced the automatic override feature. If you enable this feature, the asset name is automatically updated across your enterprise, whenever any key attribute (such as DNS, NETBIOS, INSTANCE_ID, IP address) changes. The automatically updated asset name is also reflected in the response of search host asset API.

WAS API: API Support for Catalog functions
/qps/rest/3.0/get/was/catalog/{id}
/qps/rest/3.0/count/was/catalog
/qps/rest/3.0/search/was/catalog
/qps/rest/3.0/update/was/catalog/{id}
/qps/rest/3.0/delete/was/catalog/{id}
/qps/rest/3.0/updateEntries/was/catalog
/qps/rest/3.0/addToSubscription/was/catalog/{id}
With this release, we are providing API support for catalog functions that are currently available only from WAS UI. Using these APIs, you can get the details of the catalog entries, find the total number of entries in the catalog, update, delete the catalog entries, add a web application entry to subscription to create a web application and update the entries in the catalog to add the data discovered in the most recent VM scan results within your account.

WAS API: Retrieve Retest Status for a Finding
/qps/rest/3.0/retestStatus/was/finding/{id}
We have introduced a new API “Retrieve Retest Status” API to retrieve the status of the retest for a finding. This will help you to automate scanning and retesting processes. The API will return one of these statuses: NO_RETEST, UNDER_RETEST, RETESTED, CANCELING, and CANCELED