附录 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 时可用。

connector

ZBXNEXT-8735 新增了属性 item_value_type，当 data_type 设置为 "Item values" (0) 时支持该属性。
ZBXNEXT-8735 新增了属性 attempt_interval，当 max_attempts 大于 1 时支持该属性。

dashboard

ZBXNEXT-8316, ZBXNEXT-9193, ZBX-24488, ZBX-24490 将 dashboard widget 类型 plaintext 重命名为 itemhistory，并将其 dashboard widget 字段 itemids.0、style、show_as_html 替换为 columns.0.itemid、layout、columns.0.display，同时新增了新的 dashboard widget 字段。
ZBXNEXT-8496 在 tophosts widget 中，将 dashboard widget 字段 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 widget 中，将 dashboard widget 字段 unacknowledged 替换为两个新字段 acknowledgement_status 和 acknowledged_by_me。
ZBXNEXT-8245 删除了 clock 和 item widgets 中的 dashboard widget 字段 adv_conf。
ZBXNEXT-8145 更改了 dashboard widget 字段命名：复杂数据字段从 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 widget 中，将 dashboard widget 字段 filter_widget_reference 替换为 sysmapid._reference，并删除了字段 source_type。
ZBXNEXT-8145 在 gauge、graph、graphprototype、item、plaintext 和 url widgets 中，将 dashboard widget 字段 dynamic 替换为 override_hostid._reference。
ZBXNEXT-8145 在 svggraph widget 中，将 dashboard widget 字段 graph_time 替换为 time_period._reference，将 time_from 替换为 time_period.from，将 time_to 替换为 time_period.to。
ZBXNEXT-9044 更改了 dashboard widget 参数 x（从 0-23 改为 0-71）和 y（从 0-62 改为 0-63），以及 width（从 1-24 改为 1-72）和 height（从 2-32 改为 1-64）的取值范围。

discoveryrule

ZBXNEXT-7578 discoveryrule.get、discoveryrule.create、discoveryrule.update：属性 headers 和 query_fields 已从按名称索引的对象更改为对象数组，每个对象分别包含 name 和 value 属性。

event

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；现在每个参数将返回对象数组，而不是单个对象。
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 属性已从按名称索引的对象更改为对象数组，每个对象具有单独的 name 和 value 属性。

监控项原型

ZBXNEXT-7726 对于类型为“检查是否为不受支持的值”的预处理步骤，params 属性现在是必需的。
ZBXNEXT-7578 itemprototype.get、itemprototype.create、itemprototype.update：headers 和 query_fields 属性已从按名称索引的对象更改为对象数组，每个对象具有独立的 name 和 value 属性。

问题

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

proxy

ZBXNEXT-8500 删除了 interface 和 auto_compress 对象属性。
ZBXNEXT-8500 为被动 Zabbix proxy 添加了 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 和 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-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）的取值范围。

user

ZBXNEXT-8760 user.update: 将用户的属性 userdirectoryid 设为只读。
ZBXNEXT-8760 user.get: 为由 provision 操作创建的媒体新增只读属性 userdirectory_mediaid。

userdirectory

ZBXNEXT-8760 userdirectory.create, userdirectory.update：为媒体映射新增了属性 - active、severity、period。

用户组

ZBXNEXT-8760 usergroup.update：为已配置的用户新增了对组用户变更的限制。

其他变更和错误修复

action

ZBXNEXT-6524 在 operationtype 属性中新增支持两个值（13 - 添加主机标签，14 - 删除主机标签），并为两个 eventsource action 类型（1 - 发现，2 - 自动注册）新增 optag 属性，该属性仅在 operations 属性中可用。
ZBX-21850 action.get：过滤条件将按照它们在公式中的排列顺序进行排序。

auditlog

ZBXNEXT-8541 新增了新的 audit log 条目操作（12 - Push）和资源类型（53 - History）。

认证

ZBXNEXT-6876 新增了 mfa_status 和 mfaid 两个新属性。

多因素认证

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

仪表板

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

dcheck

ZBXNEXT-8079 新增了属性 allow_redirect。

discoveryrule

ZBXNEXT-9150 新增 LLD 规则 type（22 - Browser）。
ZBXNEXT-8645 新增 LLD 规则预处理 类型 “SNMP get value”（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：过滤条件将按其在公式中的位置顺序排序。

drule

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 - Browser）。
ZBXNEXT-7460 新增只读属性 name_resolved。
ZBXNEXT-8645 新增 监控项预处理 类型“SNMP get value”（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 为“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 - Browser）。
ZBXNEXT-8645 新增 监控项原型预处理 类型 "SNMP get value"（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 为类型为 "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 proxy 新增 address 和 port 属性。

proxygroup

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 新增 模板仪表板小部件字段 类型（8 - Map，9 - Service，10 - SLA，11 - User，12 - Action，13 - Media type）。
ZBXNEXT-8331 新增 模板仪表板小部件 类型 piechart。

触发器

ZBXNEXT-2020 trigger.get：如果使用 selectTriggerDiscovery 参数，该方法现在还支持 status、ts_disable 和 disable_source 属性。

user

ZBXNEXT-6876 新增了方法 user.resettotp。
ZBXNEXT-6876 user.login：如果使用 userData 参数，该方法现在还会返回 mfaid。

用户组

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