Show Malwares Detected for an Image

Shows a list of malwares detected for all layers of an image.

GET/csapi/v1.3/images/{imageSha}/layers/malware

Input ParametersInput Parameters

Parameter	Mandatory/Optional	Data Type	Description
imageSha	Mandatory	string	Specify the SHA value of an image.
filter	Optional	string	Filter the list by providing a QQL search query. Refer to the “How to Search” topic in the online help for assistance with creating your query.
pageNumber	Optional	integer	Specify the page to be returned. Page numbers start with 1.
pageSize	Optional	integer	Specify the number of records to be included in the response.

Sample: Fetch a List of Detected Malwares for an ImageSample: Fetch a List of Detected Malwares for an Image

API Request

curl -X "GET"
"<qualys_base_url>/csapi/v1.3/images/9287a1a2856378618469b0460cb295799ec99506c3d9697193fad51276235b7d/layers/malware?pageNumber=1&pageSize=50"
-H "accept: application/json"
-H "Authorization: Bearer <token>"

Response

{
    "data": [
        {
            "layerHash": "3c779f3ff212ad57ac3c4ba19cbf8e0104e50f27beb178a4e69df5c8e70ac988",
            "layerFileName": "layer.tar",
            "layerMimeType": "application/x-tar",
            "layerCreatedDate": "1689812682000",
            "layerFilesAnalyzed": 1,
            "layerMalwareCount": 1,
            "prediction": "malicious",
            "score": 1,
            "severity": 3,
            "category": "dropper",
            "family": "mirai",
            "createdBy": null
        },
        {
            "layerHash": "994393dc58e7931862558d06e46aa2bb17487044f670f310dffe1d24e4d1eec7",
            "layerFileName": "layer.tar",
            "layerMimeType": "application/x-tar",
            "layerCreatedDate": "1689811077000",
            "layerFilesAnalyzed": 16,
            "layerMalwareCount": 0,
            "prediction": "unknown",
            "score": null,
            "severity": null,
            "category": null,
            "family": null,
            "createdBy": null
        }
    ],
    "count": 2,
    "groups": {}
}

Error Response

The following error response is seen when the sub-users don't have permission to the specified image.

    {  
    "errorCode": "403 FORBIDDEN",  
    "message": "Request Forbidden",  
    "timestamp": 1700721586546
    }