> Oggetto azione

I seguenti oggetti sono direttamente correlati all'API action.

Operazione di azione

L'oggetto operazione azione definisce un'operazione che verrà eseguita quando viene eseguita un'azione. Ha le seguenti proprietà.

Proprietà	Tipo	Descrizione
operationid	string	(readonly) ID dell'operazione di azione.
operationtype (obbligatorio)	intero	Tipo di operazione. Valori possibili: 0 - invia messaggio; 1 - script globale; 2 - aggiungi host; 3 - rimuovi host; 4 - aggiungi al gruppo host; 5 - rimuovi dal gruppo host; 6 - collega al modello; 7 - scollega dal modello;<br >8 - abilita host; 9 - disabilita host; 10 - imposta la modalità di inventario host. Tieni presente che solo i tipi '0' e '1' sono supportati per le azioni trigger e di servizio, solo '0' è supportato per le azioni interne. Tutti i tipi sono supportati per le azioni di rilevamento e registrazione automatica.
actionid	string	(readonly) ID dell'azione a cui appartiene l'operazione.
esc_period	string	Durata di un passaggio di escalation in secondi. Deve essere maggiore di 60 secondi. Accetta secondi, unità di tempo con suffisso e macro utente. Se impostato su 0 o 0s, verrà utilizzato il periodo di escalation dell'azione predefinito. Predefinito: 0s. Tieni presente che le escalation sono supportate solo per trigger, azioni interne e di servizio e solo in condizioni normali operazioni.
esc_step_from	integer	Passo da cui avviare l'escalation. Predefinito: 1. Si noti che le escalation sono supportate solo per trigger, azioni interne e di servizio e solo nelle normali operazioni .
esc_step_to	integer	Passo per terminare l'escalation alle. Predefinito: 1. Si noti che le escalation sono supportate solo per trigger, azioni interne e di servizio e solo nelle normali operazioni .
evaltype	intero	Metodo di valutazione delle condizioni operative. Valori possibili: 0 - (predefinito) AND / OR; 1 - AND; 2 - OR.
opcommand	object	Oggetto contenente dati sullo script globale eseguito dall'operazione. Ogni oggetto ha una proprietà seguente: `scriptid` - (string) ID dello script. Obbligatorio per operazioni di script globali.
opcommand_grp	array	Gruppi host su cui eseguire script globali. Ogni oggetto ha le seguenti proprietà: `opcommand_grpid` - (string, readonly) ID dell'oggetto; `operationid` - (string, readonly) ID dell'operazione; `groupid` - (string) ID del gruppo host. Richiesto per operazioni di script globali se `opcommand_hst` è non impostato.
opcommand_hst	array	Host su cui eseguire gli script globali. Ogni oggetto ha le seguenti proprietà: `opcommand_hstid` - (string, readonly) ID dell'oggetto; `operationid` - (string, readonly) ID dell'operazione; `hostid` - (string) ID dell'host; se impostato su 0 il comando verrà eseguito sull'host corrente. Richiesto per operazioni di script globali se `opcommand_grp` non è impostato.
opconditions	array	Condizioni operative utilizzate per attivare le azioni. L'oggetto condizione operativa è descritto in dettaglio di seguito.
opgroup	array	Gruppi host a cui aggiungere host. Ogni oggetto ha le seguenti proprietà: `operationid` - (string, readonly) ID dell'operazione; `groupid` - (stringa) ID del gruppo host. Obbligatorio per le operazioni "aggiungi al gruppo host" e "rimuovi dal gruppo host".
opmessage	object	Oggetto contenente i dati sul messaggio inviato dall'operazione. L'oggetto del messaggio dell'operazione è descritto in dettaglio di seguito.< br> Necessario per le operazioni sui messaggi.
opmessage_grp	array	Gruppi di utenti a cui inviare messaggi. Ogni oggetto ha le seguenti proprietà: `operationid` - (string, readonly) ID dell'operazione; `usrgrpid` - (string) ID del gruppo utenti. Richiesto per le operazioni sui messaggi se `opmessage_usr` non è impostato.
opmessage_usr	array	Utenti a cui inviare messaggi. Ogni oggetto ha le seguenti proprietà: `operationid` - (string, readonly) ID dell'operazione; `userid` - (stringa) ID dell'utente. Richiesto per le operazioni sui messaggi se `opmessage_grp` non è impostato.
optemplate	array	Modelli a cui collegare gli host. Ogni oggetto ha le seguenti proprietà: `operationid` - (string, readonly) ID dell'operazione; `templateid` - (stringa) ID del modello. Obbligatorio per le operazioni "collegamento al modello" e "scollegamento dal modello".
opinventory	object	Modalità inventario impostata su host. L'oggetto ha le seguenti proprietà: `operationid` - (string, readonly) ID dell'operazione; `inventory_mode` - * (stringa)* Modalità inventario. Obbligatorio per le operazioni "Imposta modalità inventario host".

