object hostprototype.create(object/array hostPrototypes)
Cette méthode permet de créer de nouveaux prototypes d’hôte.
(object/array) Prototypes d'hôte à créer.
En plus des propriétés de l'objet prototype d'hôte standard, la méthode accepte les paramètres suivants.
| PAramètre | Type | Description |
|---|---|---|
| groupLinks (obligatoire) | array | Liens de groupe à créer pour le prototype d'hôte. |
| ruleid (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. Les modèles doivent avoir la propriété templateid définie. |
(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.
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 :
{ "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 :
{ "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 }
CHostPrototype::create() dans frontends/php/include/classes/api/services/CHostPrototype.php.