DLI EPCR6 Object Model Reference
20241110T162643Z
UPnP server object
objectupnp/
Object representing the UPnP server configuration
dot_inline_dotgraph_567.png

Retrieving the value is denied if not administrative user

This object contains the following items:

enabledUPnP enabled
outletsOutlet UPnP configuration settings
profilesUPnP device profiles
expose_nameExpose name
expose_modelExpose model
expose_serialExpose serial
expose_outlet_positionsExpose outlet positions
notificationsNotifications

Sample curl write 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/upnp/"

Sample uom library read command:

print(uom.dump(uom.upnp))

<...>

Browse more samples

UPnP enabled

sum (boolean)upnp/enabled/
UPnP enable status
dot_inline_dotgraph_568.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 CLI write command:

uom set "upnp/enabled" "true"

Sample requests write command:

requests.put('http://192.168.0.100/restapi/upnp/enabled/',auth=auth,headers=headers,json=False)

Browse more samples

Outlet UPnP configuration settings

arrayupnp/outlets/
Properties related to exposing outlets via UPnP
dot_inline_dotgraph_569.png

The value is subject to the following constraints: length of the value is equal to length of outlets

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This array represents a value in persistent storage.

This array contains Outlet UPnP configuration elements.

Sample JS request outlet UPnP configuration creation command:

request.post({url:"upnp/outlets/",body:{"exposed":false,"alternate_name":null,"id":"1944d90d5","profile":"belkin_wemo_socket"}});

Sample JS request write command:

request.put({url:"upnp/outlets/",body:[{"exposed":false,"alternate_name":null,"id":"1944d90d0","profile":"belkin_wemo_socket"},{"exposed":true,"alternate_name":null,"id":"1944d90d1","profile":"belkin_wemo_socket"},{"exposed":false,"alternate_name":null,"id":"1944d90d2","profile":"belkin_wemo_socket"},{"exposed":false,"alternate_name":null,"id":"1944d90d3","profile":"belkin_wemo_socket"},{"exposed":true,"alternate_name":null,"id":"1944d90d4","profile":"belkin_wemo_socket"},{"exposed":true,"alternate_name":null,"id":"1944d90d5","profile":"belkin_wemo_socket"},{"exposed":true,"alternate_name":null,"id":"1944d90d6","profile":"belkin_wemo_socket"},{"exposed":true,"alternate_name":null,"id":"1944d90d7","profile":"belkin_wemo_socket"}]});

Browse more samples

See also Outlet UPnP configuration settings: Outlet UPnP configuration

Outlet UPnP configuration settings: Outlet UPnP configuration

objectupnp/outlets/N/
Properties related to exposing the outlet via UPnP
dot_inline_dotgraph_570.png

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

This object contains the following items:

idIdentifier
profileProfile
exposedExposed
alternate_nameAlternate name, if any

Sample requests deletion command (note that _outlet_upnp_configuration_index is a variable):

requests.delete('http://192.168.0.100/restapi/upnp/outlets/'+str(_outlet_upnp_configuration_index)+'/',auth=auth,headers=headers)

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

request.get({url:"upnp/outlets/"+_outlet_upnp_configuration_index.toString()+"/"},function(error,response,body) {console.log(body)});

{"exposed":false,"alternate_name":null,"id":"1944d90d1","profile":"belkin_wemo_socket"}

Browse more samples

Identifier

stringupnp/outlets/N/id/
Outlet device identifier seed
dot_inline_dotgraph_571.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

uom set "upnp/outlets/${outlet_upnp_configuration_index}/id" "\"1944d90d4\""

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

uom get "upnp/outlets/${outlet_upnp_configuration_index}/id"

"1944d90d2"

Browse more samples

Profile

stringupnp/outlets/N/profile/
Outlet device profile
dot_inline_dotgraph_572.png

The value is subject to the following constraints: UPnP device profiles[the value]

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

request.get({url:"upnp/outlets/"+_outlet_upnp_configuration_index.toString()+"/profile/"},function(error,response,body) {console.log(body)});

"belkin_wemo_socket"

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

print(requests.get('http://192.168.0.100/restapi/upnp/outlets/'+str(_outlet_upnp_configuration_index)+'/profile/',auth=auth,headers=headers).json())

'belkin_wemo_socket'

Browse more samples

Exposed

