Skip to main content

Download VM Image Scan Results

GET 
/api/v30.00/vms/download
x-prisma-cloud-target-env: {"permission":"monitorHosts","saas":true,"self-hosted":true}
x-public: true

Returns all VM image scan reports in CSV format.

Note: This endpoint maps to the table in Monitor > Vulnerabilities > Hosts > VM images > CSV in the Prisma Cloud Compute.

cURL Request​

Refer to the following example cURL command that retrieves all VM image scan reports and saves the results in a CSV file called vm_images_scan.csv:

curl -k \
  -u <USER> \
  -H 'Content-Type: application/json' \
  -X GET \
  -o vm_images_scan.csv \
  "https://<CONSOLE>/api/v<VERSION>/vms/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

    Number of reports to retrieve in a page. For PCCE, the maximum limit is 250. For PCEE, the maximum limit is 50. The default value is 50.

    search string

    Retrieves the result for a search term.

    sort string

    Sorts the result using a key. Refer to the columns in the relevant Prisma Cloud Compute user interface to use them as sort keys.

    reverse boolean

    Sorts the result in reverse order.

    collections string[]

    Filters the result based on collection names that you have defined in Prisma Cloud Compute.

    provider string[]

    Scopes the query by cloud provider.

    accountIDs string[]

    Filters the result based on cloud account IDs.

    resourceIDs string[]

    Scopes the query by resource ID.

    region string[]

    Scopes the query by cloud region.

    fields string[]

    Retrieves the fields that you need in a report. Use the list of fields you want to retrieve. By default, the result shows all fields of data.

    id string[]

    Filters the result based on VM IDs.

    name string[]

    Filters the result based on image names.

    credential string[]

    Filters the result based on cloud credentials.

    distro string[]

    Filters the result based on OS distribution names.

    release string[]

    Filters the result based on release versions.

    imageType string[]

    Filters the result based on cloud image types. Example: Use marketplace, managed, or gallery for Microsoft Azure.

    complianceIDs int[]

    Filters the result based on compliance IDs.

    normalizedSeverity boolean

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

Responses​

OK

Loading...