角色.创建

说明

object role.create(object/array roles)

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

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

参数

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

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

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

返回值

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

示例

创建角色

创建一个类型为“User”的角色 ，并禁止其访问两个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.