[comment]: # translation:outdated

[comment]: # ({286a8a1a-286a8a1a})
# Appendix 2. Changes from 3.4 to 4.0

[comment]: # ({/286a8a1a-286a8a1a})

[comment]: # ({d8f50a01-31b2151e})
## 附录2. 从3.4到4.0的变更

[comment]: # ({/d8f50a01-31b2151e})

[comment]: # ({31b2151e-5a1a8ace})
### Backward incompatible changes

[comment]: # ({/31b2151e-5a1a8ace})

[comment]: # ({new-03d104a9})
#### action

Changes:\
[ZBXNEXT-413](https://support.zabbix.com/browse/ZBXNEXT-413) renamed
property `maintenance_mode` to `pause_suppressed`.

[comment]: # ({/new-03d104a9})

[comment]: # ({f951edde-321e2e7a})
### 非向后兼容的变更

[comment]: # ({/f951edde-321e2e7a})

[comment]: # ({3810e15a-a61a80c7})
#### General

[comment]: # ({/3810e15a-a61a80c7})

[comment]: # ({f545b9b7-1eee7311})
#### 通用

Changes:\
[ZBXNEXT-4247](https://support.zabbix.com/browse/ZBXNEXT-4247) dropped
support of the deprecated methods `user.updateprofile`, `user.addmedia`,
`user.updatemedia`, `user.deletemedia`, `usergroup.massadd`,
`usergroup.massupdate` and `usermedia.get`\
[ZBXNEXT-4175](https://support.zabbix.com/browse/ZBXNEXT-4175) E-mail
values in API methods `user.get`, `user.create` and `user.update` are
represented as array if type of [Media
type](/manual/api/reference/mediatype/object#mediatype) is e-mail.\
变化:\
[ZBXNEXT-4247](https://support.zabbix.com/browse/ZBXNEXT-4247)
不再支持`user.updateprofile`, `user.addmedia`, `user.updatemedia`,
`user.deletemedia`, `usergroup.massadd`, `usergroup.massupdate` and
`usermedia.get` 这些已经弃用的方法。\
[ZBXNEXT-4175](https://support.zabbix.com/browse/ZBXNEXT-4175)
如果[Media
type](/manual/api/reference/mediatype/object#mediatype)为e-mail类型，则API方法中的E-mail值:
`user.get`, `user.create` 和 `user.update` 将以数组方式呈现。\

[comment]: # ({/f545b9b7-1eee7311})

[comment]: # ({3e73058c-fde4b63d})
#### dashboard

Changes:\
[ZBXNEXT-4516](https://support.zabbix.com/browse/ZBXNEXT-4516) 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`\

[comment]: # ({/3e73058c-fde4b63d})

[comment]: # ({c43e381c-5b2db1cc})
#### 仪表盘

变化:\
[ZBXNEXT-4516](https://support.zabbix.com/browse/ZBXNEXT-4516)
重命名了仪表盘小工具的类型： `actlog` => `actionlog`, `dscvry` =>
`discovery`, `favgrph` => `favgraphs`, `favmap` => `favmaps`,
`favscr` => `favscreens`, `hoststat` => `problemhosts`,
`navigationtree` => `navtree`, `stszbx` => `systeminfo`, `sysmap`
=> `map`, `syssum` => `problemsbysv` and `webovr` => `web`\

[comment]: # ({/c43e381c-5b2db1cc})

[comment]: # ({a61a80c7-ceb91440})
#### drule

Changes:\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) discovery rules
cannot be deleted when are used in actions\

[comment]: # ({/a61a80c7-ceb91440})

[comment]: # ({ba4af0af-2aa10a3f})
#### 发现规则

变化:\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783)
如果发现规则正在动作中使用，那么该规则将不能被删除\

[comment]: # ({/ba4af0af-2aa10a3f})

[comment]: # ({5b2db1cc-a27026ef})
### Other changes and bug fixes

[comment]: # ({/5b2db1cc-a27026ef})

[comment]: # ({1ce98599-e8dc57e8})
### 其他变更及Bug修复

[comment]: # ({/1ce98599-e8dc57e8})

[comment]: # ({aebd8363-06b1b8aa})
#### 通用

Changes:\
[ZBXNEXT-4426](https://support.zabbix.com/browse/ZBXNEXT-4426) added a
new task API introducing a new method `task.create`.\
[ZBXNEXT-4152](https://support.zabbix.com/browse/ZBXNEXT-4152) added
possibility to filter IDs by zero. For example: `host.get()` with option
`{"proxyids": [0]}` will return hosts monitored by server.\
变化:\
[ZBXNEXT-4426](https://support.zabbix.com/browse/ZBXNEXT-4426)
添加了一个新的任务API，引入了一个新方法：“task.create”。\
[ZBXNEXT-4152](https://support.zabbix.com/browse/ZBXNEXT-4152)
增加了通过 零 来过滤id的可能性。 例如: `host.get()` 中
`{"proxyids": [0]}`选项，将返回被zabbix server监控的主机。\

[comment]: # ({/aebd8363-06b1b8aa})

[comment]: # ({2aa10a3f-4e8b6a30})
#### apiinfo

Changes:\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) added strict
validation of input parameters for `version` method\

[comment]: # ({/2aa10a3f-4e8b6a30})

[comment]: # ({af267580-0c9e9b36})
#### api信息

变化:\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) 增加了对
“version” 方法输入参数的严格验证\

[comment]: # ({/af267580-0c9e9b36})

[comment]: # ({22f0427a-4f404cb9})
#### action

Changes:\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788) added
support for `not` operator in custom expression filter formula\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) added strict
validation of input parameters for `delete` method; added audit\

[comment]: # ({/22f0427a-4f404cb9})

[comment]: # ({0380a40c-c1530612})
#### 动作

变化:\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788)
在自定义表达式的筛选器公式中，增加了对“not”运算符的支持\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) 增加了对 “delete”
方法输入参数的严格验证；添加了审计\

[comment]: # ({/0380a40c-c1530612})

[comment]: # ({e8dc57e8-afb188c3})
#### correlation

Changes:\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788) added
support for `not` operator in custom expression filter formula\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) added strict
validation of input parameters for `delete` method; added audit\

[comment]: # ({/e8dc57e8-afb188c3})

[comment]: # ({4220b7e4-57fe9fd8})
#### 相互关系

变化:\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788)
在自定义表达式的筛选器公式中，增加了对“not”运算符的支持\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) 增加了对 “delete”
方法输入参数的严格验证；添加了审计\

[comment]: # ({/4220b7e4-57fe9fd8})

[comment]: # ({06b1b8aa-0e2b51a6})
#### discoveryrule

Changes:\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788) added
support for `not` operator in custom expression filter formula\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788) added
support of value `9` in the filter condition operator\

