开发者平台

 TP-LINK官网首页
VMS平台
V2.0.19
开发者平台 / 视频管理系统（VMS）/ API功能接口定义 / 用户管理

4.1.11 添加角色

接口说明：

名称

内容

URL

https://xxx/tums/account/v1/addRole

功能说明

添加角色，角色数量上限为10000

使用限制

需要用户管理权限

请求参数：

参数名称

参数描述

roleName

String

角色名，长度1~32

description

String

角色描述（可选）

projectList

Set

projectId

String

项目id

projectName

String

项目名称

menuList

Set

menuId

int

菜单id

menuName

String

菜单名称

previewRegions

Set

角色可预览的区域（可选），包含区域ID列表

previewDevices

Set

角色可预览的设备（可选），包含设备ID列表，优先级低于区域预览权限

playbackRegions

Set

角色可回放的区域（可选），包含区域ID列表

playbackDevices

Set

角色可回放的设备（可选），包含设备ID列表，优先级低于区域回放权限

返回参数

参数名称

参数描述

result

无

error_code

-80118

角色名已存在

-80126

角色数量超过最大值

-80202

项目不存在

-82400

参数错误

-82401

权限不足

代码示例

          request:
          {
            "roleName":"roleModel",
            "description":"test add role",
            "projectList":[
              {
                "projectId":"1", 
                "projectName":"管理中心"
              }],
            "menuList":[
              {
                "menuId":1,
                "menuUrl":"resource"
              },
              {
                "menuId":2,
                "menuUrl":"user"
              }],
            "previewRegions":[7,8,9],
            "previewDevices":["2","3"],
            "playbackRegions":[10, 11],
            "playbackDevices":["4","5","6"]
          }
          response:
          {
          "error_code": 0
          }