[comment]: # ({984854ac-984854ac})
# hostprototype.create

[comment]: # ({/984854ac-984854ac})

[comment]: # ({f393e5fe-8604fbe5})
### Description

`object hostprototype.create(object/array hostPrototypes)`

Cette méthode permet de créer de nouveaux prototypes d’hôte.

[comment]: # ({/f393e5fe-8604fbe5})

[comment]: # ({cc751759-b172c252})
### Paramètres

`(object/array)` Prototypes d'hôte à créer.

En plus des [propriétés de l'objet prototype d'hôte
standard](/fr/manual/api/reference/hostprototype/object#prototype_d_hote),
la méthode accepte les paramètres suivants.

|PAramètre|Type|Description|
|----------|----|-----------|
|**groupLinks**<br>(obligatoire)|array|Liens de groupe à créer pour le prototype d'hôte.|
|**ruleid**<br>(obligatoire)|string|ID de la règle de découverte bas niveau à laquelle appartient le prototype d'hôte.|
|groupPrototypes|array|Prototypes de groupe devant être créés pour le prototype hôte.|
|inventory|object|Propriétés d'inventaire du prototype d'hôte.|
|templates|object/array|Modèles à lier au prototype d'hôte.<br><br>Les modèles doivent avoir la propriété `templateid` définie.|

[comment]: # ({/cc751759-b172c252})

[comment]: # ({42920be0-b9613119})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des prototypes
d'hôte créés sous la propriété `hostids`. L'ordre des ID retournés
correspond à l'ordre des prototypes d'hôte transmis.

[comment]: # ({/42920be0-b9613119})

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

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

[comment]: # ({db64b6ac-a0f128a7})
#### Création d'un prototype d'hôte

Créer un prototype d'hôte "{\#VM.NAME}" dans la règle de découverte bas
niveau "23542" avec un prototype de groupe "{\#HV.NAME}" , et l'associer
au groupe d'hôtes "2".

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "hostprototype.create",
    "params": {
        "host": "{#VM.NAME}",
        "ruleid": "23542",
        "groupLinks": [
            {
                "groupid": "2"
            }
        ],
        "groupPrototypes": [
            {
                "name": "{#HV.NAME}"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "hostids": [
            "10103"
        ]
    },
    "id": 1
}
```

[comment]: # ({/db64b6ac-a0f128a7})

[comment]: # ({1bf1d057-cf1c169a})
### Voir également

-   [Lien de
    groupe](/fr/manual/api/reference/hostprototype/object#lien_de_groupe)
-   [Prototype de
    groupe](/fr/manual/api/reference/hostprototype/object#prototype_de_groupe)
-   [Inventaire du prototype
    d'hôte](/fr/manual/api/reference/hostprototype/object#inventaire_du_prototype_d_hote)

[comment]: # ({/1bf1d057-cf1c169a})

[comment]: # ({681e2c0e-f3236799})
### Source

CHostPrototype::create() dans
*frontends/php/include/classes/api/services/CHostPrototype.php*.

[comment]: # ({/681e2c0e-f3236799})