Documentation
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 do usuário. Consulte Funções do usuário para obter mais informações.
Parameters
(object/array) Grupos de usuários a serem criados.
Álem dos standard user group properties, o método aceito os seguinte parâmetros. ### Parâmetros
(object/array) Grupos de usuários a serem criados.
Além das propriedades do grupo de usuários padrão, o método aceita os seguintes parâmetros.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| rights | object/array | Permissões para atribuir ao grupo |
| tag_filters | array | Permissões baseadas em etiquetas para atribuir ao grupo |
| users | object/array | Usuários para adicionar ao grupo de usuários. O usuário deve ter a propriedade userid definida. |
| Parameter | Type | Description |
| -- | -- | ------ |
| rights | object/array | Permissions to assign to the group |
| tag_filters | array | Tag based permissions to assign to the group |
| users | object/array | Users to add to the user group. The user must have the userid property defined. |
Valores de retorno
(object) Retorna um objeto contendo os IDs dos grupos de usuários criados sob a 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, que negue o acesso ao grupo de hosts "2", e adicione um usuário a ele.
Request:
{ "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "rights": { "permission": 0, "id": "2" }, "users": [ {"userid": "12"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 }Response:
Veja também
Fonte
CUserGroup::create() in ui/include/classes/api/services/CUserGroup.php.