Skip to main content

cveHardwareHistory

Query

The make, model and firmware history of a device in your org, or of one of its points, as CVE scans recorded it, newest first, a page at a time. A record is added whenever a scan sees the values change, stamped with when they were first seen; a firmware update shows up here. Devices without points have device-level records only (empty pointId). Always limited to the org of the request. Ask for the next page with the nextToken of the previous one and the same arguments.

cveHardwareHistory(deviceId: String, pagination: PaginationInput, pointId: String): CVEGetHardwareHistoryResponse

Arguments​

ArgumentTypeDefaultDescription
deviceIdStringThe device (thing) id. With deviceId alone, every record of the device and of all its points. At least one of deviceId and pointId is required.
paginationPaginationInputlimit is the page size and nextToken continues from the previous page (pass the nextToken of the previous response with the same arguments).
pointIdStringA point id, for that point's records only. When deviceId is also set, the point must belong to that device.

Returns​

CVEGetHardwareHistoryResponse: One page of a device's or point's hardware history.

Example​

Request
query CveHardwareHistory {
cveHardwareHistory {
pagination {
nextToken
noMoreData
prevToken
total
totalAvailable
}
records {
deviceId
firmware
id
locationId
make
manufacturerId
model
observedAt
pointId
}
}
}