ingestMeasure #

Available since 2.5.0

Ingest a single measure into an asset.

Query Syntax #

HTTP #

URL: http://kuzzle:7512/_/device-manager/:engineId/assets/:assetId/measures/:slotName
Method: POST

Other protocols #

{
  "controller": "device-manager/assets",
  "action": "measureIngest",
  "assetId": "<assetId>",
  "engineId": "<engineId>",
  "slotName": "<slotName>"
  "body": {
    "dataSource": {
      "id": "<id>",
      // optional:
      "metadata": {
        // ...
      }
    },
    "measuredAt": "<measuredAt>"
    "values": {
      "<valueName>": "<value>",
      // ...
    }
  },

  // optional:
  "engineGroup": "<engine group>"
}

Arguments #

engineId: target engine id
assetId: target asset id
slotName: target measure slot name
engineGroup (optional): target engine group

Body properties #

dataSource: the measure source
measuredAt: the timestamp of when the measure was collected
values: the measure values

Datasource properties #

id: the measure source unique identifier
metadata: (optional) additional metadata for the source

Response #

{
  "status": 200,
  "error": null,
  "controller": "device-manager/assets",
  "action": "measureIngest",
  "requestId": "<unique request identifier>",
  "result": null,
}

Errors #

Ingesting a measure with incorrect values will throw a MeasureValidationError with the HTTP code 400.