附录 2。从 6.4 到 7.0 的变更

向后不兼容的更改

告警

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

认证

ZBXNEXT-8880 属性 http_auth_enabled、http_login_form、http_strip_domains、http_case_sensitive 仅在 安装（zabbix.conf.php）中启用了 $ALLOW_HTTP_AUTH 时才可用。

连接器

ZBXNEXT-8735 新增属性 item_value_type，当 data_type 设置为 "监控项值" 时支持该属性（0）。
ZBXNEXT-8735 新增属性 attempt_interval，当 max_attempts 大于 1 时支持该属性。

仪表盘

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

发现规则

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

事件

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

主机

ZBXNEXT-8758 如果将 monitored_by 设置为 "Proxy"，则现在 必须 使用 proxyid 属性；使用 proxyid 的 API 请求现在也必须使用 monitored_by。
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；现在每个参数将返回一个 array 类型的 objects，而不是一个 object。
ZBXNEXT-8702 hostgroup.get：将输出属性 hostPrototype 重命名为 hostPrototypes，discoveryRule 重命名为 discoveryRules，groupDiscovery 重命名为 groupDiscoveries。
ZBXNEXT-8702 hostgroup.get：移除了对 selectGroupDiscoveries（之前为 selectGroupDiscovery）参数中 groupid 属性的支持。

监控项

ZBXNEXT-7726 对于类型为“检查不支持的值”的预处理步骤，现在必须使用 params 属性。
ZBXNEXT-7578 item.get、item.create、item.update： headers 和 query_fields 属性从以名称索引的 object 更改为具有单独 name 和 value 属性的 array 的 objects。

监控项 原型

ZBXNEXT-7726 类型为“检查不支持的值”的预处理步骤现在必须包含 params 属性。
ZBXNEXT-7578 itemprototype.get、itemprototype.create、itemprototype.update：属性 headers 和 query_fields 从名称索引的 object 更改为包含单独的 name 和 value 属性的 array 的 objects。

问题

ZBXNEXT-6974 problem.get: 增加了对方法参数的严格校验。

Proxy 组

ZBXNEXT-8500 移除了 interface 和 auto_compress object 属性。
ZBXNEXT-8500 为被动 Zabbix proxies 添加了 address 和 port 属性。
ZBXNEXT-8500 将属性 host 重命名为 name，status 重命名为 operating_mode，proxy_address 重命名为 allowed_addresses。
ZBXNEXT-8500 修改了 operating_mode（之前为 status）属性的值（0 - 主动 proxy，1 - 被动 proxy）。
ZBXNEXT-8500 proxy.get：移除了对参数 selectInterface 的支持。
ZBXNEXT-8500 proxy.create 和 proxy.update：移除了对参数 interface 的支持。

脚本

ZBXNEXT-8880 script.create 和 script.update：仅当在 Zabbix server 上启用全局脚本执行时，才支持参数 execute_on 的值 "1"（在 Zabbix server 上的 run）。
ZBXNEXT-8121 script.getscriptsbyhosts：该方法不再接受 array 的 主机 ID 列表。现在接受包含以下参数的 object：hostid、scriptid、manualinput。
ZBXNEXT-8121 script.getscriptsbyevents：该方法不再接受 array 的事件 ID 列表。现在接受包含以下参数的 object：eventid、scriptid、manualinput。

任务

ZBXNEXT-8500 将属性 proxy_hostid 重命名为 proxyid。

模板仪表盘

ZBXNEXT-9044 修改了仪表板 widget 参数的取值范围：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-6524 在 operationtype 属性中新增了两个值的支持（13 - 添加 主机 标签，14 - 移除 主机 标签），并且为两种 eventsource 动作类型（1 - 发现，2 - 自动注册）新增了属性 optag，该属性仅在 operations 属性中可用。
ZBX-21850 action.get：过滤条件将按照其在公式中的排列顺序进行排序。

