View the Agentless Scan Progress
GET/api/v33.01/agentless/progress
x-prisma-cloud-target-env: {"permission":"monitorHosts"}
Shows the progress of an ongoing scan on hosts or containers for vulnerabilities and compliance.
cURL Request
Refer to the following example cURL command:
$ curl -k \
-u <USER> \
-H 'Content-Type: application/json' \
-X GET \
“https://<CONSOLE>/api/v<VERSION>/agentless/progress”
cURL Response
Refer to the following example cURL response:
{
"hostname": "",
"id": "",
"scanTime": "2022-11-09T11:10:51.649Z",
"type": "agentlessHost",
"discovery": true,
"total": 5,
"scanned": 2,
"title": "Agentless discovering"
}
]
Responses
- 200
- default
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
AISInitialScanInProgress indicates whether agentless next-gen first scheduled scan is in progress.
AISOnDemandScanInProgress indicates whether agentless next-gen on demand scan is in progress.
Discovery indicates whether the scan is in discovery phase.
Error is the error that happened during scan.
Hostname is the hostname for which the progress apply.
ID is the ID of the entity being scanned.
OnDemand indicates whether the scan was triggered by the user or not (scheduled scan).
ScanTime is the time of scan.
Scanned is the number of entities for which the scan completed.
Title is the progress title (set by the scanning process).
Total is the total amount of entities that should be scanned.
Possible values: [image,ciImage,container,host,agentlessHost,registry,serverlessScan,ciServerless,vm,tas,ciTas,cloudDiscovery,serverlessRadar,serverlessAutoDeploy,hostAutoDeploy,codeRepo,ciCodeRepo
]
ScanType displays the components for an ongoing scan
[
{
"aisInitialScanInProgress": true,
"aisOnDemandScanInProgress": true,
"discovery": true,
"error": "string",
"hostname": "string",
"id": "string",
"onDemand": true,
"scanTime": "2024-07-29T15:51:28.071Z",
"scanned": 0,
"title": "string",
"total": 0,
"type": [
"image",
"ciImage",
"container",
"host",
"agentlessHost",
"registry",
"serverlessScan",
"ciServerless",
"vm",
"tas",
"ciTas",
"cloudDiscovery",
"serverlessRadar",
"serverlessAutoDeploy",
"hostAutoDeploy",
"codeRepo",
"ciCodeRepo"
]
}
]