[comment]: # aside: 1 [comment]: # ({70b8d6b4-b7ea8d04}) # Objet hôte Les objets suivants sont directement liés à l’API des hôtes. [comment]: # ({/70b8d6b4-b7ea8d04}) [comment]: # ({7d75bf76-2f6c5c76}) ### Hôte L'objet hôte possède les propriétés suivantes. |Propriété|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |hostid|ID|ID de l'hôte.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *lecture seule*
- *obligatoire* pour les opérations de mise à jour| |host|string|Nom technique de l'hôte.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *obligatoire* pour les opérations de création| |description|text|Description de l'hôte.| |flags|integer|[Origine](/manual/api/reference_commentary#entity-origin-flags) 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é](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *lecture seule*| |maintenanceid|ID|ID de la maintenance actuellement effective sur l'hôte.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *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](/manual/api/reference/autoregistration/object), [hosts](/manual/api/reference/host/object) et [proxies](/manual/api/reference/proxy/object)).

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é](/manual/api/reference_commentary#property-behavior) :
- *é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é](/manual/api/reference_commentary#property-behavior) :
- *é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é](/manual/api/reference_commentary#property-behavior) :
- *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é](/manual/api/reference_commentary#property-behavior) :
- *lecture seule*| [comment]: # ({/7d75bf76-2f6c5c76}) [comment]: # ({c7de69b4-859da78d}) ### Inventaire de l'hôte L'objet inventaire de l'hôte possède les propriétés suivantes. ::: notetip 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](/manual/api/reference_commentary#data-types)|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| [comment]: # ({/c7de69b4-859da78d}) [comment]: # ({a70bcec5-0ae1807e}) ### Balise d'hôte L'objet balise d'hôte possède les propriétés suivantes. |Property|[Type](/manual/api/reference_commentary#data-types)|Description| |--|--|------| |tag|string|Nom de la balise d'hôte.

[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):
- *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é](/manual/api/reference_commentary#property-behavior):
- *read-only*| [comment]: # ({/a70bcec5-0ae1807e})