/api/catalog/set
Use this interface to configure device group, which can asign devices into groups, or set security configurations for groups.
Only available for the administrative group.
Prototype
| Protocol |
HTTP/HTTPS POST |
| URL |
ip[:port]/api/catalog/set |
| Content-Type |
Request: Content-Type: application/json
Response: Content-Type: application/json |
Request Cookies
| Parameter |
Description |
| mwcloud-sid |
A string that is used to identify current logged-in user. |
| mwcloud-uid |
Current logged-in username. |
Request Body
| Parameter |
Description |
| id |
Device group ID, 0 indicates that the device is removed from the custom device group. |
| devices |
Optional, serial numbers of devices moved to this group. |
| security |
Optional, Security Configuration. When id is 0, indicates configuration of visibility for global default device. |
Safety Configuration
| Parameter |
Description |
| is-inherit |
Whether the visibility configuration is inherited. A value of non-zero indicates that the mask configuration is inherited for user groups and users. This field is not displayed when global default device visibility is configured. |
| group-mask |
The set of visible user group masks. Configuring this value to 0xFFFFFFFF (4294967295) indicates that all visible devices are selected. |
| usr-mask |
The set of visible user group masks. |
Request Example
POST /api/catalog/set HTTP/1.1
Accept: application/json, text/plain, */*
Content-Type: application/json;charset=utf-8
Content-Length: xx
Cookie: mwcloud-sid=OCXWUMGEYPGIAWWOETYXPNMVHDZIAZJP; mwcloud-uid=Admin;
{
"id": 2,
"devices": [
"A305200908004",
"A304200731001"
]
}
Response Parameters
| Parameter |
Description |
| Content-Type |
Value: 'application/json; charset=UTF-8' |
Response Body
Response Example
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
content-length: xx
{
"result": 0,
}