Sidebar

Zabbix Summit 2022
View presentations

hostprototype.create

Description

object hostprototype.create(object/array hostPrototypes)

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

Paramètres

(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.

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.

Exemples

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 :

{
           "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
       }

Voir également

Source

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