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

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

[comment]: # ({06c5b0b6-06c5b0b6})
### Descripción

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

Este método permite crear nuevos grupos de equipos.

::: noteclassic
Este método solo está disponible para el tipo de usuario *Super administrador*.
Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver
[Roles de
usuario](/manual/web_interface/frontend_sections/administration/user_roles)
para más información.
:::

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

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

`(objeto/matriz)` Grupos de equipos para crear.

El método acepta grupos de equipos.
con las [propiedades estándar del grupo de equipos](object#host_group).

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

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

`(objeto)` Devuelve un objeto que contiene los ID de los grupos de equipos creados
bajo la propiedad `groupids`. El orden de las identificaciones devueltas
coincide con el orden de los grupos de equipos pasados.

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

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

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

[comment]: # ({822c3285-37cc26c2})
#### Creando un grupo de equipos

Cree un grupo de equipos llamado "servidores Linux".

Solicitud:

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.create",
    "params": {
        "name": "servidores Linux"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Respuesta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "groupids": [
            "107819"
        ]
    },
    "id": 1
}
```

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

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

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

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