Documentation
Table of Contents
> Objecte interf¨ªcie d'equip
Els seg¨¹ents objectes s¨®n enlla?ats amb l'API hostinterface.
Interf¨ªcie d'equip
L'objecte d'interf¨ªcie d'equip t¨¦ les propietats seg¨¹ents.
::: nota important Tingueu en compte que cal IP i DNS. Si no s'ha d'emprar DNS, configureu-lo en una cadena buida. :::
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| available | integer | (nom¨¦s lectura)Disponibilitat de la interf¨ªcie de l'equip. Els valors possibles s¨®n: 0 - (per defecte) desconegut; 1 - disponible;< br>2 - no disponible. |
| details | array | Objecte addicional per a la interf¨ªcie. Obligatori si el "tipus" d'interf¨ªcie ¨¦s SNMP. |
| disable_until | timestamp | (nom¨¦s lectura) La propera vegada que es consulta una interf¨ªcie d'equip no disponible. |
| dns (obligatori) |
string | Nom DNS emprat per la interf¨ªcie. Pot ¨¦sser buit si la connexi¨® s'estableix mitjan?ant IP. |
| error | string | (nom¨¦s lectura) Text d'error si la interf¨ªcie de l'equip no ¨¦s pas disponible. |
| errors_from | timestamp | (nom¨¦s lectura)Hora en qu¨¨ la interf¨ªcie de l'equip no va estar disponible. |
| hostid (obligatori) |
string | ID de l'equip al que pertany la interf¨ªcie. |
| interfaceid | string | (nom¨¦s lectura) ID de la interf¨ªcie. |
| ip (obligatori) |
string | adre?a IP emprada per la interf¨ªcie. Pot ¨¦sser buit si la connexi¨® s'estableix mitjan?ant DNS. |
| main (obligatori) |
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. Valors possibles: 0 - no (per defecte); 1 - predeterminat. |
| port (obligatori) |
string | Nombre de port emprat per la interf¨ªcie. Pot contindre macros d'usuari. |
| tipus (obligatori) |
integer | Tipus d'interf¨ªcie. Valors possibles: 1 - agent; 2 - SNMP; 3 - IPMI; >4 - JMX. |
| useip (obligatori) |
integer | Indica si la connexi¨® s'ha d'establir mitjan?ant IP. Valors possibles: 0 - connecteu-vos amb el nom DNS de l'equip ; 1 - connecteu-vos mitjan?ant l'adre?a IP de l'equip per a aquesta interf¨ªcie d'equip. |
Tingueu en compte que per a alguns m¨¨todes (actualitzar, esborrar) la combinaci¨® de par¨¤metres obligatoris/opcionals ¨¦s diferent.
Etiqueta de detalla
L'objecte t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| version (obligatori) |
integer | Versi¨® de la interf¨ªcie SNMP. Els valors possibles s¨®n: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3 |
| bulk | integer | Si s'han d'emprar consultes SNMP massives o no. Els valors possibles s¨®n: 0 - no emprar consultes massives; 1 - (per defecte) - emprar consultes massives. |
| community | string | Comunitat SNMP (obligatori). Nom¨¦s l'empren les interf¨ªcies SNMPv1 i SNMPv2. |
| securityname | string | nom de seguretat SNMPv3. Emprat nom¨¦s per interf¨ªcies SNMPv3. |
| securitylevel | integer | nivell de seguretat SNMPv3. Nom¨¦s s'empra a les interf¨ªcies SNMPv3. Els valors possibles s¨®n: 0 - (per defecte) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. |
| authpassphrase | string | frase de pas d'autenticaci¨® SNMPv3. Emprat nom¨¦s per interf¨ªcies SNMPv3. |
| privpassphrase | string | frase de contrasenya de privadesa SNMPv3. Emprat nom¨¦s per interf¨ªcies SNMPv3. |
| authprotocol | integer | Protocol d'autenticaci¨® SNMPv3. Nom¨¦s l'empren les interf¨ªcies SNMPv3. Els valors possibles s¨®n: 0 - (per defecte) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256 ; 4 - SHA384; 5 - SHA512. |
| privprotocol | integer | Protocol de privadesa SNMPv3. Nom¨¦s s'empren les interf¨ªcies SNMPv3. Els valors possibles s¨®n: 0 - (per defecte) - DES; 1 - AES128; 2 - AES192; 3 - AES256 ; 4 - AES192C; 5 - AES256C. |
| contextname | string | nom de context SNMPv3. Emprat nom¨¦s per interf¨ªcies SNMPv3. |