Table of Contents
> 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. |