Sidebar

Become a monitoring expert!
Sign up for Zabbix training

> Actie-object

De volgende objecten zijn direct gerelateerd aan de action API.

Actie

Het actieobject heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
actionid string (alleen-lezen) ID van de actie.
esc_period
(vereist)
string Standaard bewerkingsstapduur. Moet minimaal 60 seconden zijn. Accepteert seconden, tijdseenheid met achtervoegsel en gebruikersmacro.

Houd er rekening mee dat escalaties alleen worden ondersteund voor trigger-, interne en serviceacties en alleen bij normale bewerkingen.
eventsource
(vereist)
geheel getal (constant) Type gebeurtenissen dat de actie zal verwerken.

Raadpleeg de event "source" eigenschap voor een lijst met ondersteunde gebeurtenistypen.
name
(verplicht)
string Naam van de actie.
status integer Of de actie is ingeschakeld of uitgeschakeld.

Mogelijke waarden:
0 - (standaard) ingeschakeld;
1 - uitgeschakeld.
pause_suppressed integer Of de escalatie moet worden onderbroken tijdens onderhoudsperioden of niet.

Mogelijke waarden:
0 - Escalatie niet pauzeren;
1 - (standaard) Escalatie pauzeren.

Houd er rekening mee dat deze parameter alleen geldig is voor triggeracties.
notify_if_canceled integer Of u moet melden wanneer escalatie wordt geannuleerd.

Mogelijke waarden:
0 - Niet melden wanneer escalatie wordt geannuleerd;
1 - (standaard) Waarschuwen wanneer escalatie is geannuleerd.

Houd er rekening mee dat deze parameter alleen geldig is voor triggeracties.

Actie bewerking

Het actiebewerkingsobject definieert een bewerking die wordt uitgevoerd wanneer een actie wordt uitgevoerd. Het heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
operationid string (alleen-lezen) ID van de actiebewerking.
operationtype
(vereist)
geheel getal Type bewerking.

Mogelijke waarden:
0 - bericht verzenden;
1 - globaal script;
2 - toevoegen host;
3 - verwijder host;
4 - voeg toe aan hostgroep;
5 - verwijder uit hostgroep;
6 - link naar sjabloon;
7 - ontkoppel van sjabloon;<br >8 - host inschakelen;
9 - host uitschakelen;
10 - hostinventarisatiemodus instellen.

Houd er rekening mee dat alleen typen '0' en '1' worden ondersteund voor trigger- en serviceacties, alleen '0' wordt ondersteund voor interne acties. Alle typen worden ondersteund voor detectie- en automatische registratieacties.
actionid string (alleen-lezen) ID van de actie waartoe de bewerking behoort.
esc_period string Duur van een escalatiestap in seconden. Moet langer zijn dan 60 seconden. Accepteert seconden, tijdseenheid met achtervoegsel en gebruikersmacro. Indien ingesteld op 0 of 0s, wordt de standaard actie-escalatieperiode gebruikt.

Standaard: 0s.

Merk op dat escalaties alleen worden ondersteund voor trigger-, interne en serviceacties, en alleen in normale operaties.
esc_step_from integer Stap om escalatie te starten.

Standaard: 1.

Houd er rekening mee dat escalaties alleen worden ondersteund voor trigger-, interne en serviceacties, en alleen bij normale bewerkingen .
esc_step_to integer Stap om escalatie te beëindigen op.

Standaard: 1.

Houd er rekening mee dat escalaties alleen worden ondersteund voor trigger-, interne en serviceacties, en alleen bij normale bewerkingen .
evaltype geheel getal Bewerkingsvoorwaarde evaluatiemethode.

Mogelijke waarden:
0 - (standaard) AND / OR;
1 - AND;
2 - OR.
opcommand object Object dat gegevens bevat over een globaal script dat door de bewerking wordt uitgevoerd.

Elk object heeft één volgende eigenschap: scriptid - (string) ID van het script.

Vereist voor globale scriptbewerkingen.
opcommand_grp array Hostgroepen om globale scripts op uit te voeren.

Elk object heeft de volgende eigenschappen:
opcommand_grpid - (string, alleen-lezen) ID van het object;
operationid - (string, alleen-lezen) ID van de bewerking;
groupid - (string) ID van de hostgroep.

Vereist voor algemene scriptbewerkingen als opcommand_hst is niet ingesteld.
opcommand_hst array Host om globale scripts op uit te voeren.

Elk object heeft de volgende eigenschappen:
opcommand_hstid - (string, alleen-lezen) ID van het object;
operationsid - (string, alleen-lezen) ID van de bewerking;
hostid - (string) ID van de host; indien ingesteld op 0 wordt de opdracht uitgevoerd op de huidige host.

