创建

说明

object role.create(object/array roles)

#用户使用该方法可以创建新的角色用户。 ::: 请注意 该方式仅对_超级管理员_类型的用户有效。 用户可以在用户角色设置中对该方式的使用权限进行设定修改。请参考 用户角色 :::

参数

(object/array) Roles to create. 要创建的角色用户。

除此之外，根据[标准用户角色特性]( 该方式接受下列参数配置。

返回值

根据roleids特性，(object) 会返回一个对象，包含创建的角色用户的ID号。返回的ID号顺序对应查询的角色用户次序。

示例

创建角色

创建一个类型为“User”的角色 ，并禁止其访问两个UI元素。 请求:

{  "jsonrpc": "2.0",  "method": "role.create",  "params": {  "name": "Operator",  "type": "1",  "rules": {  "ui": [  {  "name": "monitoring.hosts",  "status": "0"  },  {  "name": "monitoring.maps",  "status": "0"  }  ]  }  },  "id": 1 }

响应:

{  "jsonrpc": "2.0",  "result": {  "roleids": [  "5"  ]  },  "id": 1 }

另见

• 角色规则
• UI元素
• 模型
• 活动

来源

CRole::create() in ui/include/classes/api/services/CRole.php.