[comment]: # aside: 1
[comment]: # ({9e9adb41-b1a89f1b})
# Objeto de servicio
Los siguientes objetos están directamente relacionados con la API de `service`.
[comment]: # ({/9e9adb41-b1a89f1b})
[comment]: # ({64f35abb-5d7a3d70})
### Servicio
El objeto service tiene las siguientes propiedades.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|--|
|serviceid|ID|ID del service.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*
- *required* for update operations|
|algorithm|integer|Regla de cálculo del estado. Solo aplica si existen servicios hijos.
Valores posibles:
0 - establecer el estado en OK;
1 - el más crítico si todos los hijos tienen problemas;
2 - el más crítico de los servicios hijos.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|name|string|Nombre del service.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|sortorder|integer|Posición del service utilizada para la ordenación.
Valores posibles: 0-999.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* for create operations|
|weight|integer|Peso del service.
Valores posibles: 0-1000000.
Predeterminado: 0.|
|propagation\_rule|integer|Regla de propagación del estado.
Valores posibles:
0 - *(predeterminado)* propagar el estado del service tal cual, sin cambios;
1 - aumentar el estado propagado en un valor dado de `propagation_value` (de 1 a 5 severidades);
2 - disminuir el estado propagado en un valor dado de `propagation_value` (de 1 a 5 severidades);
3 - ignorar este service: el estado no se propaga al service padre en absoluto;
4 - establecer un estado fijo del service usando un valor dado de `propagation_value`.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* if `propagation_value` is set|
|propagation\_value|integer|Valor de propagación del estado.
Valores posibles si `propagation_rule` está establecido 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;
3 - Promedio;
4 - Alto;
5 - Desastre.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required* if `propagation_rule` is set|
|status|integer|Indica si el service está en estado OK o en estado de problema.
Si el service está en estado de problema, `status` es igual a la severidad del problema más crítico o al estado más alto de un service hijo en estado de problema.
Si el service está en estado OK, `status` es igual a: -1.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|description|string|Descripción del service.|
|uuid|string|Identificador único universal, usado para vincular los services importados con los ya existentes. Se genera automáticamente si no se proporciona.|
|created_at|integer|Marca de tiempo Unix cuando se creó el service.|
|readonly|integer|Acceso al service.
Valores posibles:
0 - Lectura y escritura;
1 - Solo lectura.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
[comment]: # ({/64f35abb-5d7a3d70})
[comment]: # ({dd16f497-c2041847})
### Regla de estado
El objeto de regla de estado tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|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](/manual/api/reference_commentary#property-behavior):
- *requerido*|
|limit\_value|integer|Valor límite.
Valores posibles:
- para N y W: 1-100000;
- para N%: 1-100.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference_commentary#property-behavior):
- *requerido*|
[comment]: # ({/dd16f497-c2041847})
[comment]: # ({72128b59-c301cfb2})
### Etiqueta de servicio
El objeto de etiqueta de servicio tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|tag|string|Nombre de la etiqueta de servicio.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido*|
|value|string|Valor de la etiqueta de servicio.|
[comment]: # ({/72128b59-c301cfb2})
[comment]: # ({92be70e8-e6daa7b4})
### Alarma de servicio
::: noteclassic
Las alarmas de servicio no se pueden crear, actualizar ni eliminar directamente a través de la API de Zabbix.
:::
Los objetos de alarma de servicio representan un cambio de estado de un servicio.
Tiene las siguientes propiedades.
|Property |[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|clock|timestamp|Momento en que se produjo el cambio de estado del servicio.|
|value|integer|Estado del servicio.
Consulte la [propiedad `status` del servicio](object#service) para obtener una lista de los valores posibles.|
[comment]: # ({/92be70e8-e6daa7b4})
[comment]: # ({88aae5fd-6b88d3dc})
### Etiqueta de problema
Las etiquetas de problema permiten vincular servicios con eventos de problema.
El objeto de etiqueta de problema tiene las siguientes propiedades.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|tag|string|Nombre de la etiqueta de problema.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|operator|integer|Operador de la condición de mapeo [operator](/manual/it_services/service_tree#service-configuration).
Valores posibles:
0 - *(default)* Igual a;
2 - Contiene.|
|value|string|Valor de la etiqueta de problema.|
[comment]: # ({/88aae5fd-6b88d3dc})