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 possède les propriétés suivantes.

Propriété Type Description
hostid ID ID du prototype d’hôte.

Comportement de la propriété :
- lecture seule
- obligatoire pour les opérations de mise à jour
host string Nom technique du prototype d’hôte.

Comportement de la propriété :
- obligatoire pour les opérations de création
- lecture seule pour les objets hérités
name string Nom visible du prototype d’hôte.

Par défaut : valeur de la propriété host.

Comportement de la propriété :
- lecture seule pour les objets hérités
status integer Statut du prototype d’hôte.

Valeurs possibles :
0 - (par défaut) hôte surveillé ;
1 - hôte non surveillé.
flags integer Origine du prototype d’hôte.

Valeurs possibles :
2 - un prototype d’hôte ;
6 - un prototype d’hôte découvert

Comportement de la propriété :
- lecture seule
inventory_mode integer Mode de remplissage de l’inventaire de l’hôte.

Valeurs possibles :
-1 - (par défaut) désactivé ;
0 - manuel ;
1 - automatique.
templateid ID ID du prototype d’hôte du modèle parent.

Comportement de la propriété :
- lecture seule
discover integer Statut de découverte du prototype d’hôte.

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

Valeurs possibles :
0 - (par défaut) hériter des interfaces de l’hôte parent ;
1 - utiliser les interfaces personnalisées des prototypes d’hôte.

Comportement de la propriété :
- lecture seule pour les objets hérités
uuid string Identifiant universel unique, utilisé pour lier les prototypes d’hôte importés à ceux qui existent déjà. Généré automatiquement s’il n’est pas fourni.

Comportement de la propriété :
- pris en charge si le prototype d’hôte appartient à un modèle

Lien de groupe

L’objet de lien de groupe associe un prototype d’hôte à un groupe d’hôtes. Il possède les propriétés suivantes.

Propriété Type Description
groupid ID ID du groupe d’hôtes.

Comportement de la propriété :
- obligatoire

Prototype de groupe

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

Propriété Type Description
group_prototypeid ID ID du prototype de groupe.

Comportement de la propriété :
- lecture seule
name string Nom du prototype de groupe.

Comportement de la propriété :
- obligatoire pour les opérations de création

Balise de prototype d'hôte

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

Propriété Type Description
tag string Nom de la balise du prototype d'hôte.

Comportement de la propriété:
- obligatoire
value string Valeur de la balise du prototype d'hôte.

Comportement de la propriété:
- lecture seule.
object integer Type d'objet dont la balise a été héritée.

Valeurs possibles :
0 - modèle.

Comportement de la propriété:
- lecture seule.
objectid ID ID de l'objet dont la balise a été héritée.

Comportement de la propriété:
- lecture seule.

Interface personnalisée

Les interfaces personnalisées sont prises en charge si custom_interfaces de l’objet prototype d’hôte est défini sur « utiliser les interfaces personnalisées des prototypes d’hôte ». L’objet d’interface personnalisée possède les propriétés suivantes.

Propriété Type Description
type integer Type d’interface.

Valeurs possibles :
1 - Agent ;
2 - SNMP ;
3 - IPMI ;
4 - JMX.

Comportement de la propriété :
- obligatoire
useip integer Indique si la connexion doit être établie via l’adresse IP.

Valeurs possibles :
0 - se connecter en utilisant le nom DNS de l’hôte ;
1 - se connecter en utilisant l’adresse IP de l’hôte.

Comportement de la propriété :
- obligatoire
ip string Adresse IP utilisée par l’interface.
Peut contenir des macros.

Comportement de la propriété :
- obligatoire si useip est défini sur « se connecter en utilisant l’adresse IP de l’hôte »
dns string Nom DNS utilisé par l’interface.
Peut contenir des macros.

Comportement de la propriété :
- obligatoire si useip est défini sur « se connecter en utilisant le nom DNS de l’hôte »
port string Numéro de port utilisé par l’interface.
Peut contenir des macros utilisateur et LLD.

Comportement de la propriété :
- obligatoire
main integer Indique si l’interface est utilisée comme interface par défaut sur l’hôte.
Une seule interface d’un certain type peut être définie comme interface par défaut sur un hôte.

Valeurs possibles :
0 - non par défaut ;
1 - par défaut.

Comportement de la propriété :
- obligatoire
details object Objet supplémentaire pour les détails de l’interface personnalisée.

Comportement de la propriété :
- obligatoire si type est défini sur « SNMP »

Détails de l’interface personnalisée

L’objet details possède les propriétés suivantes.

Propriété Type Description
version integer Version de l’interface SNMP.

Valeurs possibles :
1 - SNMPv1 ;
2 - SNMPv2c ;
3 - SNMPv3.

Comportement de la propriété :
- obligatoire
bulk integer Indique s’il faut utiliser des requêtes SNMP bulk.

Valeurs possibles :
0 - ne pas utiliser de requêtes bulk ;
1 - (par défaut) - utiliser des requêtes bulk.
community string Communauté SNMP.

Comportement de la propriété :
- obligatoire si version est définie sur "SNMPv1" ou "SNMPv2c"
max_repetitions integer Valeur de répétition maximale pour les requêtes SNMP bulk natives (GetBulkRequest-PDUs).
Utilisée uniquement pour les éléments discovery[] et walk[] en SNMPv2 et v3.

Par défaut : 10.
securityname string Nom de sécurité SNMPv3.

Comportement de la propriété :
- pris en charge si version est définie sur "SNMPv3"
securitylevel integer Niveau de sécurité SNMPv3.

Valeurs possibles :
0 - (par défaut) - noAuthNoPriv ;
1 - authNoPriv ;
2 - authPriv.

Comportement de la propriété :
- pris en charge si version est définie sur "SNMPv3"
authpassphrase string Phrase secrète d’authentification SNMPv3.

Comportement de la propriété :
- pris en charge si version est définie sur "SNMPv3" et securitylevel est définie sur "authNoPriv" ou "authPriv"
privpassphrase string Phrase secrète de confidentialité SNMPv3.

Comportement de la propriété :
- pris en charge si version est définie sur "SNMPv3" et securitylevel est définie sur "authPriv"
authprotocol integer Protocole d’authentification SNMPv3.

Valeurs possibles :
0 - (par défaut) - MD5 ;
1 - SHA1 ;
2 - SHA224 ;
3 - SHA256 ;
4 - SHA384 ;
5 - SHA512.

Comportement de la propriété :
- pris en charge si version est définie sur "SNMPv3" et securitylevel est définie sur "authNoPriv" ou "authPriv"
privprotocol integer Protocole de confidentialité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.

Valeurs possibles :
0 - (par défaut) - DES ;
1 - AES128 ;
2 - AES192 ;
3 - AES256 ;
4 - AES192C ;
5 - AES256C.

Comportement de la propriété :
- pris en charge si version est définie sur "SNMPv3" et securitylevel est définie sur "authPriv"
contextname string Nom de contexte SNMPv3.

Comportement de la propriété :
- pris en charge si version est définie sur "SNMPv3"