> SLA-object

De volgende objecten zijn direct gerelateerd aan de sla (Service Level Agreement) API.

SLA

Het SLA-object heeft de volgende eigenschappen.

Eigenschap Type Beschrijving
slaid string (alleen-lezen) ID van het SLA.
name
(vereist)		 string Naam van het SLA.
period
(vereist)		 integer Rapporteringsperiode van het SLA.

Mogelijke waarden:
0 - dagelijks;
1 - wekelijks;
2 - maandelijks;
3 - kwartaal;
4 - jaarlijks.
slo
(vereist)		 float Minimum acceptabele Service Level Objective uitgedrukt als een percentage. Als de Service Level Indicator (SLI) lager wordt, wordt het SLA beschouwd als in een probleem/onvervulde staat.

Mogelijke waarden: 0-100 (maximaal 4 cijfers achter de komma).
effective_date integer Effectieve datum van het SLA.

Mogelijke waarden: datumtijdstempel in UTC.
timezone
(vereist)		 string Rapportagetijdzone, bijvoorbeeld: Europe/London, UTC.

Voor de volledige lijst met ondersteunde tijdzones verwijzen we naar de PHP-documentatie.
status integer Status van het SLA.

Mogelijke waarden:
0 - (standaard) uitgeschakeld SLA;
1 - ingeschakeld SLA.
description string Beschrijving van het SLA.

Merk op dat voor sommige methoden (bijwerken, verwijderen) de vereiste/optionele parametercombinatie anders is.

SLA-schema

Het SLA-planningsobject definieert perioden waarin de verbonden service(s) zijn gepland om in goede staat te zijn. Het heeft de volgende eigenschappen.

Eigendom Type Beschrijving
periode_vanaf
(verplicht)		 geheel getal Starttijd van de terugkerende wekelijkse periode (inclusief).

Mogelijke waarden: aantal seconden (te rekenen vanaf zondag).
periode_to
(verplicht)		 geheel getal Eindtijd van de terugkerende wekelijkse periode (exclusief).

Mogelijke waarden: aantal seconden (te rekenen vanaf zondag).

SLA uitgesloten downtime

Het uitgesloten downtime-object definieert perioden waarin de verbonden service(s) volgens de planning buiten werking zijn, zonder SLI te beïnvloeden, b.v. gepland onderhoud ondergaan.

Eigendom Type Beschrijving
naam
(verplicht)		 tekenreeks Naam van de uitgesloten uitvaltijd.
periode_vanaf
(verplicht)		 geheel getal Starttijd van de uitgesloten downtime (inclusief).

Mogelijke waarden: tijdstempel.
periode_to
(verplicht)		 geheel getal Eindtijd van de uitgesloten downtime (exclusief).

Mogelijke waarden: tijdstempel.

SLA-servicetag

Het SLA-servicetagobject koppelt services die moeten worden opgenomen in de berekeningen voor de SLA. Het heeft de volgende eigenschappen.

Eigendom Type Beschrijving
tag
(verplicht)		 tekenreeks Naam van SLA-servicetag.
operator geheel getal SLA-servicetag-operator.

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