Vereist voor algemene scriptbewerkingen als opcommand_grp niet is ingesteld.
opconditions array Bewerkingsvoorwaarden gebruikt voor triggeracties.

Het bewerkingsvoorwaarde-object wordt hieronder in detail beschreven.
opgroup array Hostgroepen waaraan hosts moeten worden toegevoegd.

Elk object heeft de volgende eigenschappen:
operationid - (string, alleen-lezen) ID van de bewerking;
groupid - (string) ID van de hostgroep.

Vereist voor bewerkingen "toevoegen aan hostgroep" en "verwijderen uit hostgroep".
opmessage object Object dat de gegevens bevat over het bericht dat door de bewerking is verzonden.

Het bewerkingsberichtobject wordt hieronder in detail beschreven.< br>
Vereist voor berichtbewerkingen.
opmessage_grp array Gebruikersgroepen waarnaar berichten moeten worden verzonden.

Elk object heeft de volgende eigenschappen:
operationid - (string, alleen-lezen) ID van de bewerking;
usrgrpid - (string) ID van de gebruikersgroep.

Vereist voor berichtbewerkingen als opmessage_usr niet is ingesteld.
opmessage_usr array Gebruikers om berichten naar te verzenden.

Elk object heeft de volgende eigenschappen:
operationid - (string, alleen-lezen) ID van de bewerking;
userid - (string) ID van de gebruiker.

Vereist voor berichtbewerkingen als opmessage_grp niet is ingesteld.
optemplate array Sjablonen om de hosts aan te koppelen.

Elk object heeft de volgende eigenschappen:
operationid - (string, alleen-lezen) ID van de bewerking;
templateid - (string) ID van de sjabloon.

Vereist voor bewerkingen "link naar sjabloon" en "ontkoppelen van sjabloon".
opinventory object Voorraadmodus zet host op.

Object heeft de volgende eigenschappen:
operationid - (string, alleen-lezen) ID van de bewerking;
inventory_mode - * (string)* Voorraadmodus.

Vereist voor bewerkingen "Hostinventarismodus instellen".

Actie operatie bericht

Het bewerkings bericht object bevat gegevens over het bericht dat worden verzonden door de operatie.

|Property|Type|Beschrijving| |--------|---------------------------------------- -----------|-----------| |default_msg|integer|Of de standaardtekst en het onderwerp van het actiebericht moeten worden gebruikt.

Mogelijke waarden:
0 - gebruik de gegevens van de bewerking;
1 - (standaard) gebruik de gegevens van het mediatype.| |mediatypeid|string|ID van het mediatype dat zal worden gebruikt om het bericht te verzenden.| |message|string|Bewerkings bericht tekst.| |subject|string|Bewerking bericht onderwerp.|

Actie operatie voorwaarde

Het actie bewerkingsvoorwaarde object definieert een voorwaarde die moet zijn voldaan om de huidige bewerking uit te voeren. Het heeft de volgende eigenschappen.

|Property|Type|Beschrijving| |--------|---------------------------------------- -----------|-----------| |opconditionid|string|(alleen-lezen) ID van de actievoorwaarde| |conditiontype
(vereist)|geheel getal|Type voorwaarde.

Mogelijke waarden:
14 - gebeurtenis bevestigd.| |waarde
(verplicht)|string|Waarde om mee te vergelijken.| |operationid|string|(alleen-lezen) ID van de bewerking.| |operator|geheel getal|Conditie-operator.

Mogelijke waarden:
0 - (standaard) =.|

De volgende operatoren en waarden worden ondersteund voor elke bewerking: soort toestand.

|Voorwaarde|Voorwaarde naam|Ondersteunde operators|Verwachte waarde| |---------|--------------|-------------------|---- ----------| |14|Gebeurtenis bevestigd|=|Of de gebeurtenis is bevestigd.

Mogelijke waarden:
0 - niet bevestigd;
1 - bevestigd.|

Actie herstel bewerking

Het actie-herstelbewerkingsobject definieert een bewerking die wordt uitgevoerd wanneer een probleem is opgelost. Herstelbewerkingen zijn mogelijk voor trigger-, interne en serviceacties. Het heeft het volgende: eigendommen.

Eigenschap Type Beschrijving
operationid string (alleen-lezen) ID van de actiebewerking.
operationtype
(vereist)
geheel getal Type bewerking.

Mogelijke waarden voor trigger- en serviceacties:
0 - bericht verzenden;
1 - algemeen script;< br>11 - breng alle betrokkenen op de hoogte.

