附录 2. 从 6.4 到 7.0 的变化

向后不兼容的更改

告警

ZBXNEXT-6974 alert.get：增加了对该方法参数的严格验证。

认证

ZBXNEXT-8880 如果在前端配置文件（zabbix.conf.php）中启用了$ALLOW_HTTP_AUTH，则属性http_auth_enabled、http_login_form、http_strip_domains、http_case_sensitive才可用。

连接器

ZBXNEXT-8735 添加了新属性item_value_type，当data_type设置为“Item values”（0）时支持此属性。
ZBXNEXT-8735 添加了新属性attempt_interval，当max_attempts大于1时支持此属性。

仪表盘

ZBXNEXT-8316, ZBXNEXT-9193, ZBX-24488, ZBX-24490 将仪表盘组件类型plaintext重命名为itemhistory，并用columns.0.itemid、layout、columns.0.display替换了其仪表盘组件字段itemids.0、style、show_as_html，并添加了新的仪表盘组件字段。
ZBXNEXT-8496 在tophosts组件中，用columns.0.time_period._reference、columns.0.time_period.from、columns.0.time_period.from替换了仪表盘组件字段columns.0.timeshift、columns.0.aggregate_interval。
ZBXNEXT-2299 在problems组件中，用两个新字段acknowledgement_status和acknowledged_by_me替换了仪表盘组件字段unacknowledged。
ZBXNEXT-8245 在clock和item组件中移除了仪表盘组件字段adv_conf。
ZBXNEXT-8145 更改了仪表盘组件字段的命名：将复杂数据字段从str.str.index1.index2重命名为str.index1.str.index2（例如thresholds.0.threshold.1，ds.0.hosts.1）；将引用数据库对象的字段从str重命名为str.index1（例如itemid.0，severities.0）。
ZBXNEXT-8145 在map组件中，用sysmapid._reference替换了仪表盘组件字段filter_widget_reference，并移除了字段source_type。
ZBXNEXT-8145 在gauge、graph、graphprototype、item、plaintext和url组件中，用override_hostid._reference替换了仪表盘组件字段dynamic。
ZBXNEXT-8145 在svggraph组件中，用time_period._reference替换了仪表盘组件字段graph_time，用time_period.from替换了time_from，用time_period.to替换了time_to。
ZBXNEXT-9044 更改了仪表盘组件参数x（从0-23变为0-71）、y（从0-62变为0-63）、width（从1-24变为1-72）和height（从2-32变为1-64）的取值范围。

事件

ZBXNEXT-6974 event.get: 添加了对方法参数的严格验证.

主机

ZBXNEXT-5878 host.create, host.update, host.massAdd, host.massUpdate, host.massRemove: 添加了对 groups, macros, tags, templates 参数的严格验证. ZBXNEXT-8500 host.get: 不再支持参数 proxy_hosts.
ZBXNEXT-8500 属性 proxy_hostid 改为 proxyid.

主机组

ZBXNEXT-8702 hostgroup.get: 参数 selectHostPrototype 改为 selectHostPrototypes, selectDiscoveryRule 改为 selectDiscoveryRules, selectGroupDiscovery 改为 selectGroupDiscoveries; 现在每个参数将返回一个对象数组而不是一个对象.
ZBXNEXT-8702 hostgroup.get: 输出属性 hostPrototype 改为 hostPrototypes, discoveryRule 改为 discoveryRules, groupDiscovery 改为 groupDiscoveries.
ZBXNEXT-8702 hostgroup.get: 删除了 selectGroupDiscoveries (之前是- selectGroupDiscovery) 参数中 groupid 属性.

问题

ZBXNEXT-6974 problem.get: 添加了对方法参数的严格验证.

proxy

ZBXNEXT-8500 删除 interface 和auto_compress 属性.
ZBXNEXT-8500 对被动模式Zabbix Proxies 添加 address 和port 属性.
ZBXNEXT-8500 属性 host 改为 name, status 改为 operating_mode, proxy_address 改为 allowed_addresses.
ZBXNEXT-8500 修改了 operating_mode (之前- status) 属性值 (0 - active proxy, 1 - passive proxy) .
ZBXNEXT-8500 proxy.get: 不在支持参数 selectInterface.
ZBXNEXT-8500 proxy.create and proxy.update: 不在支持参数 interface.

脚本

