hub.scenes.device.group.update
- Version: 1.0
- Classes: UI
- Title: Scene manager categories
- Description: Update existing device group object.
Edit
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | + | ID of a record to update |
| name | string | – | A name of a group. Should be unique, should meet firmware name length restrictions. Current firmware limits name length of majority of objects to 128 symbols. |
| categories | array of objects | – | An array of category filters. Defines a set of device categories that form a set of devices in the group. |
| devices | array of device IDs | – | Device identifiers to be added to a set defined by categories collection |
| exceptions | array of device IDs | – | Device identifiers to be excluded from a device group |
| persistent | bool | – | Defines if an object is persistent. |
Edit
- Empty result.
Edit
| Code | Message | Data |
|---|---|---|
| -32602 | Wrong params, | |
| -32602 | Wrong field of object | |
| -32600 | Value is too long, | |
| -32500 | No device found! | |
| -32602 | Record with the key does not exist |
Edit
| Broadcasts | Description |
|---|---|
| hub.scenes.device.group.updated | Inform about the change of the device group. |
Edit
Edit
{
"id":"_ID_",
"jsonrpc":"2.0",
"api": "1.0",
"method":"hub.scenes.device.group.update",
"params":{
"id": "<deviceGroupId>",
"name": "_DEVICE_GROUP_NAME_",
"categories": [
{ "category": "security_sensor", "subcategories": [ "co2", "leak" ] }
{ "category": "scene_controller", "exceptions": [ "panic" ] }
],
"devices": [],
"exceptions": [],
"persistent": false
}
}
Edit
{
"error": null,
"id": "_ID_",
"result": {
}
}