Você está visualizando a documentação da versão de desenvolvimento, que pode estar incompleta.
Esta página foi traduzida automaticamente. Se você notar um erro, selecione-o e pressione Ctrl+Enter para reportá-lo aos editores.

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

Parâmetros

(object/array) Funções a serem criadas.

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

Parâmetro Tipo Descrição
rules array Regras de função a serem criadas para a função.

Valores de retorno

(object) Retorna um objeto contendo os IDs das funções criadas 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.

Requisição:

{
           "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
       }

Resposta:

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

Veja também

Origem

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