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 - 添加只读 default 字段到 snmp community (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 - 为ip dns 路径添加了缺失的DoH参数doh-max-concurrent-queries、doh-max-server-connections 和 doh-timeout (https://github.com/ansible-collections/community.routeros/issues/230, https://github.com/ansible-collections/community.routeros/pull/235)。
api_info, api_modify - 为ip firewall 路径的子路径添加了缺失的参数address-list、address-list-timeout、randomise-ports 和 realm (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 - 为/routing id 添加了缺失的comment 属性 (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).

从这个版本开始，community.routeros 使用新的 Ansible 语义标记在其文档中。如果您使用 ansible-core 2.15 之前的 ansible-doc CLI 工具查看文档，请注意它无法正确渲染标记。在大多数情况下您仍然可以阅读它，但是您需要 ansible-core 2.15 或更高版本才能按预期查看它。或者，您可以查看 devel 文档站点以获取最新版本文档的已渲染 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).
各种插件和模块 - 删除不必要的导入 (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 引起的，它以字节为单位返回数字 - 例如 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* 模块 - 允许设置与 API 通信时使用的编码，而不是默认的 ASCII 编码（https://github.com/ansible-collections/community.routeros/pull/95）。

错误修复 

query - 修复查询函数对.id 与 id 参数的检查，避免与 RouterOS 参数（如identity）冲突（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 延续了 Ansible RouterOS 模块在 community.network 1.2.0 中的状态的工作。此处列出的更改相对于模块 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）。