Table of Contents
Appendix 2. Changes from 3.4 to 4.0
Backward incompatible changes
General
Changes:
dropped support of the deprecated methods user.updateprofile, user.addmedia, user.updatemedia, user.deletemedia, usergroup.massadd, usergroup.massupdate and usermedia.get
E-mail values in API methods user.get, user.create and user.update are represented as array if type of Media type is e-mail.
proxy.delete: proxies cannot be deleted when are used in actions
added more strict validation for JSON-RPC structure.
action
Changes:
renamed property maintenance_mode to pause_suppressed.
dashboard
Changes:
renamed dashboard widget types: actlog => actionlog, dscvry => discovery, favgrph => favgraphs, favmap => favmaps, favscr => favscreens, hoststat => problemhosts, navigationtree => navtree, stszbx => systeminfo, sysmap => map, syssum => problemsbysv and webovr => web
added new dashboard widget type: svggraph
drule
Changes:
discovery rules cannot be deleted when are used in actions
user
Changes:
user.login: password field is mandatory when HTTP authentication is enabled.
user.create: password field can be omitted if user belongs only to groups that have LDAP access.
user.update: password field can be empty string if user belongs only to groups that have LDAP access.
usergroup
Changes:
changed gui_access type 2 ? 3 - "disable access to the frontend".
added gui_access type 2 - "use LDAP authentication".
Other changes and bug fixes
General
Changes:
added a new task API introducing a new method task.create.
added possibility to filter IDs by zero. For example: host.get() with option {"proxyids": [0]} will return hosts monitored by server.
apiinfo
Changes:
added strict validation of input parameters for version method
action
Changes:
changed supported operators for action condition 16: 4 - "in" and 7 - "not in" to new ones 10 - "Yes" and 11 - "No".
added support for not operator in custom expression filter formula
added strict validation of input parameters for delete method; added audit
correlation
Changes:
added support for not operator in custom expression filter formula
added strict validation of input parameters for delete method; added audit
discoveryrule
Changes:
added support for not operator in custom expression filter formula
added support of value 9 in the filter condition operator
drule
Changes:
added strict validation of input parameters for delete method
event
Changes:
event.get: added new parameter suppressed.
event.get: added new parameter selectSuppressionData that returns list of maintenances in the suppression_data property.
event.get: added a new property evaltype and extended tags property to support new value "<?operator>"
event.get: returns only problems and corresponding recovery events that match the tag based permission filters
event.get: added new parameters problem_time_from and problem_time_till
hostprototype
hostprototype.create, hostprototype.update: added strict validation of input parameters and added audit.
item
Changes:
added new item type "HTTP agent".
itemprototype
Changes:
itemprototype.create, itemprototype.update: added possibility to add regular items and web items as master items in master_itemid property.
maintenance
Changes:
added new property tags_evaltype.
maintenance.create, maintenance.update: added new property tags.
maintenance.get: added new option selectTags that returns maintenance problem tags in the tags property.
map
Changes:
added new property show_suppressed.
mediatype
Changes:
password field for authentication type "Username and password" was made as optional.
problem
Changes:
problem.get: added new parameter suppressed.
problem.get: added new parameter selectSuppressionData that returns list of maintenances in the suppression_data property.
problem.get: added a new property evaltype and extended tags property to support new value "<?operator>"
problem.get: returns only those events that match the tag based permission filters
proxy
Changes:
added a new property auto_compress.
trigger
Changes:
trigger.get: added a new parameters evaltype and tags that allow to filter triggers by tags
trigger.get: added a new selectTriggerDiscovery option that returns the trigger discovery object in the triggerDiscovery property
usergroup
Changes:
usergroup.get: added a new selectTagFilters option that returns the array of the tag based permissions objects in the tag_filters property
usergroup.create and usergroup.update: added a new tag_filters property