[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]: # ({6a1c3833-2f6c5c76})
### Hôte

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

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|hostid|ID|ID de l'hôte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*<br>- *obligatoire* pour les opérations de mise à jour|
|host|string|Nom technique de l'hôte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* pour les opérations de création|
|description|text|Description de l'hôte.|
|flags|integer|Origine de l'hôte.<br><br>Valeurs possibles:<br>0 - un hôte simple;<br>4 - un hôte découvert.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|inventory\_mode|integer|Mode de remplissage de l'inventaire de l'hôte.<br><br>Valeurs possibles:<br>-1 - *(par défaut)* désactivé;<br>0 - manuel;<br>1 - automatique.|
|ipmi\_authtype|integer|Algorithme d'authentification IPMI.<br><br>Valeurs possibles:<br>-1 - *(par défaut)* par défaut;<br>0 - aucun;<br>1 - MD2;<br>2 - MD5<br>4 - direct;<br>5 - OEM;<br>6 - RMCP+.|
|ipmi\_password|string|Mot de passe IPMI.|
|ipmi\_privilege|integer|Niveau de privilège IPMI.<br><br>Valeurs possibles:<br>1 - callback;<br>2 - *(par défaut)* utilisateur;<br>3 - opérateur;<br>4 - admin;<br>5 - OEM.|
|ipmi\_username|string|Nom d'utilisateur IPMI.|
|maintenance\_from|timestamp|Heure de début de la maintenance effective.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|maintenance\_status|integer|Statut de la maintenance effective.<br><br>Valeurs possibles:<br>0 - *(par défaut)* aucune maintenance;<br>1 - maintenance en cours.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|maintenance\_type|integer|Type de maintenance effective.<br><br>Valeurs possibles:<br>0 - *(par défaut)* maintenance avec collecte de données;<br>1 - maintenance sans collecte de données.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|maintenanceid|ID|ID de la maintenance actuellement en vigueur sur l'hôte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|name|string|Nom visible de l'hôte.<br><br>Par défaut: valeur de la propriété `host`.|
|monitored_by|integer|Source utilisée pour surveiller l'hôte.<br><br>Valeurs possibles:<br>0 - *(par défaut)* serveur Zabbix;<br>1 - proxy;<br>2 - groupe de proxy.|
|proxyid|ID|ID du proxy utilisé pour surveiller l'hôte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `monitored_by` est défini sur "Proxy"|
|proxy_groupid|ID|ID du groupe de proxy utilisé pour surveiller l'hôte.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *obligatoire* si `monitored_by` est défini sur "Proxy group"|
|status|integer|Statut et fonction de l'hôte.<br><br>Valeurs possibles:<br>0 - *(par défaut)* activé;<br>1 - désactivé.|
|tls\_connect|integer|Connexions à l'hôte.<br><br>Valeurs possibles:<br>1 - *(par défaut)* sans chiffrement;<br>2 - PSK;<br>4 - certificat.|
|tls\_accept|integer|Connexions depuis l'hôte.<br><br>Valeurs bitmap possibles:<br>1 - *(par défaut)* sans chiffrement;<br>2 - PSK;<br>4 - certificat.<br><br>Il s'agit d'un champ de masque binaire; 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 à un seul PSK (dans [l'autodécouverte](/manual/api/reference/autoregistration/object), [les hôtes](/manual/api/reference/host/object) et [les proxys](/manual/api/reference/proxy/object)).<br><br>N'incluez pas d'informations sensibles dans l'identité PSK, car elle est envoyée non chiffrée sur le réseau afin d'indiquer au destinataire quel PSK utiliser.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *écriture seule*<br>- *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.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *écriture seule*<br>- *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.<br><br>Valeurs possibles:<br>0 - le statut de l'interface est inconnu;<br>1 - l'interface est disponible;<br>2 - l'interface n'est pas disponible.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|
|assigned_proxyid|ID|ID du proxy attribué par le serveur Zabbix, si l'hôte est surveillé par un groupe de proxy.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *lecture seule*|

[comment]: # ({/6a1c3833-2f6c5c76})

[comment]: # ({28887b61-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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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 matérielle.|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é.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle 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.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases|
|10|tag|string|Balise.|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]: # ({/28887b61-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.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|value|string|Valeur de la balise d'hôte.|
|automatic|integer|Type de balise d'hôte.<br><br>Valeurs possibles:<br>0 - *(par défaut)* manuel (balise créée par l'utilisateur);<br>1 - automatique (balise créée par la découverte de bas niveau)<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|

[comment]: # ({/a70bcec5-0ae1807e})