[comment]: # aside:1

[comment]: # ({94e18e5a-7ed888d2})
# Objecte interfície d'equip

Els següents objectes són enllaçats amb l'API `hostinterface`.

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

[comment]: # ({48ead816-ce77a3b0})
### Interfície d'equip

L'objecte d'interfície d'equip té les propietats següents.

::: nota important
Tingueu en compte que les propietats `IP` i `DNS` són *obligatòries*. Si no s'ha d'emprar DNS, configureu-lo en una cadena buida.
:::

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|interfaceid|ID|ID de la interfície.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització|
|available|integer|Disponibilitat de la interfície de l'equip.<br><br>Els valors possibles són:<br>0 - *(per defecte)* desconegut;<br>1 - disponible;<br>2 - no disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|hostid|ID|ID de l'equip al que pertany la interfície.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *obligatori* per operacions de creació|
|tipus|integer|Tipus d'interfície.<br><br>Valors possibles:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI; <br> >4 - JMX.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|
|ip|string|adreça IP emprada per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant DNS.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|
|dns|string|Nom DNS emprat per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant IP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|
|port|string|Nombre de port emprat per la interfície.<br>Pot contindre macros d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|
|useip|integer|Indica si la connexió s'ha d'establir mitjançant IP.<br><br>Valors possibles:<br>0 - connecteu-vos amb el nom DNS de l'equip;<br>1 - connecteu-vos mitjançant l'adreça IP de l'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|
|main|integer|Indica si la interfície s'empra per defecte a l'equip. Només es pot configurar per defecte una interfície d'un tipus determinat en un host.<br><br>Valors possibles:<br>0 - no (per defecte);<br>1 - predeterminat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|
|details|objecte|Objecte addicional per a la interfície.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "SNMP"|
|disable\_until|timestamp|La propera vegada que es consulta una interfície d'equip no disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|error|cadena|Text d'error si la interfície de l'equip no és pas disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|
|errors\_from|timestamp|Hora en què la interfície de l'equip no va estar disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|

[comment]: # ({/48ead816-ce77a3b0})

[comment]: # ({144d8eb5-3bb71fcc})
#### Detalls

L'objecte té les propietats següents.

|Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|versió|enter|Versió de la interfície SNMP.<br><br>Els valors possibles són:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br> 3 - SNMPv3.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|
|bulk|enter|Si s'han d'emprar consultes SNMP massives o no.<br><br>Els valors possibles són:<br>0 - no emprar consultes massives;<br>1 - (per defecte) - emprar consultes massives. |
|community|string|Comunitat SNMP (obligatori).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `version` s'ha establert a "SNMPv1" o "SNMPv2".|
|max_repetitions|enter|Valor de repetició màxim per [peticions massives d'SNMP nadiu](#native-snmp-bulk-requests) (GetBulkRequest-PDUs).<br>Emprat només per els elements `discovery[]` i `walk[]` a SNMPv2 i v3.<br><br>Per defecte: 10.|
|securityname|cadena|nom de seguretat SNMPv3. Emprat només per interfícies SNMPv3.|
|securitylevel|enter|nivell de seguretat SNMPv3. Només s'empra a les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - (per defecte) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.|
|authpassphrase|cadena|frase de pas d'autenticació SNMPv3. Emprat només per interfícies SNMPv3.|
|privpassphrase|cadena|frase de contrasenya de privadesa SNMPv3. Emprat només per interfícies SNMPv3.|
|privprotocol|enter|Protocol de privadesa SNMPv3. Només s'empren les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - (per defecte) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256 ; <br>4 - AES192C;<br>5 - AES256C.|
|contextname|cadena|nom de context SNMPv3. Emprat només per interfícies SNMPv3.|

[comment]: # ({/144d8eb5-3bb71fcc})