[comment]: # translation:outdated

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

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

[comment]: # ({0a562b4e-06c5b0b6})
### Description

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

Cette méthode permet de créer de nouveaux groupes d'hôtes.

::: noteclassic
Cette méthode est disponible uniquement pour le type d'utilisateur *Super admin*.
Les autorisations permettant d'appeler la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir
[User
roles](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d'informations.
:::

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

[comment]: # ({d4dbea88-7c6d41ff})
### Paramètres

`(object/array)` Groupes d’hôtes à créer.

La méthode accepte des groupes d’hôtes
avec les [propriétés standard des groupes d’hôtes](object#host-group).

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

[comment]: # ({e3c164f1-e3c164f1})
### Valeurs retournées

`(object)` Renvoie un objet contenant les identifiants des groupes d'hôtes créés sous la propriété `groupids`. L'ordre des identifiants retournés
correspond à l'ordre des groupes d'hôtes transmis.

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

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

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

[comment]: # ({f82f8eea-37cc26c2})
#### Création d’un groupe d’hôtes

Créez un groupe d’hôtes nommé « Linux servers ».

[Requête](/manual/api#performing-requests) :

```json
{
    "jsonrpc": "2.0",
    "method": "hostgroup.create",
    "params": {
        "name": "Linux servers"
    },
    "id": 1
}
```

Réponse :

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

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

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

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

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