> SLA object

The following objects are directly related to the sla (Service Level Agreement) API.

SLA

The SLA object has the following properties.

PropertyTypeDescription
slaidstringID of the SLA.

Property behavior:
- read-only
- required for update operations
namestringName of the SLA.

Property behavior:
- required for create operations
periodintegerReporting period of the SLA.

Possible values:
0 - daily;
1 - weekly;
2 - monthly;
3 - quarterly;
4 - annually.

Property behavior:
- required for create operations
slofloatMinimum acceptable Service Level Objective expressed as a percent. If the Service Level Indicator (SLI) drops lower, the SLA is considered to be in problem/unfulfilled state.

Possible values: 0-100 (up to 4 fractional digits).

Property behavior:
- required for create operations
effective_dateintegerEffective date of the SLA.

Possible values: date timestamp in UTC.
timezonestringReporting time zone, for example: Europe/London, UTC.

For the full list of supported time zones please refer to PHP documentation.

Property behavior:
- required for create operations
statusintegerStatus of the SLA.

Possible values:
0 - (default) disabled SLA;
1 - enabled SLA.
descriptionstringDescription of the SLA.

SLA Schedule

The SLA schedule object defines periods where the connected service(s) are scheduled to be in working order. It has the following properties.

PropertyTypeDescription
period_fromintegerStarting time of the recurrent weekly period of time (inclusive).

Possible values: number of seconds (counting from Sunday).

Property behavior:
- required
period_tointegerEnding time of the recurrent weekly period of time (exclusive).

Possible values: number of seconds (counting from Sunday).

Property behavior:
- required

SLA excluded downtime

The excluded downtime object defines periods where the connected service(s) are scheduled to be out of working order, without affecting SLI, e.g., undergoing planned maintenance. It has the following properties.

PropertyTypeDescription
namestringName of the excluded downtime.

Property behavior:
- required
period_fromintegerStarting time of the excluded downtime (inclusive).

Possible values: timestamp.

Property behavior:
- required
period_tointegerEnding time of the excluded downtime (exclusive).

Possible values: timestamp.

Property behavior:
- required

SLA service tag

The SLA service tag object links services to include in the calculations for the SLA. It has the following properties.

PropertyTypeDescription
tagstringSLA service tag name.

Property behavior:
- required
operatorintegerSLA service tag operator.

Possible values:
0 - (default) equals;
2 - like
valuestringSLA service tag value.