Objeto acción

Los siguientes objetos están directamente relacionados con la API de acción.

Acción

El objeto acción tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
actionid	ID	ID de la acción. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de actualización
esc_period	string	Duración por defecto del paso de la operación. Debe ser al menos 60 segundos. Acepta segundos, unidad de tiempo con sufijo o una macro de usuario. Comportamiento de la propiedad: - soportado si `eventsource` está establecido en "evento creado por un disparador", "evento interno" o "evento creado en la actualización del estado del servicio"
eventsource	integer	Tipo de eventos que la acción gestionará. Consulte la propiedad `source` del evento para ver una lista de los tipos de eventos soportados. Comportamiento de la propiedad: - constante - requerido para operaciones de creación
name	string	Nombre de la acción. Comportamiento de la propiedad: - requerido para operaciones de creación
status	integer	Indica si la acción está habilitada o deshabilitada. Valores posibles: 0 - (por defecto) habilitada; 1 - deshabilitada.
pause_symptoms	integer	Indica si se debe pausar la escalada si el evento es un evento síntoma. Valores posibles: 0 - No pausar la escalada para problemas síntoma; 1 - (por defecto) Pausar la escalada para problemas síntoma. Comportamiento de la propiedad: - soportado si `eventsource` está establecido en "evento creado por un disparador"
pause_suppressed	integer	Indica si se debe pausar la escalada durante los periodos de mantenimiento o no. Valores posibles: 0 - No pausar la escalada; 1 - (por defecto) Pausar la escalada. Comportamiento de la propiedad: - soportado si `eventsource` está establecido en "evento creado por un disparador"
notify_if_canceled	integer	Indica si se debe notificar cuando la escalada es cancelada. Valores posibles: 0 - No notificar cuando la escalada es cancelada; 1 - (por defecto) Notificar cuando la escalada es cancelada. Comportamiento de la propiedad: - soportado si `eventsource` está establecido en "evento creado por un disparador"

Operación de acción

