[comment]: # ({5ebe3ff8-5ebe3ff8})
## hostgroup.create

[comment]: # ({/5ebe3ff8-5ebe3ff8})

[comment]: # ({06c5b0b6-06c5b0b6})
### Descrição

`object hostgroup.create(object/array hostGroups)`

Este método permite criar novos grupos de hosts.

::: 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. Ver
[Do utilizador
funções](/manual/web_interface/frontend_sections/administration/user_roles)
Para maiores informações.
:::

[comment]: # ({/06c5b0b6-06c5b0b6})

[comment]: # ({7c6d41ff-7c6d41ff})
### Parâmetros

`(objeto/array)` Grupos de hosts a serem criados. O método aceita grupos de hosts
com as [propriedades padrão do grupo de hosts](object#host_group).

[comment]: # ({/7c6d41ff-7c6d41ff})

[comment]: # ({e3c164f1-e3c164f1})
### Valores de retorno

`(object)` Retorna um objeto contendo os IDs do host criado
grupos sob a propriedade `groupids`. A ordem dos IDs retornados
corresponde à ordem dos grupos de hosts passados.

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

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

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

[comment]: # ({822c3285-37cc26c2})
#### Criando um grupo de hosts

Crie um grupo de hosts chamado "servidores Linux".

Solicitação:

``` {.java}
{
    "jsonrpc": "2.0",
    "método": "hostgroup.create",
    "parâmetros": {
        "name": "Servidores Linux"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

``` {.java}
{
    "jsonrpc": "2.0",
    "resultado": {
        "groupids": [
            "107819"
        ]
    },
    "id": 1
}
```

[comment]: # ({/822c3285-37cc26c2})

[comment]: # ({df4dc6d7-df4dc6d7})
### Fonte

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

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