Scan

Retrieve a scan.

To use this endpoint, you must have one of the following roles: comply-admin comply-operator comply-viewer

get/v1/scan/{id}

Request

Base URL
https://help.puppet.com/api/public
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/puppet/apis/puppet-comply-api/docs/v1/scan/:id/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

The ID of the scan.

Response

GetScanResponse is the response for a scan.

created_atstring date-time required

The time at which the scan was created.

erroredinteger required

The number of nodes that errored in scan.

failedinteger required

The number of nodes that failed in scan.

finishedinteger required

The number of nodes that finished in scan.

finished_atstring date-time nullable

The time at which the scan finished.

idstring required

The ID of the scan.

namestring required

The name of the scan.

nodes_scannedinteger required

The number of nodes scanned.

status'started' | 'finished' | 'failed' required

The status of the inventory sync job.

typestring required

The type of scan.

Example response

{
  "created_at": "2023-09-25T13:57:16.743Z",
  "finished": 100,
  "finished_at": "2023-09-25T13:57:16.743Z",
  "id": "123",
  "name": "Scan 1",
  "nodes_scanned": 100,
  "status": "finished",
  "type": "desired"
}

Changes

No recorded changes to this operation across all 1 revision of this API.