/api/catalog/set
分组配置接口,可以将设备配置到分组,或者设置分组的安全配置。
仅管理员分组有权限。
接口原型
协议 |
HTTP/HTTPS POST |
URL |
ip[:port]/api/catalog/set |
数据格式 |
请求消息:Content-Type: application/json 响应消息:Content-Type: application/json |
请求Cookies
名称 |
描述 |
mwcloud-sid |
用于标识当前登录的字符串 |
mwcloud-uid |
当前登录用户名 |
Request Body
参数 |
描述 |
id |
设备分组ID, 取值为0表示从自定义的设备分组移出。 |
devices |
可选,批量移动到此分组的设备序列号集合。 |
security |
可选,安全配置, 当id为0时,表示配置全局默认设备可见性配置。 |
安全配置
参数 |
描述 |
is-inherit |
是否继承可见性配置,数值,如果非0,表示用户组和用户的掩码配置为继承值,配置全局默认设备可见性时,不显示该字段 |
group-mask |
可见用户组掩码集合,当选择所有可见时,将该值配置为0xFFFFFFFF(4294967295)。 |
usr-mask |
可见用户掩码集合。 |
请求示例
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"
]
}
响应参数
参数 |
描述 |
Content-Type |
取值为:'application/json; charset=UTF-8' |
Response Body
响应示例
HTTP/1.1 200 OK
content-type: application/json; charset=utf-8
content-length: xx
{
"result": 0,
}