sum (boolean)upnp/outlets/N/exposed/
Outlet is exposed via UPnP
dot_inline_dotgraph_573.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 CLI write command (note that outlet_upnp_configuration_index is a variable):

uom set "upnp/outlets/${outlet_upnp_configuration_index}/exposed" "false"

Sample curl write command (note that :outlet_upnp_configuration_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 "true" "http://192.168.0.100/restapi/upnp/outlets/:outlet_upnp_configuration_index/exposed/"

Browse more samples

Alternate name, if any

sum (optional string)upnp/outlets/N/alternate_name/
Alternate name for the same outlet to be used instead of the configured name, if any
dot_inline_dotgraph_574.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullConfigured outlet nameUse the outlet's configured name
stringAlternate nameAlternate name for the same outlet to be used instead of the configured namethe value is not equal to ""

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

requests.put('http://192.168.0.100/restapi/upnp/outlets/'+str(_outlet_upnp_configuration_index)+'/alternate_name/',auth=auth,headers=headers,json=None)

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

uom set "upnp/outlets/${outlet_upnp_configuration_index}/alternate_name" "null"

Browse more samples

UPnP device profiles

mapupnp/profiles/
Map of UPnP device exposure settings
dot_inline_dotgraph_575.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This map represents a value in persistent storage.

This map contains UPnP device profile elements.

Sample curl UPnP device profile 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/upnp/profiles/belkin_wemo_socket/"

Sample CLI UPnP device profile creation command:

uom insert "upnp/profiles/belkin_wemo_socket" ...

Browse more samples

UPnP device profile

objectupnp/profiles/S/
UPnP device exposure settings
dot_inline_dotgraph_576.png

This object contains the following items:

nidNamespace identifier
device_xmlnsDevice namespace
manufacturerManufacturer
modelModel
model_numberModel number
uuid_prefixUUID prefix
device_typeDevice type
device_versionDevice version
service_xmlnsService namespace
service_idService ID
service_typeService type
service_versionService version
service_control_urlService control URL
service_event_sub_urlService event subscription URL
service_scpd_urlService SCPD URL
typesVariable types
state_variablesState variables
actionsAction map
soap_xmlns_prefix_overrideSOAP XML namespace prefix override, if any
service_xmlns_prefix_overrideService XML namespace prefix override, if any
event_xmlns_prefix_overrideEvent XML namespace prefix override, if any

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

uom set "upnp/profiles/${upnp_device_profile}" ...

Sample uom library deletion command (note that _upnp_device_profile is a variable):

uom.remove(uom.upnp.profiles,_upnp_device_profile)

Browse more samples

See also UPnP device profile: Namespace identifier

See also UPnP device profile: Device namespace

See also UPnP device profile: Manufacturer

See also UPnP device profile: Model

See also UPnP device profile: Model number

See also UPnP device profile: UUID prefix

See also UPnP device profile: Device type

See also UPnP device profile: Device version

See also UPnP device profile: Service namespace

See also UPnP device profile: Service ID

See also UPnP device profile: Service type

See also UPnP device profile: Service version

See also UPnP device profile: Service control URL

See also UPnP device profile: Service event subscription URL

See also UPnP device profile: Service SCPD URL

See also UPnP device profile: Variable types

See also UPnP device profile: State variables

See also UPnP device profile: Action map

See also UPnP device profile: SOAP XML namespace prefix override, if any

See also UPnP device profile: Service XML namespace prefix override, if any

See also UPnP device profile: Event XML namespace prefix override, if any

UPnP device profile: Namespace identifier

stringupnp/profiles/S/nid/
URN namespace identifier
dot_inline_dotgraph_577.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/nid/',auth=auth,headers=headers,json='Belkin')

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

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].nid))

"Belkin"

Browse more samples

UPnP device profile: Device namespace

stringupnp/profiles/S/device_xmlns/
Device description XML namespace
dot_inline_dotgraph_578.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/device_xmlns/",body:"urn:Belkin:device-1-0"});

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

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].device_xmlns))

"urn:Belkin:device-1-0"

Browse more samples

UPnP device profile: Manufacturer

stringupnp/profiles/S/manufacturer/
Manufacturer name
dot_inline_dotgraph_579.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

uom get "upnp/profiles/${upnp_device_profile}/manufacturer"

"Belkin International Inc."

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

uom.upnp.profiles[_upnp_device_profile].manufacturer="Belkin International Inc."

Browse more samples

UPnP device profile: Model

