Se encuentra viendo la documentación de la versión en desarrollo, puede estar incompleta.
Únase a nuestro proyecto de traducción y ayude a traducir la documentación de Zabbix a su lengua materna.

> Objeto de servicio

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

Servicio

El objeto de servicio tiene las siguientes propiedades.

Propiedad Tipo Descripción
serviceid cadena ID del servicio.

Comportamiento de la propiedad:
- solo lectura
- obligatorio para operaciones de actualización
algorithm entero Regla de cálculo de estado. Solo se aplica si existen servicios para niños.

Valores posibles:
0: establece el estado en OK;
1: más crítico si todos los niños tienen problemas;
2: más crítico con los servicios para niños.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
name cadena Nombre del servicio.

Comportamiento de la propiedad:
- obligatorio para operaciones de creación
sortorder entero Posición del servicio utilizado para ordenar.

Valores posibles: 0-999.

Comportamiento de la propiedad:< br>- obligatorio para operaciones de creación
weight entero Peso del servicio.

Valores posibles: 0-1000000.

Predeterminado: 0.
propagation_rule entero Regla de propagación de estado.

Valores posibles:
0 - (predeterminado) propaga el estado del servicio tal cual, sin ningún cambio;
1 - aumenta el estado propagado en un valor_de_propagación determinado (de 1 a 5 grados de gravedad);
2: disminuye el estado propagado en un valor_de_propagación determinado (de 1 a 5 grados de gravedad);
3 - ignora este servicio: el estado no se propaga al servicio principal;
4 - establece el estado del servicio fijo usando un valor_de_propagación dado.

Comportamiento de la propiedad:
- obligatorio si se establece valor_propagación
propagation_value entero 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 está establecido en "1" o "2":
1 - Información;
2 - Advertencia;
3 - Promedio;
4 - Alto;
5 - Desastre.

Valores posibles si propagation_rule está establecido en "4":
-1 - OK;
0 - No clasificado;
1 - Información;
2 - Advertencia;< br>3 - Promedio;
4 - Alto;
5 - Desastre.

Comportamiento de la propiedad:
- obligatorio si se establece propagation_rule
status entero Si el servicio está en estado correcto o con problema.

Si el servicio está en estado de problema, status es igual a:
- la gravedad del problema más crítico;< br>- el estado más alto de un servicio secundario en estado problemático.

Si el servicio está en estado correcto, status es igual a: -1.

Comportamiento de propiedad:
- solo lectura
description cadena Descripción del servicio.
uuid cadena Identificador único universal, utilizado para vincular servicios importados con los ya existentes. Generado automáticamente, si no se proporciona.
created_at entero Marca de tiempo Unix cuando se creó el servicio.
readonly booleano Acceso al servicio.

Valores posibles:
0 - Lectura-escritura;
1 - Sólo 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 entero Condición para establecer el estado (Nuevo estado).

Valores posibles:
0 - si al menos (N) servicios secundarios tienen el estado (Estado) o superior;
1 - si al menos (N%) de los servicios para niños tienen el estado (Estado) o superior;
2 - si menos de (N) los servicios para niños tienen el estado (Estado) o inferior;
3 - si menos del (N%) de los servicios para niños tienen el estado (Estado) o inferior;
4 - si el peso de los servicios para niños con el estado (Estado) o superior es al menos (W);
5 - si el peso de los servicios para niños con el estado (Estado) o superior es al menos (N%);
6 - si el peso de los servicios para niños con estado (Estado) o inferior es menor que (W);
7 - si el peso de los servicios para niños con estado (Estado) o a continuación es menor que (N%).

Donde:
- N (W) es limit_value;
- (Estado) es limit_status;
- (Nuevo estado) es new_status.

Comportamiento de la propiedad:
- obligatorio
limit_value entero Valor límite.

Valores posibles:
- para N y W: 1-100000;
- para N%: 1-100.

Comportamiento de la propiedad:
- obligatorio
limit_status entero Estado del límite.

Valores posibles:
-1 - OK;
0 - No clasificado;
1 - Información;
2 - Advertencia;< br>3 - Promedio;
4 - Alto;
5 - Desastre.

Comportamiento de la propiedad:
- obligatorio
new_status entero Nuevo valor de estado.

Valores posibles:
0 - No clasificado;
1 - Información;
2 - Advertencia;
3 - Promedio;< br>4 - Alto;
5 - Desastre.

Comportamiento de la propiedad:
- obligatorio

Etiqueta de servicio

El objeto de etiqueta de servicio tiene las siguientes propiedades.

Propiedad Tipo Descripción
tag cadena Nombre de etiqueta de servicio.

Comportamiento de la propiedad:
- obligatorio
value cadena Valor de etiqueta de servicio.

Alarma de servicio

Las alarmas de servicio no se pueden crear, actualizar ni eliminar a través de la API de Zabbix.

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

Propiedad Tipo Descripción
clock marca de tiempo Hora en la que se produjo el cambio de estado del servicio.
value entero Estado del servicio.

Consulte la propiedad de estado del servicio para obtener una lista de valores posibles.

Etiqueta de problema

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

Propiedad Tipo Descripción
tag cadena Nombre de etiqueta del problema.

Comportamiento de la propiedad:
- obligatorio
operator entero Operador de condición de mapeo.

Valores posibles:
0 - (predeterminado) es igual;
2 - similar.
value cadena Valor de etiqueta de problema.