DLI EPCR6 Object Model Reference
20241110T162643Z
Meter server object
objectmeter/
Object representing the meter server state and configuration
dot_inline_dotgraph_698.png

This object contains the following items:

valuesMeasured values
busesBus list
power_statusPower status
emergency_off_statusEmergency shutoff status
synchronizeSynchronize meter data
notificationsNotifications

Sample JS request read command:

request.get({url:"meter/"},function(error,response,body) {console.log(body)});

<...>

Sample uom library read command:

print(uom.dump(uom.meter))

<...>

Browse more samples

Measured values

mapmeter/values/
Values measured by meters
dot_inline_dotgraph_699.png

This map contains Measured value elements.

Sample curl measured value creation command:

curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "..." "http://192.168.0.100/restapi/meter/values/current/"

Sample JS request measured value creation command:

request.put({url:"meter/values/mains_voltage/",body:{"intervals":[{"lower_bound_bottom":7.9166666666667,"alarm_level":3,"lower_bound_top":8.75,"alarm_period":null},{"lower_bound_bottom":11.833333333333,"alarm_level":2,"lower_bound_top":13.083333333333,"alarm_period":null},{"lower_bound_bottom":15.5,"alarm_level":null,"lower_bound_top":16.333333333333,"alarm_period":null},{"lower_bound_bottom":19.583333333333,"alarm_level":1,"lower_bound_top":20.25,"alarm_period":3},{"lower_bound_bottom":21.166666666667,"alarm_level":null,"lower_bound_top":22.333333333333,"alarm_period":null}],"in_calibration":true,"expression":"6","history_subsample_count":29,"data_absence_alarm_level":1,"value":false,"log_history":false,"history_time_step":2,"history_parameters":[[300,86400],[3600,1209600],[86400,31536000]],"lowest_interval_alarm_period":null,"data_absence_alarm_period":1,"update_relative_difference":0,"bus":null,"name":"AC voltage","internal":false,"lowest_interval_alarm_level":1,"quantity":"voltage"}});

Browse more samples

Measured value

objectmeter/values/S/
Value measured by meter
dot_inline_dotgraph_700.png

The value is subject to the following constraints: not index of the value matches ^(|​.*|.*)$

Removing the object from its parent collection is denied if not custom flag

This object contains the following items:

nameValue name
valueValue, if any
update_absolute_differenceMinimal absolute difference for updates
update_relative_differenceMinimal relative difference for updates
expressionExpression, if any
customCustom flag
in_calibrationCalibration flag
supports_calibrationCalibration support flag
insert_calibration_pointInsert calibration point
commit_calibrationCommit calibration
quantityQuantity
busBus index, if any
internalInternal
log_historyLog history
history_parametersHistory log parameters
history_subsample_countHistory subsample count
history_time_stepHistory time step
get_historyGet value history
clear_historyClear value history
data_absence_alarm_levelData absence alarm level, if any
data_absence_alarm_periodData absence alarm period, if any
lowest_interval_alarm_levelLowest interval alarm level, if any
lowest_interval_alarm_periodLowest interval alarm period, if any
intervalsValue interval properties

Sample CLI deletion command (note that measured_value is a variable):

uom remove "meter/values/${measured_value}"

Sample requests write command (note that _measured_value is a variable):

requests.put('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/',auth=auth,headers=headers,json={'update_absolute_difference': 0, 'intervals': [{'lower_bound_bottom': 590, 'alarm_level': 3, 'lower_bound_top': 606, 'alarm_period': 1}], 'in_calibration': True, 'expression': '6.5', 'history_subsample_count': 9, 'data_absence_alarm_level': 3, 'log_history': False, 'history_time_step': 3, 'history_parameters': [[300, 86400], [3600, 1209600], [86400, 31536000]], 'lowest_interval_alarm_period': 7, 'data_absence_alarm_period': None, 'update_relative_difference': 0, 'bus': 11, 'name': 'Current', 'internal': True, 'lowest_interval_alarm_level': None, 'quantity': 'current'})

Browse more samples

See also Measured value: Value name

See also Measured value: Value, if any

See also Measured value: Minimal absolute difference for updates

See also Measured value: Minimal relative difference for updates

See also Measured value: Expression, if any

See also Measured value: Custom flag

See also Measured value: Calibration flag

See also Measured value: Calibration support flag

See also Measured value: Insert calibration point

See also Measured value: Commit calibration

See also Measured value: Quantity

See also Measured value: Bus index, if any

See also Measured value: Internal

See also Measured value: Log history

See also Measured value: History log parameters

See also Measured value: History subsample count

See also Measured value: History time step

See also Measured value: Get value history

See also Measured value: Clear value history

See also Measured value: Data absence alarm level, if any

See also Measured value: Data absence alarm period, if any

See also Measured value: Lowest interval alarm level, if any

See also Measured value: Lowest interval alarm period, if any

See also Measured value: Value interval properties

Measured value: Value name

stringmeter/values/S/name/
Name of the measured value
dot_inline_dotgraph_701.png

Changing the value is denied if not administrative user

This string does not support direct modification if not custom flag.

This string represents a value in persistent storage.

Sample requests write command (note that _measured_value is a variable):

requests.put('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/name/',auth=auth,headers=headers,json='DC voltage')

Sample JS request read command (note that _measured_value is a variable):

request.get({url:"meter/values/"+_measured_value+"/name/"},function(error,response,body) {console.log(body)});

"Temperature"

Browse more samples

Measured value: Value, if any

sum (variant)meter/values/S/value/
Current value measured by meter, if any
dot_inline_dotgraph_702.png

Changing the value is denied if not administrative user

This sum does not support direct modification if all of the following is true:

This sum can change as if by itself or indirectly because of other actions.

Changes to this sum may have an effect besides setting value.

This sum can assume the following values:

numberValueCurrent value measured by meter
constant falseNo valueIndication that measurement is currently not being carried out

