Objet hôte

Les objets suivants sont directement liés à l’API des hôtes.

Hôte

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

Property Type Description
hostid ID ID de l’hôte.

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

Comportement de la propriété :
- obligatoire pour les opérations de création
description text Description de l’hôte.
flags integer Origine de l’hôte.

Valeurs possibles :
0 - hôte standard ;
4 - hôte converti à partir d’un prototype.

Comportement de la propriété :
- en 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.
ipmi_authtype integer Algorithme d’authentification IPMI.

Valeurs possibles :
-1 - (par défaut) par défaut ;
0 - aucun ;
1 - MD2 ;
2 - MD5
4 - direct ;
5 - OEM ;
6 - RMCP+.
ipmi_password string Mot de passe IPMI.
ipmi_privilege integer Niveau de privilège IPMI.

Valeurs possibles :
1 - rappel ;
2 - (par défaut) utilisateur ;
3 - opérateur ;
4 - administrateur ;
5 - OEM.
ipmi_username string Nom d’utilisateur IPMI.
maintenance_from timestamp Heure de début de la maintenance effective.

Comportement de la propriété :
- en lecture seule
maintenance_status integer État de maintenance effectif.

Valeurs possibles :
0 - (par défaut) aucune maintenance ;
1 - maintenance en cours.

Comportement de la propriété :
- en lecture seule
maintenance_type integer Type de maintenance effectif.

Valeurs possibles :
0 - (par défaut) maintenance avec collecte de données ;
1 - maintenance sans collecte de données.

Comportement de la propriété :
- en lecture seule
maintenanceid ID ID de la maintenance actuellement en cours sur l’hôte.

Comportement de la propriété :
- en lecture seule
name string Nom visible de l’hôte.

Valeur par défaut : valeur de la propriété host.
monitored_by integer Source utilisée pour superviser l’hôte.

Valeurs possibles :
0 - (par défaut) serveur Zabbix ;
1 - proxy ;
2 - groupe de proxys.

Comportement de la propriété :
- obligatoire si select_server_for_monitoring est défini sur « Disabled ».
proxyid ID ID du proxy utilisé pour superviser l’hôte.

Comportement de la propriété :
- obligatoire si monitored_by est défini sur « Proxy »
proxy_groupid ID ID du groupe de proxys utilisé pour superviser l’hôte.

Comportement de la propriété :
- obligatoire si monitored_by est défini sur « Proxy group »
status integer État et fonction de l’hôte.

Valeurs possibles :
0 - (par défaut) activé ;
1 - désactivé.
tls_connect integer Connexions vers l’hôte.

Valeurs possibles :
1 - (par défaut) aucun chiffrement ;
2 - PSK ;
4 - certificat.
tls_accept integer Connexions depuis l’hôte.

Valeurs bitmap possibles :
1 - (par défaut) aucun chiffrement ;
2 - PSK ;
4 - certificat.

Il s’agit d’un champ de masque de bits ; toute somme de valeurs bitmap possibles est acceptée (par exemple, 6 pour PSK et certificat).
tls_issuer string Émetteur du certificat.
tls_subject string Sujet du certificat.
tls_psk_identity string Identité PSK ; doit être associée à une seule PSK (parmi l’enregistrement automatique, les hôtes et les proxys).

N’incluez pas d’informations sensibles dans l’identité PSK, car celle-ci est envoyée sans chiffrement sur le réseau afin d’indiquer au destinataire quelle PSK utiliser.

Comportement de la propriété :
- en écriture seule
- obligatoire si tls_connect est défini sur « PSK » ou si tls_accept contient le bit « PSK »
tls_psk string Clé prépartagée (PSK) ; doit comporter au moins 32 chiffres hexadécimaux.

Comportement de la propriété :
- en écriture seule
- obligatoire si tls_connect est défini sur « PSK » ou si tls_accept contient le bit « PSK »
active_available integer État de disponibilité de l’interface active de l’hôte.

Valeurs possibles :
0 - l’état de l’interface est inconnu ;
1 - l’interface est disponible ;
2 - l’interface n’est pas disponible.

Comportement de la propriété :
- en lecture seule
assigned_proxyid ID ID du proxy attribué par le serveur Zabbix si l’hôte est supervisé par un groupe de proxys.

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

Inventaire de l'hôte

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

Chaque propriété possède son propre numéro d'identification unique, utilisé pour associer les champs d'inventaire de l'hôte aux éléments.

