usergroup.create

Descrição

object usergroup.create(object/array userGroups)

Este método permite criar novos grupos de usuários.

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

Parâmetros

(object/array) Grupos de usuários a serem criados.

Além das propriedades padrão do grupo de usuários, o método aceita os seguintes parâmetros.

Parâmetro	Tipo	Descrição
hostgroup_rights	object/array	Permissões de grupo de host a serem atribuídas ao grupo de usuários.
templategroup_rights	object/array	Permissões de grupo de template a serem atribuídas ao grupo de usuários.
tag_filters	array	Permissões baseadas em tags a serem atribuídas ao grupo de usuários.
users	object/array	Usuários a serem adicionados ao grupo de usuários. O usuário deve ter apenas a propriedade `userid` definida.

Valores de retorno

(object) Retorna um objeto contendo os IDs dos grupos de usuários criados na propriedade usrgrpids. A ordem dos IDs retornados corresponde à ordem dos grupos de usuários passados.

Exemplos

Criando um grupo de usuários

Crie um grupo de usuários Operation managers com acesso negado ao grupo de hosts "2" e adicione um usuário a ele.

Requisição:

{
           "jsonrpc": "2.0",
           "method": "usergroup.create",
           "params": {
               "name": "Operation managers",
               "hostgroup_rights": {
                   "id": "2",
                   "permission": 0
               },
               "users": [
                   {
                       "userid": "12"
                   }
               ]
           },
           "id": 1
       }

Resposta:

{
           "jsonrpc": "2.0",
           "result": {
               "usrgrpids": [
                   "20"
               ]
           },
           "id": 1
       }

Veja também

Permissão

Fonte

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

Documentation