action.get

Beschrijving

integer/array action.get(object parameters)

De methode maakt het mogelijk om acties op te halen volgens de gegeven parameters.

Deze methode is beschikbaar voor gebruikers van elk type. Rechten om de methode aan te roepen, kunnen worden ingetrokken in de instellingen van de gebruikersrol. Zie Gebruiker rollen voor meer informatie.

Parameters

(object) Parameters die de gewenste uitvoer definiëren.

The method supports the following parameters.

Parameter	Type	Beschrijving
actionids	string/array	Geef alleen acties terug met de opgegeven ID's.
groupids	string/array	Geef alleen acties terug die de opgegeven hostgroepen gebruiken in actievoorwaarden.
hostids	string/array	Geef alleen acties terug die de opgegeven hosts gebruiken in actievoorwaarden.
triggerids	string/array	Geef alleen acties terug die de opgegeven triggers gebruiken in actievoorwaarden.
mediatypeids	string/array	Geef alleen acties terug die de opgegeven mediatypen gebruiken om berichten te verzenden.
usrgrpids	string/array	Geef alleen acties terug die geconfigureerd zijn om berichten naar de opgegeven gebruikersgroepen te sturen.
userids	string/array	Geef alleen acties terug die geconfigureerd zijn om berichten naar de opgegeven gebruikers te sturen.
scriptids	string/array	Geef alleen acties terug die geconfigureerd zijn om de opgegeven scripts uit te voeren.
selectFilter	query	Geef een filter eigenschap terug met de actievoorwaardenfilter.
selectOperations	query	Geef een operations eigenschap terug met actiebewerkingen.
selectRecoveryOperations	query	Geef een recovery_operations eigenschap terug met actieherstelbewerkingen.
selectUpdateOperations	query	Geef een update_operations eigenschap terug met actie-updatebewerkingen.
sortfield	string/array	Sorteer het resultaat op basis van de opgegeven eigenschappen. Mogelijke waarden zijn: `actionid`, `name` en `status`.
countOutput	boolean	Deze parameters, die gemeenschappelijk zijn voor alle `get`-methoden, worden beschreven in de referentiecommentaar.
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Retourwaarden

(integer/array) Retourneert ofwel:

een reeks objecten;
het aantal opgehaalde objecten, als de parameter countOutput heeft gebruikt.

Voorbeelden

Triggeracties ophalen

Alle geconfigureerde triggeracties ophalen samen met actievoorwaarden en operaties.

Verzoek:

{
           "jsonrpc": "2.0",
           "method": "action.get",
           "params": {
               "output": "extend",
               "selectOperations": "extend",
               "selectRecoveryOperations": "extend",
               "selectUpdateOperations": "extend",
               "selectFilter": "extend",
               "filter": {
                   "eventsource": 0
               }
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Antwoord:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "actionid": "3",
                   "name": "Meld problemen aan Zabbix-beheerders",
                   "eventsource": "0",
                   "status": "1",
                   "esc_period": "1u",
                   "pause_suppressed": "1",
                   "filter": {
                       "evaltype": "0",
                       "formula": "",
                       "condition": [],
                       "eval_formula": ""
                   },
                   "operations": [
                       {
                           "operationid": "3",
                           "actionid": "3",
                           "operationtype": "0",
                           "esc_periode": "0",
                           "esc_step_from": "1",
                           "esc_step_to": "1",
                           "evaltype": "0",
                           "opconditions": [],
                           "opmessage": [
                               {
                                   "default_msg": "1",
                                   "subject": "",
                                   "message": "",
                                   "mediatypeid" => "0"
                               }
                           ],
                           "opmessage_grp": [
                               {
                                   "usrgrpid": "7"
                               }
                           ]
                       }
                   ],
                   "recovery_operations": [
                       {
                           "operationid": "7",
                           "actionid": "3",
                           "operationtype": "11",
                           "evaltype": "0",
                           "opcondition": [],
                           "opmessage": {
                               "default_msg": "0",
                               "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}",
                               "message": "Trigger: {TRIGGER.NAME}\r\nTriggerstatus: {TRIGGER.STATUS}\r\nTrigger-ernst: {TRIGGER.SEVERITY}\r\nTrigger-URL: {TRIGGER.URL}\r\n\ r\nItemwaarden:\r\n\r\n1. {ITEM.NAME1} ({HOST.NAME1}:{ITEM.KEY1}): {ITEM.VALUE1}\r\n2. {ITEM.NAME2} ({ HOST.NAME2}:{ITEM.KEY2}): {ITEM.VALUE2}\r\n3 {ITEM.NAME3} ({HOST.NAME3}:{ITEM.KEY3}): {ITEM.VALUE3}\r\n \r\nOriginele gebeurtenis-ID: {EVENT.ID}",
                               "mediatypeid": "0"
                           }
                       }
                   ],
                   "update_operations": [
                       {
                           "operationid": "31",
                           "operationtype": "12",
                           "evaltype": "0",
                           "opmessage": {
                               "default_msg": "1",
                               "subject": "",
                               "message": "",
                               "mediatypeid": "0"
                           }
                       },
                       {
                           "operationid": "32",
                           "operationtype": "0",
                           "evaltype": "0",
                           "opmessage": {
                               "default_msg": "0",
                               "subject": "Bijgewerkt: {TRIGGER.NAME}",
                               "message": "{USER.FULLNAME} heeft het probleem bijgewerkt op {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} met het volgende bericht:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\ nHuidige probleemstatus is {EVENT.STATUS}",
                               "mediatypeid": "1"
                           },
                           "opmessage_grp": [
                               {
                                   "usrgrpid": "7"
                               }
                           ],
                           "opmessage_usr": []
                       },
                       {
                           "operationid": "33",
                           "operationtype": "1",
                           "evaltype": "0",
                           "opcommand": {
                               "scriptid": "3"
                           },
                           "opcommand_hst": [
                               {
                                   "hostid": "10084"
                               }
                           ],
                           "opcommand_grp": []
                       }
                   ]
               }
           ],
           "id": 1
       }

Ontdekkingsacties ophalen

Haal alle geconfigureerde ontdekkingsacties op samen met actie omstandigheden en operaties. Het filter gebruikt het evaluatietype "and", dus de eigenschap formula is leeg en eval_formula is gegenereerd automatisch.