> Service-object

De volgende objecten zijn direct gerelateerd aan de service API.

Service

Het service-object heeft de volgende eigenschappen.

Eigenschap Type Omschrijving
serviceid string (alleen-lezen) ID van de service.
algorithm
(vereist)		 integer Regel voor statusberekening. Alleen van toepassing als er kindservices bestaan.

Mogelijke waarden:
0 - status instellen op OK;
1 - meest kritisch als alle kinderen problemen hebben;
2 - meest kritisch van kindservices.
name
(vereist)		 string Naam van de service.
sortorder
(vereist)		 integer Positie van de service die wordt gebruikt voor sortering.

Mogelijke waarden: 0-999.
weight integer Gewicht van de service.

Mogelijke waarden: 0-1000000.

Standaard: 0.
propagation_rule integer Regel voor statusverdeling. Moet samen met propagation_value worden ingesteld.

Mogelijke waarden:
0 - (standaard) propageer de status van de service zoals deze is - zonder wijzigingen;
1 - verhoog de gepropageerde status met een gegeven propagation_value (met 1 tot 5 ernstigheden);
2 - verlaag de gepropageerde status met een gegeven propagation_value (met 1 tot 5 ernstigheden);
3 - negeer deze service - de status wordt helemaal niet naar de bovenliggende service gepropageerd;
4 - stel een vaste service status in met behulp van een gegeven propagation_value.
propagation_value integer Waarde voor statusverdeling. Moet samen met propagation_rule worden ingesteld.

Mogelijke waarden voor propagation_rule met waarden 0 en 3: 0.

Mogelijke waarden voor propagation_rule met waarden 1 en 2: 1-5.

Mogelijke waarden voor propagation_rule met waarde 4:
-1 - OK;
0 - Niet geclassificeerd;
1 - Informatie;
2 - Waarschuwing;
3 - Gemiddeld;
4 - Hoog;
5 - Ramp.
status integer (alleen-lezen) Of de service zich in een OK- of probleemstaat bevindt.

Als de service zich in een probleemstaat bevindt, is status gelijk aan:
- de ernst van het ernstigste probleem;
- de hoogste status van een kindservice in een probleemstaat.

Als de service zich in een OK-staat bevindt, is status gelijk aan -1.
description string Beschrijving van de service.
uuid string Universele unieke identificatie. Voor updatebewerkingen is dit veld alleen-lezen.
created_at integer Unix-tijdstempel toen de service werd gemaakt.
readonly boolean (alleen-lezen) Toegang tot de service.

Mogelijke waarden:
0 - Lezen en schrijven;
1 - Alleen lezen.

Merk op dat voor sommige methoden (update, delete) de vereiste/optie parametercombinatie verschilt.

Status rule

The status rule object has the following properties.

Property Type Description
type
(required)		 integer Condition for setting (New status) status.

Possible values:
0 - if at least (N) child services have (Status) status or above;
1 - if at least (N%) of child services have (Status) status or above;
2 - if less than (N) child services have (Status) status or below;
3 - if less than (N%) of child services have (Status) status or below;
4 - if weight of child services with (Status) status or above is at least (W);
5 - if weight of child services with (Status) status or above is at least (N%);
6 - if weight of child services with (Status) status or below is less than (W);
7 - if weight of child services with (Status) status or below is less than (N%).

Where:
- N (W) is limit_value;
- (Status) is limit_status;
- (New status) is new_status.
limit_value
(required)		 integer Limit value.

Possible values:
- for N and W: 1-100000;
- for N%: 1-100.
limit_status
(required)		 integer Limit status.

Possible values:
-1 - OK;
0 - Not classified;
1 - Information;
2 - Warning;
3 - Average;
4 - High;
5 - Disaster.
new_status
(required)		 integer New status value.

Possible values:
0 - Not classified;
1 - Information;
2 - Warning;
3 - Average;
4 - High;
5 - Disaster.

Servicetag

Het servicetag-object heeft de volgende eigenschappen.

Eigendom Type Beschrijving
tag
(verplicht)		 tekenreeks Naam van servicetag.
waarde tekenreeks Waarde van servicetag.

Service alarm

Servicealarmen kunnen niet direct worden aangemaakt, bijgewerkt of verwijderd via de Zabbix API.

De service alarmobjecten vertegenwoordigen de statuswijziging van een service. Het heeft de volgende eigenschappen.

Eigendom Type Beschrijving
klok tijdstempel Tijdstip waarop de wijziging van de servicestatus heeft plaatsgevonden.
waarde geheel getal Status van de service.

Raadpleeg de servicestatuseigenschap voor een lijst met mogelijke waarden.

Probleemtag

Met probleemtags kunnen services worden gekoppeld aan probleemgebeurtenissen. De probleemtag object heeft de volgende eigenschappen.

Eigendom Type Beschrijving
tag
(verplicht)		 tekenreeks Naam van probleemtag.
operator geheel getal Toewijzingsvoorwaarde-operator.

Mogelijke waarden:
0 - (standaard) is gelijk aan;
2 - zoals.
waarde tekenreeks Waarde van probleemtag.