role.create

Описание

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

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

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

Параметры

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

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

Параметр Тип Описание
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.