action.get

Descrizione

integer/array action.get(object parameters)

Il metodo consente di recuperare azioni in base ai parametri specificati.

Questo metodo è disponibile per utenti di qualsiasi tipo. I permessi per chiamare il metodo possono essere revocati nelle impostazioni dei ruoli utente. Consultare Ruoli utente per ulteriori informazioni.

Parametri

(object) Parametri che definiscono l'output desiderato.

Il metodo supporta i seguenti parametri.

Parametro Tipo Descrizione
actionids ID/array Restituisce solo le azioni con gli ID specificati.
groupids ID/array Restituisce solo le azioni che utilizzano i gruppi di host specificati nelle condizioni dell'azione.
hostids ID/array Restituisce solo le azioni che utilizzano gli host specificati nelle condizioni dell'azione.
triggerids ID/array Restituisce solo le azioni che utilizzano i trigger specificati nelle condizioni dell'azione.
mediatypeids ID/array Restituisce solo le azioni che utilizzano i tipi di supporto specificati per inviare messaggi.
usrgrpids ID/array Restituisce solo le azioni configurate per inviare messaggi ai gruppi di utenti specificati.
userids ID/array Restituisce solo le azioni configurate per inviare messaggi agli utenti specificati.
scriptids ID/array Restituisce solo le azioni configurate per eseguire gli script specificati.
selectFilter query Restituisce una proprietà filter con il filtro delle condizioni dell'azione.
selectOperations query Restituisce una proprietà operations con le operazioni dell'azione.
selectRecoveryOperations query Restituisce una proprietà recovery_operations con le operazioni di ripristino dell'azione.
selectUpdateOperations query Restituisce una proprietà update_operations con le operazioni di aggiornamento dell'azione.
sortfield string/array Ordina il risultato in base alle proprietà specificate.

Valori possibili: actionid, name, status.
countOutput boolean Questi parametri sono descritti nel commento di riferimento.
excludeSearch boolean
filter object
limit integer
output query
preservekeys boolean
search object
searchByAny boolean
searchWildcardsEnabled boolean
sortorder string/array
startSearch boolean

Valori restituiti

(intero/array) Restituisce:

  • un array di oggetti;
  • il conteggio degli oggetti recuperati, se è stato utilizzato il parametro countOutput.

Esempi

Recuperare le azioni dei trigger

Recupera tutte le azioni dei trigger configurate insieme alle condizioni e alle operazioni dell'azione.

Richiesta:

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

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "actionid": "3",
            "name": "Segnala i problemi agli amministratori di Zabbix",
            "eventsource": "0",
            "status": "1",
            "esc_period": "1h",
            "pause_suppressed": "1",
            "filter": {
                "evaltype": "0",
                "formula": "",
                "conditions": [],
                "eval_formula": ""
            },
            "operations": [
                {
                    "operationid": "3",
                    "actionid": "3",
                    "operationtype": "0",
                    "esc_period": "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",
                    "opconditions": [],
                    "opmessage": {
                        "default_msg": "0",
                        "subject": "{TRIGGER.STATUS}: {TRIGGER.NAME}",
                        "message": "Trigger: {TRIGGER.NAME}\r\nStato del trigger: {TRIGGER.STATUS}\r\nGravità del trigger: {TRIGGER.SEVERITY}\r\nURL del trigger: {TRIGGER.URL}\r\n\r\nValori degli item:\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\nID evento originale: {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": "Aggiornato: {TRIGGER.NAME}",
                        "message": "{USER.FULLNAME} ha aggiornato il problema il {EVENT.UPDATE.DATE} alle {EVENT.UPDATE.TIME} con il seguente messaggio:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nLo stato attuale del problema è {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
}

Recuperare le azioni di discovery

Recupera tutte le azioni di discovery configurate insieme alle condizioni e alle operazioni dell'azione. Il filtro utilizza il tipo di valutazione "and", quindi la proprietà formula è vuota e eval_formula viene generata automaticamente.

Richiesta:

{
    "jsonrpc": "2.0",
    "method": "action.get",
    "params": {
        "output": "extend",
        "selectOperations": "extend",
        "selectFilter": "extend",
        "filter": {
            "eventsource": 1
        }
    },
    "id": 1
}

Risposta:

{
    "jsonrpc": "2.0",
    "result": [
        {
            "actionid": "2",
            "name": "Auto discovery. Linux servers.",
            "eventsource": "1",
            "status": "1",
            "esc_period": "0s",
            "pause_suppressed": "1",
            "filter": {
                "evaltype": "0",
                "formula": "",
                "conditions": [
                    {
                        "conditiontype": "10",
                        "operator": "0",
                        "value": "0",
                        "value2": "",
                        "formulaid": "B"
                    },
                    {
                        "conditiontype": "8",
                        "operator": "0",
                        "value": "9",
                        "value2": "",
                        "formulaid": "C"
                    },
                    {
                        "conditiontype": "12",
                        "operator": "2",
                        "value": "Linux",
                        "value2": "",
                        "formulaid": "A"
                    }
                ],
                "eval_formula": "A and B and C"
            },
            "operations": [
                {
                    "operationid": "1",
                    "actionid": "2",
                    "operationtype": "6",
                    "esc_period": "0s",
                    "esc_step_from": "1",
                    "esc_step_to": "1",
                    "evaltype": "0",
                    "opconditions": [],
                    "optemplate": [
                        {
                            "templateid": "10001"
                        }
                    ]
                },
                {
                    "operationid": "2",
                    "actionid": "2",
                    "operationtype": "4",
                    "esc_period": "0s",
                    "esc_step_from": "1",
                    "esc_step_to": "1",
                    "evaltype": "0",
                    "opconditions": [],
                    "opgroup": [
                        {
                            "groupid": "2"
                        }
                    ]
                }
            ]
        }
    ],
    "id": 1
}

Vedi anche

Sorgente

CAction::get() in ui/include/classes/api/services/CAction.php.