开发者平台

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

4.1.10 添加角色

接口说明：

名称

内容

URL

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

功能说明

添加角色

使用限制

需要用户管理权限

请求参数：

参数名称

参数描述

roleName

String

角色名，长度1~32

projectList

Set

角色关联项目列表，包含项目ID和项目名称

menuList

Set

角色关联菜单权限，包含菜单ID和菜单名称

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
          }