ZBXNEXT-8880 script.create 和 script.update: 只有在 Zabbix 服务器上启用全局脚本执行时，才支持参数 execute_on 值 “1” (在 Zabbix 服务器上运行) .
ZBXNEXT-8121 script.getscriptsbyhosts: 方法不再接受主机 ID 数组。它现在接受带有以下参数的对象 hostid, scriptid, manualinput.
ZBXNEXT-8121 script.getscriptsbyevents: 方法不再接受事件 ID 数组。 它现在接受带有以下参数的对象 eventid, scriptid, manualinput.

监控项

ZBXNEXT-7726 现在 “检查不支持的值” 类型的预处理步骤 需要 属性 params.
ZBXNEXT-7578 item.get, item.create, item.update: 名称索引中的属性 headers 和query_fields 改为具有单独 name 和value属性的对象数组.

监控项原型

ZBXNEXT-7726 现在 “检查不支持的值” 类型的预处理步骤 需要 属性 params.
ZBXNEXT-7578 itemprototype.get, itemprototype.create, itemprototype.update: 名称索引中的属性 headers 和query_fields 改为具有单独 name 和value属性的对象数组.

自动发现规则

ZBXNEXT-7578 discoveryrule.get、discoveryrule.create、discoveryrule.update：属性headers和query_fields从名称索引的对象更改为具有单独name和value属性的对象数组。

其他更改和错误修复

动作

ZBXNEXT-6524 在 operationtype 属性中添加了两个新值 (13 - 添加主机标签, 14 - 删除主机标签) 并在 eventsource 两个动作类型 (1 - 自动发现, 2 - 自动注册)中添加新的属性 optag ，这个属性只支持 operations 属性.
ZBX-21850 action.get: 筛选条件将按其在公式中的位置顺序排序.

审计日志

ZBXNEXT-8541 添加新的 审计日志 实体动作 (12 - Push) 和资源类型 (53 - History).

认证

ZBXNEXT-6876 添加新的属性 mfa_status 和 mfaid.

关联

ZBX-21850 correlation.get: 筛选条件将按其在公式中的位置顺序排序.

仪表盘

ZBXNEXT-8956 在多个小部件中新增仪表盘字段 groupids._reference, hostids._reference, itemid._reference, graphid._reference, reference.
ZBXNEXT-9057 在 systeminfo 小部件中新增仪表盘字段show_software_update_check_details .
ZBXNEXT-8686 新增 监控项导航器 仪表盘小部件 .
ZBXNEXT-8685 新增 主机导航器 仪表盘小部件.
ZBXNEXT-8683 新增 蜂窝图 仪表盘小部件.
ZBXNEXT-8907 在 图形小部件中新增仪表盘字段 legend_lines_mode.
ZBXNEXT-8496 在 监控项值 小部件中新增仪表盘字段 aggregate_function, history, time_period._reference, time_period.from, time_period.from.
ZBXNEXT-7736 在 主机可用性 小部件中新增仪表盘字段 interface_type 的值 (5 - Zabbix Agent(主动式)) in.
ZBXNEXT-7736 在 主机可用性小部件中新增仪表盘字段 only_totals .
ZBXNEXT-7687 在 TOP主机小部件中新增仪表盘字段 maintenance.
ZBXNEXT-6974 新增 TOP触发器 仪表盘小部件.
ZBXNEXT-743 新增 表盘 仪表盘小部件 .
ZBXNEXT-8331, ZBXNEXT-8145, ZBXNEXT-8908, ZBXNEXT-8907 新增 饼图 仪表盘小部件 .
ZBXNEXT-8331 在 图形 小部件中新增仪表盘字段 legend_aggregation.
ZBXNEXT-8145 在 聚合图形, 图形, and 图形原型小部件新增仪表盘字段 reference.
ZBXNEXT-8145 在 动作日志, 图形, 图形原型, and TOP触发器小部件中新增仪表盘字段 time_period._reference, time_period.from, time_period.to .

dcheck

ZBXNEXT-8079 新增属性 allow_redirect.

自动发现规则

