action.get

Descripción

integer/array action.get(object parameters)

El método permite recuperar acciones según los parámetros dados.

Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte Roles de usuario para más información.

Parámetros

(object) Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

Parámetro	Tipo	Descripción
actionids	ID/array	Devolver solo las acciones con los IDs indicados.
groupids	ID/array	Devolver solo las acciones que utilizan los grupos de equipos indicados en las condiciones de la acción.
hostids	ID/array	Devolver solo las acciones que utilizan los equipos indicados en las condiciones de la acción.
triggerids	ID/array	Devolver solo las acciones que utilizan los disparadores indicados en las condiciones de la acción.
mediatypeids	ID/array	Devolver solo las acciones que utilizan los tipos de medio indicados para enviar mensajes.
usrgrpids	ID/array	Devolver solo las acciones que están configuradas para enviar mensajes a los grupos de usuarios indicados.
userids	ID/array	Devolver solo las acciones que están configuradas para enviar mensajes a los usuarios indicados.
scriptids	ID/array	Devolver solo las acciones que están configuradas para ejecutar los scripts indicados.
selectFilter	query	Devolver una propiedad `filter` con el filtro de condiciones de la acción.
selectOperations	query	Devolver una propiedad `operations` con las operaciones de la acción.
selectRecoveryOperations	query	Devolver una propiedad `recovery_operations` con las operaciones de recuperación de la acción.
selectUpdateOperations	query	Devolver una propiedad `update_operations` con las operaciones de actualización de la acción.
sortfield	string/array	Ordenar el resultado por las propiedades indicadas. Valores posibles: `actionid`, `name`, `status`.
countOutput	boolean	Estos parámetros se describen en el comentario de referencia.
excludeSearch	boolean
filter	object
limit	integer
output	query
preservekeys	boolean
search	object
searchByAny	boolean
searchWildcardsEnabled	boolean
sortorder	string/array
startSearch	boolean

Valores de retorno

(integer/array) Devuelve:

un array de objetos;
el número de objetos recuperados, si se ha utilizado el parámetro countOutput.

Ejemplos

Recuperar acciones de disparadores

Recupera todas las acciones de disparadores configuradas junto con las condiciones de acción y operaciones.

Solicitud:

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

Respuesta:

{
           "jsonrpc": "2.0",
           "result": [
               {
                   "actionid": "3",
                   "name": "Reportar problemas a los administradores de 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": "Disparador: {TRIGGER.NAME}\r\nEstado del disparador: {TRIGGER.STATUS}\r\nSeveridad del disparador: {TRIGGER.SEVERITY}\r\nURL del disparador: {TRIGGER.URL}\r\n\r\nValores de las métricas:\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 del evento original: {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": "Actualizado: {TRIGGER.NAME}",
                               "message": "{USER.FULLNAME} actualizó el problema en {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME} con el siguiente mensaje:\r\n{EVENT.UPDATE.MESSAGE}\r\n\r\nEl estado actual del problema es {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
       }

Recuperar acciones de descubrimiento

Recupera todas las acciones de descubrimiento configuradas junto con las condiciones y operaciones de la acción. El filtro utiliza el tipo de evaluación "and", por lo que la propiedad formula está vacía y eval_formula se genera automáticamente.