[comment]: # translation:outdated [comment]: # ({402e95c5-402e95c5}) # 附录 2. 从 5.4 到 6.0 的变更 [comment]: # ({/402e95c5-402e95c5}) [comment]: # ({31b2151e-31b2151e}) ### 向后不兼容变更 [comment]: # ({/31b2151e-31b2151e}) [comment]: # ({ec310eaa-cc8baede}) #### 动作 变更:\ [ZBXNEXT-6920](https://support.zabbix.com/browse/ZBXNEXT-6920) `action.create`, `action.update`: 新增了对方法参数的严格验证.\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.create`, `action.update`: 将参数 `acknowledge_operations` 重命名为 `update_operations`.\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.get`: 将参数 `selectAcknowledgeOperations` 重命名为 `selectUpdateOperations`.\ [comment]: # ({/ec310eaa-cc8baede}) [comment]: # ({9ba4b0c4-9f13b7f1}) #### 审计日志 变更:\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) 移除了对属性 `note` 的支持.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) 移除了对 `resourcetype` 值的支持 *(2 - Zabbix配置, 7 - 图形元素)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) 移除了对 `action` 值的支持 *(5 - 启用, 6 - 禁用)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) 移除了对 `action` 值的支持 *(3 - 登录)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: 移除了参数 `selectDetails` 的支持.\ [comment]: # ({/9ba4b0c4-9f13b7f1}) [comment]: # ({5d54cfb5-557a8094}) #### 主机组 变更:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` 和 `templates` 字段现为必填项.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: 新增了对方法参数的严格验证.\ [comment]: # ({/5d54cfb5-557a8094}) [comment]: # ({50ccfbfe-01}) #### 主机原型 变更:\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: 移除了对组链接和组原型APIobjects的属性`group_prototypeid`、`hostid`、`templateid`的支持。\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: 移除了修改继承主机原型的只读字段`host`、`name`、`custom_interfaces`、`interfaces`、`groupLinks`、`groupPrototypes`、`templates`、`tags`、`macros`、`inventory_mode`的功能。\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`、`hostprototype.update`、`hostprototype.delete`: 新增了对方法参数的严格验证。 [comment]: # ({/50ccfbfe-01}) [comment]: # ({befc3fed-21320925}) #### 图标映射 变更:\ [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`、`iconmap.update`：移除了对图标映射object属性`sortorder`的支持。\ [comment]: # ({/befc3fed-21320925}) [comment]: # ({fec3bad5-fec3bad5}) #### 维护 变更:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: 新增了对方法参数的严格验证.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: 移除了对时间周期object参数`timeperiodid`的支持.\ [comment]: # ({/fec3bad5-fec3bad5}) [comment]: # ({917defbf-bd7e0bdb}) #### 媒介类型 变更:\ [ZBXNEXT-6885](https://support.zabbix.com/browse/ZBXNEXT-6885) `mediatype.create`, `mediatype.update`: 新增了对方法参数的严格验证.\ [comment]: # ({/917defbf-bd7e0bdb}) [comment]: # ({bb9db35d-9a279a07}) #### 角色 变更:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) 移除了对`action` object中`name`属性值`manage_services`的支持.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) 移除了对UI object中`name`属性值`configuration.services`的支持.\ [comment]: # ({/bb9db35d-9a279a07}) [comment]: # ({cb8fddf7-36a2d601}) #### 服务 变更:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 新增了 `uuid`、`description` 和 `created_at` 属性。\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 移除了对 `showsla`、`goodsla` 和 `times` 属性的支持。\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) 将 `status` 的值 "0" 的含义从 "OK" 改为 "未分类"。\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) 移除了对 `service.adddependencies`、`service.addtimes`、`service.deletedependencies`、`service.deletetimes` 的支持。\ [ZBXNEXT-6674](https://support.zabbix.com/browse/ZBXNEXT-6674) 移除了属性 `triggerid` 的支持。\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) `service.get`: 移除了对 `showsla`、`selectAlarms`、`selectTimes` 参数的支持。\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) `service.getsla`: 移除了对该方法的支持。\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 新增了 `sla.get`、`sla.create`、`sla.update`、`sla.delete`、`sla.getsli` 方法。\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) `service.get`: 新增了对按 `serviceid`、`status` 和 `created_at` 排序的支持。\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) `service.get`: 新增了对 `slaids` 参数的支持；新增了对按 `uuid` 过滤的支持。\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) `service.create`、`service.update`: 移除了对 `showsla`、`goodsla` 和 `times` 参数的支持。\ [ZBXNEXT-2406](https://support.zabbix.com/browse/ZBXNEXT-2406) `service.getsla`: 从带有 `intervals` 参数的请求响应中移除了 `status` 和 `problems` 属性。\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.create`、`service.update`: 移除了对 `dependencies` 和 `parentid` 参数的支持。\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.get`: 移除了对 `selectParent`、`selectDependencies` 和 `selectParentDependencies` 参数的支持。\ [ZBXNEXT-6674](https://support.zabbix.com/browse/ZBXNEXT-6674) `service.get`: 移除了对 `selectTrigger` 参数的支持。\ [comment]: # ({/cb8fddf7-36a2d601}) [comment]: # ({337a482a-337a482a}) #### 模板 变更:\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.create`, `template.update`, `template.delete`, `template.massadd`, `template.massupdate`, `template.massremove`: 新增了对方法参数的严格验证.\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.create`, `template.update`, `template.massadd`, `template.massupdate`: 移除了对参数 `hosts` 的支持.\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `template.massremove`: 移除了对参数 `hostids` 的支持. [comment]: # ({/337a482a-337a482a}) [comment]: # ({351260db-351260db}) #### 触发器 变更：\ [ZBXNEXT-6867](https://support.zabbix.com/browse/ZBXNEXT-6867) `trigger.adddependencies`、`trigger.deletedependencies`：移除了编辑继承触发器依赖项的功能。\ [comment]: # ({/351260db-351260db}) [comment]: # ({5b2db1cc-5b2db1cc}) ### 其他变更与缺陷修复 [comment]: # ({/5b2db1cc-5b2db1cc}) [comment]: # ({ba73508f-75116669}) #### 动作 变更:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) 新增了`conditiontype`值 *(27 - 服务, 28 - 服务名称)*.\ [ZBXNEXT-6250](https://support.zabbix.com/browse/ZBXNEXT-6250) `action.get`, `action.create`, `action.update`: 新增了属性 `notify_if_canceled`.\ [comment]: # ({/ba73508f-75116669}) [comment]: # ({f5721f7e-c868fc2e}) #### 审计日志 变更：\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 新增了 `resourcetype` *(48 - SLA)*。\ [ZBXNEXT-6923](https://support.zabbix.com/browse/ZBXNEXT-6923) 新增了 `resourcetype` *(47 - 高可用节点)*。\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) 新增了对 `action` 值的支持 *(8 - 登录, 9 - 失败的 login, 10 - 历史 clear)*。\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) 新增了对以下属性的支持：`username`, `recordsetid`, `details`。 [comment]: # ({/f5721f7e-c868fc2e}) [comment]: # ({aa153bdb-2d3f8080}) #### 认证 变更:\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) 新增了密码策略字段 `passwd_min_length` 和 `passwd_check_rules`。 [comment]: # ({/aa153bdb-2d3f8080}) [comment]: # ({2bdd1c6d-16cd9a71}) #### 仪表盘 变更:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 新增了部件类型 `slareport` 及部件字段类型 *(9 - 服务, 10 - SLA)*.\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) 新增了部件类型 `item`. [comment]: # ({/2bdd1c6d-16cd9a71}) [comment]: # ({86133a72-b3b51d85}) #### 历史数据 变更：\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) 新增了API方法`history.clear`。\ [comment]: # ({/86133a72-b3b51d85}) [comment]: # ({99eacf28-3ad70fa0}) #### 数据维护 变更内容：\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) 新增了对属性 `hk_events_service` 的支持。\ [comment]: # ({/99eacf28-3ad70fa0}) [comment]: # ({b601370c-12afe833}) #### 监控项 变更:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `item.get`, `item.create`, `item.update`: 为Prometheus模式预处理步骤添加了第三个参数。第二个参数现在将决定聚合方法: `value`, `label`, `function`。第三个参数现在将包含聚合方法`label`的Prometheus输出或聚合方法`function`的聚合函数。 [comment]: # ({/b601370c-12afe833}) [comment]: # ({895d835b-5de08e0e}) #### 监控项 原型 变更:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: 为Prometheus模式预处理步骤添加了第三个参数。第二个参数现在将决定聚合方法: `value`, `label`, `function`。第三个参数现在将包含聚合方法`label`的Prometheus输出或聚合方法`function`的聚合函数。 [comment]: # ({/895d835b-5de08e0e}) [comment]: # ({2c1ca1af-d6698491}) #### 维护 变更:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: 参数 `groupids` 现已弃用，请改用 `groups`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: 参数 `hostids` 现已弃用，请改用 `hosts`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: 将参数 `groups`, `hosts`, `timeperiods` 和 `tags` 的类型从 `array` 改为 `object/array`. [comment]: # ({/2c1ca1af-d6698491}) [comment]: # ({4463dd67-0a651238}) #### 媒介类型 变更:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) 消息模板 object: 新增支持 `conditiontype` 值: 4 - *(服务状态 update 时创建的事件)*. [comment]: # ({/4463dd67-0a651238}) [comment]: # ({bac21f1d-bb09f3ed}) #### Proxy 组 变更:\ [ZBXNEXT-6889](https://support.zabbix.com/browse/ZBXNEXT-6889) `proxy.create`、`proxy.update`: 移除了对 `interface.interfaceid` 和 `interface.hostid` 属性的支持。\ [comment]: # ({/bac21f1d-bb09f3ed}) [comment]: # ({0d52e83a-c455b580}) #### 正则表达式 变更:\ [ZBXNEXT-6717](https://support.zabbix.com/browse/ZBXNEXT-6717) 新增了 `regexp.get`、`regexp.create`、`regexp.update` 和 `regexp.delete` API。 [comment]: # ({/0d52e83a-c455b580}) [comment]: # ({2b7650ca-606378b1}) #### 角色 变更:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) 新增了对新属性 `services.read.mode`, `services.read.list`, `services.read.tag`, `services.write.mode`, `services.write.list` 和 `services.write.tag` 的支持.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) 在 `action` object 中为 `name` 属性新增了对值 `manage_services` 的支持.\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 在 `action` object 中为 `name` 属性新增了对值 `manage_sla` 的支持. [comment]: # ({/2b7650ca-606378b1}) [comment]: # ({709eb4ab-72cd06c4}) #### 服务 变更:\ [ZBXNEXT-6787](https://support.zabbix.com/browse/ZBXNEXT-6787) 新增属性 `readonly`.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) 新增对属性 `weight`、`propagation_rule` 和 `propagation_value` 的支持.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) 新增对 `status` 值 *(-1 - 正常)* 的支持.\ [ZBXNEXT-2406](https://support.zabbix.com/browse/ZBXNEXT-2406) `service.get`: 新增对参数 `deep_parentids` 和 `selectProblemEvents` 的支持.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.create`、`service.update`: 新增对参数 `status_rules` 的支持.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.get`: 新增对参数 `selectStatusRules` 的支持.\ [ZBXNEXT-6800](https://support.zabbix.com/browse/ZBXNEXT-6800) `service.get`: 为参数 `selectAlarms` 新增对 `count` 的支持.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.create`、`service.update`: 新增对参数 `children`、`parents` 和 `tags` 的支持.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.get`: 新增对参数 `evaltype`、`tags`、`selectChildren`、`selectParents`、`selectTags` 的支持.\ [ZBXNEXT-3022](https://support.zabbix.com/browse/ZBXNEXT-3022) `service.get`: 新增对参数 `problem_tags`、`without_problem_tags` 和 `selectProblemTags` 的支持.\ [ZBXNEXT-6674](https://support.zabbix.com/browse/ZBXNEXT-6674) `service.create`、`service.update`: 新增对参数 `problem_tags` 的支持. [comment]: # ({/709eb4ab-72cd06c4}) [comment]: # ({ea92df05-4a2a2476}) #### 设置 变更:\ [ZBXNEXT-6945](https://support.zabbix.com/browse/ZBXNEXT-6945) `settings.get`, `settings.update`: 新增对参数 `geomaps_tile_provider`, `geomaps_tile_url`, `geomaps_max_zoom` 和 `geomaps_attribution` 的支持.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `settings.get`, `settings.update`: 新增对参数 `auditlog_enabled` 的支持.\ [comment]: # ({/ea92df05-4a2a2476}) [comment]: # ({e45a1835-e9fad123}) #### SLA 变更:\ [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) 新增了 API `sla`，包含以下方法: `sla.create`, `sla.delete`, `sla.get`, `sla.getsli`, `sla.update`. [comment]: # ({/e45a1835-e9fad123}) [comment]: # ({fc7038c4-fc7038c4}) #### 模板仪表盘 变更：\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) 新增了对新部件类型 `item` 的支持。 [comment]: # ({/fc7038c4-fc7038c4}) [comment]: # ({887cfd26-86a00e40}) #### 用户 变更:\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) 新增方法 `user.unblock`.\ [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) `user.create`, `user.update`: 根据密码策略实现了密码强度验证.\ [comment]: # ({/887cfd26-86a00e40}) [comment]: # ({0712ac33-5b47f8b9}) #### 用户组 变更:\ [ZBXNEXT-6866](https://support.zabbix.com/browse/ZBXNEXT-6866) `usergroup.create`、`usergroup.update`: `userids` 参数现已弃用。请改用 `users`。 [comment]: # ({/0712ac33-5b47f8b9})