[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({94e18e5a-7ed888d2})
# Objet interface d'hôte

Les objets suivants sont directement liés à l'API `hostinterface`.

[comment]: # ({/94e18e5a-7ed888d2})

[comment]: # ({2e033569-ce77a3b0})
### Interface de l'hôte

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

::: noteimportant
Notez que les propriétés `ip` et `dns` sont toutes deux *obligatoires* pour les opérations de création.
Si vous ne souhaitez pas utiliser DNS, définissez-le comme une chaîne vide.
:::

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|interfaceid|ID|ID de l'interface.<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|
|available|integer|Disponibilité de l'interface de l'hôte.<br><br>Valeurs possibles :<br>0 - *(par défaut)* inconnue ;<br>1 - disponible ;<br>2 - indisponible.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*|
|hostid|ID|ID de l'hôte auquel l'interface appartient.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *constante*<br>- *obligatoire* pour les opérations de création|
|type|integer|Type d'interface.<br><br>Valeurs possibles :<br>1 - Agent ;<br>2 - SNMP ;<br>3 - IPMI ;<br>4 - JMX.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|ip|string|Adresse IP utilisée par l'interface.<br><br>Peut être vide si la connexion est établie via DNS.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|dns|string|Nom DNS utilisé par l'interface.<br><br>Peut être vide si la connexion est établie via IP.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|port|string|Numéro de port utilisé par l'interface.<br>Peut contenir des macros utilisateur.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|useip|integer|Indique si la connexion doit être établie via IP.<br><br>Valeurs possibles :<br>0 - se connecter en utilisant le nom DNS de l'hôte ;<br>1 - se connecter en utilisant l'adresse IP 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|
|main|integer|Indique si l'interface est utilisée par défaut sur l'hôte. Une seule interface de certains types peut être définie comme interface par défaut sur un hôte.<br><br>Valeurs possibles :<br>0 - non par défaut ;<br>1 - par défaut.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* pour les opérations de création|
|details|object|Objet [details](#details) supplémentaire pour l'interface.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* si `type` est défini sur "SNMP"|
|disable\_until|timestamp|Prochaine heure d'interrogation d'une interface d'hôte indisponible.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*|
|error|string|Texte d'erreur si l'interface de l'hôte est indisponible.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*|
|errors\_from|timestamp|Heure à laquelle l'interface de l'hôte est devenue indisponible.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *lecture seule*|

[comment]: # ({/2e033569-ce77a3b0})

[comment]: # ({58c84008-3bb71fcc})
#### Détails

L'objet details possède les propriétés suivantes.

|Propriété|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|version|integer|Version de l'interface SNMP.<br><br>Valeurs possibles :<br>1 - SNMPv1 ;<br>2 - SNMPv2c ;<br>3 - SNMPv3.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire*|
|bulk|integer|Indique s'il faut utiliser des requêtes SNMP bulk.<br><br>Valeurs possibles :<br>0 - ne pas utiliser de requêtes bulk ;<br>1 - (par défaut) - utiliser des requêtes bulk.|
|community|string|Communauté SNMP. Utilisée uniquement par les interfaces SNMPv1 et SNMPv2.<br><br>[Comportement de la propriété](/manual/api/reference_commentary#property-behavior) :<br>- *obligatoire* si `version` est définie sur "SNMPv1" ou "SNMPv2c"|
|max_repetitions|integer|Valeur de répétition maximale pour les [requêtes SNMP bulk natives](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Utilisée uniquement pour les éléments `discovery[]` et `walk[]` en SNMPv2 et v3.<br><br>Par défaut : 10.|
|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.<br><br>Valeurs possibles :<br>0 - (par défaut) - noAuthNoPriv ;<br>1 - authNoPriv ;<br>2 - authPriv.|
|authpassphrase|string|Phrase secrète d'authentification SNMPv3. Utilisée uniquement par les interfaces SNMPv3.|
|privpassphrase|string|Phrase secrète de confidentialité SNMPv3. Utilisée uniquement par les interfaces SNMPv3.|
|authprotocol|integer|Protocole d'authentification SNMPv3. Utilisé uniquement par les interfaces SNMPv3.<br><br>Valeurs possibles :<br>0 - (par défaut) - MD5 ;<br>1 - SHA1 ;<br>2 - SHA224 ;<br>3 - SHA256 ;<br>4 - SHA384 ;<br>5 - SHA512.|
|privprotocol|integer|Protocole de confidentialité SNMPv3. Utilisé uniquement par les interfaces SNMPv3.<br><br>Valeurs possibles :<br>0 - (par défaut) - DES ;<br>1 - AES128 ;<br>2 - AES192 ;<br>3 - AES256 ;<br>4 - AES192C ;<br>5 - AES256C.|
|contextname|string|Nom de contexte SNMPv3. Utilisé uniquement par les interfaces SNMPv3.|

[comment]: # ({/58c84008-3bb71fcc})