Messaggio di operazione di azione

L'oggetto messaggio operazione contiene dati sul messaggio che verrà inviato dall'operazione.

Proprietà	Tipo	Descrizione
default_msg	intero	Se utilizzare il testo e l'oggetto del messaggio di azione predefiniti. Valori possibili: 0 - utilizza i dati dell'operazione; 1 - (predefinito) usa i dati dal tipo di supporto.
mediatypeid	string	ID del tipo di supporto che verrà utilizzato per inviare il messaggio.
messaggio	stringa	Testo del messaggio di operazione.
oggetto	stringa	Oggetto del messaggio di operazione.

Condizione operativa dell'azione

L'oggetto condizione operazione azione definisce una condizione che deve essere incontrati per eseguire l'operazione in corso. Ha le seguenti proprietà.

Proprietà	Tipo	Descrizione
opconditionid	string	(sola lettura) ID della condizione dell'operazione di azione
conditiontype (obbligatorio)	intero	Tipo di condizione. Valori possibili: 14 - evento riconosciuto.
valore (obbligatorio)	stringa	Valore con cui confrontare.
operationid	string	(sola lettura) ID dell'operazione.
operator	intero	Operatore condizione. Valori possibili: 0 - (predefinito) =.

I seguenti operatori e valori sono supportati per ogni operazione tipo di condizione.

|Condizione|Nome condizione|Operatori supportati|Valore atteso| |---------|--------------|--------------------|---- ----------| |14|Evento riconosciuto|=|Se l'evento è stato riconosciuto.

Valori possibili:
0 - non riconosciuto;
1 - riconosciuto.|

Operazione di aggiornamento dell'azione

L'oggetto operazione di aggiornamento azione definisce un'operazione che sarà eseguita quando un problema viene aggiornato (commentato, riconosciuto, gravità modificata o chiusa manualmente). Sono possibili operazioni di aggiornamento per azioni trigger e di servizio. Ha le seguenti proprietà.

Proprietà	Tipo	Descrizione
operationid	string	(readonly) ID dell'operazione di azione.
operationtype (obbligatorio)	intero	Tipo di operazione. Valori possibili per trigger e azioni di servizio: 0 - invia messaggio; 1 - script globale;< br>12 - notifica a tutti i soggetti coinvolti.
opcommand	object	Oggetto contenente dati sullo script del tipo di azione globale eseguito dall'operazione. Ogni oggetto ha una proprietà seguente: `scriptid` - (string) ID dello script del tipo di azione. Richiesto per operazioni di script globali.
opcommand_grp	array	Gruppi host su cui eseguire script globali. Ogni oggetto ha le seguenti proprietà: `groupid` - (string) ID del gruppo host. < br>Richiesto per operazioni di script globali se `opcommand_hst` non è impostato.
opcommand_hst	array	Host su cui eseguire gli script globali. Ogni oggetto ha le seguenti proprietà: `hostid` - (string) ID dell'host; se impostato su 0 il comando verrà eseguito sull'host corrente. Richiesto per operazioni di script globali se `opcommand_grp` non è impostato.
opmessage	object	Oggetto contenente i dati sul messaggio inviato dall'operazione di aggiornamento. L'oggetto del messaggio di operazione è descritto in dettaglio sopra.
opmessage_grp	array	Gruppi di utenti a cui inviare messaggi. Ogni oggetto ha le seguenti proprietà: `usrgrpid` - (string) ID del gruppo utenti. <br >Richiesto solo per le operazioni di `invio del messaggio` se `opmessage_usr` non è impostato. Viene ignorato per le operazioni di `invio del messaggio di aggiornamento`.
opmessage_usr	array	Utenti a cui inviare messaggi. Ogni oggetto ha le seguenti proprietà: `userid` - (string) ID dell'utente. Obbligatorio solo per le operazioni di `invio del messaggio` se `opmessage_grp` non è impostato. Viene ignorato per le operazioni di `invio del messaggio di aggiornamento`.

