[comment]: # translation:outdated

[comment]: # aside:1

[comment]: # ({9e9adb41-b1a89f1b})
# Obiekt usługi

Następujące obiekty są bezpośrednio powiązane z API `usługi`.

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

[comment]: # ({92b0166a-5d7a3d70})
### Usługa

Obiekt usługi ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|serviceid|ID|ID usługi.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*<br>- *wymagane* dla operacji aktualizacji|
|algorithm|integer|Reguła obliczania statusu. Ma zastosowanie tylko wtedy, gdy istnieją usługi podrzędne.<br><br>Możliwe wartości:<br>0 - ustaw status na OK;<br>1 - najbardziej krytyczny, jeśli wszystkie elementy podrzędne mają problemy;<br>2 - najbardziej krytyczny spośród usług podrzędnych.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|name|string|Nazwa usługi.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|sortorder|integer|Pozycja usługi używana do sortowania.<br><br>Możliwe wartości: 0-999.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane* dla operacji tworzenia|
|weight|integer|Waga usługi.<br><br>Możliwe wartości: 0-1000000.<br><br>Domyślnie: 0.|
|propagation\_rule|integer|Reguła propagacji statusu.<br><br>Możliwe wartości:<br>0 - *(domyślnie)* propaguj status usługi bez zmian;<br>1 - zwiększ propagowany status o podaną wartość `propagation_value` (o 1 do 5 poziomów ważności);<br>2 - zmniejsz propagowany status o podaną wartość `propagation_value` (o 1 do 5 poziomów ważności);<br>3 - ignoruj tę usługę - status w ogóle nie jest propagowany do usługi nadrzędnej;<br>4 - ustaw stały status usługi przy użyciu podanej wartości `propagation_value`.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli ustawiono `propagation_value`|
|propagation\_value|integer|Wartość propagacji statusu.<br><br>Możliwe wartości, jeśli `propagation_rule` jest ustawione na „0” lub „3”:<br>0 - Niesklasyfikowane.<br><br>Możliwe wartości, jeśli `propagation_rule` jest ustawione na „1” lub „2”:<br>1 - Informacja;<br>2 - Ostrzeżenie;<br>3 - Średni;<br>4 - Wysoki;<br>5 - Katastrofa.<br><br>Możliwe wartości, jeśli `propagation_rule` jest ustawione na „4”:<br>-1 - OK;<br>0 - Niesklasyfikowane;<br>1 - Informacja;<br>2 - Ostrzeżenie;<br>3 - Średni;<br>4 - Wysoki;<br>5 - Katastrofa.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*, jeśli ustawiono `propagation_rule`|
|status|integer|Określa, czy usługa jest w stanie OK, czy w stanie problemu.<br><br>Jeśli usługa jest w stanie problemu, `status` jest równy jednej z następujących wartości:<br>- ważności najbardziej krytycznego problemu;<br>- najwyższemu statusowi usługi podrzędnej będącej w stanie problemu.<br><br>Jeśli usługa jest w stanie OK, `status` jest równy: -1.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|
|description|string|Opis usługi.|
|uuid|string|Uniwersalny unikalny identyfikator używany do łączenia importowanych usług z już istniejącymi. Generowany automatycznie, jeśli nie został podany.|
|created_at|integer|Znacznik czasu Unix określający moment utworzenia usługi.|
|readonly|integer|Dostęp do usługi.<br><br>Możliwe wartości:<br>0 - Odczyt i zapis;<br>1 - Tylko do odczytu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *tylko do odczytu*|

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

[comment]: # ({dd16f497-c2041847})
### Reguła statusu

Obiekt reguły statusu ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|type|integer|Warunek ustawienia statusu (Nowy status).<br><br>Możliwe wartości:<br>0 - jeśli co najmniej (N) usług podrzędnych ma status (Status) lub wyższy;<br>1 - jeśli co najmniej (N%) usług podrzędnych ma status (Status) lub wyższy;<br>2 - jeśli mniej niż (N) usług podrzędnych ma status (Status) lub niższy;<br>3 - jeśli mniej niż (N%) usług podrzędnych ma status (Status) lub niższy;<br>4 - jeśli waga usług podrzędnych o statusie (Status) lub wyższym wynosi co najmniej (W);<br>5 - jeśli waga usług podrzędnych o statusie (Status) lub wyższym wynosi co najmniej (N%);<br>6 - jeśli waga usług podrzędnych o statusie (Status) lub niższym jest mniejsza niż (W);<br>7 - jeśli waga usług podrzędnych o statusie (Status) lub niższym jest mniejsza niż (N%).<br><br>Gdzie:<br>- N (W) to `limit_value`;<br>- (Status) to `limit_status`;<br>- (Nowy status) to `new_status`.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|limit\_value|integer|Wartość graniczna.<br><br>Możliwe wartości:<br>- dla N i W: 1-100000;<br>- dla N%: 1-100.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|limit\_status|integer|Status graniczny.<br><br>Możliwe wartości:<br>-1 - OK;<br>0 - Niesklasyfikowany;<br>1 - Informacja;<br>2 - Ostrzeżenie;<br>3 - Średni;<br>4 - Wysoki;<br>5 - Katastrofa.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|new\_status|integer|Wartość nowego statusu.<br><br>Możliwe wartości:<br>0 - Niesklasyfikowany;<br>1 - Informacja;<br>2 - Ostrzeżenie;<br>3 - Średni;<br>4 - Wysoki;<br>5 - Katastrofa.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|

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

[comment]: # ({72128b59-c301cfb2})
### Znacznik usługi

Obiekt znacznika usługi ma następujące właściwości.

|Właściwość|[Type](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|tag|string|Nazwa znacznika usługi.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|value|string|Wartość znacznika usługi.|

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

[comment]: # ({56809270-e6daa7b4})
### Alarm usługi

::: noteclassic
Alarmów usługi nie można bezpośrednio tworzyć, aktualizować ani usuwać za pomocą Zabbix API.
:::

Obiekty alarmu usługi reprezentują zmianę stanu usługi. Mają
następujące właściwości.

|Właściwość |[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|clock|timestamp|Czas wystąpienia zmiany stanu usługi.|
|value|integer|Status usługi.<br><br>Listę możliwych wartości można znaleźć we [właściwości `status` usługi](object#service).|

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

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

Znaczniki problemów umożliwiają powiązanie usług ze zdarzeniami problemów. Obiekt znacznika problemu
ma następujące właściwości.

|Właściwość|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|tag|string|Nazwa znacznika problemu.<br><br>[Zachowanie właściwości](/manual/api/reference_commentary#property-behavior):<br>- *wymagane*|
|operator|integer|Warunek mapowania [operator](/manual/it_services/service_tree#service-configuration).<br><br>Możliwe wartości:<br>0 - *(domyślnie)* Równa się;<br>2 - Zawiera.|
|value|string|Wartość znacznika problemu.|

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