El objeto de operación de acción define una operación que se realizará cuando se ejecute una acción. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
operationtype	integer	Tipo de operación. Valores posibles: 0 - enviar mensaje; 1 - script global; 2 - añadir host; 3 - eliminar host; 4 - añadir a grupo de hosts; 5 - eliminar de grupo de hosts; 6 - enlazar template; 7 - desenlazar template; 8 - habilitar host; 9 - deshabilitar host; 10 - establecer modo de inventario del host; 13 - añadir etiquetas de host; 14 - eliminar etiquetas de host. Valores posibles si `eventsource` del objeto Acción está establecido en "evento creado por un trigger" o "evento creado en actualización de estado de servicio": 0 - "enviar mensaje"; 1 - "script global". Valores posibles si `eventsource` del objeto Acción está establecido en "evento interno": 0 - "enviar mensaje". Comportamiento de la propiedad: - requerido
esc_period	string	Duración de un paso de escalado en segundos. Debe ser mayor de 60 segundos. Acepta segundos, unidad de tiempo con sufijo o una macro de usuario. Si se establece en 0 o 0s, se utilizará el periodo de escalado de acción por defecto. Por defecto: 0s. Comportamiento de la propiedad: - soportado si `eventsource` del objeto Acción está establecido en "evento creado por un trigger", "evento interno" o "evento creado en actualización de estado de servicio"
esc_step_from	integer	Paso desde el que comenzar la escalada. Por defecto: 1. Comportamiento de la propiedad: - soportado si `eventsource` del objeto Acción está establecido en "evento creado por un trigger", "evento interno" o "evento creado en actualización de estado de servicio"
esc_step_to	integer	Paso en el que finalizar la escalada. Por defecto: 1. Comportamiento de la propiedad: - soportado si `eventsource` del objeto Acción está establecido en "evento creado por un trigger", "evento interno" o "evento creado en actualización de estado de servicio"
evaltype	integer	Método de evaluación de la condición de operación. Valores posibles: 0 - (por defecto) Y/O; 1 - Y; 2 - O.
opcommand	object	Script global a ejecutar. El script global debe tener definida la propiedad `scriptid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "script global"
opcommand_grp	array	Grupos de hosts en los que ejecutar scripts globales. Los grupos de hosts deben tener definida la propiedad `groupid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "script global" y `opcommand_hst` no está establecido
opcommand_hst	array	Host en los que ejecutar scripts globales. Los hosts deben tener definida la propiedad `hostid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "script global" y `opcommand_grp` no está establecido
opconditions	array	Condiciones de operación utilizadas para acciones de trigger. El objeto condición de operación se describe en detalle más abajo.
opgroup	array	Grupos de hosts a los que añadir hosts. Los grupos de hosts deben tener definida la propiedad `groupid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "añadir a grupo de hosts" o "eliminar de grupo de hosts"
opmessage	object	Objeto que contiene los datos sobre el mensaje enviado por la operación. El objeto mensaje de operación se describe en detalle más abajo. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje"
opmessage_grp	array	Grupos de usuarios a los que enviar mensajes. Los grupos de usuarios deben tener definida la propiedad `usrgrpid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje" y `opmessage_usr` no está establecido
opmessage_usr	array	Usuarios a los que enviar mensajes. Los usuarios deben tener definida la propiedad `userid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje" y `opmessage_grp` no está establecido
optemplate	array	Templates a enlazar a los hosts. Los templates deben tener definida la propiedad `templateid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enlazar template" o "desenlazar template"
opinventory	object	Modo de inventario al que establecer el host. El inventario debe tener definida la propiedad `inventory_mode`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "establecer modo de inventario del host"
optag	array	Etiquetas de host a añadir o eliminar. Las etiquetas deben tener definida la propiedad `tag`. La propiedad `value` es opcional. Comportamiento de la propiedad: - soportado si `operationtype` está establecido en "añadir etiquetas de host" o "eliminar etiquetas de host".

Mensaje de operación de acción

El objeto de mensaje de operación contiene datos sobre el mensaje que será enviado por la operación. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
default_msg	integer	Indica si se debe usar el texto y asunto de mensaje de acción por defecto. Valores posibles: 0 - usar los datos de la operación; 1 - (por defecto) usar los datos del tipo de medio.
mediatypeid	ID	ID del tipo de medio que se utilizará para enviar el mensaje. Comportamiento de la propiedad: - soportado si `operationtype` del Objeto de operación de acción, Objeto de operación de recuperación de acción, o Objeto de operación de actualización de acción está establecido en "enviar mensaje", o si `operationtype` del Objeto de operación de actualización de acción está establecido en "notificar a todos los involucrados"
message	string	Texto del mensaje de la operación. Comportamiento de la propiedad: - soportado si `default_msg` está establecido en "usar los datos de la operación"
subject	string	Asunto del mensaje de la operación. Comportamiento de la propiedad: - soportado si `default_msg` está establecido en "usar los datos de la operación"

Condición de operación de acción

El objeto de condición de operación de acción define una condición que debe cumplirse para realizar la operación actual. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
conditiontype	integer	Tipo de condición. Valores posibles: 14 - evento reconocido. Comportamiento de la propiedad: - requerido
value	string	Valor con el que comparar. Comportamiento de la propiedad: - requerido
operator	integer	Operador de condición. Valores posibles: 0 - (por defecto) =

Los siguientes operadores y valores son compatibles para cada tipo de condición de operación.

Condición	Nombre de la condición	Operadores soportados	Valor esperado
14	Evento reconocido	=	Si el evento está reconocido. Valores posibles: 0 - no reconocido; 1 - reconocido.

Operación de recuperación de acción

El objeto de operación de recuperación de acción define una operación que se realizará cuando se resuelva un problema. Las operaciones de recuperación son posibles solo para acciones de disparador, internas y de servicio. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
operationtype	integer	Tipo de operación. Valores posibles si `eventsource` del objeto Acción está establecido en "evento creado por un disparador" o "evento creado en la actualización del estado del servicio": 0 - enviar mensaje; 1 - script global; 11 - notificar a todos los involucrados. Valores posibles si `eventsource` del objeto Acción está establecido en "evento interno": 0 - enviar mensaje; 11 - notificar a todos los involucrados. Comportamiento de la propiedad: - requerido
opcommand	object	Script global a ejecutar. El script global debe tener definida la propiedad `scriptid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "script global"
opcommand_grp	array	Grupos de equipos en los que ejecutar scripts globales. Los grupos de equipos deben tener definida la propiedad `groupid`. Comportamiento de la propiedad: - requerido si `eventsource` del objeto Acción está establecido en "evento creado por un disparador", y `operationtype` está establecido en "script global", y `opcommand_hst` no está establecido
opcommand_hst	array	Equipo en el que ejecutar scripts globales. Los equipos deben tener definida la propiedad `hostid`. Comportamiento de la propiedad: - requerido si `eventsource` del objeto Acción está establecido en "evento creado por un disparador", y `operationtype` está establecido en "script global", y `opcommand_grp` no está establecido
opmessage	object	Objeto que contiene los datos sobre el mensaje enviado por la operación de recuperación. El objeto de mensaje de operación se describe en detalle arriba. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje"
opmessage_grp	array	Grupos de usuarios a los que enviar mensajes. Los grupos de usuarios deben tener definida la propiedad `usrgrpid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje" y `opmessage_usr` no está establecido
opmessage_usr	array	Usuarios a los que enviar mensajes. Los usuarios deben tener definida la propiedad `userid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje" y `opmessage_grp` no está establecido

