role.create

Описание

object role.create(object/array roles)

Этот метод позволяет создавать новые роли.

Этот метод доступен только для типа пользователя Super admin. Разрешения на вызов метода можно отозвать в настройках роли пользователя. См. Роли пользователей для получения дополнительной информации.

Параметры

(object/array) Роли для создания.

Помимо стандартных свойств роли, метод принимает следующие параметры.

Parameter Type Description
rules array Правила роли, которые будут созданы для роли.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID созданных ролей, указанных в свойстве roleids. Порядок возвращаемых ID совпадает с порядком переданных ролей.

Примеры

Создание роли

Создайте роль с типом "User" и запретом доступа к двум элементам интерфейса.

Запрос:

{
    "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
}

См. также

Источник

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