Mogelijke waarden voor interne acties:
0 - stuur bericht;
11 - breng alle betrokkenen op de hoogte.
actionid string (alleen-lezen) ID van de actie waartoe de herstelbewerking behoort.
opcommand object Object bevat gegevens over een globaal actietypescript dat door de bewerking wordt uitgevoerd.

Elk object heeft één volgende eigenschap: scriptid - (string) ID van het actietypescript.

Vereist voor algemene scriptbewerkingen.
opcommand_grp array Hostgroepen om globale scripts op uit te voeren.

Elk object heeft de volgende eigenschappen:
opcommand_grpid - (string, alleen-lezen) ID van het object;
operationid - (string, alleen-lezen) ID van de bewerking;
groupid - (string) ID van de hostgroep.

Vereist voor algemene scriptbewerkingen als opcommand_hst is niet ingesteld.
opcommand_hst array Host om globale scripts op uit te voeren.

Elk object heeft de volgende eigenschappen:
opcommand_hstid - (string, alleen-lezen) ID van het object;
operationsid - (string, alleen-lezen) ID van de bewerking;
hostid - (string) ID van de host; indien ingesteld op 0 wordt de opdracht uitgevoerd op de huidige host.

Vereist voor algemene scriptbewerkingen als opcommand_grp niet is ingesteld.
opmessage object Object dat de gegevens bevat over het bericht dat door de herstelbewerking is verzonden.

Het bewerkingsberichtobject is hierboven in detail beschreven.

Vereist voor berichtbewerkingen.
opmessage_grp array Gebruikersgroepen waarnaar berichten moeten worden verzonden.

Elk object heeft de volgende eigenschappen:
operationid - (string, alleen-lezen) ID van de bewerking;
usrgrpid - (string) ID van de gebruikersgroep.

Vereist voor berichtbewerkingen als opmessage_usr niet is ingesteld.
opmessage_usr array Gebruikers om berichten naar te verzenden.

Elk object heeft de volgende eigenschappen:
operationid - (string, alleen-lezen) ID van de bewerking;
userid - (string) ID van de gebruiker.

Vereist voor berichtbewerkingen als opmessage_grp niet is ingesteld.

Actie update bewerking

Het actie-update-bewerkingsobject definieert een bewerking die wordt uitgevoerd wanneer een probleem wordt bijgewerkt (becommentarieerd, erkend, ernst gewijzigd of handmatig gesloten). Updatebewerkingen zijn mogelijk voor trigger- en serviceacties. Het heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
operationid string (alleen-lezen) ID van de actiebewerking.
operationtype
(vereist)
geheel getal Type bewerking.

Mogelijke waarden voor trigger- en serviceacties:
0 - bericht verzenden;
1 - algemeen script;< br>12 - breng alle betrokkenen op de hoogte.
opcommand object Object dat gegevens bevat over een globaal actietypescript dat door de bewerking wordt uitgevoerd.

Elk object heeft één volgende eigenschap: scriptid - (string) ID van het actietypescript.

Vereist voor algemene scriptbewerkingen.
opcommand_grp array Hostgroepen om globale scripts op uit te voeren.

Elk object heeft de volgende eigenschappen:
groupid - (string) ID van de hostgroep.

br>Vereist voor globale scriptbewerkingen als opcommand_hst niet is ingesteld.
opcommand_hst array Host om globale scripts op uit te voeren.

Elk object heeft de volgende eigenschappen:
hostid - (string) ID van de host; indien ingesteld op 0 wordt de opdracht uitgevoerd op de huidige host.

Vereist voor algemene scriptbewerkingen als opcommand_grp niet is ingesteld.
opmessage object Object dat de gegevens bevat over het bericht dat is verzonden door de updatebewerking.

Het bewerkingsberichtobject is hierboven in detail beschreven.
opmessage_grp array Gebruikersgroepen om berichten naar te verzenden.

Elk object heeft de volgende eigenschappen:
usrgrpid - (string) ID van de gebruikersgroep.
<br >Alleen vereist voor 'send message'-bewerkingen als 'opmessage_usr' niet is ingesteld.
Wordt genegeerd voor 'send update message'-bewerkingen.
opmessage_usr array Gebruikers om berichten naar te verzenden.

Elk object heeft de volgende eigenschappen:
userid - (string) ID van de gebruiker.

Vereist alleen voor send message-bewerkingen als opmessage_grp niet is ingesteld.
Wordt genegeerd voor send update message-bewerkingen.

Actiefilter

