[comment]: # aside: 1

[comment]: # translation:outdated

[comment]: # ({9e9adb41-b1a89f1b})
# Dienst-Objekt

Die folgenden Objekte stehen in direktem Zusammenhang mit der `service` API.

[comment]: # ({/9e9adb41-b1a89f1b})

[comment]: # ({92b0166a-5d7a3d70})
### Service

Das Service-Objekt hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|serviceid|ID|ID des Service.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*<br>- *erforderlich* für Aktualisierungsvorgänge|
|algorithm|integer|Regel zur Statusberechnung. Nur anwendbar, wenn untergeordnete Services vorhanden sind.<br><br>Mögliche Werte:<br>0 - Status auf OK setzen;<br>1 - kritischster Status, wenn alle untergeordneten Services Probleme haben;<br>2 - kritischster Status der untergeordneten Services.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|name|string|Name des Service.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|sortorder|integer|Position des Service, die für die Sortierung verwendet wird.<br><br>Mögliche Werte: 0-999.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich* für Erstellungsvorgänge|
|weight|integer|Gewichtung des Service.<br><br>Mögliche Werte: 0-1000000.<br><br>Standard: 0.|
|propagation\_rule|integer|Regel für die Statusweitergabe.<br><br>Mögliche Werte:<br>0 - *(Standard)* Service-Status unverändert weitergeben - ohne Änderungen;<br>1 - den weitergegebenen Status um den angegebenen `propagation_value` erhöhen (um 1 bis 5 Schweregrade);<br>2 - den weitergegebenen Status um den angegebenen `propagation_value` verringern (um 1 bis 5 Schweregrade);<br>3 - diesen Service ignorieren - der Status wird überhaupt nicht an den übergeordneten Service weitergegeben;<br>4 - festen Service-Status mit dem angegebenen `propagation_value` setzen.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `propagation_value` gesetzt ist|
|propagation\_value|integer|Wert für die Statusweitergabe.<br><br>Mögliche Werte, wenn `propagation_rule` auf "0" oder "3" gesetzt ist:<br>0 - Nicht klassifiziert.<br><br>Mögliche Werte, wenn `propagation_rule` auf "1" oder "2" gesetzt ist:<br>1 - Information;<br>2 - Warnung;<br>3 - Durchschnittlich;<br>4 - Hoch;<br>5 - Katastrophe.<br><br>Mögliche Werte, wenn `propagation_rule` auf "4" gesetzt ist:<br>-1 - OK;<br>0 - Nicht klassifiziert;<br>1 - Information;<br>2 - Warnung;<br>3 - Durchschnittlich;<br>4 - Hoch;<br>5 - Katastrophe.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*, wenn `propagation_rule` gesetzt ist|
|status|integer|Gibt an, ob sich der Service im Zustand OK oder Problem befindet.<br><br>Wenn sich der Service im Problemzustand befindet, ist `status` gleich:<br>- dem Schweregrad des kritischsten Problems;<br>- dem höchsten Status eines untergeordneten Service im Problemzustand.<br><br>Wenn sich der Service im Zustand OK befindet, ist `status` gleich: -1.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|
|description|string|Beschreibung des Service.|
|uuid|string|Universell eindeutige Kennung, die verwendet wird, um importierte Services mit bereits vorhandenen zu verknüpfen. Wird automatisch generiert, wenn sie nicht angegeben wird.|
|created_at|integer|Unix-Zeitstempel, wann der Service erstellt wurde.|
|readonly|integer|Zugriff auf den Service.<br><br>Mögliche Werte:<br>0 - Lesen und Schreiben;<br>1 - Schreibgeschützt.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *schreibgeschützt*|

[comment]: # ({/92b0166a-5d7a3d70})

[comment]: # ({dd16f497-c2041847})
### Statusregel

Das Statusregel-Objekt hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|type|integer|Bedingung zum Setzen des Status (Neuer Status).<br><br>Mögliche Werte:<br>0 - wenn mindestens (N) untergeordnete Services den Status (Status) oder höher haben;<br>1 - wenn mindestens (N%) der untergeordneten Services den Status (Status) oder höher haben;<br>2 - wenn weniger als (N) untergeordnete Services den Status (Status) oder niedriger haben;<br>3 - wenn weniger als (N%) der untergeordneten Services den Status (Status) oder niedriger haben;<br>4 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder höher mindestens (W) beträgt;<br>5 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder höher mindestens (N%) beträgt;<br>6 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder niedriger kleiner als (W) ist;<br>7 - wenn die Gewichtung der untergeordneten Services mit dem Status (Status) oder niedriger kleiner als (N%) ist.<br><br>Wobei:<br>- N (W) ist `limit_value`;<br>- (Status) ist `limit_status`;<br>- (Neuer Status) ist `new_status`.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|limit\_value|integer|Grenzwert.<br><br>Mögliche Werte:<br>- für N und W: 1-100000;<br>- für N%: 1-100.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|limit\_status|integer|Grenzstatus.<br><br>Mögliche Werte:<br>-1 - OK;<br>0 - Nicht klassifiziert;<br>1 - Information;<br>2 - Warnung;<br>3 - Durchschnittlich;<br>4 - Hoch;<br>5 - Katastrophe.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|new\_status|integer|Neuer Statuswert.<br><br>Mögliche Werte:<br>0 - Nicht klassifiziert;<br>1 - Information;<br>2 - Warnung;<br>3 - Durchschnittlich;<br>4 - Hoch;<br>5 - Katastrophe.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|

[comment]: # ({/dd16f497-c2041847})

[comment]: # ({72128b59-c301cfb2})
### Service-Tag

Das Service-Tag-Objekt hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|tag|string|Name des Service-Tags.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|value|string|Wert des Service-Tags.|

[comment]: # ({/72128b59-c301cfb2})

[comment]: # ({56809270-e6daa7b4})
### Service-Alarm

::: noteclassic
Service-Alarme können nicht direkt über die Zabbix API erstellt, aktualisiert oder gelöscht werden.
:::

Die Service-Alarm-Objekte stellen eine Zustandsänderung eines Service dar. Sie verfügen über die folgenden Eigenschaften.

|Eigenschaft |[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|clock|timestamp|Zeitpunkt, zu dem die Zustandsänderung des Service eingetreten ist.|
|value|integer|Status des Service.<br><br>Eine Liste der möglichen Werte finden Sie in der [`status`-Eigenschaft des Service](object#service).|

[comment]: # ({/56809270-e6daa7b4})

[comment]: # ({10d32ffb-6b88d3dc})
### Problem-Tag

Problem-Tags ermöglichen die Verknüpfung von Services mit Problemereignissen. Das Problem-Tag-Objekt hat die folgenden Eigenschaften.

|Eigenschaft|[Typ](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|tag|string|Name des Problem-Tags.<br><br>[Verhalten der Eigenschaft](/manual/api/reference_commentary#property-behavior):<br>- *erforderlich*|
|operator|integer|Zuordnungsbedingung [operator](/manual/it_services/service_tree#service-configuration).<br><br>Mögliche Werte:<br>0 - *(Standard)* Gleich;<br>2 - Enthält.|
|value|string|Wert des Problem-Tags.|

[comment]: # ({/10d32ffb-6b88d3dc})
