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.

Propriété Type Description
hostid ID ID de l'hôte.

Comportement de la propriété :
- 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 - un hôte simple ;
4 - un hôte converti à partir d'un prototype.

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.
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 - callback ;
2 - (par défaut) utilisateur ;
3 - opérateur ;
4 - admin ;
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é :
- lecture seule
maintenance_status integer Statut de la maintenance effective.

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

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

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

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

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

Par défaut : valeur de la propriété host.
monitored_by integer Source utilisée pour surveiller l'hôte.

Valeurs possibles :
0 - (par défaut) serveur Zabbix ;
1 - Proxy ;
2 - Groupe de proxys.
proxyid ID ID du proxy utilisé pour surveiller 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 surveiller l'hôte.

Comportement de la propriété :
- obligatoire si monitored_by est défini sur "Proxy group"
status integer Statut 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) Pas de chiffrement ;
2 - PSK ;
4 - certificat.
tls_accept integer Connexions depuis l'hôte.

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

Il s'agit d'un champ de masque de bits ; toute somme des valeurs bitmap possibles est acceptable (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 (dans autoregistration, hosts et proxies).

N'incluez pas d'informations sensibles dans l'identité PSK, car elle est envoyée sans chiffrement sur le réseau pour informer le destinataire de la PSK à utiliser.

Comportement de la propriété :
- é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é :
- écriture seule
- obligatoire si tls_connect est défini sur "PSK", ou si tls_accept contient le bit "PSK"
active_available integer Statut de disponibilité de l'interface active de l'hôte.

Valeurs possibles :
0 - le statut de l'interface est inconnu ;
1 - l'interface est disponible ;
2 - l'interface n'est pas disponible.

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

Comportement de la propriété :
- lecture seule

Inventaire de l'hôte

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

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

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

Balise d'hôte

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

Property Type Description
tag string Nom de la balise d'hôte.

Comportement de la propriété:
- required
value string Valeur de la balise d'hôte.
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é:
- read-only