Skip to main content

Download Host Scan Results

GET 
/api/v32.04/hosts/download
x-prisma-cloud-target-env: {"permission":"monitorHosts","saas":true,"self-hosted":true}
x-public: true

Downloads all host scan reports in CSV format.

This endpoint maps to the CSV hyperlink in Monitor > Vulnerabilities > Hosts > Running hosts in the Console UI.

Note: The query parameters fields, complianceID and normalizedSeverity are not supported for this API endpoint.

cURL Request​

Refer to the following example cURL command that downloads all host scan reports to a CSV file called hosts_report.csv:

curl -k \
  -u <USER> \
  -H 'Content-Type: text/csv' \
  -X GET -o hosts_report.csv \
  https://<CONSOLE>/api/v<VERSION>/hosts/download

A successful response displays the status of the download.

Request​

Query Parameters

    offset integer

    Offsets the result to a specific report count. Offset starts from 0.

    limit integer

    Limit is the amount to fix.

    sort string

    Sorts the result using a key.

    reverse boolean

    Sorts the result in reverse order.

    hostname string[]

    Filters the result based on hostnames.

    distro string[]

    Filters the result based on OS distribution names.

    compact boolean

    Provides the minimal image data. Information about vulnerabilities, compliance, and extended image metadata are skipped. Default is false.

    clusters string[]

    Filters the result based on cluster names.

    complianceIDs int[]

    Filters the result based on compliance IDs.

    complianceRuleName string

    Filters the result based on applied compliance rule name.

    agentless boolean

    Retrieves the host names that were scanned by the agentless scanner.

    csa boolean

    Filters only images scanned by CSA.

    stopped boolean

    Retrieves the host names that were skipped during an agentless scan. Default is false.

    normalizedSeverity boolean

    Retrieves the result in the normalized form of low, medium, high, and critical based on vulnerability's severity level. Default is false.

    uaiID string

    Filters results by uaiID.

    issueType string

    Possible values: [vulnerabilities,compliance,]

    Filters results by issue type.

Responses​

OK

Loading...