object role.update(object/array roles)
Este método permite atualizar as funções existentes.
Este método está disponível apenas para o tipo de usuário Super admin.
As permissões para chamar o método podem ser revogadas nas configurações de função do usuário. Consulte Funções do usuário para obter mais informações.
(object/array)
Propriedades da função a serem atualizadas.
A propriedade roleid
deve ser definida para cada função, todas as outras propriedades são opcionais. Apenas as propriedades passadas serão atualizadas, todas as outras permanecerão inalteradas.
Além das propriedades de função padrão, o método aceita os seguintes parâmetros.
Parâmetro | Tipo | Descrição |
---|---|---|
rules | array | Acesse rules para substituir as regras de acesso atuais atribuídas à função. |
(object)
Retorna um objeto contendo os IDs dos papéis atualizados na propriedade roleids
.
Atualize a função com o ID "5", desative a capacidade de executar scripts.
Request:
{
"jsonrpc": "2.0",
"method": "role.update",
"params": [
{
"roleid": "5",
"rules": {
"actions": [
{
"name": "execute_scripts",
"status": "0"
}
]
}
}
],
"auth": "3a57200802b24cda67c4e4010b50c065",
"id": 1
}
Response:
Atualize a função com o ID "5", negue chamar qualquer método "criar", "atualizar" ou "excluir".
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() in ui/include/classes/api/services/CRole.php.