Filtro azione

L'oggetto filtro azione definisce un insieme di condizioni che devono essere soddisfatte per eseguire le operazioni di azione configurate. Ha le seguenti proprietà.

Proprietà	Tipo	Descrizione
condizioni (obbligatorio)	array	Set di condizioni di filtro da utilizzare per filtrare i risultati.
evaltype (obbligatorio)	intero	Metodo di valutazione delle condizioni del filtro. Valori possibili: 0 - e/o; 1 - e; 2 - o; 3 - espressione personalizzata.
eval_formula	string	(sola lettura) Espressione generata che verrà utilizzata per valutare le condizioni del filtro. L'espressione contiene ID che fanno riferimento a condizioni di filtro specifiche tramite la sua "formulaid". Il valore di `eval_formula` è uguale al valore di `formula` per i filtri con un'espressione personalizzata.
formula	string	Espressione definita dall'utente da utilizzare per valutare le condizioni dei filtri con un'espressione personalizzata. L'espressione deve contenere ID che fanno riferimento a condizioni di filtro specifiche tramite la sua "formulaid". Gli ID utilizzati nell'espressione devono corrispondere esattamente a quelli definiti nelle condizioni del filtro: nessuna condizione può rimanere inutilizzata o omessa. Obbligatorio per i filtri delle espressioni personalizzate.

Azione

L'oggetto azione ha le seguenti proprietà.

Proprietà	Tipo	Descrizione
actionid	string	(sola lettura) ID dell'azione.
esc_period (obbligatorio)	string	Durata del passaggio dell'operazione predefinita. Devono essere almeno 60 secondi. Accetta secondi, unità di tempo con suffisso e macro utente. Tieni presente che le escalation sono supportate solo per trigger, azioni interne e di servizio e solo nelle normali operazioni.
eventsource (richiesto)	intero	(costante) Tipo di eventi che l'azione gestirà. Fai riferimento alla proprietà event "source" per un elenco dei tipi di eventi supportati.
name (obbligatorio)	string	Nome dell'azione.
status	intero	Se l'azione è abilitata o disabilitata. Valori possibili: 0 - (predefinito) abilitato; 1 - disabilitato.
pause_suppressed	intero	Se sospendere o meno l'escalation durante i periodi di manutenzione. Valori possibili: 0 - Non mettere in pausa l'escalation; 1 - (predefinito) Metti in pausa l'escalation. Si noti che questo parametro è valido solo per le azioni trigger.
notify_if_canceled	intero	Se notificare quando l'escalation viene annullata. Valori possibili: 0 - Non notificare quando l'escalation viene annullata; 1 - (predefinito) Notifica quando l'escalation viene annullata. Tieni presente che questo parametro è valido solo per le azioni trigger.

Si noti che per alcuni metodi (aggiornamento, eliminazione) la combinazione di parametri richiesta/facoltativa è diversa.

Operazione di ripristino dell'azione

L'oggetto operazione di ripristino dell'azione definisce un'operazione che sarà eseguita quando un problema viene risolto. Sono possibili operazioni di recupero per azioni trigger, interne e di servizio. Ha quanto segue proprietà.