Sample uom library write command (note that _measured_value is a variable):

uom.meter.values[_measured_value].value=0

Sample requests write command (note that _measured_value is a variable):

requests.put('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/value/',auth=auth,headers=headers,json=118)

Browse more samples

Measured value: Minimal absolute difference for updates

numbermeter/values/S/update_absolute_difference/
Requested (advisory) minimum absolute difference for value updates
dot_inline_dotgraph_703.png

The value represents quantity.

The value is subject to the following constraints: the value is greater or equal to 0

The value is unconditionally set to 0 on creation and doesn't have to be supplied (if it is, it must match)

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number represents a value in persistent storage.

Sample CLI write command (note that measured_value is a variable):

uom set "meter/values/${measured_value}/update_absolute_difference" "0.01"

Sample JS request write command (note that _measured_value is a variable):

request.put({url:"meter/values/"+_measured_value+"/update_absolute_difference/",body:0.8});

Browse more samples

Measured value: Minimal relative difference for updates

numbermeter/values/S/update_relative_difference/
Requested (advisory) minimum relative difference for value updates
dot_inline_dotgraph_704.png

The value represents ratio, which is dimensionless.

To convert to percents, multiply by 100.

To convert from percents, divide by 100.

The value is subject to the following constraints: all of the following is true:

The value is unconditionally set to 0 on creation and doesn't have to be supplied (if it is, it must match)

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number represents a value in persistent storage.

Sample JS request read command (note that _measured_value is a variable):

request.get({url:"meter/values/"+_measured_value+"/update_relative_difference/"},function(error,response,body) {console.log(body)});

9e-06

Sample CLI read command (note that measured_value is a variable):

uom get "meter/values/${measured_value}/update_relative_difference"

0.7

Browse more samples

Measured value: Expression, if any

sum (optional string)meter/values/S/expression/
Expression governing the value, if any
dot_inline_dotgraph_705.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum does not support direct modification if not custom flag.

This sum represents a value in persistent storage.

This sum can change as if by itself or indirectly because of other actions.

This sum can assume the following values:

constant nullVariableThe value can be modified arbitrarily
stringExpressionExpression governing the value

Sample curl read command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/expression/"

"9.5"

Sample JS request write command (note that _measured_value is a variable):

request.put({url:"meter/values/"+_measured_value+"/expression/",body:"2"});

Browse more samples

Measured value: Custom flag

sum (boolean)meter/values/S/custom/
Flag indicating whether the value is custom
dot_inline_dotgraph_706.png

The value is unconditionally set to true on creation and doesn't have to be supplied (if it is, it must match)

Retrieving the value is denied if not administrative user

This sum does not support direct modification.

This sum represents a value in persistent storage.

This sum can assume the following values:

constant trueCustomThe value is custom and can be modified freely
constant falseBuilt-inThe value is built-in and only the hardware can modify it

Sample JS request read command (note that _measured_value is a variable):

request.get({url:"meter/values/"+_measured_value+"/custom/"},function(error,response,body) {console.log(body)});

[]

Sample curl read command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/custom/"

[]

Browse more samples

Measured value: Calibration flag

sum (boolean)meter/values/S/in_calibration/
Flag indicating whether the value is being calibrated
dot_inline_dotgraph_707.png

The value is subject to the following constraints: any of the following is true:

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum does not support direct modification if not calibration support flag.

This sum can change as if by itself or indirectly because of other actions if calibration support flag.

This sum can assume the following values:

constant trueCalibrationThe value is being calibrated (it can be updated to match external reference)
constant falseMeasurementThe value is being measured

Sample uom library read command (note that _measured_value is a variable):

print(uom.dump(uom.meter.values[_measured_value].in_calibration))

false

Sample curl write command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "true" "http://192.168.0.100/restapi/meter/values/:measured_value/in_calibration/"

Browse more samples

Measured value: Calibration support flag

sum (boolean)meter/values/S/supports_calibration/
Flag indicating whether calibrating the value is supported
dot_inline_dotgraph_708.png

Retrieving the value is denied if not administrative user

This sum does not support direct modification.

This sum represents a value in persistent storage.

This sum can assume the following values:

constant trueSupportedThe value can be calibrated
constant falseNot supportedThere is no support for calibrating the value, or it does not make sense to

Sample CLI read command (note that measured_value is a variable):

uom get "meter/values/${measured_value}/supports_calibration"

true

Sample requests read command (note that _measured_value is a variable):

print(requests.get('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/supports_calibration/',auth=auth,headers=headers).json())

False

Browse more samples

Measured value: Insert calibration point

callmeter/values/S/insert_calibration_point/
Specify custom calibration point, possibly overriding measurements
dot_inline_dotgraph_709.png

Performing the function call is denied if any of the following is true:

The call accepts the following arguments:

  1. Kind: Standard, Identity or Current
  2. Value: number
  3. Weight: number
  4. Derivative: number
  5. Derivative weight: number

The call returns the following results:

  1. Empty result: null

Sample CLI invocation (note that measured_value is a variable):

uom invoke "meter/values/${measured_value}/insert_calibration_point" "\"current\"" "5" "6.8" "-2.2" "8.7"

null

Sample uom library invocation (note that _measured_value is a variable):

print(uom.dump(uom.meter.values[_measured_value].insert_calibration_point("current",278,5.6,4.5,6.6)))

null

Browse more samples

Kind

sum (enumerated string)meter/values/S/insert_calibration_point/arguments: 1/
Kind of calibration point

This sum does not correspond to an actual resource.

This sum can assume the following values:

constant "standard"StandardThe point supplies the calibrated value
constant "identity"IdentityAssume the calibration function is the identity in point
constant "current"CurrentAssume the calibration function keeps current value in point

Value

numbermeter/values/S/insert_calibration_point/arguments: 2/
Calibrated value
dot_inline_dotgraph_710.png

The value represents quantity.

This number does not correspond to an actual resource.

Weight