Operación de actualización de acción

El objeto de operación de actualización de acción define una operación que se realizará cuando se actualice un problema (se comente, se reconozca, se cambie la gravedad o se cierre manualmente). Las operaciones de actualización son posibles solo para acciones de disparador y de servicio. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
operationtype	integer	Tipo de operación. Valores posibles: 0 - enviar mensaje; 1 - script global; 12 - notificar a todos los involucrados. Comportamiento de la propiedad: - requerido
opcommand	object	Script global a ejecutar. El script global debe tener definida la propiedad `scriptid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "script global"
opcommand_grp	array	Grupos de equipos en los que ejecutar scripts globales. Los grupos de equipos deben tener definida la propiedad `groupid`. Comportamiento de la propiedad: - requerido si `eventsource` del objeto Acción está establecido en "evento creado por un disparador", y `operationtype` está establecido en "script global", y `opcommand_hst` no está establecido
opcommand_hst	array	Equipo en el que ejecutar scripts globales. Los equipos deben tener definida la propiedad `hostid`. Comportamiento de la propiedad: - requerido si `eventsource` del objeto Acción está establecido en "evento creado por un disparador", y `operationtype` está establecido en "script global", y `opcommand_grp` no está establecido
opmessage	object	Objeto que contiene los datos sobre el mensaje enviado por la operación de actualización. El objeto de mensaje de operación se describe en detalle arriba.
opmessage_grp	array	Grupos de usuarios a los que enviar mensajes. Los grupos de usuarios deben tener definida la propiedad `usrgrpid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje" y `opmessage_usr` no está establecido
opmessage_usr	array	Usuarios a los que enviar mensajes. Los usuarios deben tener definida la propiedad `userid`. Comportamiento de la propiedad: - requerido si `operationtype` está establecido en "enviar mensaje" y `opmessage_grp` no está establecido

Filtro de acción