Het actiefilter object definieert een reeks voorwaarden waaraan moet worden voldaan om: de geconfigureerde actiebewerkingen uitvoeren. Het heeft het volgende: eigenschappen.

|Property|Type|Beschrijving| |--------|---------------------------------------- -----------|-----------| |voorwaarden
(vereist)|array|Set van filtervoorwaarden om te gebruiken voor het filteren van resultaten.| |evaltype
(vereist)|geheel getal|Filterconditie-evaluatiemethode.

Mogelijke waarden:
0 - en/of;
1 - en;
2 - of;
3 - aangepaste uitdrukking.| |eval_formula|string|(alleen-lezen) Gegenereerde expressie die zal worden gebruikt voor het evalueren van filtervoorwaarden. De expressie bevat ID's die verwijzen naar specifieke filtervoorwaarden door middel van de formulaid. De waarde van eval_formula is gelijk aan de waarde van formula voor filters met een aangepaste expressie.| |formula|string|Door de gebruiker gedefinieerde expressie die moet worden gebruikt voor het evalueren van voorwaarden van filters met een aangepaste expressie. De expressie moet ID's bevatten die verwijzen naar specifieke filtervoorwaarden door middel van de formulaid. De ID's die in de expressie worden gebruikt, moeten exact overeenkomen met de ID's die zijn gedefinieerd in de filtervoorwaarden: geen enkele voorwaarde mag ongebruikt blijven of worden weggelaten.

Vereist voor aangepaste expressie filters.|

Actiefiltervoorwaarde

Het actiefiltervoorwaardeobject definieert een specifieke voorwaarde die: moet worden gecontroleerd voordat de actiebewerkingen worden uitgevoerd.

Property Type Beschrijving
conditionid string (alleen-lezen) ID van de actievoorwaarde.
conditiontype
(vereist)
geheel getal Type voorwaarde.

Mogelijke waarden voor triggeracties:
0 - hostgroep;
1 - host;
2 - trigger;
3 - triggernaam;
4 - ernst van trigger;
6 - tijdsperiode;
13 - hostsjabloon;
16 - probleem is onderdrukt;
25 - gebeurtenis tag;
26 - gebeurtenistagwaarde.

Mogelijke waarden voor ontdekkingsacties:
7 - host-IP;
8 - ontdekt servicetype;
9 - ontdekte servicepoort;< br>10 - ontdekkingsstatus;
11 - uptime of duur van downtime;
12 - ontvangen waarde;
18 - ontdekkingsregel;
19 - ontdekkingscontrole;
20 - proxy;<br >21 - discovery-object.

Mogelijke waarden voor automatische registratieacties:
20 - proxy;
22 - hostnaam;
24 - hostmetadata.

Mogelijke waarden voor interne acties:
0 - hostgroep;
1 - host;
13 - hostsjabloon;
23 - gebeurtenistype;
25 - gebeurtenistag;
26 - waarde van gebeurtenistag .

Mogelijke waarden voor serviceacties:
25 - gebeurtenistag;
26 - gebeurtenistagwaarde;
27 - service;<br >28 - servicenaam.
waarde
(verplicht)
string Waarde om mee te vergelijken.
value2
string Secundaire waarde om mee te vergelijken. Vereist voor trigger-, interne en serviceacties wanneer het conditietype 26 is.
actionid string (alleen-lezen) ID van de actie waartoe de voorwaarde behoort.
formulaid string Willekeurige unieke ID die wordt gebruikt om te verwijzen naar de voorwaarde vanuit een aangepaste expressie. Mag alleen hoofdletters bevatten. De ID moet door de gebruiker worden gedefinieerd bij het wijzigen van filtervoorwaarden, maar wordt opnieuw gegenereerd wanneer ze daarna worden aangevraagd.
operator geheel getal Conditie-operator.

Mogelijke waarden:
0 - (standaard) is gelijk aan;
1 - is niet gelijk aan;
2 - bevat;
3 - bevat niet;
4 - in;
5 - is groter dan of gelijk aan;
6 - is kleiner dan of gelijk aan;
7 - niet in;
8 - komt overeen;<br >9 - komt niet overeen;
10 - Ja;
11 - Nee.

Om beter te begrijpen hoe u filters kunt gebruiken met verschillende soorten uitdrukkingen, zie voorbeelden op de action.get en action.create methode Pagina's.

De volgende operatoren en waarden worden ondersteund voor elke voorwaarde: type.

