[comment]: # translation:outdated

[comment]: # ({c40e8cd1-c40e8cd1})
# usergroup.create

[comment]: # ({/c40e8cd1-c40e8cd1})

[comment]: # ({c4e5814a-c74b5711})
### Descrição  
  
`object usergroup.create(object/array userGroups)`  
  
Este método permite criar novos grupos de usuários.  
  
::: noteclassic  
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](/manual/web_interface/frontend_sections/administration/user_roles) para obter mais informações.
:::

[comment]: # ({/c4e5814a-c74b5711})

[comment]: # ({298ee6e6-3b20a75b})
### Parameters

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

Álem dos  [standard user group properties](object#user_group),
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](object#user_group), o método aceita os seguintes parâmetros.  
  
|Parâmetro|[Tipo](/manual/api/reference_commentary#data_types)|Descrição|
|--|--|------|
|rights|object/array|[Permissões](/manual/api/reference/usergroup/object#permission) para atribuir ao grupo|
|tag\_filters|array|[Permissões baseadas em etiquetas](/manual/api/reference/usergroup/object#tag_based_permission) para atribuir ao grupo|
|users|object/array|[Usuários](/manual/api/reference/user/create) para adicionar ao grupo de usuários.<br><br>O usuário deve ter a propriedade `userid` definida.|
|Parameter|[Type](/manual/api/reference_commentary#data_types)|Description|
|--|--|------|
|rights|object/array|[Permissions](/manual/api/reference/usergroup/object#permission) to assign to the group|
|tag\_filters|array|[Tag based permissions](/manual/api/reference/usergroup/object#tag_based_permission) to assign to the group|
|users|object/array|[Users](/manual/api/reference/user/create) to add to the user group.<br><br>The user must have the `userid` property defined.|

[comment]: # ({/298ee6e6-3b20a75b})

[comment]: # ({19e4f0cc-19e4f0cc})
### 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.

[comment]: # ({/19e4f0cc-19e4f0cc})

[comment]: # ({b41637d2-b41637d2})
### Exemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({8f0e0ef4-61abd39a})
#### 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:

```json
{
    "jsonrpc": "2.0",
    "method": "usergroup.create",
    "params": {
        "name": "Operation managers",
        "rights": {
            "permission": 0,
            "id": "2"
        },
        "users": [
            {"userid": "12"}
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response:

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

[comment]: # ({/8f0e0ef4-61abd39a})

[comment]: # ({d5c7ed4f-d5c7ed4f})
### Veja também

-   [Permissão](object#permission)

[comment]: # ({/d5c7ed4f-d5c7ed4f})

[comment]: # ({2d7f8c71-2d7f8c71})
### Fonte

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

[comment]: # ({/2d7f8c71-2d7f8c71})