附录 2. 从 6.4 到 7.0 的变化

向后不兼容的更改

告警

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

认证

ZBXNEXT-8880 如果在前端配置文件zabbix.conf.php)中启用了$ALLOW_HTTP_AUTH,则属性http_auth_enabledhttp_login_formhttp_strip_domainshttp_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.itemidlayoutcolumns.0.display替换了其仪表盘组件字段itemids.0styleshow_as_html,并添加了新的仪表盘组件字段。
ZBXNEXT-8496tophosts组件中,用columns.0.time_period._referencecolumns.0.time_period.fromcolumns.0.time_period.from替换了仪表盘组件字段columns.0.timeshiftcolumns.0.aggregate_interval
ZBXNEXT-2299problems组件中,用两个新字段acknowledgement_statusacknowledged_by_me替换了仪表盘组件字段unacknowledged
ZBXNEXT-8245clockitem组件中移除了仪表盘组件字段adv_conf
ZBXNEXT-8145 更改了仪表盘组件字段的命名:将复杂数据字段从str.str.index1.index2重命名为str.index1.str.index2(例如thresholds.0.threshold.1ds.0.hosts.1);将引用数据库对象的字段从str重命名为str.index1(例如itemid.0severities.0)。
ZBXNEXT-8145map组件中,用sysmapid._reference替换了仪表盘组件字段filter_widget_reference,并移除了字段source_type
ZBXNEXT-8145gaugegraphgraphprototypeitemplaintexturl组件中,用override_hostid._reference替换了仪表盘组件字段dynamic
ZBXNEXT-8145svggraph组件中,用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 删除 interfaceauto_compress 属性.
ZBXNEXT-8500 对被动模式Zabbix Proxies 添加 addressport 属性.
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.createscript.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: 名称索引中的属性 headersquery_fields 改为具有单独 namevalue属性的对象数组.

监控项原型

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

自动发现规则

ZBXNEXT-7578 discoveryrule.getdiscoveryrule.creatediscoveryrule.update:属性headersquery_fields从名称索引的对象更改为具有单独namevalue属性的对象数组。

其他更改和错误修复

动作

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

审计日志

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

认证

ZBXNEXT-6876 添加新的属性 mfa_statusmfaid.

关联

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

仪表盘

ZBXNEXT-8956 在多个小部件中新增仪表盘字段 groupids._reference, hostids._reference, itemid._reference, graphid._reference, reference.
ZBXNEXT-9057systeminfo 小部件中新增仪表盘字段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-7687TOP主机小部件中新增仪表盘字段 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 属性可以存储更多的信息, 有多个 headerquery_fields 实体.
ZBXNEXT-2020 新增属性 lifetime_type, enabled_lifetimeenabled_lifetime_type.
ZBXNEXT-2020lifetime 参数的默认值从 30d 改为 7d.
ZBX-21850 discoveryrule.get: 筛选条件将按其在公式中的位置顺序排序.

事件

ZBXNEXT-6974 event.get: 新增参数 selectAcknowledges, selectAlerts, trigger_severities, and groupBy.
ZBXNEXT-6974 event.get: 已废弃的参数 select_acknowledgesselect_alerts.
ZBXNEXT-2299, ZBX-23240 event.get: 新增参数 actionaction_userids.

图形

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

历史数据

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

主机

ZBXNEXT-8758 新增属性 monitored_byproxy_groupid.
ZBXNEXT-8758 新增只读属性 assigned_proxyid.
ZBXNEXT-8758 host.get: 新增参数 proxy_groupids.
ZBXNEXT-2020 host.get: 如果使用 selectHostDiscovery 参数,该方法支持 status, ts_disabledisable_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 属性可以存储更多的信息, 有多个 headerquery_fields 实体.
ZBXNEXT-2020 item.get: 如果使用 selectItemDiscovery 参数,该方法支持 status, ts_disabledisable_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 属性可以存储更多的信息, 有多个 headerquery_fields 实体.

问题

ZBXNEXT-2299, ZBX-23240 problem.get: 新增参数 actionaction_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_disabledisable_source 属性.

用户

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

用户组

ZBXNEXT-6876 新增属性 mfa_statusmfaid.
ZBXNEXT-6876 usergroup.get: 新增参数 mfa_statusmfaids.

proxy

ZBXNEXT-9150 新增属性 timeout_browser.
ZBXNEXT-8758 新增只读属性 state.
ZBXNEXT-8758 proxy.get: 新增参数 selectAssignedHostsselectProxyGroup.
ZBXNEXT-8758 proxy.get: selectHosts 参数支持 countZBXNEXT-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 增加 addressport 属性.

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