Áú»¢¶Ä²©

> Objecte d'acci¨®

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.

Operaci¨® d'acci¨®

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".

Missatge d'operaci¨® d'acci¨®

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¨®.

°ä´Ç²Ô»å¾±³¦¾±¨® d'operaci¨® d'acci¨®

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.

Operaci¨® de recuperaci¨® d'acci¨®

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.

Operaci¨® d'actualitzaci¨® de l'acci¨®

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.

°ä´Ç²Ô»å¾±³¦¾±¨® del filtre d'acci¨®

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.