role.create

Описание

object role.create(объект/массив roles)

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

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

Параметры

(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.