Insert check data
POST /asset/<assetId>/collector/<collectorKey>/check/<checkKey>
Description
Insert check data.
Path parameters
| Param | Description |
|---|---|
assetId |
Asset Id. |
collectorKey |
Collector key. |
checkKey |
Check key. |
Query parameters
none
Body
| Param | Type | Required | Description |
|---|---|---|---|
data |
object | Yes | Object with check data. |
version |
string | Yes | Version of the collector. |
runtime |
float | No | Time it took for the check to run in seconds. |
no_count |
boolean | No | If true, the check result will not be "counted" by InfraSonar and therefore not affect "last-seen". |
timestamp |
integer | No | Unix timestamp in seconds. If omitted, InfraSonar will set the timestamp for the check data. |
Return codes
| Error code | Reason |
|---|---|
204 |
Success. |
400 |
Invalid body. |
401 |
Invalid or missing token. |
403 |
Insufficient permissions (required: API+INSERT_CHECK_DATA). |
404 |
Asset or collector or check not found. |
409 |
Collector is not assigned to the asset. |
413 |
Body size too large (maximum 500 KB). |
Example
Curl request:
curl \
-X POST 'https://api.infrasonar.com/asset/123/collector/docker/check/network' \
-H 'Authorization: Bearer XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX' \
-H 'Content-Type: application/json' \
--data-raw '{
"data": {
"networks": [
{
"name": "myNetwork",
"ipAddress": "1.2.3.4"
}
]
},
"version": "0.1.0"
}'