Objeto de servicio

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

Servicio

El objeto servicio tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
serviceid	ID	ID del servicio. Comportamiento de la propiedad: - solo lectura - requerido para operaciones de actualización
algorithm	integer	Regla de cálculo de estado. Solo aplicable si existen servicios hijos. Valores posibles: 0 - establecer estado en OK; 1 - más crítico si todos los hijos tienen problemas; 2 - más crítico de los servicios hijos. Comportamiento de la propiedad: - requerido para operaciones de creación
name	string	Nombre del servicio. Comportamiento de la propiedad: - requerido para operaciones de creación
sortorder	integer	Posición del servicio utilizada para ordenar. Valores posibles: 0-999. Comportamiento de la propiedad: - requerido para operaciones de creación
weight	integer	Peso del servicio. Valores posibles: 0-1000000. Por defecto: 0.
propagation_rule	integer	Regla de propagación de estado. Valores posibles: 0 - (por defecto) propagar el estado del servicio tal cual - sin cambios; 1 - aumentar el estado propagado por un `propagation_value` dado (de 1 a 5 niveles de severidad); 2 - disminuir el estado propagado por un `propagation_value` dado (de 1 a 5 niveles de severidad); 3 - ignorar este servicio - el estado no se propaga al servicio padre en absoluto; 4 - establecer un estado fijo del servicio usando un `propagation_value` dado. Comportamiento de la propiedad: - requerido si se establece `propagation_value`
propagation_value	integer	Valor de propagación de estado. Valores posibles si `propagation_rule` se establece en "0" o "3": 0 - No clasificado. Valores posibles si `propagation_rule` se establece en "1" o "2": 1 - Información; 2 - Advertencia; 3 - Media; 4 - Alta; 5 - Desastre. Valores posibles si `propagation_rule` se establece en "4": -1 - OK; 0 - No clasificado; 1 - Información; 2 - Advertencia; 3 - Media; 4 - Alta; 5 - Desastre. Comportamiento de la propiedad: - requerido si se establece `propagation_rule`
status	integer	Indica si el servicio está en estado OK o en estado de problema. Si el servicio está en estado de problema, `status` es igual a: - la severidad del problema más crítico; - el estado más alto de un servicio hijo en estado de problema. Si el servicio está en estado OK, `status` es igual a: -1. Comportamiento de la propiedad: - solo lectura
description	string	Descripción del servicio.
uuid	string	Identificador único universal, utilizado para vincular servicios importados a los ya existentes. Se genera automáticamente si no se proporciona.
created_at	integer	Marca de tiempo Unix cuando se creó el servicio.
readonly	boolean	Acceso al servicio. Valores posibles: 0 - Lectura-escritura; 1 - Solo lectura. Comportamiento de la propiedad: - solo lectura

Regla de estado

El objeto de regla de estado tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
type	integer	Condición para establecer el estado (Nuevo estado). Valores posibles: 0 - si al menos (N) servicios hijos tienen el estado (Estado) o superior; 1 - si al menos (N%) de los servicios hijos tienen el estado (Estado) o superior; 2 - si menos de (N) servicios hijos tienen el estado (Estado) o inferior; 3 - si menos de (N%) de los servicios hijos tienen el estado (Estado) o inferior; 4 - si el peso de los servicios hijos con el estado (Estado) o superior es al menos (W); 5 - si el peso de los servicios hijos con el estado (Estado) o superior es al menos (N%); 6 - si el peso de los servicios hijos con el estado (Estado) o inferior es menor que (W); 7 - si el peso de los servicios hijos con el estado (Estado) o inferior es menor que (N%). Donde: - N (W) es `limit_value`; - (Estado) es `limit_status`; - (Nuevo estado) es `new_status`. Comportamiento de la propiedad: - requerido
limit_value	integer	Valor límite. Valores posibles: - para N y W: 1-100000; - para N%: 1-100. Comportamiento de la propiedad: - requerido
limit_status	integer	Estado límite. Valores posibles: -1 - OK; 0 - No clasificado; 1 - Información; 2 - Advertencia; 3 - Media; 4 - Alta; 5 - Desastre. Comportamiento de la propiedad: - requerido
new_status	integer	Valor del nuevo estado. Valores posibles: 0 - No clasificado; 1 - Información; 2 - Advertencia; 3 - Media; 4 - Alta; 5 - Desastre. Comportamiento de la propiedad: - requerido

Etiqueta de servicio

El objeto de etiqueta de servicio tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
tag	string	Nombre de la etiqueta de servicio. Comportamiento de la propiedad: - requerido
value	string	Valor de la etiqueta de servicio.

Alarma de servicio

Las alarmas de servicio no pueden ser creadas, actualizadas o eliminadas directamente a través de la API de Zabbix.

Los objetos de alarma de servicio representan un cambio de estado de un servicio. Tienen las siguientes propiedades.

Propiedad	Tipo	Descripción
clock	timestamp	Hora en la que ocurrió el cambio de estado del servicio.
value	integer	Estado del servicio. Consulte la propiedad `status` del servicio para ver una lista de valores posibles.

Etiqueta de problema

Las etiquetas de problema permiten vincular servicios con eventos de problema. El objeto de etiqueta de problema tiene las siguientes propiedades.

Propiedad	Tipo	Descripción
tag	string	Nombre de la etiqueta de problema. Comportamiento de la propiedad: - obligatorio
operator	integer	Operador de condición de mapeo. Valores posibles: 0 - (por defecto) igual; 2 - similar.
value	string	Valor de la etiqueta de problema.

Documentation