Proprietà	Tipo	Descrizione
operationid	string	(readonly) ID dell'operazione di azione.
operationtype (obbligatorio)	intero	Tipo di operazione. Valori possibili per trigger e azioni di servizio: 0 - invia messaggio; 1 - script globale;< br>11 - notifica a tutti i soggetti coinvolti. Possibili valori per le azioni interne: 0 - invio messaggio; 11 - notifica a tutti i soggetti coinvolti.
actionid	string	(readonly) ID dell'azione a cui appartiene l'operazione di ripristino.
opcommand	object	L'oggetto contiene dati sullo script del tipo di azione globale eseguito dall'operazione. Ogni oggetto ha una proprietà seguente: `scriptid` - (string) ID dello script del tipo di azione. Richiesto per operazioni di script globali.
opcommand_grp	array	Gruppi host su cui eseguire script globali. Ogni oggetto ha le seguenti proprietà: `opcommand_grpid` - (string, readonly) ID dell'oggetto; `operationid` - (string, readonly) ID dell'operazione; `groupid` - (string) ID del gruppo host. Richiesto per operazioni di script globali se `opcommand_hst` è non impostato.
opcommand_hst	array	Host su cui eseguire gli script globali. Ogni oggetto ha le seguenti proprietà: `opcommand_hstid` - (string, readonly) ID dell'oggetto; `operationid` - (string, readonly) ID dell'operazione; `hostid` - (string) ID dell'host; se impostato su 0 il comando verrà eseguito sull'host corrente. Richiesto per operazioni di script globali se `opcommand_grp` non è impostato.
opmessage	object	Oggetto contenente i dati sul messaggio inviato dall'operazione di ripristino. L'oggetto del messaggio di operazione è descritto in dettaglio sopra. Necessario per le operazioni sui messaggi.
opmessage_grp	array	Gruppi di utenti a cui inviare messaggi. Ogni oggetto ha le seguenti proprietà: `operationid` - (string, readonly) ID dell'operazione; `usrgrpid` - (string) ID del gruppo utenti. Richiesto per le operazioni sui messaggi se `opmessage_usr` non è impostato.
opmessage_usr	array	Utenti a cui inviare messaggi. Ogni oggetto ha le seguenti proprietà: `operationid` - (string, readonly) ID dell'operazione; `userid` - (stringa) ID dell'utente. Richiesto per le operazioni sui messaggi se `opmessage_grp` non è impostato.

Condizione del filtro delle azioni

L'oggetto condizione filtro azione definisce una condizione specifica che deve essere verificata prima di eseguire le operazioni di azione.

Proprietà	Tipo	Descrizione
conditionid	string	(sola lettura) ID della condizione dell'azione.
conditiontype (obbligatorio)	intero	Tipo di condizione. Valori possibili per le azioni trigger: 0 - gruppo host; 1 - host; 2 - trigger; 3 - nome del trigger; 4 - gravità del trigger; 6 - periodo di tempo; 13 - modello host; 16 - problema eliminato; 25 - evento tag; 26 - valore del tag evento. Possibili valori per le azioni di rilevamento: 7 - IP host; 8 - tipo di servizio rilevato; 9 - porta di servizio rilevata;< br>10 - stato del rilevamento; 11 - durata del tempo di attività o di inattività; 12 - valore ricevuto; 18 - regola di rilevamento; 19 - controllo del rilevamento; 20 - proxy;<br >21 - oggetto discovery. Possibili valori per le azioni di registrazione automatica: 20 - proxy; 22 - nome host; 24 - metadati host. Possibili valori per azioni interne: 0 - gruppo host; 1 - host; 13 - modello host; 23 - tipo di evento; 25 - tag evento; 26 - valore tag evento . Possibili valori per le azioni di servizio: 25 - tag evento; 26 - valore tag evento; 27 - servizio;<br >28 - nome del servizio.
valore (obbligatorio)	stringa	Valore con cui confrontare.
value2	string	Valore secondario con cui confrontare. Necessario per azioni trigger, interne e di servizio quando il tipo di condizione è 26.
actionid	string	(readonly) ID dell'azione a cui appartiene la condizione.
formulaid	string	ID univoco arbitrario utilizzato per fare riferimento alla condizione da un'espressione personalizzata. Può contenere solo lettere maiuscole. L'ID deve essere definito dall'utente durante la modifica delle condizioni del filtro, ma verrà generato nuovamente quando ne verrà richiesto in seguito.
operator	intero	Operatore condizione. Valori possibili: 0 - (predefinito) uguale; 1 - non uguale; 2 - contiene; 3 - non contiene; 4 - in; 5 - è maggiore o uguale a; 6 - è minore o uguale; 7 - non in; 8 - corrisponde;<br >9 - non corrisponde; 10 - Sì; 11 - No.

