This is a translation of the original English documentation page. Help us make it better.

hostprototype.create

Description

object hostprototype.create(object/array hostPrototypes)

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

Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.

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(/manual/api/reference/hostprototype/object#group_prototype) devant être créés pour le prototype d'hôte.
macros object/array Macros utilisateurs à créer pour le prototype d'hôte.
tags object/array Tags de prototype d'hôte.
interfaces object/array Interfaces personnalisée de 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) Renvoie un objet contenant les IDs des prototypes d'hôtes créés sous la propriété hostids. L'ordre des ID renvoyés correspond à l'ordre des prototypes d'hôtes transmis.

Exemples

Création d'un prototype d'hôte

Créez un prototype d'hôte "{#VM.NAME}" sur la règle LLD "23542" avec un prototype de groupe "{#HV.NAME}", une paire de tag "Datacenter": "#DATACENTER.NAME}" et une interface SNMPv2 personnalisée 127.0.0.1:161 avec la communauté {$SNMP_COMMUNITY}. Liez-le au groupe d'hôtes "2".

Requête :

{
           "jsonrpc": "2.0",
           "method": "hostprototype.create",
           "params": {
               "host": "{#VM.NAME}",
               "ruleid": "23542",
               "custom_interfaces": "1",
               "groupLinks": [
                   {
                       "groupid": "2"
                   }
               ],
               "groupPrototypes": [
                   {
                       "name": "{#HV.NAME}"
                   }
               ],
               "tags": [
                   {
                       "tag": "Datacenter",
                       "value": "{#DATACENTER.NAME}"
                   }
               ],
               "interfaces": [
                   {
                       "main": "1",
                       "type": "2",
                       "useip": "1",
                       "ip": "127.0.0.1",
                       "dns": "",
                       "port": "161",
                       "details": {
                           "version": "2",
                           "bulk": "1",
                           "community": "{$SNMP_COMMUNITY}"
                       }
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

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

Voir également

Source

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