role.create

Descrição

object role.create(object/array roles)

Este método permite criar novas funções.

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 de usuário para obter mais informações.

Parâmetros

(object/array) Funções para criar.

Além das propriedades de função padrão, o método aceita os seguintes parâmetros.

Parâmetro Tipo Descrição
rules array Função rules a ser criada para a função.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos papéis criados na propriedade roleids. A ordem dos IDs retornados corresponde à ordem das funções passadas.

Exemplos

Criando uma função

Crie uma função com o tipo "Usuário" e acesso negado a dois elementos da interface do usuário.

Request:

{
           "jsonrpc": "2.0",
           "method": "role.create",
           "params": {
               "name": "Operator",
               "type": "1",
               "rules": {
                   "ui": [
                       {
                           "name": "monitoring.hosts",
                           "status": "0"
                       },
                       {
                           "name": "monitoring.maps",
                           "status": "0"
                       }
                   ]
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Response:

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

Veja também

Fonte

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