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