Documentation
Table of Contents
Objecte prototip d'equips
Els seg¨¹ents objectes s¨®n relacionats amb l'API hostprototype.
Prototipus d'equip
L'objecte prototip d'equip t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| hostid | ID | ID del prototip d'equips. Comportament de la propietat: - nom¨¦s lectura - obligatori per operacions d'actualitzaci¨® |
| host | string | Nom t¨¨cnic del prototip d'equips. Comportament de la propietat: - obligatori per operacions de creaci¨® - nom¨¦s lectura per objectes heretats |
| name | string | Nom visible del prototip d'equips. Per defecte: valor de la propietat host.Comportament de la propietat: - nom¨¦s lectura per objectes heretats |
| status | integer | Estat del prototip d'equips. Valors possibles: 0 - (per defecte) equip monitorat; 1 - equip no monitorat. |
| inventory_mode | integer | Mode d'omplerta d'inventari de l'equip. Els valors possibles s¨®n: -1 - (per defecte) desactivat; 0 - manual ; 1 - autom¨¤tic . |
| templateid | ID | ID de la plantilla principal del prototip d'equips. Comportament de la propietat: - nom¨¦s lectura |
| discover | integer | Estat de descobriment del prototip d'equips. Valors possibles: 0 - (per defecte) es descobriran nous equips; 1 - no es descobriran els nous equips i els existents es marcaran com a perduts. |
| custom_interfaces | integer | Font de les interf¨ªcies dels equips creats per el prototip d'equips. Valors possibles: 0 - (per defecte) hereta les interf¨ªcies de l'equip principal; 1 - empra personalitzat interf¨ªcies de prototips d'equips. Comportament de la propietat: - nom¨¦s lectura per objectes heretats |
| uuid | string | Identificador universal ¨²nic, que s'empra per enlla?ar els prototips d'equips importats amb els existents. S'empra nom¨¦s per a prototips d'equips en models. Es genera autom¨¤ticament, si no es proporciona. Comportament de la propietat: - ²¹»å³¾¨¨²õ si el prototip d'equip pertany a una plantilla |
Enlla? de grup
L'objecte d'enlla? de grup enlla?a un prototip d'equips amb un grup d'equips i t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| groupid | ID | ID del grup d'equips. Comportament de la propietat: - obligatori |
Prototip de grup
L'objecte defineix un grup que es crear¨¤ per a un equip descobert i t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| group_prototypeid | ID | ID del prototip de grup. Comportament de la propietat: - nom¨¦s lectura |
| name | cadena | Nom del prototip de grup. Comportament de la propietat: - obligatori per a operacions de creaci¨® |
Etiqueta de prototip d'equip
L'objecte d'etiqueta de prototip d'equipt¨¦ les propietats seg¨¹ents:
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| tag | string | Nom de l'etiqueta de prototip d'equip. Comportament de la propietat: - obligatori |
| value | string | Valor de l'etiqueta del prototip d'equip. |
Interf¨ªcie personalitzada
Les interf¨ªcies personalitzades s'admeten si custom_interfaces de l'objecte de prototip d'equip s'estableix per "emprar interf¨ªcies personalitzades de prototipus d'equips".
L'objecte d'interf¨ªcie personalitzada t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| tipus | enter | Tipus d'interf¨ªcie. Els valors possibles s¨®n: 1 - agent; 2 - SNMP; 3 - IPMI ; 4 - JMX. Comportament de la propietat: - obligatori |
| useip | enter | Indica si la connexi¨® s'ha d'establir mitjan?ant IP. Els valors possibles s¨®n: 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. Comportament de la propietat: - obligatori |
| ip | cadena | adre?a IP emprada per la interf¨ªcie. Pot contindre macros. Comportament de la propietat: - obligatori si useip s'ha definit com a "connectar emprant adre?a IP de l'equip" |
| dns | cadena | Nom DNS emprat per la interf¨ªcie. Pot contindre macros. Comportament de la propietat: - obligatori si useip s'ha definit com a "connectar emprant nom DNS de l'equip" |
| port | cadena | Nombre de port emprat per la interf¨ªcie. Pot contindre macros d'usuari i LLD. Comportament de la propietat: - obligatori |
| main | enter | Indica si la interf¨ªcie s'empra per defecte a l'equip. Nom¨¦s es pot establir una interf¨ªcie d'un determinat tipus com a predeterminada en un equip. Els valors possibles s¨®n: 0 - no per defecte; 1 - per defecte. Comportament de la propietat: - obligatori |
| details | array | Objecte addicional per a la interf¨ªcie. Comportament de la propietat: - obligatori si tipus s'ha establert a "SNMP" |
Detalls de la interf¨ªcie personalitzada
L'objecte de detalls t¨¦ les propietats seg¨¹ents.
| Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|---|
| version | enter | Versi¨® de la interf¨ªcie SNMP. Els valors possibles s¨®n: 1 - SNMPv1; 2 - SNMPv2c; 3 - SNMPv3. Comportament de la propietat: - obligatori |
| bulk | enter | Indica si s'han d'emprar consultes SNMP massives. Els valors possibles s¨®n: 0 - no empreu consultes massives; 1 - (per defecte ) - empreu sol¡¤licituds massives. |
| community | cadena | Comunitat SNMP. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv1" o "SNMPv2c" |
| max_repetitions | enter | Valor de repetici¨® m¨¤xima per peticions massives d'SNMP nadiues (GetBulkRequest-PDUs). Emprat nom¨¦s per els elements discovery[] i walk[] a SNMPv2 i v3.Per defecte: 10. |
| securityname | cadena | Nom de seguretat SNMPv3. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv3" |
| securitylevel | enter | Nivell de seguretat SNMPv3. Els valors possibles s¨®n: 0 - (per defecte) - noAuthNoPriv; 1 - authNoPriv; 2 - authPriv. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv3" |
| authpassphrase | string | Mot de pas d'autenticaci¨® SNMPv3. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv3" i securitylevel s'ha fixat a "authNoPriv" o "authPriv" |
| privpassphrase | string | Frase de pas de privadesa SNMPv3. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv3" i securitylevel s'ha fixat a "authPriv" |
| authprotocol | integer | Protocol d'autenticaci¨® SNMPv3. Els valors possibles s¨®n: 0 - (per defecte) - MD5; 1 - SHA1; 2 - SHA224; 3 - SHA256; 4 - SHA384; 5 - SHA512. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv3" i securitylevel s'ha fixat a "authNoPriv" o "authPriv" |
| privprotocol | integer | Protocol de privadesa SNMPv3. Els valors possibles s¨®n: 0 - (per defecte) - DES; 1 - AES128; 2 - AES192; 3 - AES256; 4 - AES192C; 5 - AES256C. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv3" i securitylevel s'ha fixat a "authPriv" |
| contextname | string | Nom de context SNMPv3. Comportament de la propietat: - ²¹»å³¾¨¨²õ si version s'ha establert a "SNMPv3" |