El objeto filtro de acción define un conjunto de condiciones que deben cumplirse para realizar las operaciones de acción configuradas. Tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
conditions	array	Conjunto de condiciones de filtro a utilizar para filtrar los resultados. Las condiciones se ordenarán en el orden de su colocación en la fórmula. Comportamiento de la propiedad: - obligatorio
evaltype	integer	Método de evaluación de la condición del filtro. Valores posibles: 0 - Y/O; 1 - Y; 2 - O; 3 - Expresión personalizada. Comportamiento de la propiedad: - obligatorio
eval_formula	string	Expresión generada que se utilizará para evaluar las condiciones del filtro. La expresión contiene IDs que hacen referencia a condiciones de filtro específicas por su `formulaid`. El valor de `eval_formula` es igual al valor de `formula` para los filtros con una expresión personalizada. Comportamiento de la propiedad: - sólo lectura
formula	string	Expresión definida por el usuario que se utilizará para evaluar las condiciones de los filtros con una expresión personalizada. La expresión debe contener IDs que hagan referencia a condiciones de filtro específicas por su `formulaid`. Los IDs utilizados en la expresión deben coincidir exactamente con los definidos en las condiciones del filtro: ninguna condición puede quedar sin usar u omitirse. Comportamiento de la propiedad: - obligatorio si `evaltype` está establecido en "expresión personalizada"

Condición de filtro de acción

El objeto de condición de filtro de acción define una condición específica que debe verificarse antes de ejecutar las operaciones de la acción.

Propiedad	Tipo	Descripción
conditiontype	integer	Tipo de condición. Valores posibles si `eventsource` del objeto Acción se establece en "evento creado por un trigger": 0 - grupo de hosts; 1 - host; 2 - trigger; 3 - nombre del evento; 4 - severidad del trigger; 6 - período de tiempo; 13 - template de host; 16 - el problema está suprimido; 25 - etiqueta del evento; 26 - valor de la etiqueta del evento. Valores posibles si `eventsource` del objeto Acción se establece en "evento creado por una regla de descubrimiento": 7 - IP del host; 8 - tipo de servicio descubierto; 9 - puerto del servicio descubierto; 10 - estado del descubrimiento; 11 - duración del tiempo de actividad o inactividad; 12 - valor recibido; 18 - regla de descubrimiento; 19 - comprobación de descubrimiento; 20 - proxy; 21 - objeto de descubrimiento. Valores posibles si `eventsource` del objeto Acción se establece en "evento creado por autoregistro activo del agent": 20 - proxy; 22 - nombre del host; 24 - metadatos del host. Valores posibles si `eventsource` del objeto Acción se establece en "evento interno": 0 - grupo de hosts; 1 - host; 13 - template de host; 23 - tipo de evento; 25 - etiqueta del evento; 26 - valor de la etiqueta del evento. Valores posibles si `eventsource` del objeto Acción se establece en "evento creado en la actualización del estado del servicio": 25 - etiqueta del evento; 26 - valor de la etiqueta del evento; 27 - servicio; 28 - nombre del servicio. Comportamiento de la propiedad: - requerido
value	string	Valor a comparar. Comportamiento de la propiedad: - requerido
value2	string	Valor secundario a comparar. Comportamiento de la propiedad: - requerido si `eventsource` del objeto Acción se establece en "evento creado por un trigger", `conditiontype` se establece en cualquier valor posible para acciones de trigger, y el tipo de condición (ver abajo) es "26" - requerido si `eventsource` del objeto Acción se establece en "evento interno", `conditiontype` se establece en cualquier valor posible para acciones internas, y el tipo de condición (ver abajo) es "26" - requerido si `eventsource` del objeto Acción se establece en "evento creado en la actualización del estado del servicio", `conditiontype` se establece en cualquier valor posible para acciones de servicio, y el tipo de condición (ver abajo) es "26"
formulaid	string	ID único arbitrario que se utiliza para hacer referencia a la condición desde una expresión personalizada. Solo puede contener letras mayúsculas. El ID debe ser definido por el usuario al modificar las condiciones del filtro, pero se generará uno nuevo al solicitarlas posteriormente.
operator	integer	Operador de la condición. Valores posibles: 0 - (por defecto) igual; 1 - no es igual; 2 - contiene; 3 - no contiene; 4 - en; 5 - es mayor o igual que; 6 - es menor o igual que; 7 - no en; 8 - coincide; 9 - no coincide; 10 - Sí; 11 - No.