numbermeter/values/S/insert_calibration_point/arguments: 3/
Weight of the calibration point

The value represents ratio, which is dimensionless.

To convert to percents, multiply by 100.

To convert from percents, divide by 100.

The value is subject to the following constraints: the value is greater or equal to 0

This number does not correspond to an actual resource.

Derivative

numbermeter/values/S/insert_calibration_point/arguments: 4/
Derivative value in the calibration point

The value represents ratio, which is dimensionless.

To convert to percents, multiply by 100.

To convert from percents, divide by 100.

This number does not correspond to an actual resource.

Derivative weight

numbermeter/values/S/insert_calibration_point/arguments: 5/
Weight of derivative value in the calibration point

The value represents ratio, which is dimensionless.

To convert to percents, multiply by 100.

To convert from percents, divide by 100.

The value is subject to the following constraints: the value is greater or equal to 0

This number does not correspond to an actual resource.

Empty result

constant nullmeter/values/S/insert_calibration_point/results: 1/
No additional information available

This constant does not correspond to an actual resource.

Measured value: Commit calibration

callmeter/values/S/commit_calibration/
Save calibration data to persistent storage
dot_inline_dotgraph_711.png

Performing the function call is denied if any of the following is true:

The call has no arguments (supply empty tuple).

The call returns the following results:

  1. Empty result: null

Sample JS request invocation (note that _measured_value is a variable):

request.post({url:"meter/values/"+_measured_value+"/commit_calibration/",body:[]});

null