审计日志

ZBXNEXT-8541 新增了 审计日志 条目动作（12 - 推送）和资源类型（53 - 历史记录）。

认证

ZBXNEXT-6876 新增属性 mfa_status 和 mfaid。

多因素认证

ZBXNEXT-6876 添加了新的 MFA API，包含方法 mfa.create、mfa.update、mfa.get 和 mfa.delete。

仪表盘

ZBXNEXT-8956 在多个小部件中新增了仪表板小部件get字段 groupids._reference、hostids._reference、itemid._reference、graphid._reference、reference。
ZBXNEXT-9057 在systeminfo小部件中新增了仪表板小部件get字段 show_software_update_check_details。
ZBXNEXT-8686 新增了仪表盘部件类型 itemnavigator。
ZBXNEXT-8685 新增了仪表盘部件类型 hostnavigator。
ZBXNEXT-8683 新增了仪表盘部件类型 honeycomb。
ZBXNEXT-8907 在graph小部件中新增了仪表板小部件get字段 legend_lines_mode。
ZBXNEXT-8496 在item小部件中新增了仪表板小部件get字段 aggregate_function、history、time_period._reference、time_period.from、time_period.from。
ZBXNEXT-7736 在hostavail小部件中新增了仪表板小部件get字段 interface_type 的值（5 - Zabbix Agent（主动检查））。
ZBXNEXT-7736 在hostavail小部件中新增了仪表板小部件get字段 only_totals。
ZBXNEXT-7687 在tophosts小部件中新增了仪表板小部件get字段 maintenance。
ZBXNEXT-6974 新增了仪表盘部件类型 toptriggers。
ZBXNEXT-743 新增了仪表盘部件类型 gauge。
ZBXNEXT-8331、ZBXNEXT-8145、ZBXNEXT-8908、ZBXNEXT-8907 新增了仪表盘部件类型 piechart。
ZBXNEXT-8331 在graph小部件中新增了仪表板小部件get字段 legend_aggregation。
ZBXNEXT-8145 在svggraph、graph和graphprototype小部件中新增了仪表板小部件get字段 reference。
ZBXNEXT-8145 在actionlog、graph、graphprototype和toptriggers小部件中新增了仪表板小部件get字段 time_period._reference、time_period.from、time_period.to。

dcheck

ZBXNEXT-8079 添加了新属性 allow_redirect。

发现规则