ID Propriété Type Description Longueur maximale
4 alias string Alias. 128 caractères
11 asset_tag string Étiquette d'inventaire. 64 caractères
28 chassis string Châssis. 64 caractères
23 contact string Personne à contacter. 65535 caractères pour les bases de données SQL
32 contract_number string Numéro de contrat. 64 caractères
47 date_hw_decomm string Date de mise hors service du matériel. 64 caractères
46 date_hw_expiry string Date d'expiration de la maintenance du matériel. 64 caractères
45 date_hw_install string Date d'installation du matériel. 64 caractères
44 date_hw_purchase string Date d'achat du matériel. 64 caractères
34 deployment_status string Statut de déploiement. 64 caractères
14 hardware string Matériel. 255 caractères
15 hardware_full string Détails du matériel. 65535 caractères pour les bases de données SQL
39 host_netmask string Masque de sous-réseau de l'hôte. 39 caractères
38 host_networks string Réseaux de l'hôte. 65535 caractères pour les bases de données SQL
40 host_router string Routeur de l'hôte. 39 caractères
30 hw_arch string Architecture matérielle. 32 caractères
33 installer_name string Nom de l'installateur. 64 caractères
24 location string Emplacement. 65535 caractères pour les bases de données SQL
25 location_lat string Latitude de l'emplacement. 16 caractères
26 location_lon string Longitude de l'emplacement. 16 caractères
12 macaddress_a string Adresse MAC A. 64 caractères
13 macaddress_b string Adresse MAC B. 64 caractères
29 model string Modèle. 64 caractères
3 name string Nom. 128 caractères
27 notes string Notes. 65535 caractères pour les bases de données SQL
41 oob_ip string Adresse IP OOB. 39 caractères
42 oob_netmask string Masque de sous-réseau de l'hôte OOB. 39 caractères
43 oob_router string Routeur OOB. 39 caractères
5 os string Nom du système d'exploitation. 128 caractères
6 os_full string Nom détaillé du système d'exploitation. 255 caractères
7 os_short string Nom court du système d'exploitation. 128 caractères
61 poc_1_cell string Numéro de mobile du contact principal. 64 caractères
58 poc_1_email string E-mail principal. 128 caractères
57 poc_1_name string Nom du contact principal. 128 caractères
63 poc_1_notes string Notes du contact principal. 65535 caractères pour les bases de données SQL
59 poc_1_phone_a string Téléphone A du contact principal. 64 caractères
60 poc_1_phone_b string Téléphone B du contact principal. 64 caractères
62 poc_1_screen string Nom d'écran du contact principal. 64 caractères
68 poc_2_cell string Numéro de mobile du contact secondaire. 64 caractères
65 poc_2_email string E-mail secondaire. 128 caractères
64 poc_2_name string Nom du contact secondaire. 128 caractères
70 poc_2_notes string Notes du contact secondaire. 65535 caractères pour les bases de données SQL
66 poc_2_phone_a string Téléphone A du contact secondaire. 64 caractères
67 poc_2_phone_b string Téléphone B du contact secondaire. 64 caractères
69 poc_2_screen string Nom d'écran du contact secondaire. 64 caractères
8 serialno_a string Numéro de série A. 64 caractères
9 serialno_b string Numéro de série B. 64 caractères
48 site_address_a string Adresse du site A. 128 caractères
49 site_address_b string Adresse du site B. 128 caractères
50 site_address_c string Adresse du site C. 128 caractères
51 site_city string Ville du site. 128 caractères
53 site_country string Pays du site. 64 caractères
56 site_notes string Notes du site. 65535 caractères pour les bases de données SQL
55 site_rack string Emplacement de baie du site. 128 caractères
52 site_state string État/région du site. 64 caractères
54 site_zip string Code postal du site. 64 caractères
16 software string Logiciel. 255 caractères
18 software_app_a string Application logicielle A. 64 caractères
19 software_app_b string Application logicielle B. 64 caractères
20 software_app_c string Application logicielle C. 64 caractères
21 software_app_d string Application logicielle D. 64 caractères
22 software_app_e string Application logicielle E. 64 caractères
17 software_full string Détails du logiciel. 65535 caractères pour les bases de données SQL
10 tag string Étiquette. 64 caractères
1 type string Type. 64 caractères
2 type_full string Détails du type. 64 caractères
35 url_a string URL A. 2048 caractères
36 url_b string URL B. 2048 caractères
37 url_c string URL C. 2048 caractères
31 vendor string Fournisseur. 64 caractères

Balise d'hôte

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

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

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

Comportement de la propriété :
- lecture seule.
automatic integer Type de balise d'hôte.

Valeurs possibles :
0 - (par défaut) manuel (balise créée par l'utilisateur) ;
1 - automatique (balise créée par la découverte de bas niveau)

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.