Sample curl invocation (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[]" "http://192.168.0.100/restapi/meter/values/:measured_value/commit_calibration/"

null

Browse more samples

Empty result

constant nullmeter/values/S/commit_calibration/results: 1/
No additional information available

This constant does not correspond to an actual resource.

Measured value: Quantity

stringmeter/values/S/quantity/
Quantity of the value
dot_inline_dotgraph_712.png

The value is subject to the following constraints: known quantities[the value]

Changing the value is denied if not administrative user

This string does not support direct modification if not custom flag.

This string represents a value in persistent storage.

Sample CLI read command (note that measured_value is a variable):

uom get "meter/values/${measured_value}/quantity"

"voltage"

Sample CLI write command (note that measured_value is a variable):

uom set "meter/values/${measured_value}/quantity" "\"voltage\""

Browse more samples

Measured value: Bus index, if any

sum (optional number)meter/values/S/bus/
Index of bus being measured, if any
dot_inline_dotgraph_713.png

Changing the value is denied if not administrative user

This sum does not support direct modification if not custom flag.

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullUnspecifiedThe value is not related to a bus
numberBus indexIndex of bus being measuredbuses[the value]

Sample requests write command (note that _measured_value is a variable):

requests.put('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/bus/',auth=auth,headers=headers,json=3)

Sample JS request write command (note that _measured_value is a variable):

request.put({url:"meter/values/"+_measured_value+"/bus/",body:null});

Browse more samples

Measured value: Internal

sum (boolean)meter/values/S/internal/
Flag indicating whether this value is internal
dot_inline_dotgraph_714.png

Changing the value is denied if not administrative user

This sum does not support direct modification if not custom flag.

This sum represents a value in persistent storage.

This sum can assume the following values:

constant trueInternalThe value is internal and should not matter to users
constant falseVisibleThe value should be visible to users

Sample curl read command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/internal/"

true

Sample CLI read command (note that measured_value is a variable):

uom get "meter/values/${measured_value}/internal"

false

Browse more samples

Measured value: Log history

sum (boolean)meter/values/S/log_history/
Flag indicating whether the value should be logged to the history
dot_inline_dotgraph_715.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum represents a value in persistent storage.

This sum can assume the following values:

constant trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

Sample curl read command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/log_history/"

false

Sample uom library write command (note that _measured_value is a variable):

uom.meter.values[_measured_value].log_history=false

Browse more samples

Measured value: History log parameters

arraymeter/values/S/history_parameters/
Configuration of history logs sampling intervals and timespans
dot_inline_dotgraph_716.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This array is composite, i.e. is modified as a whole.

This array represents a value in persistent storage.

This array can change as if by itself or indirectly because of other actions.

This array contains History log elements.

Sample JS request write command (note that _measured_value is a variable):

request.put({url:"meter/values/"+_measured_value+"/history_parameters/",body:[[300,86400],[3600,1209600],[86400,31536000]]});

Sample requests read command (note that _measured_value is a variable):

print(requests.get('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/history_parameters/',auth=auth,headers=headers).json())

[[300, 86400], [3600, 1209600], [86400, 31536000]]

Browse more samples

History log

tuplemeter/values/S/history_parameters/N/
History log settings

This tuple is a part of a composite value which is modified as a whole.

This tuple contains the following items:

1Interval
2Span

Sample requests read command (note that _measured_value and _history_log_index are variables):

print(requests.get('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/history_parameters/'+str(_history_log_index)+'/',auth=auth,headers=headers).json())

[3600, 1209600]

Sample uom library read command (note that _measured_value and _history_log_index are variables):

print(uom.dump(uom.meter.values[_measured_value].history_parameters[_history_log_index]))

{3600,1209600}

Browse more samples

Interval

numbermeter/values/S/history_parameters/N/1/
Time interval between two consecutive history samples (changes will trigger history rebuilding and may cause adjustments to time span)
dot_inline_dotgraph_717.png

The value represents time, the standard unit of which is the second (s).

The value is subject to the following constraints: all of the following is true:

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number is a part of a composite value which is modified as a whole.

This number represents a value in persistent storage.

This number can change as if by itself or indirectly because of other actions.

Sample CLI read command (note that measured_value and history_log_index are variables):

uom get "meter/values/${measured_value}/history_parameters/${history_log_index}/0"

3600

Sample curl read command (note that :measured_value and :history_log_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/history_parameters/:history_log_index/0/"

300

Browse more samples

Span

numbermeter/values/S/history_parameters/N/2/
Time span covered by history fragment (changes will trigger history rebuilding)
dot_inline_dotgraph_718.png

The value represents time, the standard unit of which is the second (s).

The value is subject to the following constraints: all of the following is true:

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number is a part of a composite value which is modified as a whole.

This number represents a value in persistent storage.

This number can change as if by itself or indirectly because of other actions.

Sample requests read command (note that _measured_value and _history_log_index are variables):

print(requests.get('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/history_parameters/'+str(_history_log_index)+'/1/',auth=auth,headers=headers).json())

31536000

Sample CLI read command (note that measured_value and history_log_index are variables):

uom get "meter/values/${measured_value}/history_parameters/${history_log_index}/1"

86400

Browse more samples

Measured value: History subsample count

numbermeter/values/S/history_subsample_count/
Number of measurements per history sample
dot_inline_dotgraph_719.png

The value represents count, the standard unit of which is the time (times).

The value is subject to the following constraints: all of the following is true:

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number represents a value in persistent storage.

Sample CLI write command (note that measured_value is a variable):

uom set "meter/values/${measured_value}/history_subsample_count" "26"

Sample uom library read command (note that _measured_value is a variable):

print(uom.dump(uom.meter.values[_measured_value].history_subsample_count))

23

Browse more samples

Measured value: History time step

numbermeter/values/S/history_time_step/
Minimal amount of time between saved history samples (changes will trigger history rebuilding and may cause adjustments to history_parameters)
dot_inline_dotgraph_720.png

The value represents time, the standard unit of which is the second (s).

The value is subject to the following constraints: the value is greater than 0

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number represents a value in persistent storage.

Sample uom library write command (note that _measured_value is a variable):

uom.meter.values[_measured_value].history_time_step=1

Sample requests read command (note that _measured_value is a variable):

print(requests.get('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/history_time_step/',auth=auth,headers=headers).json())

7

Browse more samples

Value history record: Value history

arraymeter/values/S/get_history/results: 1/3/
Historical data points

This array does not correspond to an actual resource.

This array contains Data point, if any elements.

Data point, if any

sum (variant)meter/values/S/get_history/results: 1/3/N/
Historical data point, if any
dot_inline_dotgraph_721.png

This sum does not correspond to an actual resource.

This sum can assume the following values:

numberData pointHistorical data point, whose corresponding time is determined by array position
constant falseMissing dataIndication that data for the time determined by array position could not be found

Measured value: Get value history

callmeter/values/S/get_history/
Get history of values over a specific time range
dot_inline_dotgraph_722.png

Performing the function call is denied if not administrative user

The call accepts the following arguments:

  1. Data start time: number
  2. Data end time: number
  3. Data time step: number

The call returns the following results:

  1. Value history record: (number,number,array of "Data point or Missing data")

Sample requests invocation (note that _measured_value is a variable):

print(requests.post('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/get_history/',auth=auth,headers=headers,json=[1566878967, 1566878972, 1]).json())

[1566878967, 1, [False, False, 11, 10, 0]]

Sample curl invocation (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[1598768537,1598770337,900]" "http://192.168.0.100/restapi/meter/values/:measured_value/get_history/"

[1598768100,900,[95,false]]

Browse more samples

Data start time

numbermeter/values/S/get_history/arguments: 1/
Requested timestamp of the first data point to retrieve

The value represents time, the standard unit of which is the second (s).

This number does not correspond to an actual resource.

Data end time

numbermeter/values/S/get_history/arguments: 2/
Requested timestamp of the last data point to retrieve

The value represents time, the standard unit of which is the second (s).

This number does not correspond to an actual resource.

Data time step

numbermeter/values/S/get_history/arguments: 3/
Requested time step between succeeding data points

The value represents time, the standard unit of which is the second (s).

The value is subject to the following constraints: the value is greater or equal to 0

This number does not correspond to an actual resource.

Value history record

tuplemeter/values/S/get_history/results: 1/
Historical measured values
dot_inline_dotgraph_723.png

This tuple does not correspond to an actual resource.

This tuple contains the following items:

1Data start time
2Data time step
3Value history

Data start time

numbermeter/values/S/get_history/results: 1/1/
Timestamp of the first retrieved historical data point (may differ from requested start timestamp)

The value represents time, the standard unit of which is the second (s).

This number does not correspond to an actual resource.

Data time step

numbermeter/values/S/get_history/results: 1/2/
Time step between succeeding retrieved historical data points (may differ from requested time step)

The value represents time, the standard unit of which is the second (s).

The value is subject to the following constraints: the value is greater or equal to 0

This number does not correspond to an actual resource.

See also Value history record: Value history

Measured value: Clear value history

callmeter/values/S/clear_history/
Clear the complete history of values, and reset value to zero
dot_inline_dotgraph_724.png

Performing the function call is denied if not administrative user

The call has no arguments (supply empty tuple).

The call returns the following results:

  1. Empty result: null

Sample CLI invocation (note that measured_value is a variable):

uom invoke "meter/values/${measured_value}/clear_history"

null

Sample uom library invocation (note that _measured_value is a variable):

print(uom.dump(uom.meter.values[_measured_value].clear_history()))

null

Browse more samples

Empty result

constant nullmeter/values/S/clear_history/results: 1/
No additional information available

This constant does not correspond to an actual resource.

Measured value: Data absence alarm level, if any

sum (optional number)meter/values/S/data_absence_alarm_level/
Alarm level for absence of data, if any
dot_inline_dotgraph_725.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneNo alarm is generated on absence of data
numberData absence alarm levelAlarm level for absence of data

Sample uom library write command (note that _measured_value is a variable):

uom.meter.values[_measured_value].data_absence_alarm_level=null

Sample curl write command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "null" "http://192.168.0.100/restapi/meter/values/:measured_value/data_absence_alarm_level/"

Browse more samples

Measured value: Data absence alarm period, if any

sum (optional number)meter/values/S/data_absence_alarm_period/
The time interval after which data absence alarm events should be repeated, if any
dot_inline_dotgraph_726.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneThe data absence alarm event is generated only once on data loss and is not repeated
numberData absence alarm periodThe time interval after which data absence alarm events should be repeatedthe value is greater than 0

Sample JS request read command (note that _measured_value is a variable):

request.get({url:"meter/values/"+_measured_value+"/data_absence_alarm_period/"},function(error,response,body) {console.log(body)});

10

Sample uom library read command (note that _measured_value is a variable):

print(uom.dump(uom.meter.values[_measured_value].data_absence_alarm_period))

2

Browse more samples

Measured value: Lowest interval alarm level, if any

sum (optional number)meter/values/S/lowest_interval_alarm_level/
Alarm level for the lowest value interval, if any
dot_inline_dotgraph_727.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneNo alarm is generated for the lowest value interval
numberLowest interval alarm levelAlarm level for the lowest value interval

Sample JS request write command (note that _measured_value is a variable):

request.put({url:"meter/values/"+_measured_value+"/lowest_interval_alarm_level/",body:null});

Sample JS request read command (note that _measured_value is a variable):

request.get({url:"meter/values/"+_measured_value+"/lowest_interval_alarm_level/"},function(error,response,body) {console.log(body)});

2

Browse more samples

Measured value: Lowest interval alarm period, if any

sum (optional number)meter/values/S/lowest_interval_alarm_period/
The time interval after which lowest interval alarm events should be repeated, if any
dot_inline_dotgraph_728.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneThe alarm event is generated only once at lowest interval entry and is not repeated while the value is in the interval
numberLowest interval alarm periodThe time interval after which lowest interval alarm events should be repeatedthe value is greater than 0

Sample uom library read command (note that _measured_value is a variable):

print(uom.dump(uom.meter.values[_measured_value].lowest_interval_alarm_period))

3

Sample curl read command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/lowest_interval_alarm_period/"

null

Browse more samples

Measured value: Value interval properties

arraymeter/values/S/intervals/
Properties defining intervals of the value and their alarm levels
dot_inline_dotgraph_729.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This array is composite, i.e. is modified as a whole.

This array contains Interval configuration elements.

Sample curl write command (note that :measured_value is a URL template argument):

curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[{\"lower_bound_bottom\":292,\"alarm_level\":3,\"lower_bound_top\":309,\"alarm_period\":1},{\"lower_bound_bottom\":307,\"alarm_level\":2,\"lower_bound_top\":318,\"alarm_period\":3},{\"lower_bound_bottom\":344,\"alarm_level\":2,\"lower_bound_top\":354,\"alarm_period\":null},{\"lower_bound_bottom\":358,\"alarm_level\":null,\"lower_bound_top\":363,\"alarm_period\":null}]" "http://192.168.0.100/restapi/meter/values/:measured_value/intervals/"

Sample CLI write command (note that measured_value is a variable):

uom set "meter/values/${measured_value}/intervals" "[{\"lower_bound_bottom\":292,\"alarm_level\":2,\"lower_bound_top\":304,\"alarm_period\":2},{\"lower_bound_bottom\":336,\"alarm_level\":1,\"lower_bound_top\":341,\"alarm_period\":null},{\"lower_bound_bottom\":372,\"alarm_level\":null,\"lower_bound_top\":385,\"alarm_period\":null},{\"lower_bound_bottom\":429,\"alarm_level\":null,\"lower_bound_top\":435,\"alarm_period\":5},{\"lower_bound_bottom\":476,\"alarm_level\":null,\"lower_bound_top\":488,\"alarm_period\":null},{\"lower_bound_bottom\":491,\"alarm_level\":null,\"lower_bound_top\":503,\"alarm_period\":null},{\"lower_bound_bottom\":527,\"alarm_level\":null,\"lower_bound_top\":531,\"alarm_period\":2},{\"lower_bound_bottom\":546,\"alarm_level\":null,\"lower_bound_top\":554,\"alarm_period\":null}]"

Browse more samples

Interval configuration

objectmeter/values/S/intervals/N/
Configuration of a value interval

This object is a part of a composite value which is modified as a whole.

This object contains the following items:

lower_bound_bottomLower bound bottom
lower_bound_topLower bound top
alarm_levelAlarm level, if any
alarm_periodAlarm period, if any

Sample curl read command (note that :measured_value and :interval_configuration_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/intervals/:interval_configuration_index/"

{"lower_bound_bottom":494.16666666667,"alarm_level":1,"lower_bound_top":505.83333333333,"alarm_period":null}

Sample CLI write command (note that measured_value and interval_configuration_index are variables):

uom set "meter/values/${measured_value}/intervals/${interval_configuration_index}" "{\"lower_bound_bottom\":49.25,\"alarm_level\":1,\"lower_bound_top\":50.333333333333,\"alarm_period\":null}"

Browse more samples

Lower bound bottom

numbermeter/values/S/intervals/N/lower_bound_bottom/
The bottom of the lower bound of this interval; value must be lower to be considered outside this interval
dot_inline_dotgraph_730.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number is a part of a composite value which is modified as a whole.

This number represents a value in persistent storage.

Sample CLI write command (note that measured_value and interval_configuration_index are variables):

uom set "meter/values/${measured_value}/intervals/${interval_configuration_index}/lower_bound_bottom" "5.8858858858859"

Sample uom library write command (note that _measured_value and _interval_configuration_index are variables):

uom.meter.values[_measured_value].intervals[_interval_configuration_index].lower_bound_bottom=827

Browse more samples

Lower bound top

numbermeter/values/S/intervals/N/lower_bound_top/
The top of the lower bound of this interval; value must be higher to be considered inside this interval
dot_inline_dotgraph_731.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number is a part of a composite value which is modified as a whole.

This number represents a value in persistent storage.

Sample requests write command (note that _measured_value and _interval_configuration_index are variables):

requests.put('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/intervals/'+str(_interval_configuration_index)+'/lower_bound_top/',auth=auth,headers=headers,json=147)

Sample CLI write command (note that measured_value and interval_configuration_index are variables):

uom set "meter/values/${measured_value}/intervals/${interval_configuration_index}/lower_bound_top" "603"

Browse more samples

Alarm level, if any

sum (optional number)meter/values/S/intervals/N/alarm_level/
The level of importance assigned to this interval, if any
dot_inline_dotgraph_732.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum is a part of a composite value which is modified as a whole.

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneNo alarm is generated for this value interval
numberAlarm levelThe level of importance assigned to this interval

Sample requests read command (note that _measured_value and _interval_configuration_index are variables):

print(requests.get('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/intervals/'+str(_interval_configuration_index)+'/alarm_level/',auth=auth,headers=headers).json())

1

Sample requests write command (note that _measured_value and _interval_configuration_index are variables):

requests.put('http://192.168.0.100/restapi/meter/values/'+_measured_value+'/intervals/'+str(_interval_configuration_index)+'/alarm_level/',auth=auth,headers=headers,json=None)

Browse more samples

Alarm period, if any

sum (optional number)meter/values/S/intervals/N/alarm_period/
The time interval after which alarm events should be repeated, if any
dot_inline_dotgraph_733.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum is a part of a composite value which is modified as a whole.

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneThe alarm event is generated only once at interval entry and is not repeated while the value is in the interval
numberAlarm periodThe time interval after which alarm events should be repeatedthe value is greater than 0

Sample JS request write command (note that _measured_value and _interval_configuration_index are variables):

request.put({url:"meter/values/"+_measured_value+"/intervals/"+_interval_configuration_index.toString()+"/alarm_period/",body:4});

Sample curl read command (note that :measured_value and :interval_configuration_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/values/:measured_value/intervals/:interval_configuration_index/alarm_period/"

null

Browse more samples

Bus list

arraymeter/buses/
Attributes for buses
dot_inline_dotgraph_734.png

This array does not support direct modification.

This array contains Bus attributes elements.

Creating elements in this collection is not supported.

Sample requests read command:

print(requests.get('http://192.168.0.100/restapi/meter/buses/',auth=auth,headers=headers).json())

[{'power_status': True, 'name': 'Bus A', 'power_factor_percent': 100}, {'power_status': False, 'name': 'Bus B', 'power_factor_percent': 100}]

Sample CLI read command:

uom get "meter/buses"

[{"power_status":true,"name":"Bus A","power_factor_percent":100},{"power_status":false,"name":"Bus B","power_factor_percent":100}]

Browse more samples

See also Bus list: Bus attributes

Bus list: Bus attributes

objectmeter/buses/N/
Attributes for a bus
dot_inline_dotgraph_735.png

The value is subject to the following constraints: buses[index of the value]

This object contains the following items:

nameName
power_statusPower status
power_factor_percentPower factor

Sample requests write command (note that _bus_attributes_index is a variable):

requests.put('http://192.168.0.100/restapi/meter/buses/'+str(_bus_attributes_index)+'/',auth=auth,headers=headers,json={'power_status': False, 'name': 'Bus B', 'power_factor_percent': 100})

Sample JS request write command (note that _bus_attributes_index is a variable):

request.put({url:"meter/buses/"+_bus_attributes_index.toString()+"/",body:{"power_status":false,"name":"Bus B","power_factor_percent":100}});

Browse more samples

Name

stringmeter/buses/N/name/
User-visible name of this bus
dot_inline_dotgraph_736.png

Changing the value is denied if not administrative user

This string represents a value in persistent storage.

Sample curl write command (note that :bus_attributes_index is a URL template argument):

curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "\"Bus A\"" "http://192.168.0.100/restapi/meter/buses/:bus_attributes_index/name/"

Sample curl read command (note that :bus_attributes_index is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/buses/:bus_attributes_index/name/"

"Bus A"

Browse more samples

Power status

sum (boolean)meter/buses/N/power_status/
Status of bus power
dot_inline_dotgraph_737.png

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This sum does not support direct modification.

This sum can change as if by itself or indirectly because of other actions.

This sum can assume the following values:

constant trueOnBus is powered
constant falseOffBus is not powered

Sample CLI read command (note that bus_attributes_index is a variable):

uom get "meter/buses/${bus_attributes_index}/power_status"

false

Sample curl read command (note that :bus_attributes_index is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/buses/:bus_attributes_index/power_status/"

true

Browse more samples

Power factor

numbermeter/buses/N/power_factor_percent/
Power factor for this bus
dot_inline_dotgraph_738.png

The value is subject to the following constraints: all of the following is true:

Retrieving the value is denied if not administrative user

Changing the value is denied if not administrative user

This number represents a value in persistent storage.

Sample CLI read command (note that bus_attributes_index is a variable):

uom get "meter/buses/${bus_attributes_index}/power_factor_percent"

100

Sample JS request read command (note that _bus_attributes_index is a variable):

request.get({url:"meter/buses/"+_bus_attributes_index.toString()+"/power_factor_percent/"},function(error,response,body) {console.log(body)});

100

Browse more samples

Power status

sum (boolean)meter/power_status/
Status of unit power
dot_inline_dotgraph_739.png

Retrieving the value is denied if not administrative user

This sum does not support direct modification.

This sum can change as if by itself or indirectly because of other actions.

This sum can assume the following values:

constant trueMainsUnit is powered from at least one bus, outlets can be driven
constant falseBatteryUnit is powered from the battery only, outlets cannot be driven, unit shutdown expected

Sample JS request read command:

request.get({url:"meter/power_status/"},function(error,response,body) {console.log(body)});

true

Sample CLI read command:

uom get "meter/power_status"

true

Browse more samples

Emergency shutoff status

sum (optional boolean)meter/emergency_off_status/
Status of emergency shutoff
dot_inline_dotgraph_740.png

Retrieving the value is denied if not administrative user

This sum does not support direct modification.

This sum can change as if by itself or indirectly because of other actions.

This sum can assume the following values:

constant trueActiveEmergency shutoff active, all outlets off
constant falseInactiveEmergency shutoff inactive, normal outlet operation
constant nullUnknownEmergency shutoff is in an unknown state, probably due to power failure, all outlets likely off

Sample requests read command:

print(requests.get('http://192.168.0.100/restapi/meter/emergency_off_status/',auth=auth,headers=headers).json())

False

Sample uom library read command:

print(uom.dump(uom.meter.emergency_off_status))

false

Browse more samples

Synchronize meter data

callmeter/synchronize/
Saves meter data to persistent storage expressly (synchronization takes place periodically even without this call)
dot_inline_dotgraph_741.png

Performing the function call is denied if not administrative user

The call has no arguments (supply empty tuple).

The call returns the following results:

  1. Empty result: null

Sample curl invocation:

curl --digest -u admin:1234 -H "X-CSRF: x" -H "Content-type: application/json" -H "Accept: application/json" --data-binary "[]" "http://192.168.0.100/restapi/meter/synchronize/"

null

Sample requests invocation:

print(requests.post('http://192.168.0.100/restapi/meter/synchronize/',auth=auth,headers=headers,json={}).json())

None

Browse more samples

Empty result

constant nullmeter/synchronize/results: 1/
No additional information available

This constant does not correspond to an actual resource.

Notifications

objectmeter/notifications/
Meter status notifications
dot_inline_dotgraph_742.png

Retrieving the value is denied if not administrative user

This object does not support direct modification.

This object contains the following items:

parameter_kindsParameter kinds
eventsEvents

Sample uom library read command:

print(uom.dump(uom.meter.notifications))

<...>

Sample CLI read command:

uom get "meter/notifications"

...

Browse more samples

See also Notifications: Parameter kinds

Events

mapmeter/notifications/events/
Event templates
dot_inline_dotgraph_743.png

Retrieving the value is denied if not administrative user

This map is composite, i.e. is modified as a whole.

This map does not support direct modification.

This map contains Event elements.

Creating elements in this collection is not supported.

Sample CLI read command:

uom get "meter/notifications/events"

...

Sample JS request read command:

request.get({url:"meter/notifications/events/"},function(error,response,body) {console.log(body)});

<...>

Browse more samples

See also Events: Event

Notifications: Parameter kinds

objectmeter/notifications/parameter_kinds/
Kinds of event parameters

This object does not correspond to an actual resource.

This object contains the following items:

bus_indexBus index
bus_nameBus name
bus_poweredBus power status
poweredPower status
emergency_offEmergency shutoff status
value_idValue identifier
value_nameValue name
value_alarm_levelValue alarm level
value_alarm_repeatedValue alarm repeat count, if any
value_alarm_durationValue alarm duration

Bus index

numbermeter/notifications/parameter_kinds/bus_index/
Index of the bus

Bus name

stringmeter/notifications/parameter_kinds/bus_name/
Name of the bus

Bus power status

sum (boolean)meter/notifications/parameter_kinds/bus_powered/
Status of bus power

This sum can assume the following values:

constant truePoweredThe bus is powered
constant falseNot poweredThe bus is not powered

Power status

sum (boolean)meter/notifications/parameter_kinds/powered/
Status of unit power

This sum can assume the following values:

constant trueMainsThe unit is running on mains
constant falseBatteryThe unit is running on battery

Emergency shutoff status

sum (boolean)meter/notifications/parameter_kinds/emergency_off/
Status of emergency shutoff

This sum can assume the following values:

constant trueActiveAll outlets off
constant falseInactiveNormal outlet operation

Value identifier

stringmeter/notifications/parameter_kinds/value_id/
Identifier of the value

Value name

stringmeter/notifications/parameter_kinds/value_name/
Name of the value

Value alarm level

numbermeter/notifications/parameter_kinds/value_alarm_level/
Alarm level associated with the value

Value alarm repeat count, if any

sum (optional number)meter/notifications/parameter_kinds/value_alarm_repeated/
Number of consecutive times this alarm has been sent, if any

This sum can assume the following values:

constant nullInitial alarmThe value has just entered the interval
numberValue alarm repeat countNumber of consecutive times this alarm has been sent

all of the following is true:

Value alarm duration

numbermeter/notifications/parameter_kinds/value_alarm_duration/
Amount of time the value has been at this alarm level

The value represents time, the standard unit of which is the second (s).

The value is subject to the following constraints: the value is greater or equal to 0

Event parameters: Event parameter

objectmeter/notifications/events/S/parameters/N/
Properties of a parameter associated with the event

This object is a part of a composite value which is modified as a whole.

This object contains the following items:

idIdentifier
has_fixed_valueFixed value flag
fixed_valueFixed value

Sample curl write command (note that :event and :event_parameter_index are URL template arguments):

curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "{\"fixed_value\":false,\"has_fixed_value\":true,\"id\":\"emergency_off\"}" "http://192.168.0.100/restapi/meter/notifications/events/:event/parameters/:event_parameter_index/"

Sample curl read command (note that :event and :event_parameter_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/notifications/events/:event/parameters/:event_parameter_index/"

{"fixed_value":null,"has_fixed_value":false,"id":"value_alarm_duration"}

Browse more samples

Identifier

stringmeter/notifications/events/S/parameters/N/id/
Parameter identifier
dot_inline_dotgraph_744.png

The value is subject to the following constraints: parameter kinds[the value]

Retrieving the value is denied if not administrative user

This string is a part of a composite value which is modified as a whole.

This string does not support direct modification.

Sample uom library read command (note that _event and _event_parameter_index are variables):

print(uom.dump(uom.meter.notifications.events[_event].parameters[_event_parameter_index].id))

"bus_index"

Sample requests read command (note that _event and _event_parameter_index are variables):

print(requests.get('http://192.168.0.100/restapi/meter/notifications/events/'+_event+'/parameters/'+str(_event_parameter_index)+'/id/',auth=auth,headers=headers).json())

'powered'

Browse more samples

Fixed value flag

sum (boolean)meter/notifications/events/S/parameters/N/has_fixed_value/
Flag indicating that the parameter's value for this event is fixed
dot_inline_dotgraph_745.png

Retrieving the value is denied if not administrative user

This sum is a part of a composite value which is modified as a whole.

This sum does not support direct modification.

This sum can assume the following values:

constant trueFixedThe value is fixed
constant falseVariableThe value is variable

Sample CLI read command (note that event and event_parameter_index are variables):

uom get "meter/notifications/events/${event}/parameters/${event_parameter_index}/has_fixed_value"

true

Sample uom library read command (note that _event and _event_parameter_index are variables):

print(uom.dump(uom.meter.notifications.events[_event].parameters[_event_parameter_index].has_fixed_value))

true

Browse more samples

Fixed value

sum (variant)meter/notifications/events/S/parameters/N/fixed_value/
Fixed parameter value for this particular event
dot_inline_dotgraph_746.png

Retrieving the value is denied if not administrative user

This sum is a part of a composite value which is modified as a whole.

This sum does not support direct modification.

This sum can assume the following values:

constant nullNullNull
constant trueTrueTrue
constant falseFalseFalse
stringStringThis string
numberNumberThis number

Sample requests read command (note that _event and _event_parameter_index are variables):

print(requests.get('http://192.168.0.100/restapi/meter/notifications/events/'+_event+'/parameters/'+str(_event_parameter_index)+'/fixed_value/',auth=auth,headers=headers).json())

True

Sample CLI read command (note that event and event_parameter_index are variables):

uom get "meter/notifications/events/${event}/parameters/${event_parameter_index}/fixed_value"

null

Browse more samples

Events: Event

objectmeter/notifications/events/S/
Event template
dot_inline_dotgraph_747.png

This object is a part of a composite value which is modified as a whole.

This object contains the following items:

message_templateMessage template
severitySeverity
parametersEvent parameters

Sample uom library read command (note that _event is a variable):

print(uom.dump(uom.meter.notifications.events[_event]))

{message_template={"running on battery"},parameters={{fixed_value=false,has_fixed_value=true,id="powered"}},severity=5}

Sample JS request read command (note that _event is a variable):

request.get({url:"meter/notifications/events/"+_event+"/"},function(error,response,body) {console.log(body)});

{"severity":5,"message_template":["running on battery"],"parameters":[{"fixed_value":false,"has_fixed_value":true,"id":"powered"}]}

Browse more samples

Message template

arraymeter/notifications/events/S/message_template/
Template for human-readable message generation
dot_inline_dotgraph_748.png

Retrieving the value is denied if not administrative user

This array is a part of a composite value which is modified as a whole.

This array does not support direct modification.

This array contains Message template element elements.

Creating elements in this collection is not supported.

Sample CLI read command (note that event is a variable):

uom get "meter/notifications/events/${event}/message_template"

["running on mains"]

Sample requests read command (note that _event is a variable):

print(requests.get('http://192.168.0.100/restapi/meter/notifications/events/'+_event+'/message_template/',auth=auth,headers=headers).json())

['emergency shutoff status unknown due to power loss']

Browse more samples

Message template element

sum (variant)meter/notifications/events/S/message_template/N/
Element of human-readable message template
dot_inline_dotgraph_749.png

Retrieving the value is denied if not administrative user

This sum is a part of a composite value which is modified as a whole.

This sum does not support direct modification.

This sum can assume the following values:

stringStringFixed string
numberParameterIndex of message parameter to insertevent parameters[the value]

Sample JS request read command (note that _event and _message_template_element_index are variables):

request.get({url:"meter/notifications/events/"+_event+"/message_template/"+_message_template_element_index.toString()+"/"},function(error,response,body) {console.log(body)});

"emergency shutoff status unknown due to power loss"

Sample uom library read command (note that _event and _message_template_element_index are variables):

print(uom.dump(uom.meter.notifications.events[_event].message_template[_message_template_element_index]))

") is powered"

Browse more samples

Severity

sum (enumerated number)meter/notifications/events/S/severity/
Severity rating assigned to the event
dot_inline_dotgraph_750.png

Retrieving the value is denied if not administrative user

This sum is a part of a composite value which is modified as a whole.

This sum does not support direct modification.

This sum can assume the following values:

constant 1EmergencyTreat the event as an emergency
constant 2AlertTreat the event as an alert
constant 3CriticalTreat the event as critical
constant 4ErrorTreat the event as an error
constant 5WarningTreat the event as a warning
constant 6NoticeTreat the event as a notice
constant 7InformationalTreat the event as informational
constant 8DebugTreat the event as debugging-related

Sample curl read command (note that :event is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/notifications/events/:event/severity/"

6

Sample CLI read command (note that event is a variable):

uom get "meter/notifications/events/${event}/severity"

5

Browse more samples

Event parameters

arraymeter/notifications/events/S/parameters/
Additional data associated with the event
dot_inline_dotgraph_751.png

Retrieving the value is denied if not administrative user

This array is a part of a composite value which is modified as a whole.

This array does not support direct modification.

This array contains Event parameter elements.

Creating elements in this collection is not supported.

Sample requests read command (note that _event is a variable):

print(requests.get('http://192.168.0.100/restapi/meter/notifications/events/'+_event+'/parameters/',auth=auth,headers=headers).json())

[{'fixed_value': True, 'has_fixed_value': True, 'id': 'emergency_off'}]

Sample curl read command (note that :event is a URL template argument):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/meter/notifications/events/:event/parameters/"

[{"fixed_value":false,"has_fixed_value":true,"id":"powered"}]

Browse more samples

See also Event parameters: Event parameter