action truesight_get_device_parameter_history {
label: "Gets data history for a parameter of a specific device over a given period."
description: "You need to provide the Device ID, Parameter Name, Monitor Type and Monitor SID:
- use the hardware/devices service to get all available device IDs
- use the /hardware/device-monitors/{deviceId} to get the parameter name, the Monitor type and the Monitor SID.
Finally, define the period for which you wish to retrieve data history."
provider: truesight
method: GET
path: "/hardware/devices/{deviceId}/parameter-history"
encoding: json
input: {
type: "object"
properties: {
deviceId: {
type: "integer"
format: "int32"
}
from: {
type: "integer"
format: "int64"
}
monitorSid: {
type: "string"
}
monitorType: {
type: "string"
}
parameterName: {
type: "string"
}
to: {
type: "integer"
format: "int64"
}
}
required: ["deviceId", "monitorType", "parameterName"]
additionalProperties: false
}
output: {
type: "object"
additionalProperties: true
}
}