Para comprender mejor cómo usar los filtros con varios tipos de expresiones, consulte los ejemplos en las páginas de los métodos action.get y action.create.

Los siguientes operadores y valores son compatibles para cada tipo de condición.

Condición	Nombre de la condición	Operadores soportados	Valor esperado
0	Grupo de hosts	igual, no es igual	ID del grupo de hosts.
1	Host	igual, no es igual	ID del host.
2	Trigger	igual, no es igual	ID del trigger.
3	Nombre del evento	contiene, no contiene	Nombre del evento.
4	Severidad del trigger	igual, no es igual, es mayor o igual que, es menor o igual que	Severidad del trigger. Consulte la propiedad `severity` del trigger para ver una lista de severidades de trigger soportadas.
5	Valor del trigger	igual	Valor del trigger. Consulte la propiedad `value` del trigger para ver una lista de valores de trigger soportados.
6	Período de tiempo	en, no en	Momento en que se activó el evento como período de tiempo.
7	IP del host	igual, no es igual	Uno o varios rangos de IP a comprobar, separados por comas. Consulte la sección de configuración de descubrimiento de red para obtener más información sobre los formatos soportados de rangos de IP.
8	Tipo de servicio descubierto	igual, no es igual	Tipo de servicio descubierto. El tipo de servicio coincide con el tipo de comprobación de descubrimiento utilizada para detectar el servicio. Consulte la propiedad `type` de la comprobación de descubrimiento para ver una lista de tipos soportados.
9	Puerto del servicio descubierto	igual, no es igual	Uno o varios rangos de puertos, separados por comas.
10	Estado del descubrimiento	igual	Estado de un objeto descubierto. Valores posibles: 0 - host o servicio activo; 1 - host o servicio inactivo; 2 - host o servicio descubierto; 3 - host o servicio perdido.
11	Duración del tiempo de actividad o inactividad	es mayor o igual que, es menor o igual que	Tiempo que indica cuánto tiempo ha estado el objeto descubierto en el estado actual en segundos.
12	Valores recibidos	igual, no es igual, es mayor o igual que, es menor o igual que, contiene, no contiene	Valor devuelto al realizar una comprobación de descubrimiento de agent Zabbix, SNMPv1, SNMPv2 o SNMPv3.
13	Template de host	igual, no es igual	ID del template vinculado.
16	El problema está suprimido	Sí, No	No se requiere valor: usar el operador "Sí" significa que el problema debe estar suprimido, "No" - no suprimido.
18	Regla de descubrimiento	igual, no es igual	ID de la regla de descubrimiento.
19	Comprobación de descubrimiento	igual, no es igual	ID de la comprobación de descubrimiento.
20	Proxy	igual, no es igual	ID del proxy.
21	Objeto de descubrimiento	igual	Tipo de objeto que activó el evento de descubrimiento. Valores posibles: 1 - host descubierto; 2 - servicio descubierto.
22	Nombre del host	contiene, no contiene, coincide, no coincide	Nombre del host. El uso de una expresión regular es compatible para los operadores coincide y no coincide en condiciones de autoregistro.
23	Tipo de evento	igual	Evento interno específico. Valores posibles: 0 - item en estado "no soportado"; 1 - item en estado "normal"; 2 - regla LLD en estado "no soportado"; 3 - regla LLD en estado "normal"; 4 - trigger en estado "desconocido"; 5 - trigger en estado "normal".
24	Metadatos del host	contiene, no contiene, coincide, no coincide	Metadatos del host autoregistrado. El uso de una expresión regular es compatible para los operadores coincide y no coincide.
25	Etiqueta	igual, no es igual, contiene, no contiene	Etiqueta del evento.
26	Valor de la etiqueta	igual, no es igual, contiene, no contiene	Valor de la etiqueta del evento.
27	Servicio	igual, no es igual	ID del servicio.
28	Nombre del servicio	igual, no es igual	Nombre del servicio.

Documentation