Table of Contents
Generic Zabbix API information
Setting Disable GUI access for a user group will also disable API access.
When performing an API request, a Content-Type: application/json header must be included. Otherwise, the request will fail with a 412 Precondition Failed status code.
Supported data types
The Zabbix API supports the following data types:
| Type | Description |
|---|---|
| bool | A boolean value, accepts either true or false. |
| flag | The value is considered to be true if it is passed and not equal to null and false otherwise. |
| integer | A whole number. |
| float | A floating point number. |
| string | A text string. |
| timestamp | A Unix timestamp |
| array | An ordered sequence of values, that is, a plain array. |
| object | An associative array. |
| query | A value which defines, what data should be returned. Can be defined as an array of property names to return only specific properties, or as one of the predefined values: shorten - returns just the primary key;refer - returns the primary key and the foreign keys used to link related objects;extend - returns all object properties;count - returns the number of retrieved records; supported only by certain subselects. |
Common "get" method parameters
The following parameters are supported by all get methods:
| Parameter | Type | Description |
|---|---|---|
| countOutput | flag | Return the number of records in the result instead of the actual data. |
| editable | boolean | If set to true return only objects that the user has write permissions to.Default: false. |
| excludeSearch | flag | Return results that do not match the criteria given in the search parameter. |
| filter | object | Return only those results that exactly match the given filter. Accepts an array, where the keys are property names, and the values are either a single value or an array of values to match against. |
| limit | integer | Limit the number of records returned. |
| nodeids | string/array | Returns objects that belong to the given nodes. |
| output | query | Object properties to be returned. Default: refer. |
| preservekeys | flag | Use IDs as keys in the resulting array. |
| search | object | Return results that match the given wildcard search. Accepts an array, where the keys are property names, and the values are strings to search for. If no additional options are given, this will perform a LIKE "%…%" search.Works only with text fields. |
| searchByAny | boolean | If set to true return results that match any of the criteria given in the filter or search parameter instead of all of them.Default: false. |
| searchWildcardsEnabled | boolean | If set to true enables the use of "*" as a wildcard character in the search parameter.Default: false. |
| sortfield | string/array | Sort the result by the given properties. Refer to a specific API get method description for a list of properties that can be used for sorting. Macros are not expanded before sorting. |
| sortorder | string/array | Order of sorting. If an array is passed, each value will be matched to the corresponding property given in the sortfield parameter.Possible values are: ASC - ascending;DESC - descending. |
| startSearch | flag | The search parameter will compare the beginning of fields, that is, perform a LIKE "…%" search instead. |