Per capire meglio come utilizzare i filtri con vari tipi di espressioni, vedere esempi su action.get e Metodo action.create. pagine.

I seguenti operatori e valori sono supportati per ogni tipo di condizione.

Condizione	Nome condizione	Operatori supportati	Valore atteso
0	Gruppo host	uguale, non uguale	ID gruppo host.
1	Host	uguale, non è uguale	ID host.
2	Trigger	uguale, non uguale	ID trigger.
3	Nome del trigger	contiene, non contiene	Nome del trigger.
4	Gravità del trigger	uguale, non uguale, è maggiore o uguale, è minore o uguale a	Gravità del trigger. Fare riferimento alla proprietà "gravità" del trigger per un elenco delle severità del trigger supportate.
5	Valore di attivazione	uguale	Valore di attivazione. Fare riferimento alla proprietà "valore" trigger per un elenco di valori di trigger supportati.
6	Periodo di tempo	in, non in	Ora in cui l'evento è stato attivato come periodo di tempo.
7	IP host	uguale, non uguale	Uno o più intervalli IP da controllare separati da virgole. Fare riferimento alla sezione configurazione rilevamento rete per ulteriori informazioni sui formati supportati degli intervalli IP.
8	Tipo di servizio rilevato	uguale, non uguale	Tipo di servizio rilevato. Il tipo di servizio corrisponde al tipo di controllo di individuazione utilizzato per rilevare il servizio. Fare riferimento alla proprietà di discovery check "type" per un elenco di tipi supportati.
9	Porta del servizio rilevata	uguale, non uguale	Uno o più intervalli di porte separati da virgole.
10	Stato rilevamento	uguale	Stato di un oggetto rilevato. Valori possibili: 0 - host o servizio attivo; 1 - host o servizio inattivo; 2 - host o servizio rilevato; 3 - host o servizio perso.
11	La durata del tempo di attività o di inattività	è maggiore o uguale, è inferiore o uguale a	Tempo che indica per quanto tempo l'oggetto rilevato è rimasto nello stato corrente in secondi.
12	Valori ricevuti	uguale, non uguale, è maggiore o uguale, è minore o uguale, contiene, non contiene	Valore restituito durante l'esecuzione di un Agente Zabbix, controllo rilevamento SNMPv1, SNMPv2 o SNMPv3.
13	Modello host	uguale, non uguale	ID modello collegato.
16	Il problema è stato eliminato	Sì, No	Nessun valore richiesto: l'utilizzo dell'operatore "Sì" significa che il problema deve essere eliminato, "No" - non eliminato.
18	Regola di rilevamento	uguale, non uguale	ID della regola di rilevamento.
19	Controllo rilevamento	uguale, non uguale	ID del controllo rilevamento.
20	Proxy	uguale, non uguale	ID del proxy.
21	Oggetto di rilevamento	uguale	Tipo di oggetto che ha attivato l'evento di rilevamento. Valori possibili: 1 - host rilevato; 2 - servizio rilevato.
22	Nome host	contiene, non contiene, corrisponde, non corrisponde	Nome host. L'uso di un'espressione regolare è supportato per gli operatori corrisponde e non corrisponde in condizioni di autoregistrazione.
23	Tipo di evento	uguale	Evento interno specifico. Valori possibili: 0 - elemento in stato "non supportato"; 1 - elemento in stato "normale"; 2 - Regola LLD in stato "non supportato"; 3 - Regola LLD in stato "normale"; 4 - trigger in stato "sconosciuto"; 5 - trigger in stato "normale".
24	Metadati host	contiene, non contiene, corrisponde, non corrisponde	Metadati dell'host registrato automaticamente. L'uso di un'espressione regolare è supportato per gli operatori corrisponde e non corrisponde.
25	Tag	uguale, non uguale, contiene, non contiene	Tag evento.
26	Valore tag	uguale, non uguale, contiene, non contiene	Valore tag evento.
27	Servizio	uguale, non uguale	ID servizio.
28	Nome servizio	uguale, non uguale	Nome servizio.

Documentation