Skip to main content

Get VM Image Names

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

Returns an array of strings containing VM image names.

cURL Request​

Refer to the following example cURL command:

$ curl -k \
  -X GET \
  -u <USER> \
  -H 'Content-Type: application/json' \
  "https://<CONSOLE>/api/v<VERSION>/vms/names"

cURL Response​

Refer to the following example response:

[
  "new-auto-images-cen7-dock",
  "ubuntu-pro-2004-focal-v20210720",
  "user-encrypted2",
  "ubuntu-20.04-lts:1.0.0",
  "user-test-b",
  "user-ubuntu-image-scan1",
  "Canonical:0001-com-ubuntu-server-focal:20_04-lts:20.04.202110260",
  "ubuntu-20.04-lts"
]

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​

Schema
  • Array [

    • string

  • ]
Loading...