Skip to main content

Get Registry Scan Status

GET 
/api/v32.04/statuses/registry
x-prisma-cloud-target-env: {"permission":"monitorImages","saas":true,"self-hosted":true}
x-public: true

Returns the status of a regular registry scan that might include the following information:

  • Scan is completed: "completed": true
  • Scan is ongoing.
  • Errors: 10 most recent aggregated errors that occured during the scan with error messages such as:
    • "Failed to retrieve repositories info..."
    • "Failed to query image details..."
    • "No available Defender was found"

To view the more details about the progress of a regular or on-demand registry scan, use the /registry/progress API endpoint.

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>/statuses/registry

Response​

{
  "scanTime": "2019-07-31T19:42:49.036311567Z",
  "completed": true
}

Responses​

ScanStatus represents the status of current scan

Schema
    completed boolean

    Indicates if scanning has successfully completed (true) or not (false).

    errors string (string)[]

    List of errors that occurred during the last scan.

    hostname string

    Name of the host where Defender runs.

    scanTime date-time

    Datetime of the last completed scan.

    scanning boolean

    Indicates whether scanning is in progress (true) or not (false).

    selective boolean

    Indicates if the scan is for a specific resource (true) or not (false).

Loading...