[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]: # ({92b0166a-5d7a3d70})
### Servicio
El objeto servicio tiene las siguientes propiedades.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|serviceid|ID|ID del servicio.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *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 - el más crítico si todos los hijos tienen problemas;
2 - el más crítico de los servicios hijos.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* para operaciones de creación|
|name|string|Nombre del servicio.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *requerido* para operaciones de creación|
|sortorder|integer|Posición del servicio utilizada para ordenar.
Valores posibles: 0-999.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *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 de servicio usando un `propagation_value` dado.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference_commentary#property-behavior):
- *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](/manual/api/reference_commentary#property-behavior):
- *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|integer|Acceso al servicio.
Valores posibles:
0 - Lectura-escritura;
1 - Solo lectura.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *solo lectura*|
[comment]: # ({/92b0166a-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):
- *obligatorio*|
|value|string|Valor de la etiqueta de servicio.|
[comment]: # ({/72128b59-c301cfb2})
[comment]: # ({56809270-e6daa7b4})
### Alarma de servicio
::: noteclassic
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. Tiene las siguientes propiedades.
|Propiedad |[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|clock|timestamp|Hora en la que se produjo el cambio de estado del servicio.|
|value|integer|Estado del servicio.
Consulte la [propiedad `status` del servicio](object#service) para ver una lista de valores posibles.|
[comment]: # ({/56809270-e6daa7b4})
[comment]: # ({10d32ffb-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.
|Propiedad|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|tag|string|Nombre de la etiqueta de problema.
[Comportamiento de la propiedad](/manual/api/reference_commentary#property-behavior):
- *obligatorio*|
|operator|integer|[Operador](/manual/it_services/service_tree#service-configuration) de condición de mapeo.
Valores posibles:
0 - *(por defecto)* Igual;
2 - Contiene.|
|value|string|Valor de la etiqueta de problema.|
[comment]: # ({/10d32ffb-6b88d3dc})