Community.Routeros 版本说明

v3.1.0

发行摘要

错误修复和功能更新版本。

次要更改

• api_info, api_modify - 为 ip pool 路径添加缺失字段 comment, next-pool (https://github.com/ansible-collections/community.routeros/pull/327).

错误修复

• api_info, api_modify - ip firewall filter, ip firewall mangle, ip firewall nat, ip firewall raw 路径中的字段 log 和 log-prefix 现在具有正确的默认值 (https://github.com/ansible-collections/community.routeros/pull/324).

v3.0.0

发行摘要

主要版本，放弃对已终止生命周期的 Python 版本的支持，并修复 community.routeros.command 的检查模式。

重大更改/移植指南

• command - 此模块不再声明其支持检查模式 (https://github.com/ansible-collections/community.routeros/pull/318).

已移除的功能（之前已弃用）

• 此集合不再支持 Ansible 2.9、ansible-base 2.10、ansible-core 2.11、ansible-core 2.12、ansible-core 2.13 和 ansible-core 2.14。如果您需要继续使用已终止生命周期的 Ansible/ansible-base/ansible-core 版本，请使用 community.routeros 2.x.y (https://github.com/ansible-collections/community.routeros/pull/318).

v2.20.0

发行摘要

功能更新版本。

次要更改

• api_info, api_modify - 添加 RouterOS 7.16 版本中的新参数 (https://github.com/ansible-collections/community.routeros/pull/323).

• api_info, api_modify - 添加对 interface l2tp-client 配置的支持 (https://github.com/ansible-collections/community.routeros/pull/322).

• api_info, api_modify - 添加对 system routerboard settings 中 cpu-frequency、memory-frequency、preboot-etherboot 和 preboot-etherboot-server 属性的支持 (https://github.com/ansible-collections/community.routeros/pull/320).

• api_info, api_modify - 添加对 RouterOS 7.16 引入的 ip dhcp-server matcher 中 matching-type 属性的支持 (https://github.com/ansible-collections/community.routeros/pull/321).

v2.19.0

发行摘要

功能更新版本。

次要更改

• api_info, api_modify - 添加对 RouterOS 7.15 及更高版本实现的 ip dns adlist 路径的支持 (https://github.com/ansible-collections/community.routeros/pull/310).

• api_info, api_modify - 添加对 interface bridge 中 mld-version 和 multicast-querier 属性的支持 (https://github.com/ansible-collections/community.routeros/pull/315).

• api_info, api_modify - 添加对 RouterOS 7 及更高版本实现的 routing filter num-list 路径的支持 (https://github.com/ansible-collections/community.routeros/pull/313).

• api_info, api_modify - 添加对 routing igmp-proxy 路径的支持（https://github.com/ansible-collections/community.routeros/pull/309）。

• api_modify, api_info - 在 snmp community 中添加只读 default 字段（https://github.com/ansible-collections/community.routeros/pull/311）。

v2.18.0

发行说明

功能更新版本。

次要更改

• api_info - 使用新的 restrict 选项允许通过将字段限制为特定值来限制输出（https://github.com/ansible-collections/community.routeros/pull/305）。

• api_info, api_modify - 添加对 ip dhcp-server matcher 路径的支持（https://github.com/ansible-collections/community.routeros/pull/300）。

• api_info, api_modify - 添加对 ipv6 nd prefix 路径的支持（https://github.com/ansible-collections/community.routeros/pull/303）。

• api_info, api_modify - 添加对 RouterOS 7.15 中引入的 interface wireguard peers 路径下的 name 和 is-responder 属性的支持（https://github.com/ansible-collections/community.routeros/pull/304）。

• api_info, api_modify - 添加对 RouterOS 7 中 routing ospf static-neighbor 路径的支持（https://github.com/ansible-collections/community.routeros/pull/302）。

• api_info, api_modify - 将 ip dhcp-server option 中 force 的默认值显式设置为 false（https://github.com/ansible-collections/community.routeros/pull/300）。

• api_modify - 使用新的 restrict 选项允许通过将字段限制为特定值来限制更新的内容（https://github.com/ansible-collections/community.routeros/pull/305）。

已弃用的功能

• 该集合弃用了对所有当前已终止生命周期的 Ansible/ansible-base/ansible-core 版本的支持，根据 ansible-core 支持矩阵。这意味着该集合的下一个主要版本将不再支持 Ansible 2.9、ansible-base 2.10、ansible-core 2.11、ansible-core 2.12、ansible-core 2.13 和 ansible-core 2.14。

错误修复

• api_modify, api_info - 将 ingress-filtering 在 interface bridge 和 interface bridge port 路径中的默认值改回为 RouterOS 7 版本之前的 false（https://github.com/ansible-collections/community.routeros/pull/305）。

v2.17.0

发行说明

功能更新版本。

次要更改

• api_info, api_modify - 添加 system health settings 路径（https://github.com/ansible-collections/community.routeros/pull/294）。

• api_info, api_modify - 添加缺失的路径 /system resource irq rps（https://github.com/ansible-collections/community.routeros/pull/295）。

• api_info, api_modify - 为 ip ssh 路径添加参数 host-key-type（https://github.com/ansible-collections/community.routeros/issues/280, https://github.com/ansible-collections/community.routeros/pull/297）。

v2.16.0

发行说明

功能更新版本。

次要更改

• api_info, api_modify - 添加缺失的路径 /ppp secret（https://github.com/ansible-collections/community.routeros/pull/286）。

• api_info, api_modify - 对 /interface ethernet 路径字段进行了细微更改（https://github.com/ansible-collections/community.routeros/pull/288）。

v2.15.0

发行说明

功能更新版本。

次要更改

• api_info, api_modify - 将 RouterOS 7.x 支持添加到 /mpls ldp 路径（https://github.com/ansible-collections/community.routeros/pull/271）。

• api_info, api_modify - 为 RouterOS 6.x 添加 /ip route rule 路径（https://github.com/ansible-collections/community.routeros/pull/278）。

• api_info, api_modify - 为 RouterOS 6.x 添加 /routing filter 路径（https://github.com/ansible-collections/community.routeros/pull/279）。

• api_info, api_modify - 为 /ipv6 address 中的 from-pool 字段添加默认值（https://github.com/ansible-collections/community.routeros/pull/270）。

• api_info, api_modify - 添加缺失的路径 /interface pppoe-server server（https://github.com/ansible-collections/community.routeros/pull/273）。

• api_info, api_modify - 添加缺失的路径 /ip dhcp-relay（https://github.com/ansible-collections/community.routeros/pull/276）。

• api_info, api_modify - 添加缺失的路径 /queue simple（https://github.com/ansible-collections/community.routeros/pull/269）。

• api_info, api_modify - 添加缺失的路径 /queue type（https://github.com/ansible-collections/community.routeros/pull/274）。

• api_info, api_modify - 添加缺失的路径 /routing bgp aggregate、/routing bgp network 和 /routing bgp peer（https://github.com/ansible-collections/community.routeros/pull/277）。

• api_info, api_modify - 添加对 /mpls interface、/mpls ldp accept-filter、/mpls ldp advertise-filter 和 mpls ldp interface 路径的支持（https://github.com/ansible-collections/community.routeros/pull/272）。

v2.14.0

发行说明

功能更新版本。

次要更改

• api_info, api_modify - 在 system package update 中添加只读字段 installed-version、latest-version 和 status（https://github.com/ansible-collections/community.routeros/pull/263）。

• api_info, api_modify - 添加对 interface wifi 及其子路径的支持（https://github.com/ansible-collections/community.routeros/pull/266）。

• api_info, api_modify - 删除 interface wireless 中只读字段 running 的默认值（https://github.com/ansible-collections/community.routeros/pull/264）。

v2.13.0

发行说明

错误修复和功能更新版本。

次要更改

• api_info, api_modify - 使路径 user group 可修改，并添加 comment 属性（https://github.com/ansible-collections/community.routeros/issues/256，https://github.com/ansible-collections/community.routeros/pull/257）。

• api_modify, api_info - 在 RouterOS 7 中添加对 ip vrf 路径的支持（https://github.com/ansible-collections/community.routeros/pull/259）。

错误修复

• facts - 修复幂等配置导出时日期未被删除的问题（https://github.com/ansible-collections/community.routeros/pull/262）。

v2.12.0

发行摘要

功能更新版本。

次要更改

• api_info, api_modify - 添加 interface ovpn-client 路径（https://github.com/ansible-collections/community.routeros/issues/242，https://github.com/ansible-collections/community.routeros/pull/244）。

• api_info, api_modify - 添加 radius 路径（https://github.com/ansible-collections/community.routeros/issues/241，https://github.com/ansible-collections/community.routeros/pull/245）。

• api_info, api_modify - 添加 routing rule 路径（https://github.com/ansible-collections/community.routeros/issues/162，https://github.com/ansible-collections/community.routeros/pull/246）。

• api_info, api_modify - 添加缺失的路径 routing bgp template（https://github.com/ansible-collections/community.routeros/pull/243）。

• api_info, api_modify - 在 interface wireless 中添加对 tx-power 属性的支持（https://github.com/ansible-collections/community.routeros/pull/239）。

• api_info, api_modify - 删除 tool netwatch 路径中的 host 主键（https://github.com/ansible-collections/community.routeros/pull/248）。

• api_modify, api_info - 添加对 interface wifiwave2 的支持（https://github.com/ansible-collections/community.routeros/pull/226）。

v2.11.0

发行摘要

特性和错误修复版本。

次要更改

• api_info, api_modify - 将缺失的 DoH 参数 doh-max-concurrent-queries、doh-max-server-connections 和 doh-timeout 添加到 ip dns 路径（https://github.com/ansible-collections/community.routeros/issues/230，https://github.com/ansible-collections/community.routeros/pull/235）。

• api_info, api_modify - 将缺失的参数 address-list、address-list-timeout、randomise-ports 和 realm 添加到 ip firewall 路径的子路径（https://github.com/ansible-collections/community.routeros/issues/236，https://github.com/ansible-collections/community.routeros/pull/237）。

• api_info, api_modify - 将 interface wireless 参数 running 标记为只读（https://github.com/ansible-collections/community.routeros/pull/233）。

• api_info, api_modify - 在文档中可以看到的更多路径中，将 disabled 参数的默认值设置为 false（https://github.com/ansible-collections/community.routeros/pull/237）。

• api_modify - 将缺失的 comment 属性添加到 /routing id（https://github.com/ansible-collections/community.routeros/pull/234）。

• api_modify - 将缺失的属性添加到 routing bgp connection 路径（https://github.com/ansible-collections/community.routeros/pull/234）。

• api_modify - 将版本控制添加到 /tool e-mail 路径（RouterOS 7.12 版本）（https://github.com/ansible-collections/community.routeros/pull/234）。

• api_modify - 使 /ip traffic-flow target 成为多值属性（https://github.com/ansible-collections/community.routeros/pull/234）。

v2.10.0

发行摘要

错误修复和功能更新版本。

次要更改

• api_info - 添加新的 include_read_only 选项来选择只读值的处理方式。默认情况下，这些值不会返回（https://github.com/ansible-collections/community.routeros/pull/213）。

• api_info, api_modify - 在 ip dns static 路径中添加对 RouterOS 7.7 中引入的 address-list 和 match-subdomain 的支持（https://github.com/ansible-collections/community.routeros/pull/197）。

• api_info, api_modify - 在 system clock 路径下添加对 user、time 和 gmt-offset 的支持（https://github.com/ansible-collections/community.routeros/pull/210）。

• api_info, api_modify - 添加对 interface ppp-client 路径的支持（https://github.com/ansible-collections/community.routeros/pull/199）。

• api_info, api_modify - 添加对 interface wireless 路径的支持（https://github.com/ansible-collections/community.routeros/pull/195）。

• api_info, api_modify - 添加对 iot modbus 路径的支持（https://github.com/ansible-collections/community.routeros/pull/205）。

• api_info, api_modify - 添加对 ip dhcp-server option 和 ip dhcp-server option sets 路径的支持（https://github.com/ansible-collections/community.routeros/pull/223）。

• api_info, api_modify - 添加对 ip upnp interfaces、tool graphing interface、tool graphing resource 路径的支持（https://github.com/ansible-collections/community.routeros/pull/227）。

• api_info, api_modify - 添加对 ipv6 firewall nat 路径的支持（https://github.com/ansible-collections/community.routeros/pull/204）。

• api_info, api_modify - 添加对 RouterOS 7.7 中引入的 ip neighbor discovery-settings 中的 mode 属性的支持（https://github.com/ansible-collections/community.routeros/pull/198）。

• api_info, api_modify - 添加对 port remote-access 路径的支持（https://github.com/ansible-collections/community.routeros/pull/224）。

• api_info, api_modify - 添加对 routing filter rule 和 routing filter select-rule 路径的支持（https://github.com/ansible-collections/community.routeros/pull/200）。

• api_info, api_modify - 在 RouterOS 7 中添加对 routing table 路径的支持（https://github.com/ansible-collections/community.routeros/pull/215）。

• api_info, api_modify - 在 RouterOS 7 中添加对 tool netwatch 路径的支持（https://github.com/ansible-collections/community.routeros/pull/216）。

• api_info, api_modify - 添加对 user settings 路径的支持（https://github.com/ansible-collections/community.routeros/pull/201）。

• api_info, api_modify - 添加对 user 路径的支持（https://github.com/ansible-collections/community.routeros/pull/211）。

• api_info, api_modify - 为interface wireless security-profiles路径完成字段定义并启用它（https://github.com/ansible-collections/community.routeros/pull/203）。

• api_info, api_modify - 为ppp profile路径完成字段定义并启用它（https://github.com/ansible-collections/community.routeros/pull/217）。

• api_modify - 添加新的handle_read_only和handle_write_only选项来处理模块对于只读和只写字段的行为（https://github.com/ansible-collections/community.routeros/pull/213）。

• api_modify, api_info - 支持API路径routing id，routing bgp connection（https://github.com/ansible-collections/community.routeros/pull/220）。

错误修复

• api_info, api_modify - 在snmp路径中，确保engine-id-suffix仅在RouterOS 7.10+版本可用，并且engine-id在RouterOS 7.10+版本中为只读（https://github.com/ansible-collections/community.routeros/issues/208，https://github.com/ansible-collections/community.routeros/pull/218）。

v2.9.0

发行概要

错误修复和功能更新版本。

次要更改

• api_info, api_modify - 添加路径caps-man channel并启用路径caps-man manager interface（https://github.com/ansible-collections/community.routeros/issues/193，https://github.com/ansible-collections/community.routeros/pull/194）。

• api_info, api_modify - 添加路径ip traffic-flow target（https://github.com/ansible-collections/community.routeros/issues/191，https://github.com/ansible-collections/community.routeros/pull/192）。

错误修复

• api_modify, api_info - 为snmp路径添加缺失的参数engine-id-suffix（https://github.com/ansible-collections/community.routeros/issues/189，https://github.com/ansible-collections/community.routeros/pull/190）。

v2.8.3

发行概要

维护版本，更新了文档。

从这个版本开始，community.routeros在其文档中使用新的Ansible语义标记。如果您使用ansible-core 2.15之前的ansible-doc CLI工具查看文档，请注意它无法正确渲染标记。在大多数情况下您仍然可以阅读它，但是您需要ansible-core 2.15或更高版本才能按预期看到它。或者，您可以查看devel docsite以获取最新版本文档的渲染HTML版本。

已知问题

• 对于ansible-core 2.15之前的版本，Ansible标记将以原始形式显示在ansible-doc文本输出中。如果您在解读文档标记时遇到问题，请升级到ansible-core 2.15（或更高版本），或在https://docs.ansible.org.cn/ansible/devel/collections/community/routeros/上阅读HTML文档。

v2.8.2

发行概要

错误修复版本。

错误修复

• api_modify, api_info - 为tool e-mail路径添加缺失的参数tls（https://github.com/ansible-collections/community.routeros/issues/179，https://github.com/ansible-collections/community.routeros/pull/180）。

v2.8.1

发行概要

错误修复版本。

错误修复

• facts - 在行展开期间意外情况下，不会在CLI输出预处理中崩溃（https://github.com/ansible-collections/community.routeros/issues/170，https://github.com/ansible-collections/community.routeros/pull/177）。

v2.8.0

发行概要

错误修复和功能更新版本。

次要更改

• api_modify - 调整API路径ip dhcp-server network的数据（https://github.com/ansible-collections/community.routeros/pull/156）。

• api_modify - 添加对API路径snmp community的支持（https://github.com/ansible-collections/community.routeros/pull/159）。

• api_modify - 在API路径snmp中添加对trap-interfaces的支持（https://github.com/ansible-collections/community.routeros/pull/159）。

• api_modify - 添加对在API路径ipv6 settings中禁用IPv6的支持（https://github.com/ansible-collections/community.routeros/pull/158）。

• api_modify - 支持API路径ip firewall layer7-protocol（https://github.com/ansible-collections/community.routeros/pull/153）。

• command - 针对RouterOS 6.49到7.1.5版本之间stdout中额外字符的解决方法（https://github.com/ansible-collections/community.routeros/issues/62，https://github.com/ansible-collections/community.routeros/pull/161）。

错误修复

• api_info, api_modify - 修复ip dhcp-client路径中dhcp-options的默认值和删除行为（https://github.com/ansible-collections/community.routeros/issues/148，https://github.com/ansible-collections/community.routeros/pull/154）。

• api_modify - 修复创建时禁用键的处理（https://github.com/ansible-collections/community.routeros/pull/154）。

• various plugins and modules - 删除不必要的导入（https://github.com/ansible-collections/community.routeros/pull/149）。

v2.7.0

发行概要

错误修复和功能更新版本。

次要更改

• api_modify, api_info - 支持API路径ip arp，ip firewall raw，ipv6 firewall raw（https://github.com/ansible-collections/community.routeros/pull/144）。

错误修复

• api_modify, api_info - 修正了interface wireguard peers API路径中字段的默认值（https://github.com/ansible-collections/community.routeros/pull/144）。

v2.6.0

发行概要

常规错误修复和功能发布。

次要更改

• api_modify, api_info - 向ip dns static添加字段regexp（https://github.com/ansible-collections/community.routeros/issues/141）。

• api_modify, api_info - 支持API路径interface wireguard，interface wireguard peers（https://github.com/ansible-collections/community.routeros/pull/143）。

错误修复

• api_modify - 不要在ip dns static中使用name作为唯一键（https://github.com/ansible-collections/community.routeros/issues/141）。

• api_modify, api_info - 如果路由器在ip dns static中包含regexp DNS条目，则不会崩溃（https://github.com/ansible-collections/community.routeros/issues/141）。

v2.5.0

发行概要

特性和错误修复版本。

次要更改

• api_info、api_modify - 支持API路径 interface ethernet poe、interface gre6、interface vrrp，也支持之前在ip dhcp-server中缺少的所有字段（https://github.com/ansible-collections/community.routeros/pull/137）。

错误修复

• api_modify - API路径ip dhcp-server中条目的address-pool字段不再是必需的（https://github.com/ansible-collections/community.routeros/pull/137）。

v2.4.0

发行摘要

改进api*模块的功能版本。

次要更改

• api* 模块 - 添加新选项force_no_cert，用于使用ADH密码连接（https://github.com/ansible-collections/community.routeros/pull/124）。

• api_info - 新参数include_builtin，允许包含由ROS自动生成且用户无法修改的“内置”条目（https://github.com/ansible-collections/community.routeros/pull/130）。

• api_modify、api_info - 支持API路径 - interface bonding、interface bridge mlag、ipv6 firewall mangle、ipv6 nd、system scheduler、system script、system ups（https://github.com/ansible-collections/community.routeros/pull/133）。

• api_modify、api_info - 支持API路径 caps-man access-list、caps-man configuration、caps-man datapath、caps-man manager、caps-man provisioning、caps-man security（https://github.com/ansible-collections/community.routeros/pull/126）。

• api_modify、api_info - 支持API路径 interface list 和 interface list member（https://github.com/ansible-collections/community.routeros/pull/120）。

• api_modify、api_info - 支持API路径 interface pppoe-client、interface vlan、interface bridge、interface bridge vlan（https://github.com/ansible-collections/community.routeros/pull/125）。

• api_modify、api_info - 支持API路径 ip ipsec identity、ip ipsec peer、ip ipsec policy、ip ipsec profile、ip ipsec proposal（https://github.com/ansible-collections/community.routeros/pull/129）。

• api_modify、api_info - 支持API路径 ip route 和 ip route vrf（https://github.com/ansible-collections/community.routeros/pull/123）。

• api_modify、api_info - 支持API路径 ipv6 address、ipv6 dhcp-server、ipv6 dhcp-server option、ipv6 route、queue tree、routing ospf area、routing ospf area range、routing ospf instance、routing ospf interface-template、routing pimsm instance、routing pimsm interface-template（https://github.com/ansible-collections/community.routeros/pull/131）。

• api_modify、api_info - 支持API路径 system logging、system logging action（https://github.com/ansible-collections/community.routeros/pull/127）。

• api_modify、api_info - 支持路径ip firewall filter的字段hw-offload（https://github.com/ansible-collections/community.routeros/pull/121）。

• api_modify、api_info - 支持路径ip firewall nat中的字段address-list、address-list-timeout、connection-bytes、connection-limit、connection-mark、connection-rate、connection-type、content、disabled、dscp、dst-address-list、dst-address-type、dst-limit、fragment、hotspot、icmp-options、in-bridge-port、in-bridge-port-list、ingress-priority、ipsec-policy、ipv4-options、jump-target、layer7-protocol、limit、log、log-prefix、nth、out-bridge-port、out-bridge-port-list、packet-mark、packet-size、per-connection-classifier、port、priority、psd、random、realm、routing-mark、same-not-by-dst、src-address、src-address-list、src-address-type、src-mac-address、src-port、tcp-mss、time、tls-host、ttl（https://github.com/ansible-collections/community.routeros/pull/133）。

• api_modify、api_info - 支持路径interface ethernet的字段combo-mode、comment、fec-mode、mdix-enable、poe-out、poe-priority、poe-voltage、power-cycle-interval、power-cycle-ping-address、power-cycle-ping-enabled、power-cycle-ping-timeout（https://github.com/ansible-collections/community.routeros/pull/121）。

• api_modify、api_info - 在 ip firewall filter API 路径中支持字段 jump-target、reject-with；在 ip firwall address-list API 路径中支持字段 comment；在 ip firewall mangle API 路径中支持字段 jump-target；在 ipv6 firewall address-list API 路径中支持字段 comment；在 ipv6 firewall filter API 路径中支持字段 jump-target、reject-with（https://github.com/ansible-collections/community.routeros/pull/133）。

• api_modify、api_info - 支持同时可以禁用并具有默认值的API字段，支持API路径 interface gre、interface eoip（https://github.com/ansible-collections/community.routeros/pull/128）。

• api_modify、api_info - 在 ip route 路径中支持字段 blackhole、pref-src、routing-table、suppress-hw-offload、type、vrf-interface（https://github.com/ansible-collections/community.routeros/pull/131）。

• api_modify、api_info - 支持 ROS7 中可用的路径 system ntp client servers 和 system ntp server，以及 system ntp client 的新字段 servers、mode 和 vrf（https://github.com/ansible-collections/community.routeros/pull/122）。

错误修复

• api_modify - ip route 条目无需 gateway 字段即可定义，这对于不可达/黑洞类型的路由是正确的（https://github.com/ansible-collections/community.routeros/pull/131）。

• api_modify - queue interface 路径现在可以工作了（https://github.com/ansible-collections/community.routeros/pull/131）。

• api_modify、api_info - 从 API 路径 ipv6 firewall address-list 中删除了错误的字段 dynamic（https://github.com/ansible-collections/community.routeros/pull/133）。

• api_modify、api_info - interface bridge port 中 ingress-filtering 字段的默认值现在为 true，这与 ROS 中的默认值一致（https://github.com/ansible-collections/community.routeros/pull/125）。

• command、facts - 命令在安全模式下不再超时（https://github.com/ansible-collections/community.routeros/pull/134）。

已知问题

• api_modify - 当 queue tree 中条目的限制以人类可读的方式定义时（例如 25M），配置将在 ROS 中正确设置，但即使没有进行任何更改，模块也会在每次运行时都指示项目已更改。这是由 ROS API 引起的，该 API 以字节为单位返回数字（例如 25000000）（与 CLI 行为不一致）。为了减轻这种情况，限制必须以字节为单位定义（这些限制在 ROS CLI 中仍然会显示为人类可读）（https://github.com/ansible-collections/community.routeros/pull/131）。

• api_modify、api_info - 由于 ROS6 和 ROS7 之间的重大更改，routing ospf area、routing ospf area range、routing ospf instance、routing ospf interface-template 路径并未针对 ROS6 完全实现（https://github.com/ansible-collections/community.routeros/pull/131）。

v2.3.1

发行摘要

维护版本，改进了文档。

已知问题

• community.routeros.command 模块声称支持检查模式。由于它无法判断执行的命令是否修改了状态，因此此行为不正确。由于这可能会破坏现有的剧本，因此我们将不会更改此行为，直到 community.routeros 3.0.0。

v2.3.0

发行摘要

特性和错误修复版本。

次要更改

• 集合存储库符合 REUSE规范，但变更日志片段除外（https://github.com/ansible-collections/community.routeros/pull/108）。

• api* 模块 - 添加了 timeout 参数（https://github.com/ansible-collections/community.routeros/pull/109）。

• api_modify、api_info - 支持 API 路径 ip firewall mangle（https://github.com/ansible-collections/community.routeros/pull/110）。

错误修复

• api_modify、api_info - 使 API 路径 ip dhcp-server 支持 script，并使 ip firewall nat 支持 in-interface 和 in-interface-list（https://github.com/ansible-collections/community.routeros/pull/110）。

v2.2.1

发行摘要

错误修复版本。

错误修复

• api_modify、api_info - 使 API 路径 ip dhcp-server lease 支持 server=all（https://github.com/ansible-collections/community.routeros/issues/104，https://github.com/ansible-collections/community.routeros/pull/107）。

• api_modify、api_info - 使 API 路径 ip dhcp-server network 支持缺少的选项 boot-file-name、dhcp-option-set、dns-none、domain 和 next-server（https://github.com/ansible-collections/community.routeros/issues/104，https://github.com/ansible-collections/community.routeros/pull/106）。

v2.2.0

发行摘要

新功能版本。

次要更改

• 所有软件许可证现在都在集合根目录的 LICENSES/ 目录中。此外，SPDX-License-Identifier: 用于声明每个非自动生成的文件的适用许可证（https://github.com/ansible-collections/community.routeros/pull/101）。

错误修复

• 为 routeros 模块实用程序包含 LICENSES/BSD-2-Clause.txt 文件（https://github.com/ansible-collections/community.routeros/pull/101）。

新模块

• community.routeros.api_info - 从 API 获取信息

• community.routeros.api_modify - 使用 API 修改路径中的数据

v2.1.0

发行摘要

包含新模块的功能和错误修复版本。

次要更改

• 添加了 community.routeros.api 模块默认组。与 group/community.routeros.api 一起使用，为所有基于 API 的模块提供选项（https://github.com/ansible-collections/community.routeros/pull/89）。

• 通过声明其依赖关系来准备集合以包含在执行环境中（https://github.com/ansible-collections/community.routeros/pull/83）。

• api - 添加了新选项 extended query，用于针对 RouterOS API 进行更复杂的查询（https://github.com/ansible-collections/community.routeros/pull/63）。

• api - 更新 query 以接受符号参数（https://github.com/ansible-collections/community.routeros/pull/63）。

• api* 模块 - 允许设置除默认 ASCII 以外的编码来与 API 通信（https://github.com/ansible-collections/community.routeros/pull/95）。

错误修复

• query - 修复 .id 与 id 参数的查询函数检查，避免与像 identity 这样的 RouterOS 参数冲突（https://github.com/ansible-collections/community.routeros/pull/68，https://github.com/ansible-collections/community.routeros/issues/67）。

• 引用和取消引用过滤器插件，api 模块 - 正确处理转义序列 \_，将其作为空格的转义符而不是下划线的转义符（https://github.com/ansible-collections/community.routeros/pull/89）。

新增模块

• community.routeros.api_facts - 使用 API 从运行 MikroTik RouterOS 的远程设备收集事实信息

• community.routeros.api_find_and_modify - 使用 API 查找和修改信息

v2.0.0

发行说明

一个新的主要版本，其中 community.routeros.api 和 community.routeros.command 的行为发生了重大更改。

次要更改

• api - 使 query 的 WHERE 验证更加严格（https://github.com/ansible-collections/community.routeros/pull/53）。

• command - commands 和 wait_for 选项现在将列表元素转换为字符串（https://github.com/ansible-collections/community.routeros/pull/55）。

• facts - gather_subset 选项现在将列表元素转换为字符串（https://github.com/ansible-collections/community.routeros/pull/55）。

重大更改/移植指南

• api - 由于编程错误，模块在发生错误时从未失败。此问题现已修复。如果您依赖于模块在幂等命令的情况下不失败（导致像 failure: already have such address 这样的错误），则需要调整您的角色/剧本。我们建议使用 failed_when 来在特定情况下接受失败，例如 failed_when: "'failure: already have ' in result.msg[0]"（https://github.com/ansible-collections/community.routeros/pull/39）。

• api - 拆分命令不再使用简单的空格分割，而是使用更兼容 RouterOS CLI 的分割算法（https://github.com/ansible-collections/community.routeros/pull/45）。

• command - 模块现在始终指示发生了更改。如果这是不正确的，请使用 changed_when 来确定任务的正确更改状态（https://github.com/ansible-collections/community.routeros/pull/50）。

错误修复

• api - 改进 WHERE 查询的分割（https://github.com/ansible-collections/community.routeros/pull/47）。

• api - 将结果列表转换为字典时，不再删除第二个 = 和其后的文本（如果存在）（https://github.com/ansible-collections/community.routeros/pull/47）。

• routeros cliconf 插件 - 调整在创建此插件后 Ansible 中修改的函数签名（https://github.com/ansible-collections/community.routeros/pull/43）。

新增插件

过滤器

• community.routeros.join - 将参数列表连接到命令

• community.routeros.list_to_dict - 将参数列表转换为字典列表

• community.routeros.quote_argument - 引用参数

• community.routeros.quote_argument_value - 引用参数值

• community.routeros.split - 将命令拆分为参数

v1.2.0

发行说明

错误修复和功能更新版本。

次要更改

• 避免使用内部 ansible-core module_utils，转而使用自 Ansible 2.9 以来可用的等效公共 API（https://github.com/ansible-collections/community.routeros/pull/38）。

• api - 添加选项 validate_certs（默认值 true）、validate_cert_hostname（默认值 false）和 ca_path 来控制证书验证（https://github.com/ansible-collections/community.routeros/pull/37）。

• api - 将选项 ssl 重命名为 tls，并保留旧名称作为别名（https://github.com/ansible-collections/community.routeros/pull/37）。

• fact - 添加事实信息 ansible_net_config_nonverbose 以获取幂等配置（无日期，无详细信息）（https://github.com/ansible-collections/community.routeros/pull/23）。

错误修复

• api - 使用 TLS/SSL 时，删除对不安全值的显式密码配置，这也使得无法连接到较新的 RouterOS 版本（https://github.com/ansible-collections/community.routeros/pull/34）。

v1.1.0

发行说明

此版本允许在基于 SSH 的模块中使用用户名中的短划线。

次要更改

• command - 添加对用户名中短划线 (-) 的支持（https://github.com/ansible-collections/community.routeros/pull/18）。

• facts - 添加对用户名中短划线 (-) 的支持（https://github.com/ansible-collections/community.routeros/pull/18）。

v1.0.1

发行说明

维护版本，其中包含对 api 的错误修复。

错误修复

• api - 删除 id to .id 作为默认要求，因为它与 RouterOS id 配置参数冲突（https://github.com/ansible-collections/community.routeros/pull/15）。

v1.0.0

发行说明

这是 community.routeros 的第一个生产（非预发行）版本。

错误修复

• routeros terminal 插件 - 允许在主机名中使用斜杠进行终端检测。如果没有这个，主机名中的斜杠将导致连接超时（https://github.com/ansible-collections/community.network/pull/138）。

v0.1.1

发行说明

对初始版本的少量改进和错误修复。

错误修复

• api - 修复使用 ssl 参数时的崩溃问题（https://github.com/ansible-collections/community.routeros/pull/3）。

v0.1.0

发行说明

community.routeros 延续了 community.network 1.2.0 版本中 Ansible RouterOS 模块的工作。此处列出的更改相对于 community.network.routeros_* 模块而言。

次要更改

• facts - 现在还收集关于 BGP 和 OSPF 的数据 (https://github.com/ansible-collections/community.network/pull/101)。

• facts - 将配置导出设置为详细模式，以进行完整配置导出 (https://github.com/ansible-collections/community.network/pull/104)。