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 modèle parent du prototype d'hôte.

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 relie 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

Étiquette du prototype d’hôte

L’objet d’étiquette du prototype d’hôte possède les propriétés suivantes.

Property Type Description
tag string Nom de l’étiquette du prototype d’hôte.

Comportement de la propriété :
- required.
value string Valeur de l’étiquette du prototype d’hôte.

Étiquette de prototype d’hôte héritée

L’objet d’étiquette de prototype d’hôte héritée possède les propriétés suivantes.

Property Type Description
tag string Nom de l’étiquette.

Comportement de la propriété :
- lecture seule.
value string Valeur de l’étiquette.

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

Valeurs possibles :
0 - modèle.

Comportement de la propriété :
- lecture seule.
objectid ID ID de l’objet dont l’étiquette 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 « use host prototypes custom interfaces ». 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 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 « connect using host IP address »
dns string Nom DNS utilisé par l'interface.
Peut contenir des macros.

Comportement de la propriété :
- obligatoire si useip est défini sur « connect using host DNS name »
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 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.

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

Property Type Description
version integer Version de l'interface SNMP.

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

Comportement de la propriété :
- required
bulk integer Indique s'il faut utiliser les requêtes SNMP groupées.

Valeurs possibles :
0 - ne pas utiliser de requêtes groupées ;
1 - (default) - utiliser des requêtes groupées.
community string Communauté SNMP.

Comportement de la propriété :
- required si version est défini sur « SNMPv1 » ou « SNMPv2c »
max_repetitions string Valeur maximale de répétition pour les requêtes SNMP groupées natives (PDU GetBulkRequest).
Utilisé uniquement pour l'élément walk[] dans SNMPv2 et SNMPv3.
Les macros LLD et les macros utilisateur sont prises en charge.

Valeurs possibles : 1–2147483647 (INT32_MAX).
Valeur par défaut : 10.
retries string Nombre maximal de nouvelles tentatives si une requête expire.
Utilisé pour les éléments walk[] et get[]. Pour walk[], les nouvelles tentatives sont partagées sur l'ensemble du parcours.
Les macros LLD et les macros utilisateur sont prises en charge.

Valeurs possibles : 0–100 (0 - désactiver les nouvelles tentatives).
Valeur par défaut : 5.
securityname string Nom de sécurité SNMPv3.

Comportement de la propriété :
- supported si version est défini sur « SNMPv3 »
securitylevel integer Niveau de sécurité SNMPv3.

Valeurs possibles :
0 - (default) - noAuthNoPriv ;
1 - authNoPriv ;
2 - authPriv.

Comportement de la propriété :
- supported si version est défini sur « SNMPv3 »
authpassphrase string Phrase secrète d'authentification SNMPv3.

Comportement de la propriété :
- supported si version est défini sur « SNMPv3 » et securitylevel sur « authNoPriv » ou « authPriv »
privpassphrase string Phrase secrète de confidentialité SNMPv3.

Comportement de la propriété :
- supported si version est défini sur « SNMPv3 » et securitylevel sur « authPriv »
authprotocol integer Protocole d'authentification SNMPv3.

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

Comportement de la propriété :
- supported si version est défini sur « SNMPv3 » et securitylevel sur « authNoPriv » ou « authPriv »
privprotocol integer Protocole de confidentialité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.

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

Comportement de la propriété :
- supported si version est défini sur « SNMPv3 » et securitylevel sur « authPriv »
contextname string Nom de contexte SNMPv3.

Comportement de la propriété :
- supported si version est défini sur « SNMPv3 »