[comment]: # ({/06b1b8aa-0e2b51a6})

[comment]: # ({3f42365a-8e249146})
#### 发现规则

变化:\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788)
在自定义表达式的筛选器公式中，增加了对“not”运算符的支持\
[ZBXNEXT-2788](https://support.zabbix.com/browse/ZBXNEXT-2788)
在过滤条件运算符中,增加了数值“9”的支持\

[comment]: # ({/3f42365a-8e249146})

[comment]: # ({4e8b6a30-1229b83f})
#### drule

Changes:\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) added strict
validation of input parameters for `delete` method\

[comment]: # ({/4e8b6a30-1229b83f})

[comment]: # ({26e8f0a0-242c1d1b})
#### 发现规则

Changes:\
[ZBX-3783](https://support.zabbix.com/browse/ZBX-3783) 增加了对 “delete”
方法输入参数的严格验证\

[comment]: # ({/26e8f0a0-242c1d1b})

[comment]: # ({3e495608-32d63cff})
#### event

Changes:\
[ZBXNEXT-4118](https://support.zabbix.com/browse/ZBXNEXT-4118)
`event.get`: added a new property `evaltype` and extended `tags`
property to support new value "<​operator>"\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`event.get`: returns only problems and corresponding recovery events
that match the tag based permission filters\

[comment]: # ({/3e495608-32d63cff})

[comment]: # ({c0ba3fa0-4e2e0054})
#### 事件

变化:\
[ZBXNEXT-4118](https://support.zabbix.com/browse/ZBXNEXT-4118)
`event.get`: 新增 `evaltype` 属性，扩展 `tags` 属性以支持新的值
"<​operator>"\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`event.get`: 只返回与基于权限筛选器的标记匹配的问题和相应的恢复事件\

#### item

Changes:\
[ZBXNEXT-4358](https://support.zabbix.com/browse/ZBXNEXT-4358) added new
item type "HTTP agent".\

#### 监控项

变化:\
[ZBXNEXT-4358](https://support.zabbix.com/browse/ZBXNEXT-4358) 新增"HTTP
agent"监控项类型。\

#### itemprototype

Changes:\
[ZBXNEXT-4200](https://support.zabbix.com/browse/ZBXNEXT-4200)
`itemprototype.create`, `itemprototype.update`: added possibility to add
regular items and web items as master items in `master_itemid`
property.\

#### 监控项原型

Changes:\
[ZBXNEXT-4200](https://support.zabbix.com/browse/ZBXNEXT-4200)
`itemprototype.create`, `itemprototype.update`:
在`master_itemid`属性中，添加了常规监控项和web监控项作为主监控项的可能性。\

#### mediatype

Changes:\
[ZBXNEXT-4144](https://support.zabbix.com/browse/ZBXNEXT-4144) password
field for authentication type "Username and password" was made as
optional.\

#### 媒介类型

Changes:\
[ZBXNEXT-4144](https://support.zabbix.com/browse/ZBXNEXT-4144) 验证类型
"Username and password"中的password字段变为选填项。\

#### problem

Changes:\
[ZBXNEXT-4118](https://support.zabbix.com/browse/ZBXNEXT-4118)
`problem.get`: added a new property `evaltype` and extended `tags`
property to support new value "<​operator>"\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`problem.get`: returns only those events that match the tag based
permission filters\

#### 问题

变化:\
[ZBXNEXT-4118](https://support.zabbix.com/browse/ZBXNEXT-4118)
`problem.get`: 新增 `evaltype` 属性，扩展 `tags` 属性以支持新的值
"<​operator>"\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`problem.get`: 只返回与基于权限筛选器的标记匹配的事件\

#### proxy

Changes:\
[ZBXNEXT-4411](https://support.zabbix.com/browse/ZBXNEXT-4411) added a
new property `auto_compress`.\

#### 代理

变化:\
[ZBXNEXT-4411](https://support.zabbix.com/browse/ZBXNEXT-4411) 新增属性
`auto_compress`\

#### trigger

Changes:\
[ZBXNEXT-4357](https://support.zabbix.com/browse/ZBXNEXT-4357)
`trigger.get`: added a new `selectTriggerDiscovery` option that returns
the trigger discovery object in the `triggerDiscovery` property\

#### 触发器

变化:\
[ZBXNEXT-4357](https://support.zabbix.com/browse/ZBXNEXT-4357)
`trigger.get`: 新增 `selectTriggerDiscovery` 选项，
该选项返回在`triggerDiscovery`属性中的触发器发现对象\

#### usergroup

Changes:\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`usergroup.get`: added a new `selectTagFilters` option that returns the
array of the tag based permissions objects in the `tag_filters`
property\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`usergroup.create` and `usergroup.update`: added a new `tag_filters`
property\

#### 用户组

变化:\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`usergroup.get`: 新增 `selectTagFilters` 选项， 该选项返回 在
`tag_filters` 属性中，基于标签的权限对象数组\
[ZBXNEXT-4119](https://support.zabbix.com/browse/ZBXNEXT-4119)
`usergroup.create` and `usergroup.update`: 新增 `tag_filters` 属性\

[comment]: # ({/c0ba3fa0-4e2e0054})