object role.update(объект/массив roles)
Этот метод позволяет обновлять существующие роли.
Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.
(object/array)
Role properties to be updated.
The roleid
property must be defined for each role, all other properties are optional. Only the passed properties will be updated, all others will remain unchanged.
Additionally to the standard role properties the method accepts the following parameters.
Parameter | Type | Description |
---|---|---|
rules | array | Access rules to replace the current access rules assigned to the role. |
(object)
Возвращает объект, содержащий идентификаторы обновлённых ролей, указанных в свойстве roleids
.
Update role with ID "5", disable ability to execute scripts.
Request:
{
"jsonrpc": "2.0",
"method": "role.update",
"params": [
{
"roleid": "5",
"rules": {
"actions": [
{
"name": "execute_scripts",
"status": "0"
}
]
}
}
],
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}
Response:
Update role with ID "5", deny to call any "create", "update" or "delete" methods.
Request:
{
"jsonrpc": "2.0",
"method": "role.update",
"params": [
{
"roleid": "5",
"rules": {
"api.access": "1",
"api.mode": "0",
"api": ["*.create", "*.update", "*.delete"]
}
}
],
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}
Response:
CRole::update() в ui/include/classes/api/services/CRole.php.