stringupnp/profiles/S/model/
Model name
dot_inline_dotgraph_580.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/model/",body:"DLI emulated Belkin socket"});

Sample curl write command (note that :upnp_device_profile 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 "\"DLI emulated Belkin socket\"" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/model/"

Browse more samples

UPnP device profile: Model number

stringupnp/profiles/S/model_number/
Model number string
dot_inline_dotgraph_581.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

Sample curl write command (note that :upnp_device_profile 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 "\"1_0\"" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/model_number/"

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

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/model_number/"

"1_0"

Browse more samples

UPnP device profile: UUID prefix

stringupnp/profiles/S/uuid_prefix/
Outlet device identifier prefix
dot_inline_dotgraph_582.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/uuid_prefix/"

"Socket-1_0-"

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

request.get({url:"upnp/profiles/"+_upnp_device_profile+"/uuid_prefix/"},function(error,response,body) {console.log(body)});

"Socket-1_0-"

Browse more samples

UPnP device profile: Device type

stringupnp/profiles/S/device_type/
Device type identifier
dot_inline_dotgraph_583.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/device_type/",body:"controllee"});

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

uom get "upnp/profiles/${upnp_device_profile}/device_type"

"controllee"

Browse more samples

UPnP device profile: Device version

stringupnp/profiles/S/device_version/
Device version string
dot_inline_dotgraph_584.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/device_version/',auth=auth,headers=headers,json='1')

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

request.get({url:"upnp/profiles/"+_upnp_device_profile+"/device_version/"},function(error,response,body) {console.log(body)});

"1"

Browse more samples

UPnP device profile: Service namespace

stringupnp/profiles/S/service_xmlns/
Service description XML namespace
dot_inline_dotgraph_585.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

print(requests.get('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/service_xmlns/',auth=auth,headers=headers).json())

'urn:Belkin:service-1-0'

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

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].service_xmlns))

"urn:Belkin:service-1-0"

Browse more samples

UPnP device profile: Service ID

stringupnp/profiles/S/service_id/
Service identifier
dot_inline_dotgraph_586.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

uom.upnp.profiles[_upnp_device_profile].service_id="basicevent1"

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

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/service_id/',auth=auth,headers=headers,json='basicevent1')

Browse more samples

UPnP device profile: Service type

stringupnp/profiles/S/service_type/
Service type identifier
dot_inline_dotgraph_587.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/service_type/',auth=auth,headers=headers,json='basicevent')

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

uom.upnp.profiles[_upnp_device_profile].service_type="basicevent"

Browse more samples

UPnP device profile: Service version

stringupnp/profiles/S/service_version/
Service version string
dot_inline_dotgraph_588.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/service_version/',auth=auth,headers=headers,json='1')

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

uom.upnp.profiles[_upnp_device_profile].service_version="1"

Browse more samples

UPnP device profile: Service control URL

stringupnp/profiles/S/service_control_url/
URL to send service control requests to
dot_inline_dotgraph_589.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].service_control_url))

"/upnp/control/basicevent1"

Sample curl write command (note that :upnp_device_profile 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 "\"/upnp/control/basicevent1\"" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/service_control_url/"

Browse more samples

UPnP device profile: Service event subscription URL

stringupnp/profiles/S/service_event_sub_url/
URL to send service subscription management requests to
dot_inline_dotgraph_590.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/service_event_sub_url/",body:"/upnp/event/basicevent1"});

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

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/service_event_sub_url/"

"/upnp/event/basicevent1"

Browse more samples

UPnP device profile: Service SCPD URL

stringupnp/profiles/S/service_scpd_url/
Service control protocol document URL
dot_inline_dotgraph_591.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This string represents a value in persistent storage.

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

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].service_scpd_url))

"/eventservice.xml"

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

uom get "upnp/profiles/${upnp_device_profile}/service_scpd_url"

"/eventservice.xml"

Browse more samples

UPnP device profile: Variable types

mapupnp/profiles/S/types/
Map of supported variable types
dot_inline_dotgraph_592.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This map represents a value in persistent storage.

This map contains Variable type elements.

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

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/types/",body:{"Boolean":{"decode":"function(str) return str==\"1\" end","encode":"function(value) return value and \"1\" or \"0\" end"},"string":{"decode":"function(str) return str end","encode":"function(value) return value end"}}});

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

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].types))

{Boolean={decode="function(str) return str==\"1\" end",encode="function(value) return value and \"1\" or \"0\" end"},string={decode="function(str) return str end",encode="function(value) return value end"}}

