角色.创建

说明

object role.create(object/array roles)

用户使用该方法可以创建新的角色用户。

该方式仅对超级管理员类型的用户有效。 用户可以在用户角色设置中对该方式的使用权限进行设定修改。请参考 用户角色以获取更多信息。

参数

(object/array) 要创建的角色用户。

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

参数类型说明
rules数组角色 角色规则用于创建新的角色用户。

返回值

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

示例

创建一个新的角色用户

创建一个信息的普通 “用户” ,并禁止其访问两方面UI元素。

请求:

  1. {
  2. "jsonrpc": "2.0",
  3. "method": "role.create",
  4. "params": {
  5. "name": "Operator",
  6. "type": "1",
  7. "rules": {
  8. "ui": [
  9. {
  10. "name": "monitoring.hosts",
  11. "status": "0"
  12. },
  13. {
  14. "name": "monitoring.maps",
  15. "status": "0"
  16. }
  17. ]
  18. }
  19. },
  20. "auth": "038e1d7b1735c6a5436ee9eae095879e",
  21. "id": 1
  22. }

反馈:

  1. {
  2. "jsonrpc": "2.0",
  3. "result": {
  4. "roleids": [
  5. "5"
  6. ]
  7. },
  8. "id": 1
  9. }

另见

来源

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