Les objets suivants sont directement liés à l'API hostprototype
.
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.
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. |
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. |
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. |
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. |
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. |