Browse more samples

Variable type

objectupnp/profiles/S/types/S/
Variable type properties

The value is subject to the following constraints: index of the value matches ^[a-zA-Z_][a-zA-Z_0-9]*$

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

This object contains the following items:

decodeDecoding function
encodeEncoding function

Sample CLI write command (note that upnp_device_profile and variable_type are variables):

uom set "upnp/profiles/${upnp_device_profile}/types/${variable_type}" "{\"decode\":\"function(str) return str end\",\"encode\":\"function(value) return value end\"}"

Sample uom library read command (note that _upnp_device_profile and _variable_type are variables):

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].types[_variable_type]))

{decode="function(str) return str==\"1\" end",encode="function(value) return value and \"1\" or \"0\" end"}

Browse more samples

Decoding function

stringupnp/profiles/S/types/S/decode/
Code of Lua function to decode and validate the value's string representation
dot_inline_dotgraph_593.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample uom library read command (note that _upnp_device_profile and _variable_type are variables):

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].types[_variable_type].decode))

"function(str) return str==\"1\" end"

Sample curl write command (note that :upnp_device_profile and :variable_type 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 "\"function(str) return str end\"" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/types/:variable_type/decode/"

Browse more samples

Encoding function

stringupnp/profiles/S/types/S/encode/
Code of Lua function to check and encode the value to string representation
dot_inline_dotgraph_594.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample CLI write command (note that upnp_device_profile and variable_type are variables):

uom set "upnp/profiles/${upnp_device_profile}/types/${variable_type}/encode" "\"function(value) return value and \\\"1\\\" or \\\"0\\\" end\""

Sample uom library read command (note that _upnp_device_profile and _variable_type are variables):

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].types[_variable_type].encode))

"function(value) return value end"

Browse more samples

UPnP device profile: State variables

mapupnp/profiles/S/state_variables/
Map of state variable bindings
dot_inline_dotgraph_595.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This map represents a value in persistent storage.

This map contains State variable binding elements.

Sample curl write command (note that :upnp_device_profile 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 "{\"FriendlyName\":{\"default_value\":\"\",\"events_enabled\":true,\"name\":\"name\",\"type\":\"string\"},\"BinaryState\":{\"default_value\":\"0\",\"events_enabled\":true,\"name\":\"state\",\"type\":\"Boolean\"}}" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/state_variables/"

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

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/state_variables/",body:{"FriendlyName":{"default_value":"","events_enabled":true,"name":"name","type":"string"},"BinaryState":{"default_value":"0","events_enabled":true,"name":"state","type":"Boolean"}}});

Browse more samples

State variable binding

objectupnp/profiles/S/state_variables/S/
Properties of a state variable binding

The value is subject to the following constraints: index of the value matches ^[a-zA-Z_][a-zA-Z_0-9]*$

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

This object contains the following items:

nameOutlet property name
typeVariable type
default_valueDefault variable name
events_enabledEvents

Sample CLI write command (note that upnp_device_profile and state_variable_binding are variables):

uom set "upnp/profiles/${upnp_device_profile}/state_variables/${state_variable_binding}" "{\"default_value\":\"0\",\"events_enabled\":true,\"name\":\"state\",\"type\":\"Boolean\"}"

Sample requests read command (note that _upnp_device_profile and _state_variable_binding are variables):

print(requests.get('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/state_variables/'+_state_variable_binding+'/',auth=auth,headers=headers).json())

{'default_value': '0', 'events_enabled': True, 'name': 'state', 'type': 'Boolean'}

Browse more samples

Outlet property name

stringupnp/profiles/S/state_variables/S/name/
The outlet property to which the variable is bound
dot_inline_dotgraph_596.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample requests write command (note that _upnp_device_profile and _state_variable_binding are variables):

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/state_variables/'+_state_variable_binding+'/name/',auth=auth,headers=headers,json='state')

Sample curl write command (note that :upnp_device_profile and :state_variable_binding 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 "\"name\"" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/state_variables/:state_variable_binding/name/"

Browse more samples

Variable type

stringupnp/profiles/S/state_variables/S/type/
The type of the variable
dot_inline_dotgraph_597.png

The value is subject to the following constraints: variable types[the value]

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample JS request read command (note that _upnp_device_profile and _state_variable_binding are variables):

request.get({url:"upnp/profiles/"+_upnp_device_profile+"/state_variables/"+_state_variable_binding+"/type/"},function(error,response,body) {console.log(body)});

"Boolean"

Sample CLI read command (note that upnp_device_profile and state_variable_binding are variables):

uom get "upnp/profiles/${upnp_device_profile}/state_variables/${state_variable_binding}/type"

"Boolean"

Browse more samples

Default variable name

stringupnp/profiles/S/state_variables/S/default_value/
The string-encoded default value of the state variable
dot_inline_dotgraph_598.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample curl read command (note that :upnp_device_profile and :state_variable_binding are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/state_variables/:state_variable_binding/default_value/"

"0"

Sample uom library read command (note that _upnp_device_profile and _state_variable_binding are variables):

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].state_variables[_state_variable_binding].default_value))

