Sidebar

Zabbix Summit 2022
Register for Zabbix Summit 2022

role.update

Descrição

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.

Parâmetros

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

Valores de retorno

(object) Retorna um objeto contendo os IDs dos papéis atualizados na propriedade roleids.

Exemplos

Desativando a capacidade de executar scripts

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:

{
           "jsonrpc": "2.0",
           "result": {
               "roleids": [
                   "5"
               ]
           },
           "id": 1
       }

Limitando o acesso à API

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:

{
           "jsonrpc": "2.0",
           "result": {
               "roleids": [
                   "5"
               ]
           },
           "id": 1
       }

Fonte

CRole::update() in ui/include/classes/api/services/CRole.php.