Table of Contents
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.
{ "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "hostgroup_rights": { "id": "2", "permission": 0 }, "users": [ { "userid": "12" } ] }, "id": 1 }Resposta:
Veja também
Fonte
CUserGroup::create() em ui/include/classes/api/services/CUserGroup.php.