ZBXNEXT-9150 新增 LLD 规则 type (22 - Browser).
ZBXNEXT-8645 新增 LLD 规则预处理 类型 “SNMP get value” (30).
ZBXNEXT-8645 如果监控项 类型 是”SNMP agent” (20) 并且 snmp_oid 是以 “get[“ 开头，则支持 timeout参数.
ZBXNEXT-1096 如果监控项 类型 是 “Zabbix 客户端” (0), “简单检查” (3) 且 key_ 不是以 “vmware.开头， “icmpping“, “Zabbix 客户端 (主动式)” (7), “外部检查” (10), “数据库监控” (11), “SSH 客户端” (13), “TELNET 客户端” (14), “SNMP 代理” (20) 且 snmp_oid 是以 “walk[“开头, 则支持 timeout参数.
ZBXNEXT-7726 新增 LLD 规则预处理 类型 “匹配正则表达式” (14).
ZBXNEXT-6986 不推荐的方法 discoveryrule.copy.
ZBXNEXT-7578 现在 query_fields 属性可以存储更多的信息, 有多个 header 和 query_fields 实体.
ZBXNEXT-2020 新增属性 lifetime_type, enabled_lifetime 和 enabled_lifetime_type.
ZBXNEXT-2020 将 lifetime 参数的默认值从 30d 改为 7d.
ZBX-21850 discoveryrule.get: 筛选条件将按其在公式中的位置顺序排序.

事件

ZBXNEXT-6974 event.get: 新增参数 selectAcknowledges, selectAlerts, trigger_severities, and groupBy.
ZBXNEXT-6974 event.get: 已废弃的参数 select_acknowledges 和 select_alerts.
ZBXNEXT-2299, ZBX-23240 event.get: 新增参数 action 和 action_userids.

图形

ZBXNEXT-2020 graph.get: 如果使用 selectGraphDiscovery参数，该方法支持 status 属性.

历史数据

ZBXNEXT-9193 history.get: 参数 sortfield 支持 ns.
ZBXNEXT-8541 新增方法 history.push.

主机

ZBXNEXT-8758 新增属性 monitored_by 和 proxy_groupid.
ZBXNEXT-8758 新增只读属性 assigned_proxyid.
ZBXNEXT-8758 host.get: 新增参数 proxy_groupids.
ZBXNEXT-2020 host.get: 如果使用 selectHostDiscovery 参数，该方法支持 status, ts_disable 和 disable_source 属性.

主机组

ZBXNEXT-2020 hostgroup.get: 如果使用 selectGroupDiscoveries参数，该方法支持 status 属性.

媒介类型

ZBXNEXT-4165 mediatype.get: 新增参数 selectActions.
ZBXNEXT-9138 mediatype.get, mediatype.create, mediatype.update: 新增属性 message_format.
ZBXNEXT-9138 mediatype.get, mediatype.create, mediatype.update: 已废弃的属性 content_type.

多重身份验证mfa

ZBXNEXT-6876 新增 MFA API 方法 mfa.create, mfa.update, mfa.get, mfa.delete.

监控项

ZBXNEXT-9150 新增监控项 类型 (22 - 浏览器).
ZBXNEXT-7460 新增只读属性 name_resolved.
ZBXNEXT-8645 新增 监控项预处理 类型 “SNMP get value” (30).
ZBXNEXT-8645 如果监控项 类型 是”SNMP agent” (20) 并且 snmp_oid 是以 “get[“ 开头，则支持 timeout参数.
ZBXNEXT-1096 如果监控项 类型 是 “Zabbix 客户端” (0), “简单检查” (3) 且 key_ 不是以 “vmware.开头， “icmpping“, “Zabbix 客户端 (主动式)” (7), “外部检查” (10), “数据库监控” (11), “SSH 客户端” (13), “TELNET 客户端” (14), “SNMP 代理” (20) 且 snmp_oid 是以 “walk[“开头, 则支持 timeout参数.
ZBXNEXT-7726 对预处理步骤类型 “不支持监控项值检查” 增加 scope and pattern 参数.
ZBXNEXT-7578 现在 query_fields 属性可以存储更多的信息, 有多个 header 和 query_fields 实体.
ZBXNEXT-2020 item.get: 如果使用 selectItemDiscovery 参数，该方法支持 status, ts_disable 和 disable_source 属性.

监控项原型

ZBXNEXT-9150 新增监控项原型 类型 (22 - 浏览器).
ZBXNEXT-8645 新增 监控项原型预处理 类型 “SNMP get value” (30).
ZBXNEXT-8645 如果监控项 类型 是”SNMP agent” (20) 并且 snmp_oid 是以 “get[“ 开头，则支持 timeout参数.
ZBXNEXT-1096 如果监控项 类型 是 “Zabbix 客户端” (0), “简单检查” (3) 且 key_ 不是以 “vmware.开头， “icmpping“, “Zabbix 客户端 (主动式)” (7), “外部检查” (10), “数据库监控” (11), “SSH 客户端” (13), “TELNET 客户端” (14), “SNMP 代理” (20) 且 snmp_oid 是以 “walk[“开头, 则支持 timeout参数.
ZBXNEXT-7726 对预处理步骤类型 “不支持监控项值检查” 增加 scope and pattern 参数.
ZBXNEXT-7578 现在 query_fields 属性可以存储更多的信息, 有多个 header 和 query_fields 实体.

问题

ZBXNEXT-2299, ZBX-23240 problem.get: 新增参数 action 和 action_userids.

任务

ZBXNEXT-8500 属性 proxy_hostid 改为 proxyid.

模板仪表板

ZBXNEXT-9044 更改了仪表板小部件参数的值范围 x (从 0-23 到 0-71 ) 和 y (从0-62 到 0-63) 以及 width (从 1–24 到 1–72) 和 height (从 2–32 到 1–64).

用户

ZBXNEXT-8760 user.update: 属性 userdirectoryid 为只读.
ZBXNEXT-8760 user.get: 为预定义创建的媒介添加新的只读属性 userdirectory_mediaid .

用户目录

ZBXNEXT-8760 userdirectory.create, userdirectory.update: 媒介映射中添加新的属性 - active, severity, period.

用户组

ZBXNEXT-8760 usergroup.update: 添加了对已配置用户组的用户更改限制.

模板仪表盘

ZBXNEXT-8686 新增 模版仪表盘组件 类型 监控项导航器.
ZBXNEXT-8685 新增 模版仪表盘组件 类型 主机导航器.
ZBXNEXT-8683 新增 模版仪表盘组件 类型 蜂窝图.
ZBXNEXT-6974 新增 模版仪表盘组件 类型 TOP触发器.
ZBXNEXT-743 新增 模版仪表盘组件 类型 表盘.
ZBXNEXT-8086 新增 模版仪表盘组件 类型 actionlog, dataover, discovery, favgraphs, favmaps, hostavail, map, navtree, problemhosts, problems, problemsbysv, slareport, svggraph, systeminfo, tophosts, trigover, web.
ZBXNEXT-8086 新增 模版仪表盘组件字段 类型 (8 - Map, 9 - Service, 10 - SLA, 11 - User, 12 - Action, 13 - Media type).
ZBXNEXT-8331 新增 模版仪表盘组件 类型 饼图.

触发器

ZBXNEXT-2020 trigger.get: 如果使用 selectTriggerDiscovery参数，该方法支持 status, ts_disable 和 disable_source 属性.

用户

ZBXNEXT-6876 新增方法 user.resettotp.
ZBXNEXT-6876 user.login: 如果使用 userData 参数，该方法也将返回 mfaid .

用户组

ZBXNEXT-6876 新增属性 mfa_status 和 mfaid.
ZBXNEXT-6876 usergroup.get: 新增参数 mfa_status 和 mfaids.

proxy

ZBXNEXT-9150 新增属性 timeout_browser.
ZBXNEXT-8758 新增只读属性 state.
ZBXNEXT-8758 proxy.get: 新增参数 selectAssignedHosts 和 selectProxyGroup.
ZBXNEXT-8758 proxy.get: selectHosts 参数支持 count. ZBXNEXT-1096 新增属性 custom_timeouts, timeout_zabbix_agent, timeout_simple_check, timeout_snmp_agent, timeout_external_check, timeout_db_monitor, timeout_http_agent, timeout_ssh_agent, timeout_telnet_agent, timeout_script.
ZBXNEXT-8500 被动 Zabbix proxies 增加 address 和 port 属性.

proxygroup

ZBXNEXT-8758 新增 proxygroup API.

脚本

ZBXNEXT-8121 新增属性 manualinput, manualinput_prompt, manualinput_validator, manualinput_validator_type, manualinput_default_value.
ZBXNEXT-8121 script.execute: 新增参数 manualinput.

设置

ZBXNEXT-9150 新增属性 timeout_browser.
ZBXNEXT-8837 新增属性 auditlog_mode.
ZBXNEXT-1096 新增属性 timeout_zabbix_agent, timeout_simple_check, timeout_snmp_agent, timeout_external_check, timeout_db_monitor, timeout_http_agent, timeout_ssh_agent, timeout_telnet_agent, timeout_script.

drule

ZBXNEXT-2732 新增属性 concurrency_max.
ZBXNEXT-8500 proxy_hostid 改为 proxyid