ZBXNEXT-9150 添加了新的 LLD 规则 type（22 - 浏览器）。
ZBXNEXT-8645 添加了新的 lld-规则预处理 类型“SNMP get 值”（30）。
ZBXNEXT-8645 当 监控项 type 设置为“SNMP agent”（20）且 snmp_oid 以“get[”开头时，现在也支持属性 timeout。
ZBXNEXT-1096 当 监控项 type 设置为“Zabbix agent”（0）、“Simple check”（3）且 key_ 不以“vmware.”和“icmpping”开头、设置为“Zabbix agent (active)”（7）、“External check”（10）、“Database monitor”（11）、“SSH agent”（13）、“TELNET agent”（14）、“SNMP agent”（20）且 snmp_oid 以“walk[”开头时，现在支持属性 timeout。
ZBXNEXT-7726 添加了对 lld-规则预处理 类型“Matches regular expression”（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-2732 添加了新属性 concurrency_max。
ZBXNEXT-8500 将 proxy_hostid 重命名为 proxyid

事件

ZBXNEXT-6974 event.get：新增参数 selectAcknowledges、selectAlerts、trigger_severities 和 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 属性。

主机原型

ZBX-23284 hostprototype.get、hostprototype.update：返回对组原型 objects 的 group_prototypeid 属性的支持。

监控项

ZBXNEXT-9150 新增了 监控项type（22 - 浏览器）。
ZBXNEXT-7460 新增只读属性 name_resolved。
ZBXNEXT-8645 新增了 预处理 类型 "SNMP get 值"（30）。
ZBXNEXT-8645 当 监控项 type 设置为 "SNMP agent"（20）且 snmp_oid 以 "get[" 开头时，现在也支持属性 timeout。
ZBXNEXT-1096 当 监控项 type 设置为 "Zabbix agent"（0）、"Simple check"（3）且 key_ 不以 "vmware." 和 "icmpping" 开头时，现在支持属性 timeout；同时也支持 "Zabbix agent (active)"（7）、"External check"（10）、"Database monitor"（11）、"SSH agent"（13）、"TELNET agent"（14）、"SNMP agent"（20）且 snmp_oid 以 "walk[" 开头的情况。
ZBXNEXT-7726 在类型为 "Check for not supported value" 的步骤参数中新增了 scope 和 pattern 组件。
ZBXNEXT-7578 现在可以为 query_fields 属性存储更多数据，并允许 header 和 query_fields 条目重复出现。
ZBXNEXT-2020 item.get：如果使用 selectItemDiscovery 参数，方法现在也支持 status、ts_disable 和 disable_source 属性。

监控项 原型

ZBXNEXT-9150 新增了新的 监控项 原型 type（22 - 浏览器）。
ZBXNEXT-8645 新增了新的 监控项-原型预处理 类型“SNMP get 值”（30）。
ZBXNEXT-8645 当 监控项 type 设置为“SNMP agent”（20）并且 snmp_oid 以“get[”开头时，现在也支持属性 timeout。
ZBXNEXT-1096 当 监控项 type 设置为“Zabbix agent”（0）、“Simple check”（3）并且 key_ 不以“vmware.”和“icmpping”开头时，现在支持属性 timeout，同时也支持“Zabbix agent (active)”（7）、“External check”（10）、“Database monitor”（11）、“SSH agent”（13）、“TELNET agent”（14）、“SNMP agent”（20）并且 snmp_oid 以“walk[”开头的情况。
ZBXNEXT-7726 在“Check for not supported value”类型步骤的参数中新增了 scope 和 pattern 组件。
ZBXNEXT-7578 现在可以为 query_fields 属性存储更多数据，并允许重复的 header 和 query_fields 条目。

媒介类型

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。

相关性

ZBX-21850 correlation.get：筛选条件将按照其在公式中的排列顺序进行排序。

问题

ZBXNEXT-2299，ZBX-23240 problem.get：新增参数 action 和 action_userids。

Proxy 组

ZBXNEXT-9150 新增属性 timeout_browser。
ZBXNEXT-8758 新增只读属性 state。
ZBXNEXT-8758 proxy.get：新增参数 proxy_groupids、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 属性。

代理组

ZBXNEXT-8758 新增了新的 proxygroup API。

角色

ZBXNEXT-8758 新增了ui元素 administration.proxy_groups。

脚本

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。

模板仪表盘

ZBXNEXT-8686 新增了 模板仪表盘部件 类型 itemnavigator。
ZBXNEXT-8685 新增了 模板仪表盘部件 类型 hostnavigator。
ZBXNEXT-8683 新增了 模板仪表盘部件 类型 honeycomb。
ZBXNEXT-6974 新增了 模板仪表盘部件 类型 toptriggers。
ZBXNEXT-743 新增了 模板仪表盘部件 类型 gauge。
ZBXNEXT-8086 新增了 模板仪表盘部件 类型 actionlog、dataover、discovery、favgraphs、favmaps、hostavail、map、navtree、problemhosts、problems、problemsbysv、slareport、svggraph、systeminfo、tophosts、trigover、web。
ZBXNEXT-8086 新增了 template dashboard widget field 类型（8 - 地图，9 - 服务，10 - SLA，11 - 用户，12 - 动作，13 - 媒介类型）。
ZBXNEXT-8331 新增了 模板仪表盘部件 类型 piechart。

触发器

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。