Monitors

Create or update a monitors relation

Create a monitors relation (or update the existing one) between a role and a device.<br><br> To execute this query, the user must be a member of an authorizing role which satisfies both of the following conditions: <ol> <li> One of the following role-related conditions is true: <ul> <li> The authorizing role has direct or indirect deviceManagement rights for the role from which the monitors relation is created (or updated) </li> <li> The authorizing role has indirect roleManagement rights for the role from which the monitors relation is created (or updated) </li> </ul> </li> <li> The authorizing role has monitorManagement rights for the device to which the monitors relation is created </li> </ol>

put/v1/role/{roleId}/monitors

Path parameters

roleIdinteger required

Id of the role of the newly created (or updated) monitors relation

Query parameters

deviceIdinteger[] required

Id of the device the newly created (or updated) monitors relation

Request body

monitorManagementboolean required

Indicates whether the role has the right to create new monitors relations to the monitored device. If true, the role may read and edit any device property.

readsstring[] required

A list of device properties which may be read by the role monitoring the device

editsstring[] required

A list of device properties which may be both read and edited by the role monitoring the device

Response

The newly created (or updated) monitors relation

Changes

No recorded changes to this endpoint across all 1 revision of this API.