""

Browse more samples

Events

sum (boolean)upnp/profiles/S/state_variables/S/events_enabled/
Send events on property change
dot_inline_dotgraph_599.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 trueEnabledThe feature is enabled
constant falseDisabledThe feature is disabled

Sample JS request write command (note that _upnp_device_profile and _state_variable_binding are variables):

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/state_variables/"+_state_variable_binding+"/events_enabled/",body:true});

Sample requests write command (note that _upnp_device_profile and _state_variable_binding are variables):

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/state_variables/'+_state_variable_binding+'/events_enabled/',auth=auth,headers=headers,json=True)

Browse more samples

Arguments: Argument

objectupnp/profiles/S/actions/S/arguments/N/
Action input or output argument properties

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

This object contains the following items:

nameArgument name
typeArgument type
is_outputOutput/return value flag
state_idRelated state variable identifier, if any

Sample curl read command (note that :upnp_device_profile, :action and :argument_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/actions/:action/arguments/:argument_index/"

{"is_output":true,"state_id":"FriendlyName","name":"FriendlyName","type":"string"}

Sample CLI read command (note that upnp_device_profile, action and argument_index are variables):

uom get "upnp/profiles/${upnp_device_profile}/actions/${action}/arguments/${argument_index}"

{"is_output":false,"state_id":"FriendlyName","name":"FriendlyName","type":"string"}

Browse more samples

Argument name

stringupnp/profiles/S/actions/S/arguments/N/name/
The name of the argument as seen by clients
dot_inline_dotgraph_600.png

The value is subject to the following constraints: the value matches ^[a-zA-Z_][a-zA-Z_0-9]*$

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample curl read command (note that :upnp_device_profile, :action and :argument_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/actions/:action/arguments/:argument_index/name/"

"BinaryState"

Sample JS request write command (note that _upnp_device_profile, _action and _argument_index are variables):

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/actions/"+_action+"/arguments/"+_argument_index.toString()+"/name/",body:"FriendlyName"});

Browse more samples

Argument type

stringupnp/profiles/S/actions/S/arguments/N/type/
The type of the argument
dot_inline_dotgraph_601.png

The value is subject to the following constraints: variable types[the value]

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample requests read command (note that _upnp_device_profile, _action and _argument_index are variables):

print(requests.get('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/actions/'+_action+'/arguments/'+str(_argument_index)+'/type/',auth=auth,headers=headers).json())

'string'

Sample curl read command (note that :upnp_device_profile, :action and :argument_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/actions/:action/arguments/:argument_index/type/"

"string"

Browse more samples

Output/return value flag

sum (boolean)upnp/profiles/S/actions/S/arguments/N/is_output/
Flag indicating that the argument is output/return instead of input
dot_inline_dotgraph_602.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 trueOutput/returnThe argument is output, and also the return value if it's the first output argument
constant falseInputThe argument is input

Sample curl read command (note that :upnp_device_profile, :action and :argument_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/actions/:action/arguments/:argument_index/is_output/"

false

Sample CLI read command (note that upnp_device_profile, action and argument_index are variables):

uom get "upnp/profiles/${upnp_device_profile}/actions/${action}/arguments/${argument_index}/is_output"

false

Browse more samples

Related state variable identifier, if any

sum (optional string)upnp/profiles/S/actions/S/arguments/N/state_id/
The identifier of the state variable to which the argument is related, if any
dot_inline_dotgraph_603.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 nullNo related state variableThe argument isn't related to a state variable
stringRelated state variable identifierThe identifier of the state variable to which the argument is relatedstate variables[the value]

Sample uom library read command (note that _upnp_device_profile, _action and _argument_index are variables):

print(uom.dump(uom.upnp.profiles[_upnp_device_profile].actions[_action].arguments[_argument_index].state_id))

"BinaryState"

Sample CLI write command (note that upnp_device_profile, action and argument_index are variables):

uom set "upnp/profiles/${upnp_device_profile}/actions/${action}/arguments/${argument_index}/state_id" "\"BinaryState\""

Browse more samples

UPnP device profile: Action map

mapupnp/profiles/S/actions/
Map of actions that can be performed on the outlet
dot_inline_dotgraph_604.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This map represents a value in persistent storage.

This map contains Action elements.

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

uom set "upnp/profiles/${upnp_device_profile}/actions" "{\"GetFriendlyName\":{\"code\":\"function(outlet) return outlet.name end\",\"arguments\":[{\"is_output\":true,\"state_id\":\"FriendlyName\",\"name\":\"FriendlyName\",\"type\":\"string\"}]},\"GetBinaryState\":{\"code\":\"function(outlet) return outlet.state end\",\"arguments\":[{\"is_output\":true,\"state_id\":\"BinaryState\",\"name\":\"BinaryState\",\"type\":\"Boolean\"}]},\"SetBinaryState\":{\"code\":\"function(outlet,value) outlet.state=value end\",\"arguments\":[{\"is_output\":false,\"state_id\":\"BinaryState\",\"name\":\"BinaryState\",\"type\":\"Boolean\"}]},\"SetFriendlyName\":{\"code\":\"function(outlet,value) outlet.name=val end\",\"arguments\":[{\"is_output\":false,\"state_id\":\"FriendlyName\",\"name\":\"FriendlyName\",\"type\":\"string\"}]}}"

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

request.get({url:"upnp/profiles/"+_upnp_device_profile+"/actions/"},function(error,response,body) {console.log(body)});

Browse more samples

Action

objectupnp/profiles/S/actions/S/
Action properties
dot_inline_dotgraph_605.png

The value is subject to the following constraints: index of the value matches ^[a-zA-Z_][a-zA-Z_0-9]*$

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

This object contains the following items:

argumentsArguments
codeCode

Sample curl read command (note that :upnp_device_profile and :action are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/actions/:action/"

{"code":"function(outlet,value) outlet.state=value end","arguments":[{"is_output":false,"state_id":"BinaryState","name":"BinaryState","type":"Boolean"}]}

Sample requests write command (note that _upnp_device_profile and _action are variables):

requests.put('http://192.168.0.100/restapi/upnp/profiles/'+_upnp_device_profile+'/actions/'+_action+'/',auth=auth,headers=headers,json={'code': 'function(outlet,value) outlet.state=value end', 'arguments': [{'is_output': False, 'state_id': 'BinaryState', 'name': 'BinaryState', 'type': 'Boolean'}]})

Browse more samples

Arguments

arrayupnp/profiles/S/actions/S/arguments/
Action input and output arguments
dot_inline_dotgraph_606.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This array represents a value in persistent storage.

This array contains Argument elements.

Sample CLI argument creation command (note that upnp_device_profile and action are variables):

uom insert "upnp/profiles/${upnp_device_profile}/actions/${action}/arguments/0" "{\"is_output\":false,\"state_id\":\"BinaryState\",\"name\":\"BinaryState\",\"type\":\"Boolean\"}"

Sample curl write command (note that :upnp_device_profile and :action 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 "[{\"is_output\":true,\"state_id\":\"BinaryState\",\"name\":\"BinaryState\",\"type\":\"Boolean\"}]" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/actions/:action/arguments/"

Browse more samples

See also Arguments: Argument

Code

stringupnp/profiles/S/actions/S/code/
Code of Lua function to perform the action
dot_inline_dotgraph_607.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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

This string represents a value in persistent storage.

Sample curl read command (note that :upnp_device_profile and :action are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/actions/:action/code/"

"function(outlet,value) outlet.state=value end"

Sample JS request read command (note that _upnp_device_profile and _action are variables):

request.get({url:"upnp/profiles/"+_upnp_device_profile+"/actions/"+_action+"/code/"},function(error,response,body) {console.log(body)});

"function(outlet,value) outlet.state=value end"

Browse more samples

UPnP device profile: SOAP XML namespace prefix override, if any

sum (optional string)upnp/profiles/S/soap_xmlns_prefix_override/
SOAP XML namespace prefix to use on encoding instead of the default one (for compatibility), if any
dot_inline_dotgraph_608.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneUse the default SOAP XML namespace prefix ('soap11')
stringSOAP XML namespace prefix overrideSOAP XML namespace prefix to use on encoding instead of the default one (for compatibility)the value matches ^([A-Za-z_][A-Za-z0-9_-]?|[A-WYZa-wyz_][A-Za-z0-9_-]{2,}|[xX][A-LN-Za-ln-z0-9_-][A-Za-z0-9_-]{1,}|[xX][mM][A-KM-Za-km-z0-9_-][A-Za-z0-9_-]*)$

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

request.put({url:"upnp/profiles/"+_upnp_device_profile+"/soap_xmlns_prefix_override/",body:null});

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

uom get "upnp/profiles/${upnp_device_profile}/soap_xmlns_prefix_override"

null

Browse more samples

UPnP device profile: Service XML namespace prefix override, if any

sum (optional string)upnp/profiles/S/service_xmlns_prefix_override/
Service XML namespace prefix to use on encoding instead of the default one (for compatibility), if any
dot_inline_dotgraph_609.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneUse the default service XML namespace prefix ('svc')
stringService XML namespace prefix overrideService XML namespace prefix to use on encoding instead of the default one (for compatibility)the value matches ^([A-Za-z_][A-Za-z0-9_-]?|[A-WYZa-wyz_][A-Za-z0-9_-]{2,}|[xX][A-LN-Za-ln-z0-9_-][A-Za-z0-9_-]{1,}|[xX][mM][A-KM-Za-km-z0-9_-][A-Za-z0-9_-]*)$

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

uom set "upnp/profiles/${upnp_device_profile}/service_xmlns_prefix_override" "\"XqR\""

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

uom.upnp.profiles[_upnp_device_profile].service_xmlns_prefix_override="XmB"

Browse more samples

UPnP device profile: Event XML namespace prefix override, if any

sum (optional string)upnp/profiles/S/event_xmlns_prefix_override/
Event XML namespace prefix to use on encoding instead of the default one (for compatibility), if any
dot_inline_dotgraph_610.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

This sum represents a value in persistent storage.

This sum can assume the following values:

constant nullNoneUse the default event XML namespace prefix ('event')
stringEvent XML namespace prefix overrideEvent XML namespace prefix to use on encoding instead of the default one (for compatibility)the value matches ^([A-Za-z_][A-Za-z0-9_-]?|[A-WYZa-wyz_][A-Za-z0-9_-]{2,}|[xX][A-LN-Za-ln-z0-9_-][A-Za-z0-9_-]{1,}|[xX][mM][A-KM-Za-km-z0-9_-][A-Za-z0-9_-]*)$

Sample curl write command (note that :upnp_device_profile 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/upnp/profiles/:upnp_device_profile/event_xmlns_prefix_override/"

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

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/profiles/:upnp_device_profile/event_xmlns_prefix_override/"

null

Browse more samples

Expose name

sum (boolean)upnp/expose_name/
Controller name is exposed via UPnP
dot_inline_dotgraph_611.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 JS request read command:

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

false

Sample curl write command:

curl --digest -u admin:1234 -H "X-CSRF: x" -X PUT -H "Content-type: application/json" -H "Accept: application/json" --data-binary "false" "http://192.168.0.100/restapi/upnp/expose_name/"

Browse more samples

Expose model

sum (boolean)upnp/expose_model/
Controller model is exposed via UPnP
dot_inline_dotgraph_612.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 uom library write command:

uom.upnp.expose_model=false

Sample requests write command:

requests.put('http://192.168.0.100/restapi/upnp/expose_model/',auth=auth,headers=headers,json=True)

Browse more samples

Expose serial

sum (boolean)upnp/expose_serial/
Controller serial number is exposed via UPnP
dot_inline_dotgraph_613.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 CLI write command:

uom set "upnp/expose_serial" "true"

Sample CLI read command:

uom get "upnp/expose_serial"

true

Browse more samples

Expose outlet positions

sum (boolean)upnp/expose_outlet_positions/
Outlet positions (indices) are exposed via UPnP
dot_inline_dotgraph_614.png

Retrieving the value is denied if not administrative user

Changing the value is denied if any of the following is true:

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 JS request write command:

request.put({url:"upnp/expose_outlet_positions/",body:true});

Sample requests write command:

requests.put('http://192.168.0.100/restapi/upnp/expose_outlet_positions/',auth=auth,headers=headers,json=False)

Browse more samples

Notifications

objectupnp/notifications/
UPnP-related notifications
dot_inline_dotgraph_615.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 curl read command:

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/notifications/"

{"events":{"dli.upnp.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}},"parameter_kinds":[]}

Sample JS request read command:

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

{"events":{"dli.upnp.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}},"parameter_kinds":[]}

Browse more samples

Parameter kinds

objectupnp/notifications/parameter_kinds/
Kinds of event parameters

This object does not correspond to an actual resource.

This object is empty.

Events

mapupnp/notifications/events/
Event templates
dot_inline_dotgraph_616.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 "upnp/notifications/events"

{"dli.upnp.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}}

Sample JS request read command:

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

{"dli.upnp.sample_event":{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}}

Browse more samples

See also Events: Event

Event parameters: Event parameter

objectupnp/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 CLI write command (note that event and event_parameter_index are variables):

uom set "upnp/notifications/events/${event}/parameters/${event_parameter_index}" "{\"id\":\"sample_parameter\",\"has_fixed_value\":false,\"fixed_value\":null}"

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

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

{'id': 'sample_parameter', 'has_fixed_value': False, 'fixed_value': None}

Browse more samples

Identifier

stringupnp/notifications/events/S/parameters/N/id/
Parameter identifier
dot_inline_dotgraph_617.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 requests read command (note that _event and _event_parameter_index are variables):

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

'sample_parameter'

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/upnp/notifications/events/:event/parameters/:event_parameter_index/id/"

"sample_parameter"

Browse more samples

Fixed value flag

sum (boolean)upnp/notifications/events/S/parameters/N/has_fixed_value/
Flag indicating that the parameter's value for this event is fixed
dot_inline_dotgraph_618.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 JS request read command (note that _event and _event_parameter_index are variables):

request.get({url:"upnp/notifications/events/"+_event+"/parameters/"+_event_parameter_index.toString()+"/has_fixed_value/"},function(error,response,body) {console.log(body)});

false

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

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

false

Browse more samples

Fixed value

sum (variant)upnp/notifications/events/S/parameters/N/fixed_value/
Fixed parameter value for this particular event
dot_inline_dotgraph_619.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 JS request read command (note that _event and _event_parameter_index are variables):

request.get({url:"upnp/notifications/events/"+_event+"/parameters/"+_event_parameter_index.toString()+"/fixed_value/"},function(error,response,body) {console.log(body)});

null

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

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

null

Browse more samples

Events: Event

objectupnp/notifications/events/S/
Event template
dot_inline_dotgraph_620.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.upnp.notifications.events[_event]))

{message_template={"sample event"},parameters={{fixed_value=null,has_fixed_value=false,id="sample_parameter"}}}

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

request.put({url:"upnp/notifications/events/"+_event+"/",body:{"parameters":[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}],"message_template":["sample event"]}});

Browse more samples

Message template

arrayupnp/notifications/events/S/message_template/
Template for human-readable message generation
dot_inline_dotgraph_621.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 "upnp/notifications/events/${event}/message_template"

["sample event"]

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

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

['sample event']

Browse more samples

Message template element

sum (variant)upnp/notifications/events/S/message_template/N/
Element of human-readable message template
dot_inline_dotgraph_622.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 curl read command (note that :event and :message_template_element_index are URL template arguments):

curl --digest -u admin:1234 -H "Accept: application/json" "http://192.168.0.100/restapi/upnp/notifications/events/:event/message_template/:message_template_element_index/"

"sample event"

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

uom get "upnp/notifications/events/${event}/message_template/${message_template_element_index}"

"sample event"

Browse more samples

Severity

sum (enumerated number)upnp/notifications/events/S/severity/
Severity rating assigned to the event
dot_inline_dotgraph_623.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 JS request read command (note that _event is a variable):

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

[]

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

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

[]

Browse more samples

Event parameters

arrayupnp/notifications/events/S/parameters/
Additional data associated with the event
dot_inline_dotgraph_624.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 CLI read command (note that event is a variable):

uom get "upnp/notifications/events/${event}/parameters"

[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}]

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

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

[{"id":"sample_parameter","has_fixed_value":false,"fixed_value":null}]

Browse more samples

See also Event parameters: Event parameter