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

> Objet Prototype d'hôte

Les objets suivants sont directement liés à l'API hostprototype.

Prototype d'hôte

L'objet prototype d'hôte a les propriétés suivantes.

Propriété Type Description
hostid string (lecture seule) ID du prototype d'hôte.
host
(obligatoire)
string Nom technique du prototype d'hôte.
name string Nom visible du prototype d'hôte.

Par défaut : valeur de la propriété host.
status integer Statut du prototype d'hôte.

Valeurs possibles :
0 - (par défaut) hôte surveillé ;
1 - hôte non surveillé.
inventory_mode integer Mode de remplissage de l'inventaire de l'hôte.

Les valeurs possibles sont :
-1 - (par défaut) désactivé ;
0 - manuel ;
1 - automatique.
templateid string (lecture seul) ID du modèle parent du prototype d'hôte.
discover integer Statut de découverte du prototype d'hôte.

Valeurs possibles :
0 - (par défaut) de nouveaux hôtes seront découverts ;
1 - de nouveaux hôtes ne seront pas découverts et les hôtes existants seront marqués comme perdus.
custom_interfaces integer Source des interfaces pour les hôtes créés par le prototype d'hôte.

Valeurs possibles :
0 - (par défaut) hérite des interfaces de l'hôte parent ;
1 - utilise les interfaces personnalisées des prototypes d'hôte.
uuid string Identifiant unique universel, utilisé pour lier les prototypes d'hôtes importés à ceux déjà existants. Utilisé uniquement pour les prototypes hôtes sur les modèles. Généré automatiquement, s'il n'est pas fourni.

Pour les opérations de mise à jour, ce champ est en lecture seule.

Notez que pour certaines méthodes (mise à jour, suppression) la combinaison de paramètres requise/optionnelle est différente.

Lien de groupe

L'objet de lien de groupe relie un prototype d'hôte à un groupe d'hôtes et possède les propriétés suivantes.

Propriété Type Description
groupid
(obligatoire)
string ID du groupe d'hôtes.

Prototype de groupe

L'objet prototype de groupe définit un groupe qui sera créé pour un hôte découvert et possède les propriétés suivantes.

Propriété Type Description
name
(obligatoire)
string Nom du prototype de groupe.

Tag de prototype d'hôte

L'objet de tag de prototype d'hôte possède les propriétés suivantes.

Propriété Type Description
tag
(obligatoire)
string Nom de tag du prototype d'hôte.
value string Valeur de tag du prototype d'hôte.

Interface personnalisée

L'objet d'interface personnalisée a les propriétés suivantes.

Propriété Type Description
dns string Nom DNS utilisé par l'interface.

Obligatoire si la connexion se fait via DNS. Peut contenir des macros.
ip string Adresse IP utilisée par l'interface.

Obligatoire si la connexion se fait via IP. Peut contenir des macros.
main
(obligatoire)
integer Indique si l'interface est utilisée par défaut sur l'hôte. Une seule interface d'un certain type peut être définie par défaut sur un hôte.

Les valeurs possibles sont :
0 - pas par défaut ;
1 - par défaut.
port
(obligatoire)
string Numéro de port utilisé par l'interface. Peut contenir des macros utilisateur et LLD.
type
(obligatoire)
integer Type d'interface.

Les valeurs possibles sont :
1 - agent ;
2 - SNMP ;
3 - IPMI ;
4 - JMX.
useip
(obligatoire)
integer Indique si la connexion doit être établie via IP.

Les valeurs possibles sont :
0 - se connecter en utilisant le nom DNS de l'hôte ;
1 - se connecter en utilisant l'adresse IP de l'hôte pour cette interface hôte.
details array Objet supplémentaire pour l'interface. Obligatoire si l'interface 'type' est SNMP.

Détails de l'interface personnalisée

L'objet détails a les propriétés suivantes.

Propriété Type Description
version
(obligatoire)
integer Version de l'interface SNMP.

Les valeurs possibles sont :
1 - SNMPv1;
2 - SNMPv2c;
3 - SNMPv3
bulk integer Indique s'il faut utiliser les requêtes SNMP en masse.

Les valeurs possibles sont :
0 - ne pas utiliser les requêtes en masse ;
1 - (par défaut) - utiliser les requêtes en masse.
community string Communauté SNMP. Utilisé uniquement par les interfaces SNMPv1 et SNMPv2.
securityname string Nom de sécurité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.
securitylevel integer Niveau de sécurité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.

Les valeurs possibles sont :
0 - (par défaut) - noAuthNoPriv;
1 - authNoPriv;
2 - authPriv.
authpassphrase string Mot de passe d'authentification SNMPv3. Utilisé uniquement par les interfaces SNMPv3.
privpassphrase string Phrase secrète de confidentialité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.
authprotocol integer Protocole d'authentification SNMPv3. Utilisé uniquement par les interfaces SNMPv3.

Les valeurs possibles sont :
0 - (par défaut) - MD5;
1 - SHA1;
2 - SHA224;
3 - SHA256;
4 - SHA384;
5 - SHA512.
privprotocol integer Protocole de confidentialité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.

Les valeurs possibles sont :
0 - (par défaut) - DES;
1 - AES128;
2 - AES192;
3 - AES256;
4 - AES192C;
5 - AES256C.
contextname string Nom de contexte SNMPv3. Utilisé uniquement par les interfaces SNMPv3.