|Voorwaarde|Voorwaarde naam|Ondersteunde operators|Verwachte waarde| |---------|--------------|-------------------|---- ----------| |0|Hostgroep|gelijk aan,
is niet gelijk aan|ID hostgroep.| |1|Host|is gelijk aan,
is niet gelijk aan|Host-ID.| |2|Trigger|is gelijk aan,
is niet gelijk aan|Trigger ID.| |3|Triggernaam|bevat,
bevat niet|Triggernaam.| |4|De ernst van de trigger|is gelijk aan,
is niet gelijk aan,
is groter dan of gelijk aan,
is kleiner dan of gelijk aan|De ernst van de trigger. Raadpleeg de trigger "severity" eigenschap voor een lijst met ondersteunde trigger-ernsten.| |5|Triggerwaarde|is gelijk aan|Triggerwaarde. Raadpleeg de eigenschap trigger "value" voor een lijst met ondersteunde triggerwaarden.| |6|Tijdsperiode|in, niet in|Tijd waarop de gebeurtenis werd geactiveerd als een tijdsperiode.| |7|Host IP|is gelijk aan,
is niet gelijk aan|Een of meerdere IP-bereiken om te controleren, gescheiden door komma's. Raadpleeg de sectie configuratie van netwerkdetectie voor meer informatie over ondersteunde indelingen van IP-bereiken.| |8|Ontdekt servicetype|gelijk aan,
is niet gelijk aan|Type ontdekte service. Het type service komt overeen met het type detectiecontrole dat wordt gebruikt om de service te detecteren. Raadpleeg de discovery check "type" eigenschap voor een lijst met ondersteunde typen.| |9|Ontdekte servicepoort|is gelijk aan,
is niet gelijk aan|Een of meerdere poortbereiken gescheiden door komma's.| |10|Ontdekkingsstatus|gelijk aan|Status van een ontdekt object.

Mogelijke waarden:
0 - host of service up;
1 - host of service down;
2 - host of service ontdekt;
3 - host of service verloren.| |11|Duur van uptime of downtime|is groter dan of gelijk aan,
is kleiner dan of gelijk aan|Tijd die aangeeft hoe lang het ontdekte object in de huidige status is in seconden.| |12|Ontvangen waarden|gelijk aan,
is niet gelijk aan,
is groter dan of gelijk aan,
is kleiner dan of gelijk aan,
bevat,
bevat niet|Waarde die wordt geretourneerd bij het uitvoeren van een Zabbix-agent, SNMPv1-, SNMPv2- of SNMPv3-detectiecontrole.| |13|Hostsjabloon|is gelijk aan,
is niet gelijk aan|Gekoppelde sjabloon-ID.| |16|Probleem is onderdrukt|Ja, Nee|Geen waarde vereist: het gebruik van de "Ja"-operator betekent dat het probleem moet worden onderdrukt, "Nee" - niet onderdrukt.| |18|Ontdekkingsregel|is gelijk aan,
is niet gelijk aan|ID van de ontdekkingsregel.| |19|Ontdekkingscontrole|is gelijk aan,
is niet gelijk aan|ID van de ontdekkingscontrole.| |20|Proxy|is gelijk aan,
is niet gelijk aan|ID van de proxy.| |21|Ontdekkingsobject|gelijk aan|Type object dat de ontdekkingsgebeurtenis heeft geactiveerd.

Mogelijke waarden:
1 - ontdekte host;
2 - ontdekte service.| |22|Hostnaam|bevat,
bevat niet,
komt overeen,
komt niet overeen|Hostnaam.
Het gebruik van een reguliere expressie wordt ondersteund voor operators komt overeen en komt niet overeen in autoregistratievoorwaarden.| |23|Gebeurtenistype|gelijk aan|Specifieke interne gebeurtenis.

Mogelijke waarden:
0 - item in "niet ondersteund" status;
1 - item in "normale" status;
2 - LLD-regel in "niet ondersteund" status;
3 - LLD-regel in "normale" status;
4 - trigger in "onbekende" status;
5 - trigger in "normale" status.| |24|Metadata host|bevat,
bevat niet,
komt overeen,
komt niet overeen|Metadata van de automatisch geregistreerde host.
Het gebruik van een reguliere expressie wordt ondersteund voor operators komt overeen en komt niet overeen.| |25|Tag|is gelijk aan,
is niet gelijk aan,
bevat,
bevat niet|Event-tag.| |26|Tagwaarde|is gelijk aan,
is niet gelijk aan,
bevat,
bevat niet|Gebeurtenistagwaarde.| |27|Service|gelijk aan,
is niet gelijk aan|Service-ID.| |28|Servicenaam|is gelijk aan,
is niet gelijk aan|Servicenaam.|