Table of Contents
> IT Service object
The following objects are directly related to the service API.
IT Service
The IT service object has the following properties.
| Property | Type | Description |
|---|---|---|
| serviceid | string | (readonly) ID of the IT service. |
| algorithm (required) |
integer | Algorithm used to calculate the state of the IT service. Possible values: 0 - do not calculate; 1 - problem, if at least one child has a problem; 2 - problem, if all children have problems. |
| name (required) |
string | Name of the IT service. |
| showsla (required) |
integer | Whether SLA should be calculated. Possible values: 0 - do not calculate; 1 - calculate. |
| sortorder (required) |
integer | Position of the IT service used for sorting. |
| goodsla | float | Minimum acceptable SLA value. If the SLA drops lower, the IT service is considered to be in problem state. Default: 99.9. |
| status | integer | (readonly) Whether the IT service is in OK or problem state. If the IT service is in problem state, status is equal either to:- the priority of the linked trigger if it is set to 2, "Warning" or higher (priorities 0, "Not classified" and 1, "Information" are ignored); - the highest status of a child IT service in problem state. If the IT service is in OK state, status is equal to 0. |
| triggerid | string | Trigger associated with the IT service. Can only be set for IT services that don't have children. Default: 0 |
Service time
The service time object defines periods, when an IT service is scheduled to be up or down. It has the following properties.
| Property | Type | Description |
|---|---|---|
| timeid | string | (readonly) ID of the service time. |
| serviceid (required) |
string | ID of the IT service. Cannot be updated. |
| ts_from (required) |
integer | Time when the service time comes into effect. For onetime downtimes ts_from must be set as a Unix timestamp, for other types - as a specific time in a week, in seconds, for example, 90000 for Mon, 1:00 AM. |
| ts_to (required) |
integer | Time when the service time ends. For onetime uptimes ts_to must be set as a Unix timestamp, for other types - as a specific time in a week, in seconds, for example, 90000 for Mon, 1:00 AM. |
| type (required) |
integer | Service time type. Possible values: 0 - planned uptime, repeated every week; 1 - planned downtime, repeated every week; 2 - one-time downtime. |
| note | string | Additional information about the service time. |
Service dependency
The service dependency object represents a dependency between IT services. It has the following properties.
| Property | Type | Description |
|---|---|---|
| linkid | string | (readonly) ID of the service dependency. |
| servicedownid (required) |
string | ID of the IT service, that a service depends on, that is, the child service. An IT service can have multiple children. |
| serviceupid (required) |
string | ID of the IT service, that is dependent on a service, that is, the parent service. An IT service can have multiple parents forming a directed graph. |
| soft (required) |
integer | Type of dependency between IT services. Possible values: 0 - hard dependency; 1 - soft dependency. An IT service can have only one hard-dependent parent. This attribute has no effect on status or SLA calculation and is only used to create a core IT service tree. Additional parents can be added as soft dependencies forming a graph. An IT service can not be deleted if it has hard-dependent children. |
Service alarm
Service alarms cannot be directly created, updated or deleted via the Zabbix API.
The service alarm objects represents an IT service's state change. It has the following properties.
| Property | Type | Description |
|---|---|---|
| servicealarmid | string | ID of the service alarm. |
| serviceid | string | ID of the IT service. |
| clock | timestamp | Time when the IT service state change has happened. |
| value | integer | Status of the IT service. Refer the the IT service status property for a list of possible values. |