Els seg¨¹ents objectes s¨®n relacionats amb l'API action
.
L'objecte acci¨® t¨¦ aquestes propietats.
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
actionid | string | (nomes lectura) ID de l'acci¨®. |
esc_period (obligatori) |
string | Durada per defecte de l'etapa d'operaci¨®. Com a m¨ªnim, ha de tindre 60 segons. Accepta segons, unitat de temps com a sufixe i macro d'usuari. Veieu que l'escalat ¨¦s suportat nom¨¦s per a triggers, accions internes i de servei; i nom¨¦s en operacions normals. |
eventsource (obligatori) |
enter | (constant) Tipus d'esdeveniments que l'acci¨® manipular¨¤. Consulteu la propietat event "source" property per obtindre una llista de tipus d'esdeveniments suportats. |
name (obligatori) |
string | Nom de l'acci¨®. |
status | enter | Si l'acci¨® ¨¦s habilitada o no ho ¨¦s pas. Valors possibles: 0 - (per defecte) actiu; 1 - desactivat. |
pause_suppressed | enter | Si aturar o no l'escalament durant els ±è±ð°ù¨ª´Ç»å±ðs de manteniment. Valors possibles: 0 - No aturar l'escalament; 1 - (per defecte) Aturar-lo. Veieu que aquest par¨¤metre nom¨¦s ¨¦s v¨¤lid per a accions de triggers. |
notify_if_canceled | enter | Si hem de notificar quan l'escalada ¨¦s cancel¡¤lada. Valors possibles: 0 - No notificar la cancel¡¤laci¨® de l'escalada; 1 - (per defecte) Notificar-ne la cancel¡¤laci¨®. Veieu que aquest par¨¤metre ¨¦s v¨¤lid nom¨¦s per a accions de triggers. |
Veieu tamb¨¦ que, per a alguns dels m¨¨todes (com ara actualitzar i esborrar) la combinaci¨® de par¨¤metre requerit o opcional ¨¦s diferent.
L'objecte d'operaci¨® d'acci¨® defineix una operaci¨® que s'executar¨¤ quan s'executi una acci¨®. T¨¦ les propietats seg¨¹ents:
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
operationid | string | (nom¨¦s lectura) ID de l'operaci¨® d'acci¨®. |
operationtype (obligatori) |
enter | Tipus d'operaci¨®. Valors possibles: 0 - Enviar missatge; 1 - script global; 2 - afegir equip; 3 - esborrar equip; 4 - afegir a un grup d'equips; 5 - treure d'un grup d'equips; 6 - enlla?ar a una plantilla; 7 - desenlla?ar de la plantilla; 8 - activar equip; 9 - desactivar equip; 10 - establir el mode d'inventari de l'equip. Veieu que els tipus '0' i '1' s¨®n suportats per accions de trigger i servei, i '0' nom¨¦s es suporta per accions internes. Tots els tipus s¨®n suportats per accions de descobriment i autoregistre. |
actionid | cadena | (nom¨¦s lectura) ID de l'acci¨® a qui pertany l'operaci¨®. |
esc_period | string | Durada de l'escalada, en segons. Ha d'¨¦sser superior a 60 segons. Accepta segons, unitats de temps amb sufixe i macro d'usuari. Si s'estableix a 0, s'emprar¨¤ el ±è±ð°ù¨ª´Ç»å±ð d'escalat de l'acci¨® pe defecte. Per defecte: 0s. Veieu que l'escalat es suporta nom¨¦s per a triggers, accions internes i de servei, i nom¨¦s en operacions normals. |
esc_step_from | enter | Gra¨® de partida de l'escalat. Per defecte: 1. Veieu que l'escalada ¨¦s suportada nom¨¦s per triggers, accions internes i de servei, i nom¨¦s en operacions normals. |
esc_step_to | enter | Gra¨® d'escalada dest¨ª. Per defecte: 1. Veieu que l'escalat ¨¦s suportat nom¨¦s per a triggers, accions internes i de servei; i nom¨¦s en operacions normals. |
evaltype | enter | M¨¨tode d'avaluaci¨® de la condici¨® d'operaci¨®. Valors possibles: 0 - (per defecte) AND / OR; 1 - AND; 2 - OR. |
opcommand | objecte | Objecte que cont¨¦ informaci¨® del global script executat per l'operaci¨®. Cada objecte t¨¦ una de les seg¨¹ents propietats: scriptid - (cadena) ID de l'script.Obligatori per a operacions d'escript globals. |
opcommand_grp | matriu | Grups d'equips per executar scripts globals. Cada objecte t¨¦ les propietats seg¨¹ents: opcommand_grpid - (cadena, nom¨¦s lectura) ID de l'objecte;operationid - (cadena, nom¨¦s lectura) ID de l'operaci¨®;groupid - (cadena) ID del grup d'equips.Obligatori per a operacions d'script globals si no s'estableix opcommand_hst . |
opcommand_hst | matriu | Equip que executa els scripts globals. Cada objecte t¨¦ les propietats seg¨¹ents: opcommand_hstid - (cadena, nom¨¦s lectura) ID de l'objecte;operationid - (cadena, nom¨¦s lectura) ID de l'operaci¨®;hostid - (cadena) ID de l'equip; si s'estableix a 0, la comanda s'executar¨¤ a l'equip actualt.Obligatori per a operacions d'scripts globals si no s'estableix opcommand_grp . |
opconditions | matriu | Condicions d'operaci¨® emprades per accions de triggers. L'objecte de condici¨® d'operaci¨® ¨¦s descrit en detall m¨¦s avall. |
opgroup | array | Grups d'equips on afegir equips. Cada objecte t¨¦ les propietats seg¨¹ents: operationid - (cadena, nom¨¦s lectura) ID de l'operaci¨®;groupid - (cadena) ID del grup d'equips.Obligatori per les operacions d'"afegir al grup d'equips" i "treure del grup d'equips". |
opmessage | objecte | Objecte que cont¨¦ la informaci¨® sobre el missatge enviat per l'operaci¨®. L'objecte missatge de l'opieraci¨® ¨¦s detallat avall. Obligatori per operacions de missatges. |
opmessage_grp | matriu | Grups d'usuaris als qui enviar missatges. Cada objecte t¨¦ les propietats seg¨¹ents:: operationid - (cadena, nom¨¦s lectura) ID de l'operaci¨®;usrgrpid - (cadena) ID del grup d'usuaris.Obligatori per a operacions de missatge, si no s'ha pas definit opmessage_usr . |
opmessage_usr | matriu | Usuaris als qui enviar missatges. Cada objecte t¨¦ les propietats seg¨¹ents: operationid - (cadena, nom¨¦s lectura) ID of the operation;userid - (cadena) ID de l'usuari.Obligatori per a operacions de missatge si no hi s'ha pas definit opmessage_grp . |
optemplate | matriu | Plantilles a les que vincular-hi equips. Cada objecte t¨¦ les propietats seg¨¹ents: operationid - (cadena, nom¨¦s lectura) ID de l'operaci¨®;templateid - (cadena) ID de la plantilla.Obligatori per a les operacions "enlla?ar a plantilla" i "desenlla?ar de plantilla". |
opinventory | objecte | Mode d'inventari definit com equip. L'objecte t¨¦ les propietats seg¨¹ents: operationid - (cadena, nom¨¦s lectura) ID de l'opieraci¨®;inventory_mode - (cadena) Mode d'inventari.Obligatori per a operacions "Establir mode d'inventari d'equips". |
L'objecte de missatge d'opieraci¨® cont¨¦ informaci¨® sobre el missatge que s'enviar¨¤ per l'operaci¨®.
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
default_msg | enter | Fer ¨²s del text i/o de l'assumpte del missatge. Valors possibles: 0 - fer ¨²s de la informaci¨® de l'operaci¨®; 1 - (per defecte) fer ¨²s de la informaci¨® del tipus de medi. |
mediatypeid | cadena | ID del tipus de medi que s'emprar¨¤ per enviar el missatge. |
missatge | cadena | Text del missatge de l'operaci¨®. |
assumpte | cadena | Assumpte del missatge de l'operaci¨®. |
L'objecte condici¨® d'operaci¨® d'acci¨® defineix una condici¨® que ha d'encaixar per executar l'operaci¨® en curs. T¨¦ les seg¨¹ents propietats.
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
opconditionid | string | (nom¨¦s lectura) ID de la condici¨® d'operaci¨® d'acci¨® |
conditiontype (obligatori) |
integer | Tipus de condici¨®. Valors possibles: 14 - esdeveniment reconegut. |
value (obligatori) |
string | Valor amb el que comparar. |
operationid | string | (nom¨¦s lectura) ID de l'operaci¨®. |
operator | integer | Operador de condici¨®. Valors possibles: 0 - (per defecte) =. |
Els seg¨¹ents operadors i valors s¨®n suportats per cada tipus de condici¨® d'operaci¨®.
°ä´Ç²Ô»å¾±³¦¾±¨® | Nom de la condici¨® | Operadors admesos | Valor esperat |
---|---|---|---|
14 | Esdeveniment reconegut | = | Si l'esdeveniment s'ha reconegut. Valors possibles: 0 - no reconegut pas; 1 - reconegut. |
L'objecte d'operaci¨® de recuperaci¨® d'acci¨® defineix una operaci¨® que s'efectuar¨¤ quan un problema sigui resolt. Les operacions de recuperaci¨® s¨®n possibles per els triggers i accions internes i de servei. T¨¦ les propietats seg¨¹ents.
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
operationid | string | (nom¨¦s lectura) ID de l'operaci¨® d'acci¨®. |
operationtype (obligatori) |
integer | Tipus d'operaci¨®. Valors possibles per al trigger i accions de servei: 0 - enviar missatge; 1 - script global; 11 - notificar a tots els implicats. Valors possibles per les accions internes: 0 - enviar missatge; 11 - notificar a tots els implicats. |
actionid | string | (nom¨¦s lectura) ID de l'acci¨® a qui pertany l'operaci¨® de recuperaci¨®. |
opcommand | object | Objecte que cont¨¦ informaci¨® de l'script del tipus d'acci¨® global que executa l'operaci¨®. Cada objecte t¨¦ una de les seg¨¹ents propietats: scriptid - (string) ID de l'escript del tipus d'acci¨®.Obligatori per a operacions d'script globals. |
opcommand_grp | array | Grups d'equips on s'executaran els scripts globals. Cada objecte t¨¦ les propietats seg¨¹ents: opcommand_grpid - (string, nom¨¦s lectura) ID de l'objecte;operationid - (string, nom¨¦s lectura) ID de l'operaci¨®;groupid - (string) ID del grup d'equips.Obligatori per les operacions d'scripts globals si no s'ha establert opcommand_hst . |
opcommand_hst | array | Equip on correran els scripts globals. Cada objecte t¨¦ les propietats seg¨¹ents: opcommand_hstid - (string, nom¨¦s lectura) ID de l'objecte;operationid - (string, nom¨¦s lectura) ID de l'operaci¨®;hostid - (string) ID de l'equip; si s'estableix a 0, la comanda s'executar¨¤ a l'equip actual.Obligatori per les operacions d'scripts globals si no s'ha establert opcommand_grp . |
opmessage | object | Objecte que cont¨¦ la informaci¨® sobre el missatge que s'ha enviat per l'operaci¨® de recuperaci¨®. L'objecte missatge de l'operaci¨® es descriu en detall m¨¦s amunt. Obligatori per a operacions de missatges. |
opmessage_grp | array | Grups d'usuaris als qui enviar els missatges. Cada objecte t¨¦ les propietats seg¨¹ents: operationid - (string, nom¨¦s lectura) ID de l'operaci¨®;usrgrpid - (string) ID del grup d'usuaris.Obligatori per les operacions de missatges si no s'ha establert opmessage_usr . |
opmessage_usr | array | Usuaris a qui enviar els missatges. Cada objecte t¨¦ les propietats seg¨¹ents: operationid - (string, nom¨¦s lectura) ID de l'operaci¨®;userid - (string) ID de l'usuari.Obligatori per les operacions de missatges si no s'ha establert opmessage_grp . |
L'objecte d'operaci¨® d'actualitzaci¨® de l'acci¨® defineix una operaci¨® que s'efectuar¨¤ quan s'actualitzi un problema (comentat, reconegut, gravetat modificada o tancat manualment). Les operacions d'actualitzaci¨® s¨®n possibles per les accions de triggers i de serveis. Tenen les seg¨¹ents propietats:
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
operationid | string | (nom¨¦s lectura) identificador de l'operaci¨® d'acci¨®. |
operationtype (obligatori) |
integer | Tipus d'operaci¨®. Valors possibles per les accions de trigger i de servei: 0 - enviar un missatge; 1 - script global; 12 - informar a totes les persones implicades. |
opcommand | object | Object que cont¨¦ les dades de l'script del tipus d'acci¨® global executada per l'operaci¨®. Cada objecte t¨¦ la propietat seg¨¹ent: scriptid - (string) identificador de l'script de tipus d'acci¨®.Obligatori per les operacions d'script global. |
opcommand_grp | array | Grups d'equips on executar els scripts globals. Cada objecte t¨¦ les propietats seg¨¹ents: groupid - (string) identificador del grup d'equips.< br>Obligatori per les operacions d'script global si no s'ha definit opcommand_hst . |
opcommand_hst | array | Equip on executar els scripts globals. Cada objecte t¨¦ les propietats seg¨¹ents: hostid - (string) identificador de l'equip; si es defineix a 0, la comanda s'executar¨¤ a l'equip actual.Obligatori per les operacions d'script global si no s'ha definit opcommand_grp . |
opmessage | object | Object que cont¨¦ les dades del missatge enviat per l'operaci¨® d'actualitzaci¨®. L'objecte de missage d'operaci¨® es descriu en detall aqu¨ª. |
opmessage_grp | array | Groups d'usuaris als qui enviar els missatges. Cada objecte t¨¦ les propietats seg¨¹ents: usrgrpid - (string) identificador del grup d'usuaris.>Obligatori nom¨¦s per les operacions send message si no s'ha definit opmessage_usr .Ignorat per les operacions send update message . |
opmessage_usr | array | Usuaris als qui enviar els missatges. Cada objecte t¨¦ les propietats seg¨¹ents: userid - (string) identificador de l'usuari.Obligatori nom¨¦s per les operacions send message si no s'ha definit pas opmessage_grp .Ignorat per les operacions |
###?Filtre d'accions
L'object de filtre d'acci¨® defineix un recull de condicions que s'han d'especificar per efectuar les operacions d'acci¨® configurades. T¨¦ les propietats seg¨¹ents:
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
condicions (obligatori) |
array | Conjunt de condicions de filtre a emprar per filtrar els resultats. |
evaltype (obligatori) |
integer | M¨¨tode d'avaluaci¨® de la condici¨® de filtre. Valors possibles: 0 - i/o?; 1 - i?; 2 - o?; 3 - expressi¨® personalitzada. |
eval_formula | string | (nom¨¦s lectura) Expressi¨® generada que s'emprar¨¤ per avaluar les condicions de filtre. L'expressi¨® cont¨¦ els identificadors que fan refer¨¨ncia a les condicions de filtre espec¨ªfiques per la seva formulaid . El valor de eval_formula ¨¦s igual al valor de formula per als filtres amb una expressi¨® personalitzada. |
formula | string | Expressi¨® definida per l'usuari a emprar per avaluar les condicions dels filtres amb una expressi¨® personalitzada. L'expressi¨® ha de contindre els identificadors fent refer¨¨ncia a les condicions de filtre espec¨ªfiques per la seva formulaid . Els identificadors emprats a l'expressi¨® han de correspondre exactament als definits a les condicions de filtre: cap condici¨® pot restar sense ¨²s o omesa.Obligatori per als filtres d'expressi¨® personalitzats. |
Aquest objecte defineix una condici¨® espec¨ªfica que s'ha de verificar abans d'executar les operacions d'acci¨®
Propietat | Tipus | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
---|---|---|
conditionid | string | (nom¨¦s lectura) Identificador de la condici¨® d'acci¨®. |
conditiontype (obligatori) |
enter | Tipus de condici¨®. Valors possibles per les accions dels triggers: 0 - grup d'equips; 1 - equip; 2 - trigger; 3 - nom de l'esdeveniment; 4 - gravetat del trigger; 6 - ±è±ð°ù¨ª´Ç»å±ð; 13 - model d'equip; 16 - problema esborrat; 25 - etiqueta d'esdeveniment; 26 - valor de l'etiqueta d'esdeveniment. Valors possibles per les accions de descoberta: 7 - IP de l'equip; 8 - tipus de servei de descoberta; 9 - port del servei de descoberta;< br>10 - estat de descoberta; 11 - durada de disponibilitat o indisponibilitat; 12 - valor rebut; 18 - regla de descoberta; 19 - verificaci¨® de descoberta; 20 - proxy;<br >21 - objecte de descoberta. Valors possibles per les accions d'enregistrament autom¨¤tic: 20 - proxy; 22 - nom d'equip; 24 - metadades de l'equip. Valors possibles per les accions internes: 0 - grup d'equips; 1 - equip; 13 - model d'equip; 23 - tipus d'esdeveniment; 25 - etiqueta d'esdeveniment; 26 - valor de l'etiqueta d'esdeveniment. Valors possibles per les accions de servei: 25 - etiqueta d'esdeveniment; 26 - valor de l'etiqueta d'esdeveniment; 27 - servei;<br >28 - nom del servei. |
valor (obligatori) |
string | Valor a comparar. |
value2 |
string | Valor secundari a comparar. Obligatori per les accions de triggers, internes i de servei quan el tipus de condici¨® sigui 26. |
actionid | string | (nom¨¦s lectura) Identificador de l'acci¨® a qui pertany la condici¨®. |
formulaid | string | Identificador ¨²nic arbitrari emprat per referenciar la condici¨® a partir d'una expressi¨® personalitzada. Nom¨¦s pot contindre lletres maj¨²scules. L'identificador s'ha de definir per l'usuari durant la modificaci¨® de condicions de filtre, per¨° es generar¨¤ de nou a petici¨® posterior. |
operador | enter | Operador de condici¨®. Valors possibles: 0 - (per defecte) ¨¦s igual; 1 - no ¨¦s pas igual; 2 - cont¨¦; 3 - no ho cont¨¦ pas; 4 - entre; 5 - ¨¦s superior o igual a; 6 - inferior o igual a; 7 - no ¨¦s pas entre; 8 - correspon;<br >9 - no correspon pas; 10 - S¨ª; 11 - No. |
Per entendre millor com emprar els filtres amb diferents tipus d'expressions, consulteu els exemples a les p¨¤gines dels m¨¨todes action.get i action.create.
Els operadors i valors seg¨¹ents s'admeten per cada tipus de condici¨®.
°ä´Ç²Ô»å¾±³¦¾±¨® | Nom de la condici¨® | Operadors admesos | Valor esperat | |
---|---|---|---|---|
0 | Grup d'equips | igual, no ¨¦s igual |
identificador del grup d'equips. | |
1 | Equip | igual, no ¨¦s igual |
identificador d'equip. | |
2 | Trigger | igual, no ¨¦s igual |
identificador de trigger. | |
3 | Nom de l'esdeveniment | ³¦´Ç²Ô³Ù¨¦, no cont¨¦ pas |
Nom de l'esdeveniment. | |
4 | Gravetat del trigger | igual, no ¨¦s igual, superior o igual, inferior o igual |
Gravetat del trigger. Consulteu la propietat "trigger "severity" per obtindre una llista de gravetats de triggers admeses. | |
5 | Valor de trigger | igual | Valor de trigger. Consulteu la propietat "valor" del trigger per obtindre una llista dels valors de triggers admesos. | |
6 | Per¨ªode de temps | entre, no entre | Hora en la que l'esdeveniment s'ha disparat al ±è±ð°ù¨ª´Ç»å±ð. | |
7 | IP de l'equip | igual, no ¨¦s igual |
Un o m¨¦s llocs IP a verificar separats per comes. Consulteu la secci¨® configuraci¨® de la descoberta de xarxa per tindre m¨¦s informaci¨® dels format admesos dels llocs IP. | |
8 | Tipus de servei descobert | igual, no ¨¦s igual |
Tipus de servei descobert. El tipus de servei descobert correspon al tipus de control de descoberta emprat per detectar el servei. Consulteu la propietat "tipus" de la verificaci¨® de descoberta per obtindre la llista dels tipus admesos. | |
9 | Port de servei descobert | igual, diferent |
Un o m¨¦s llocs de ports separats per comes. | |
10 | Estat de descoberta | igual | Estat d'un objecte descobert. Valors possibles: 0 - equip o servei actiu; 1 - equip o servei desactivat; 2 - equip o servei descobert; 3 - equip o servei perdut. |
|
11 | Durada de disponibilitat o indisponibilitat | superior o igual, inferior o igual |
Durada indicant quan de temps l'objecte descobert ¨¦s a l'estat actual, en segons. | |
12 | Valors rebuts | iguals, diferents, superiors o iguals, inferiors o iguals, ³¦´Ç²Ô³Ù¨¦, no cont¨¦ pas |
Valor retornat quan s'executa un agent Áú»¢¶Ä²©, control de descoberta SNMPv1, SNMPv2 o SNMPv3. | |
13 | Model d'equip | igual, no ¨¦s igual |
ID de model vinculat. | |
16 | El problema s'ha esborrat | S¨ª, No | No cal pas cap valor: l'¨²s de l'operador "S¨ª" vol dir que el problema s'ha esborrat, "No" - no s'ha esborrat pas. | |
18 | Regla de descoberta | igual, no ¨¦s igual |
ID de la regla de descoberta. | |
19 | Control de descoberta | igual, no ¨¦s igual |
ID del control de descoberta. | |
20 | Proxy | igual, no ¨¦s igual |
ID del proxy. | |
21 | Objecte de descoberta | igual | Tipus d'objecte que ha desencadenat l'esdeveniment de descoberta. Valors possibles: 1 - equip descobert; 2 - servei descobert. |
|
22 | Nom d'equip | ³¦´Ç²Ô³Ù¨¦, no cont¨¦ pas, correspon, no correspon pas |
Nom d'equip. L'¨²s d'una expressi¨® regular s'admet per els operadors correspon i no correspon pas a les condicions d'auto-enregistrement. |
|
23 | Tipus d'esdeveniment | igual | Esdeveniment intern espec¨ªfic. Valors possibles: 0 - element amb estat "no adm¨¨s" ; 1 - element amb esetat "normal"; 2 - Regla LLD amb estat "no admesa" ; 3 - Regla LLD amb estat "normal" ; 4 - Trigger amb estat "desconegut" ; 5 - Trigger amb estat "normal". |
|
24 | Metadades de l'equip | ³¦´Ç²Ô³Ù¨¦, no cont¨¦ pas, correspon, no correspon pas |
Metadades de l'equip registrat autom¨¤ticament. L'¨²s d'una expressi¨® regular s'admet per als operadors correspon et no correspon pas. |
|
25 | Etiqueta | igual, no ¨¦s igual, ³¦´Ç²Ô³Ù¨¦, no cont¨¦ pas |
Etiqueta d'esdeveniment. | |
26 | Valor de l'etiqueta | igual, no ¨¦s igual, ³¦´Ç²Ô³Ù¨¦, no cont¨¦ pas |
Valor de l'etiqueta d'esdeveniment. | |
27 | Servei | igual, no ¨¦s igual a |
ID de servei. | |
28 | Nom del servei | igual, no ¨¦s igual |
Nom del servei. |