This is a translation of the original English documentation page. Help us make it better.

> Oggetto azione

I seguenti oggetti sono direttamente correlati all'API action.

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

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.

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.