mirror.MikroTik/ansible-collections.community.routeros
1
0
Fork 0
mirror of https://github.com/ansible-collections/community.routeros.git synced 2025-07-31 08:15:13 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

Release 3.8.1.
Some checks are pending
Collection Docs / Publish Ansible Docs (push) Blocked by required conditions
Details
Collection Docs / Build Ansible Docs (push) Waiting to run
Details
nox / Run extra sanity tests (push) Waiting to run
Details
nox / ansible-test (push) Waiting to run
Details

Browse source
This commit is contained in:
Felix Fontein 2025-07-26 14:38:22 +02:00
parent 1c182725ce
commit 6e9d2e1379
5 changed files with 176 additions and 140 deletions
Download patch file Download diff file Expand all files Collapse all files

290
CHANGELOG.md
View file

@ -2,158 +2,174 @@
**Topics** **Topics**
- <a href="#v3-8-0">v3\.8\.0</a> - <a href="#v3-8-1">v3\.8\.1</a>
- <a href="#release-summary">Release Summary</a> - <a href="#release-summary">Release Summary</a>
- <a href="#bugfixes">Bugfixes</a>
- <a href="#v3-8-0">v3\.8\.0</a>
- <a href="#release-summary-1">Release Summary</a>
- <a href="#minor-changes">Minor Changes</a> - <a href="#minor-changes">Minor Changes</a>
- <a href="#v3-7-0">v3\.7\.0</a> - <a href="#v3-7-0">v3\.7\.0</a>
- <a href="#release-summary-1">Release Summary</a> - <a href="#release-summary-2">Release Summary</a>
- <a href="#minor-changes-1">Minor Changes</a> - <a href="#minor-changes-1">Minor Changes</a>
- <a href="#v3-6-0">v3\.6\.0</a> - <a href="#v3-6-0">v3\.6\.0</a>
- <a href="#release-summary-2">Release Summary</a> - <a href="#release-summary-3">Release Summary</a>
- <a href="#minor-changes-2">Minor Changes</a> - <a href="#minor-changes-2">Minor Changes</a>
- <a href="#v3-5-0">v3\.5\.0</a> - <a href="#v3-5-0">v3\.5\.0</a>
- <a href="#release-summary-3">Release Summary</a> - <a href="#release-summary-4">Release Summary</a>
- <a href="#minor-changes-3">Minor Changes</a> - <a href="#minor-changes-3">Minor Changes</a>
- <a href="#v3-4-0">v3\.4\.0</a> - <a href="#v3-4-0">v3\.4\.0</a>
- <a href="#release-summary-4">Release Summary</a>
- <a href="#minor-changes-4">Minor Changes</a>
- <a href="#bugfixes">Bugfixes</a>
- <a href="#v3-3-0">v3\.3\.0</a>
- <a href="#release-summary-5">Release Summary</a> - <a href="#release-summary-5">Release Summary</a>
- <a href="#minor-changes-4">Minor Changes</a>
- <a href="#bugfixes-1">Bugfixes</a>
- <a href="#v3-3-0">v3\.3\.0</a>
- <a href="#release-summary-6">Release Summary</a>
- <a href="#minor-changes-5">Minor Changes</a> - <a href="#minor-changes-5">Minor Changes</a>
- <a href="#v3-2-0">v3\.2\.0</a> - <a href="#v3-2-0">v3\.2\.0</a>
- <a href="#release-summary-6">Release Summary</a> - <a href="#release-summary-7">Release Summary</a>
- <a href="#minor-changes-6">Minor Changes</a> - <a href="#minor-changes-6">Minor Changes</a>
- <a href="#v3-1-0">v3\.1\.0</a> - <a href="#v3-1-0">v3\.1\.0</a>
- <a href="#release-summary-7">Release Summary</a>
- <a href="#minor-changes-7">Minor Changes</a>
- <a href="#bugfixes-1">Bugfixes</a>
- <a href="#v3-0-0">v3\.0\.0</a>
- <a href="#release-summary-8">Release Summary</a> - <a href="#release-summary-8">Release Summary</a>
- <a href="#minor-changes-7">Minor Changes</a>
- <a href="#bugfixes-2">Bugfixes</a>
- <a href="#v3-0-0">v3\.0\.0</a>
- <a href="#release-summary-9">Release Summary</a>
- <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a> - <a href="#breaking-changes--porting-guide">Breaking Changes / Porting Guide</a>
- <a href="#removed-features-previously-deprecated">Removed Features \(previously deprecated\)</a> - <a href="#removed-features-previously-deprecated">Removed Features \(previously deprecated\)</a>
- <a href="#v2-20-0">v2\.20\.0</a> - <a href="#v2-20-0">v2\.20\.0</a>
- <a href="#release-summary-9">Release Summary</a> - <a href="#release-summary-10">Release Summary</a>
- <a href="#minor-changes-8">Minor Changes</a> - <a href="#minor-changes-8">Minor Changes</a>
- <a href="#v2-19-0">v2\.19\.0</a> - <a href="#v2-19-0">v2\.19\.0</a>
- <a href="#release-summary-10">Release Summary</a> - <a href="#release-summary-11">Release Summary</a>
- <a href="#minor-changes-9">Minor Changes</a> - <a href="#minor-changes-9">Minor Changes</a>
- <a href="#v2-18-0">v2\.18\.0</a> - <a href="#v2-18-0">v2\.18\.0</a>
- <a href="#release-summary-11">Release Summary</a> - <a href="#release-summary-12">Release Summary</a>
- <a href="#minor-changes-10">Minor Changes</a> - <a href="#minor-changes-10">Minor Changes</a>
- <a href="#deprecated-features">Deprecated Features</a> - <a href="#deprecated-features">Deprecated Features</a>
- <a href="#bugfixes-2">Bugfixes</a> - <a href="#bugfixes-3">Bugfixes</a>
- <a href="#v2-17-0">v2\.17\.0</a> - <a href="#v2-17-0">v2\.17\.0</a>
- <a href="#release-summary-12">Release Summary</a> - <a href="#release-summary-13">Release Summary</a>
- <a href="#minor-changes-11">Minor Changes</a> - <a href="#minor-changes-11">Minor Changes</a>
- <a href="#v2-16-0">v2\.16\.0</a> - <a href="#v2-16-0">v2\.16\.0</a>
- <a href="#release-summary-13">Release Summary</a> - <a href="#release-summary-14">Release Summary</a>
- <a href="#minor-changes-12">Minor Changes</a> - <a href="#minor-changes-12">Minor Changes</a>
- <a href="#v2-15-0">v2\.15\.0</a> - <a href="#v2-15-0">v2\.15\.0</a>
- <a href="#release-summary-14">Release Summary</a> - <a href="#release-summary-15">Release Summary</a>
- <a href="#minor-changes-13">Minor Changes</a> - <a href="#minor-changes-13">Minor Changes</a>
- <a href="#v2-14-0">v2\.14\.0</a> - <a href="#v2-14-0">v2\.14\.0</a>
- <a href="#release-summary-15">Release Summary</a> - <a href="#release-summary-16">Release Summary</a>
- <a href="#minor-changes-14">Minor Changes</a> - <a href="#minor-changes-14">Minor Changes</a>
- <a href="#v2-13-0">v2\.13\.0</a> - <a href="#v2-13-0">v2\.13\.0</a>
- <a href="#release-summary-16">Release Summary</a>
- <a href="#minor-changes-15">Minor Changes</a>
- <a href="#bugfixes-3">Bugfixes</a>
- <a href="#v2-12-0">v2\.12\.0</a>
- <a href="#release-summary-17">Release Summary</a> - <a href="#release-summary-17">Release Summary</a>
- <a href="#minor-changes-15">Minor Changes</a>
- <a href="#bugfixes-4">Bugfixes</a>
- <a href="#v2-12-0">v2\.12\.0</a>
- <a href="#release-summary-18">Release Summary</a>
- <a href="#minor-changes-16">Minor Changes</a> - <a href="#minor-changes-16">Minor Changes</a>
- <a href="#v2-11-0">v2\.11\.0</a> - <a href="#v2-11-0">v2\.11\.0</a>
- <a href="#release-summary-18">Release Summary</a> - <a href="#release-summary-19">Release Summary</a>
- <a href="#minor-changes-17">Minor Changes</a> - <a href="#minor-changes-17">Minor Changes</a>
- <a href="#v2-10-0">v2\.10\.0</a> - <a href="#v2-10-0">v2\.10\.0</a>
- <a href="#release-summary-19">Release Summary</a>
- <a href="#minor-changes-18">Minor Changes</a>
- <a href="#bugfixes-4">Bugfixes</a>
- <a href="#v2-9-0">v2\.9\.0</a>
- <a href="#release-summary-20">Release Summary</a> - <a href="#release-summary-20">Release Summary</a>
- <a href="#minor-changes-19">Minor Changes</a> - <a href="#minor-changes-18">Minor Changes</a>
- <a href="#bugfixes-5">Bugfixes</a> - <a href="#bugfixes-5">Bugfixes</a>
- <a href="#v2-8-3">v2\.8\.3</a> - <a href="#v2-9-0">v2\.9\.0</a>
- <a href="#release-summary-21">Release Summary</a> - <a href="#release-summary-21">Release Summary</a>
- <a href="#minor-changes-19">Minor Changes</a>
- <a href="#bugfixes-6">Bugfixes</a>
- <a href="#v2-8-3">v2\.8\.3</a>
- <a href="#release-summary-22">Release Summary</a>
- <a href="#known-issues">Known Issues</a> - <a href="#known-issues">Known Issues</a>
- <a href="#v2-8-2">v2\.8\.2</a> - <a href="#v2-8-2">v2\.8\.2</a>
- <a href="#release-summary-22">Release Summary</a>
- <a href="#bugfixes-6">Bugfixes</a>
- <a href="#v2-8-1">v2\.8\.1</a>
- <a href="#release-summary-23">Release Summary</a> - <a href="#release-summary-23">Release Summary</a>
- <a href="#bugfixes-7">Bugfixes</a> - <a href="#bugfixes-7">Bugfixes</a>
- <a href="#v2-8-0">v2\.8\.0</a> - <a href="#v2-8-1">v2\.8\.1</a>
- <a href="#release-summary-24">Release Summary</a> - <a href="#release-summary-24">Release Summary</a>
- <a href="#minor-changes-20">Minor Changes</a>
- <a href="#bugfixes-8">Bugfixes</a> - <a href="#bugfixes-8">Bugfixes</a>
- <a href="#v2-7-0">v2\.7\.0</a> - <a href="#v2-8-0">v2\.8\.0</a>
- <a href="#release-summary-25">Release Summary</a> - <a href="#release-summary-25">Release Summary</a>
- <a href="#minor-changes-21">Minor Changes</a> - <a href="#minor-changes-20">Minor Changes</a>
- <a href="#bugfixes-9">Bugfixes</a> - <a href="#bugfixes-9">Bugfixes</a>
- <a href="#v2-6-0">v2\.6\.0</a> - <a href="#v2-7-0">v2\.7\.0</a>
- <a href="#release-summary-26">Release Summary</a> - <a href="#release-summary-26">Release Summary</a>
- <a href="#minor-changes-22">Minor Changes</a> - <a href="#minor-changes-21">Minor Changes</a>
- <a href="#bugfixes-10">Bugfixes</a> - <a href="#bugfixes-10">Bugfixes</a>
- <a href="#v2-5-0">v2\.5\.0</a> - <a href="#v2-6-0">v2\.6\.0</a>
- <a href="#release-summary-27">Release Summary</a> - <a href="#release-summary-27">Release Summary</a>
- <a href="#minor-changes-23">Minor Changes</a> - <a href="#minor-changes-22">Minor Changes</a>
- <a href="#bugfixes-11">Bugfixes</a> - <a href="#bugfixes-11">Bugfixes</a>
- <a href="#v2-4-0">v2\.4\.0</a> - <a href="#v2-5-0">v2\.5\.0</a>
- <a href="#release-summary-28">Release Summary</a> - <a href="#release-summary-28">Release Summary</a>
- <a href="#minor-changes-24">Minor Changes</a> - <a href="#minor-changes-23">Minor Changes</a>
- <a href="#bugfixes-12">Bugfixes</a> - <a href="#bugfixes-12">Bugfixes</a>
- <a href="#v2-4-0">v2\.4\.0</a>
- <a href="#release-summary-29">Release Summary</a>
- <a href="#minor-changes-24">Minor Changes</a>
- <a href="#bugfixes-13">Bugfixes</a>
- <a href="#known-issues-1">Known Issues</a> - <a href="#known-issues-1">Known Issues</a>
- <a href="#v2-3-1">v2\.3\.1</a> - <a href="#v2-3-1">v2\.3\.1</a>
- <a href="#release-summary-29">Release Summary</a> - <a href="#release-summary-30">Release Summary</a>
- <a href="#known-issues-2">Known Issues</a> - <a href="#known-issues-2">Known Issues</a>
- <a href="#v2-3-0">v2\.3\.0</a> - <a href="#v2-3-0">v2\.3\.0</a>
- <a href="#release-summary-30">Release Summary</a>
- <a href="#minor-changes-25">Minor Changes</a>
- <a href="#bugfixes-13">Bugfixes</a>
- <a href="#v2-2-1">v2\.2\.1</a>
- <a href="#release-summary-31">Release Summary</a> - <a href="#release-summary-31">Release Summary</a>
- <a href="#minor-changes-25">Minor Changes</a>
- <a href="#bugfixes-14">Bugfixes</a> - <a href="#bugfixes-14">Bugfixes</a>
- <a href="#v2-2-0">v2\.2\.0</a> - <a href="#v2-2-1">v2\.2\.1</a>
- <a href="#release-summary-32">Release Summary</a> - <a href="#release-summary-32">Release Summary</a>
- <a href="#minor-changes-26">Minor Changes</a>
- <a href="#bugfixes-15">Bugfixes</a> - <a href="#bugfixes-15">Bugfixes</a>
- <a href="#v2-2-0">v2\.2\.0</a>
- <a href="#release-summary-33">Release Summary</a>
- <a href="#minor-changes-26">Minor Changes</a>
- <a href="#bugfixes-16">Bugfixes</a>
- <a href="#new-modules">New Modules</a> - <a href="#new-modules">New Modules</a>
- <a href="#v2-1-0">v2\.1\.0</a> - <a href="#v2-1-0">v2\.1\.0</a>
- <a href="#release-summary-33">Release Summary</a> - <a href="#release-summary-34">Release Summary</a>
- <a href="#minor-changes-27">Minor Changes</a> - <a href="#minor-changes-27">Minor Changes</a>
- <a href="#bugfixes-16">Bugfixes</a> - <a href="#bugfixes-17">Bugfixes</a>
- <a href="#new-modules-1">New Modules</a> - <a href="#new-modules-1">New Modules</a>
- <a href="#v2-0-0">v2\.0\.0</a> - <a href="#v2-0-0">v2\.0\.0</a>
- <a href="#release-summary-34">Release Summary</a> - <a href="#release-summary-35">Release Summary</a>
- <a href="#minor-changes-28">Minor Changes</a> - <a href="#minor-changes-28">Minor Changes</a>
- <a href="#breaking-changes--porting-guide-1">Breaking Changes / Porting Guide</a> - <a href="#breaking-changes--porting-guide-1">Breaking Changes / Porting Guide</a>
- <a href="#bugfixes-17">Bugfixes</a> - <a href="#bugfixes-18">Bugfixes</a>
- <a href="#new-plugins">New Plugins</a> - <a href="#new-plugins">New Plugins</a>
- <a href="#filter">Filter</a> - <a href="#filter">Filter</a>
- <a href="#v1-2-0">v1\.2\.0</a> - <a href="#v1-2-0">v1\.2\.0</a>
- <a href="#release-summary-35">Release Summary</a>
- <a href="#minor-changes-29">Minor Changes</a>
- <a href="#bugfixes-18">Bugfixes</a>
- <a href="#v1-1-0">v1\.1\.0</a>
- <a href="#release-summary-36">Release Summary</a> - <a href="#release-summary-36">Release Summary</a>
- <a href="#minor-changes-29">Minor Changes</a>
- <a href="#bugfixes-19">Bugfixes</a>
- <a href="#v1-1-0">v1\.1\.0</a>
- <a href="#release-summary-37">Release Summary</a>
- <a href="#minor-changes-30">Minor Changes</a> - <a href="#minor-changes-30">Minor Changes</a>
- <a href="#v1-0-1">v1\.0\.1</a> - <a href="#v1-0-1">v1\.0\.1</a>
- <a href="#release-summary-37">Release Summary</a>
- <a href="#bugfixes-19">Bugfixes</a>
- <a href="#v1-0-0">v1\.0\.0</a>
- <a href="#release-summary-38">Release Summary</a> - <a href="#release-summary-38">Release Summary</a>
- <a href="#bugfixes-20">Bugfixes</a> - <a href="#bugfixes-20">Bugfixes</a>
- <a href="#v0-1-1">v0\.1\.1</a> - <a href="#v1-0-0">v1\.0\.0</a>
- <a href="#release-summary-39">Release Summary</a> - <a href="#release-summary-39">Release Summary</a>
- <a href="#bugfixes-21">Bugfixes</a> - <a href="#bugfixes-21">Bugfixes</a>
- <a href="#v0-1-0">v0\.1\.0</a> - <a href="#v0-1-1">v0\.1\.1</a>
- <a href="#release-summary-40">Release Summary</a> - <a href="#release-summary-40">Release Summary</a>
- <a href="#bugfixes-22">Bugfixes</a>
- <a href="#v0-1-0">v0\.1\.0</a>
- <a href="#release-summary-41">Release Summary</a>
- <a href="#minor-changes-31">Minor Changes</a> - <a href="#minor-changes-31">Minor Changes</a>
<a id="v3-8-1"></a>
## v3\.8\.1
<a id="release-summary"></a>
### Release Summary
Bugfix release\.
<a id="bugfixes"></a>
### Bugfixes
* facts and api\_facts modules \- prevent deprecation warnings when used with ansible\-core 2\.19 \([https\://github\.com/ansible\-collections/community\.routeros/pull/384](https\://github\.com/ansible\-collections/community\.routeros/pull/384)\)\.
<a id="v3-8-0"></a> <a id="v3-8-0"></a>
## v3\.8\.0 ## v3\.8\.0
<a id="release-summary"></a> <a id="release-summary-1"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -169,7 +185,7 @@ Feature release\.
<a id="v3-7-0"></a> <a id="v3-7-0"></a>
## v3\.7\.0 ## v3\.7\.0
<a id="release-summary-1"></a> <a id="release-summary-2"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -183,7 +199,7 @@ Feature release\.
<a id="v3-6-0"></a> <a id="v3-6-0"></a>
## v3\.6\.0 ## v3\.6\.0
<a id="release-summary-2"></a> <a id="release-summary-3"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -198,7 +214,7 @@ Feature release\.
<a id="v3-5-0"></a> <a id="v3-5-0"></a>
## v3\.5\.0 ## v3\.5\.0
<a id="release-summary-3"></a> <a id="release-summary-4"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -211,7 +227,7 @@ Feature release\.
<a id="v3-4-0"></a> <a id="v3-4-0"></a>
## v3\.4\.0 ## v3\.4\.0
<a id="release-summary-4"></a> <a id="release-summary-5"></a>
### Release Summary ### Release Summary
Feature and bugfix release\. Feature and bugfix release\.
@ -221,7 +237,7 @@ Feature and bugfix release\.
* api\_info\, api\_modify \- add support for the <code>ip dns forwarders</code> path implemented by RouterOS 7\.17 and newer \([https\://github\.com/ansible\-collections/community\.routeros/pull/343](https\://github\.com/ansible\-collections/community\.routeros/pull/343)\)\. * api\_info\, api\_modify \- add support for the <code>ip dns forwarders</code> path implemented by RouterOS 7\.17 and newer \([https\://github\.com/ansible\-collections/community\.routeros/pull/343](https\://github\.com/ansible\-collections/community\.routeros/pull/343)\)\.
<a id="bugfixes"></a> <a id="bugfixes-1"></a>
### Bugfixes ### Bugfixes
* api\_info\, api\_modify \- remove the primary key <code>action</code> from the <code>interface wifi provisioning</code> path\, since RouterOS also allows to create completely duplicate entries \([https\://github\.com/ansible\-collections/community\.routeros/issues/344](https\://github\.com/ansible\-collections/community\.routeros/issues/344)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/345](https\://github\.com/ansible\-collections/community\.routeros/pull/345)\)\. * api\_info\, api\_modify \- remove the primary key <code>action</code> from the <code>interface wifi provisioning</code> path\, since RouterOS also allows to create completely duplicate entries \([https\://github\.com/ansible\-collections/community\.routeros/issues/344](https\://github\.com/ansible\-collections/community\.routeros/issues/344)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/345](https\://github\.com/ansible\-collections/community\.routeros/pull/345)\)\.
@ -229,7 +245,7 @@ Feature and bugfix release\.
<a id="v3-3-0"></a> <a id="v3-3-0"></a>
## v3\.3\.0 ## v3\.3\.0
<a id="release-summary-5"></a> <a id="release-summary-6"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -245,7 +261,7 @@ Feature release\.
<a id="v3-2-0"></a> <a id="v3-2-0"></a>
## v3\.2\.0 ## v3\.2\.0
<a id="release-summary-6"></a> <a id="release-summary-7"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -258,7 +274,7 @@ Feature release\.
<a id="v3-1-0"></a> <a id="v3-1-0"></a>
## v3\.1\.0 ## v3\.1\.0
<a id="release-summary-7"></a> <a id="release-summary-8"></a>
### Release Summary ### Release Summary
Bugfix and feature release\. Bugfix and feature release\.
@ -268,7 +284,7 @@ Bugfix and feature release\.
* api\_info\, api\_modify \- add missing fields <code>comment</code>\, <code>next\-pool</code> to <code>ip pool</code> path \([https\://github\.com/ansible\-collections/community\.routeros/pull/327](https\://github\.com/ansible\-collections/community\.routeros/pull/327)\)\. * api\_info\, api\_modify \- add missing fields <code>comment</code>\, <code>next\-pool</code> to <code>ip pool</code> path \([https\://github\.com/ansible\-collections/community\.routeros/pull/327](https\://github\.com/ansible\-collections/community\.routeros/pull/327)\)\.
<a id="bugfixes-1"></a> <a id="bugfixes-2"></a>
### Bugfixes ### Bugfixes
* api\_info\, api\_modify \- fields <code>log</code> and <code>log\-prefix</code> in paths <code>ip firewall filter</code>\, <code>ip firewall mangle</code>\, <code>ip firewall nat</code>\, <code>ip firewall raw</code> now have the correct default values \([https\://github\.com/ansible\-collections/community\.routeros/pull/324](https\://github\.com/ansible\-collections/community\.routeros/pull/324)\)\. * api\_info\, api\_modify \- fields <code>log</code> and <code>log\-prefix</code> in paths <code>ip firewall filter</code>\, <code>ip firewall mangle</code>\, <code>ip firewall nat</code>\, <code>ip firewall raw</code> now have the correct default values \([https\://github\.com/ansible\-collections/community\.routeros/pull/324](https\://github\.com/ansible\-collections/community\.routeros/pull/324)\)\.
@ -276,7 +292,7 @@ Bugfix and feature release\.
<a id="v3-0-0"></a> <a id="v3-0-0"></a>
## v3\.0\.0 ## v3\.0\.0
<a id="release-summary-8"></a> <a id="release-summary-9"></a>
### Release Summary ### Release Summary
Major release that drops support for End of Life Python versions and fixes check mode for community\.routeros\.command\. Major release that drops support for End of Life Python versions and fixes check mode for community\.routeros\.command\.
@ -294,7 +310,7 @@ Major release that drops support for End of Life Python versions and fixes check
<a id="v2-20-0"></a> <a id="v2-20-0"></a>
## v2\.20\.0 ## v2\.20\.0
<a id="release-summary-9"></a> <a id="release-summary-10"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -310,7 +326,7 @@ Feature release\.
<a id="v2-19-0"></a> <a id="v2-19-0"></a>
## v2\.19\.0 ## v2\.19\.0
<a id="release-summary-10"></a> <a id="release-summary-11"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -327,7 +343,7 @@ Feature release\.
<a id="v2-18-0"></a> <a id="v2-18-0"></a>
## v2\.18\.0 ## v2\.18\.0
<a id="release-summary-11"></a> <a id="release-summary-12"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -348,7 +364,7 @@ Feature release\.
* The collection deprecates support for all Ansible/ansible\-base/ansible\-core versions that are currently End of Life\, [according to the ansible\-core support matrix](https\://docs\.ansible\.com/ansible\-core/devel/reference\_appendices/release\_and\_maintenance\.html\#ansible\-core\-support\-matrix)\. This means that the next major release of the collection will no longer support Ansible 2\.9\, ansible\-base 2\.10\, ansible\-core 2\.11\, ansible\-core 2\.12\, ansible\-core 2\.13\, and ansible\-core 2\.14\. * The collection deprecates support for all Ansible/ansible\-base/ansible\-core versions that are currently End of Life\, [according to the ansible\-core support matrix](https\://docs\.ansible\.com/ansible\-core/devel/reference\_appendices/release\_and\_maintenance\.html\#ansible\-core\-support\-matrix)\. This means that the next major release of the collection will no longer support Ansible 2\.9\, ansible\-base 2\.10\, ansible\-core 2\.11\, ansible\-core 2\.12\, ansible\-core 2\.13\, and ansible\-core 2\.14\.
<a id="bugfixes-2"></a> <a id="bugfixes-3"></a>
### Bugfixes ### Bugfixes
* api\_modify\, api\_info \- change the default of <code>ingress\-filtering</code> in paths <code>interface bridge</code> and <code>interface bridge port</code> back to <code>false</code> for RouterOS before version 7 \([https\://github\.com/ansible\-collections/community\.routeros/pull/305](https\://github\.com/ansible\-collections/community\.routeros/pull/305)\)\. * api\_modify\, api\_info \- change the default of <code>ingress\-filtering</code> in paths <code>interface bridge</code> and <code>interface bridge port</code> back to <code>false</code> for RouterOS before version 7 \([https\://github\.com/ansible\-collections/community\.routeros/pull/305](https\://github\.com/ansible\-collections/community\.routeros/pull/305)\)\.
@ -356,7 +372,7 @@ Feature release\.
<a id="v2-17-0"></a> <a id="v2-17-0"></a>
## v2\.17\.0 ## v2\.17\.0
<a id="release-summary-12"></a> <a id="release-summary-13"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -371,7 +387,7 @@ Feature release\.
<a id="v2-16-0"></a> <a id="v2-16-0"></a>
## v2\.16\.0 ## v2\.16\.0
<a id="release-summary-13"></a> <a id="release-summary-14"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -385,7 +401,7 @@ Feature release\.
<a id="v2-15-0"></a> <a id="v2-15-0"></a>
## v2\.15\.0 ## v2\.15\.0
<a id="release-summary-14"></a> <a id="release-summary-15"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -407,7 +423,7 @@ Feature release\.
<a id="v2-14-0"></a> <a id="v2-14-0"></a>
## v2\.14\.0 ## v2\.14\.0
<a id="release-summary-15"></a> <a id="release-summary-16"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -422,7 +438,7 @@ Feature release\.
<a id="v2-13-0"></a> <a id="v2-13-0"></a>
## v2\.13\.0 ## v2\.13\.0
<a id="release-summary-16"></a> <a id="release-summary-17"></a>
### Release Summary ### Release Summary
Bugfix and feature release\. Bugfix and feature release\.
@ -433,7 +449,7 @@ Bugfix and feature release\.
* api\_info\, api\_modify \- make path <code>user group</code> modifiable and add <code>comment</code> attribute \([https\://github\.com/ansible\-collections/community\.routeros/issues/256](https\://github\.com/ansible\-collections/community\.routeros/issues/256)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/257](https\://github\.com/ansible\-collections/community\.routeros/pull/257)\)\. * api\_info\, api\_modify \- make path <code>user group</code> modifiable and add <code>comment</code> attribute \([https\://github\.com/ansible\-collections/community\.routeros/issues/256](https\://github\.com/ansible\-collections/community\.routeros/issues/256)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/257](https\://github\.com/ansible\-collections/community\.routeros/pull/257)\)\.
* api\_modify\, api\_info \- add support for the <code>ip vrf</code> path in RouterOS 7 \([https\://github\.com/ansible\-collections/community\.routeros/pull/259](https\://github\.com/ansible\-collections/community\.routeros/pull/259)\) * api\_modify\, api\_info \- add support for the <code>ip vrf</code> path in RouterOS 7 \([https\://github\.com/ansible\-collections/community\.routeros/pull/259](https\://github\.com/ansible\-collections/community\.routeros/pull/259)\)
<a id="bugfixes-3"></a> <a id="bugfixes-4"></a>
### Bugfixes ### Bugfixes
* facts \- fix date not getting removed for idempotent config export \([https\://github\.com/ansible\-collections/community\.routeros/pull/262](https\://github\.com/ansible\-collections/community\.routeros/pull/262)\)\. * facts \- fix date not getting removed for idempotent config export \([https\://github\.com/ansible\-collections/community\.routeros/pull/262](https\://github\.com/ansible\-collections/community\.routeros/pull/262)\)\.
@ -441,7 +457,7 @@ Bugfix and feature release\.
<a id="v2-12-0"></a> <a id="v2-12-0"></a>
## v2\.12\.0 ## v2\.12\.0
<a id="release-summary-17"></a> <a id="release-summary-18"></a>
### Release Summary ### Release Summary
Feature release\. Feature release\.
@ -460,7 +476,7 @@ Feature release\.
<a id="v2-11-0"></a> <a id="v2-11-0"></a>
## v2\.11\.0 ## v2\.11\.0
<a id="release-summary-18"></a> <a id="release-summary-19"></a>
### Release Summary ### Release Summary
Feature and bugfix release\. Feature and bugfix release\.
@ -480,7 +496,7 @@ Feature and bugfix release\.
<a id="v2-10-0"></a> <a id="v2-10-0"></a>
## v2\.10\.0 ## v2\.10\.0
<a id="release-summary-19"></a> <a id="release-summary-20"></a>
### Release Summary ### Release Summary
Bugfix and feature release\. Bugfix and feature release\.
@ -509,7 +525,7 @@ Bugfix and feature release\.
* api\_modify \- add new <code>handle\_read\_only</code> and <code>handle\_write\_only</code> options to handle the module\'s behavior for read\-only and write\-only fields \([https\://github\.com/ansible\-collections/community\.routeros/pull/213](https\://github\.com/ansible\-collections/community\.routeros/pull/213)\)\. * api\_modify \- add new <code>handle\_read\_only</code> and <code>handle\_write\_only</code> options to handle the module\'s behavior for read\-only and write\-only fields \([https\://github\.com/ansible\-collections/community\.routeros/pull/213](https\://github\.com/ansible\-collections/community\.routeros/pull/213)\)\.
* api\_modify\, api\_info \- support API paths <code>routing id</code>\, <code>routing bgp connection</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/220](https\://github\.com/ansible\-collections/community\.routeros/pull/220)\)\. * api\_modify\, api\_info \- support API paths <code>routing id</code>\, <code>routing bgp connection</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/220](https\://github\.com/ansible\-collections/community\.routeros/pull/220)\)\.
<a id="bugfixes-4"></a> <a id="bugfixes-5"></a>
### Bugfixes ### Bugfixes
* api\_info\, api\_modify \- in the <code>snmp</code> path\, ensure that <code>engine\-id\-suffix</code> is only available on RouterOS 7\.10\+\, and that <code>engine\-id</code> is read\-only on RouterOS 7\.10\+ \([https\://github\.com/ansible\-collections/community\.routeros/issues/208](https\://github\.com/ansible\-collections/community\.routeros/issues/208)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/218](https\://github\.com/ansible\-collections/community\.routeros/pull/218)\)\. * api\_info\, api\_modify \- in the <code>snmp</code> path\, ensure that <code>engine\-id\-suffix</code> is only available on RouterOS 7\.10\+\, and that <code>engine\-id</code> is read\-only on RouterOS 7\.10\+ \([https\://github\.com/ansible\-collections/community\.routeros/issues/208](https\://github\.com/ansible\-collections/community\.routeros/issues/208)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/218](https\://github\.com/ansible\-collections/community\.routeros/pull/218)\)\.
@ -517,7 +533,7 @@ Bugfix and feature release\.
<a id="v2-9-0"></a> <a id="v2-9-0"></a>
## v2\.9\.0 ## v2\.9\.0
<a id="release-summary-20"></a> <a id="release-summary-21"></a>
### Release Summary ### Release Summary
Bugfix and feature release\. Bugfix and feature release\.
@ -528,7 +544,7 @@ Bugfix and feature release\.
* api\_info\, api\_modify \- add path <code>caps\-man channel</code> and enable path <code>caps\-man manager interface</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/193](https\://github\.com/ansible\-collections/community\.routeros/issues/193)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/194](https\://github\.com/ansible\-collections/community\.routeros/pull/194)\)\. * api\_info\, api\_modify \- add path <code>caps\-man channel</code> and enable path <code>caps\-man manager interface</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/193](https\://github\.com/ansible\-collections/community\.routeros/issues/193)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/194](https\://github\.com/ansible\-collections/community\.routeros/pull/194)\)\.
* api\_info\, api\_modify \- add path <code>ip traffic\-flow target</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/191](https\://github\.com/ansible\-collections/community\.routeros/issues/191)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/192](https\://github\.com/ansible\-collections/community\.routeros/pull/192)\)\. * api\_info\, api\_modify \- add path <code>ip traffic\-flow target</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/191](https\://github\.com/ansible\-collections/community\.routeros/issues/191)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/192](https\://github\.com/ansible\-collections/community\.routeros/pull/192)\)\.
<a id="bugfixes-5"></a> <a id="bugfixes-6"></a>
### Bugfixes ### Bugfixes
* api\_modify\, api\_info \- add missing parameter <code>engine\-id\-suffix</code> for the <code>snmp</code> path \([https\://github\.com/ansible\-collections/community\.routeros/issues/189](https\://github\.com/ansible\-collections/community\.routeros/issues/189)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/190](https\://github\.com/ansible\-collections/community\.routeros/pull/190)\)\. * api\_modify\, api\_info \- add missing parameter <code>engine\-id\-suffix</code> for the <code>snmp</code> path \([https\://github\.com/ansible\-collections/community\.routeros/issues/189](https\://github\.com/ansible\-collections/community\.routeros/issues/189)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/190](https\://github\.com/ansible\-collections/community\.routeros/pull/190)\)\.
@ -536,7 +552,7 @@ Bugfix and feature release\.
<a id="v2-8-3"></a> <a id="v2-8-3"></a>
## v2\.8\.3 ## v2\.8\.3
<a id="release-summary-21"></a> <a id="release-summary-22"></a>
### Release Summary ### Release Summary
Maintenance release with updated documentation\. Maintenance release with updated documentation\.
@ -557,19 +573,6 @@ for the rendered HTML version of the documentation of the latest release\.
<a id="v2-8-2"></a> <a id="v2-8-2"></a>
## v2\.8\.2 ## v2\.8\.2
<a id="release-summary-22"></a>
### Release Summary
Bugfix release\.
<a id="bugfixes-6"></a>
### Bugfixes
* api\_modify\, api\_info \- add missing parameter <code>tls</code> for the <code>tool e\-mail</code> path \([https\://github\.com/ansible\-collections/community\.routeros/issues/179](https\://github\.com/ansible\-collections/community\.routeros/issues/179)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/180](https\://github\.com/ansible\-collections/community\.routeros/pull/180)\)\.
<a id="v2-8-1"></a>
## v2\.8\.1
<a id="release-summary-23"></a> <a id="release-summary-23"></a>
### Release Summary ### Release Summary
@ -578,12 +581,25 @@ Bugfix release\.
<a id="bugfixes-7"></a> <a id="bugfixes-7"></a>
### Bugfixes ### Bugfixes
* api\_modify\, api\_info \- add missing parameter <code>tls</code> for the <code>tool e\-mail</code> path \([https\://github\.com/ansible\-collections/community\.routeros/issues/179](https\://github\.com/ansible\-collections/community\.routeros/issues/179)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/180](https\://github\.com/ansible\-collections/community\.routeros/pull/180)\)\.
<a id="v2-8-1"></a>
## v2\.8\.1
<a id="release-summary-24"></a>
### Release Summary
Bugfix release\.
<a id="bugfixes-8"></a>
### Bugfixes
* facts \- do not crash in CLI output preprocessing in unexpected situations during line unwrapping \([https\://github\.com/ansible\-collections/community\.routeros/issues/170](https\://github\.com/ansible\-collections/community\.routeros/issues/170)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/177](https\://github\.com/ansible\-collections/community\.routeros/pull/177)\)\. * facts \- do not crash in CLI output preprocessing in unexpected situations during line unwrapping \([https\://github\.com/ansible\-collections/community\.routeros/issues/170](https\://github\.com/ansible\-collections/community\.routeros/issues/170)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/177](https\://github\.com/ansible\-collections/community\.routeros/pull/177)\)\.
<a id="v2-8-0"></a> <a id="v2-8-0"></a>
## v2\.8\.0 ## v2\.8\.0
<a id="release-summary-24"></a> <a id="release-summary-25"></a>
### Release Summary ### Release Summary
Bugfix and feature release\. Bugfix and feature release\.
@ -598,7 +614,7 @@ Bugfix and feature release\.
* api\_modify \- support API paths <code>ip firewall layer7\-protocol</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/153](https\://github\.com/ansible\-collections/community\.routeros/pull/153)\)\. * api\_modify \- support API paths <code>ip firewall layer7\-protocol</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/153](https\://github\.com/ansible\-collections/community\.routeros/pull/153)\)\.
* command \- workaround for extra characters in stdout in RouterOS versions between 6\.49 and 7\.1\.5 \([https\://github\.com/ansible\-collections/community\.routeros/issues/62](https\://github\.com/ansible\-collections/community\.routeros/issues/62)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/161](https\://github\.com/ansible\-collections/community\.routeros/pull/161)\)\. * command \- workaround for extra characters in stdout in RouterOS versions between 6\.49 and 7\.1\.5 \([https\://github\.com/ansible\-collections/community\.routeros/issues/62](https\://github\.com/ansible\-collections/community\.routeros/issues/62)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/161](https\://github\.com/ansible\-collections/community\.routeros/pull/161)\)\.
<a id="bugfixes-8"></a> <a id="bugfixes-9"></a>
### Bugfixes ### Bugfixes
* api\_info\, api\_modify \- fix default and remove behavior for <code>dhcp\-options</code> in path <code>ip dhcp\-client</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/148](https\://github\.com/ansible\-collections/community\.routeros/issues/148)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/154](https\://github\.com/ansible\-collections/community\.routeros/pull/154)\)\. * api\_info\, api\_modify \- fix default and remove behavior for <code>dhcp\-options</code> in path <code>ip dhcp\-client</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/148](https\://github\.com/ansible\-collections/community\.routeros/issues/148)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/154](https\://github\.com/ansible\-collections/community\.routeros/pull/154)\)\.
@ -608,7 +624,7 @@ Bugfix and feature release\.
<a id="v2-7-0"></a> <a id="v2-7-0"></a>
## v2\.7\.0 ## v2\.7\.0
<a id="release-summary-25"></a> <a id="release-summary-26"></a>
### Release Summary ### Release Summary
Bugfix and feature release\. Bugfix and feature release\.
@ -618,7 +634,7 @@ Bugfix and feature release\.
* api\_modify\, api\_info \- support API paths <code>ip arp</code>\, <code>ip firewall raw</code>\, <code>ipv6 firewall raw</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/144](https\://github\.com/ansible\-collections/community\.routeros/pull/144)\)\. * api\_modify\, api\_info \- support API paths <code>ip arp</code>\, <code>ip firewall raw</code>\, <code>ipv6 firewall raw</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/144](https\://github\.com/ansible\-collections/community\.routeros/pull/144)\)\.
<a id="bugfixes-9"></a> <a id="bugfixes-10"></a>
### Bugfixes ### Bugfixes
* api\_modify\, api\_info \- defaults corrected for fields in <code>interface wireguard peers</code> API path \([https\://github\.com/ansible\-collections/community\.routeros/pull/144](https\://github\.com/ansible\-collections/community\.routeros/pull/144)\)\. * api\_modify\, api\_info \- defaults corrected for fields in <code>interface wireguard peers</code> API path \([https\://github\.com/ansible\-collections/community\.routeros/pull/144](https\://github\.com/ansible\-collections/community\.routeros/pull/144)\)\.
@ -626,7 +642,7 @@ Bugfix and feature release\.
<a id="v2-6-0"></a> <a id="v2-6-0"></a>
## v2\.6\.0 ## v2\.6\.0
<a id="release-summary-26"></a> <a id="release-summary-27"></a>
### Release Summary ### Release Summary
Regular bugfix and feature release\. Regular bugfix and feature release\.
@ -637,7 +653,7 @@ Regular bugfix and feature release\.
* api\_modify\, api\_info \- add field <code>regexp</code> to <code>ip dns static</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/141](https\://github\.com/ansible\-collections/community\.routeros/issues/141)\)\. * api\_modify\, api\_info \- add field <code>regexp</code> to <code>ip dns static</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/141](https\://github\.com/ansible\-collections/community\.routeros/issues/141)\)\.
* api\_modify\, api\_info \- support API paths <code>interface wireguard</code>\, <code>interface wireguard peers</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/143](https\://github\.com/ansible\-collections/community\.routeros/pull/143)\)\. * api\_modify\, api\_info \- support API paths <code>interface wireguard</code>\, <code>interface wireguard peers</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/143](https\://github\.com/ansible\-collections/community\.routeros/pull/143)\)\.
<a id="bugfixes-10"></a> <a id="bugfixes-11"></a>
### Bugfixes ### Bugfixes
* api\_modify \- do not use <code>name</code> as a unique key in <code>ip dns static</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/141](https\://github\.com/ansible\-collections/community\.routeros/issues/141)\)\. * api\_modify \- do not use <code>name</code> as a unique key in <code>ip dns static</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/141](https\://github\.com/ansible\-collections/community\.routeros/issues/141)\)\.
@ -646,7 +662,7 @@ Regular bugfix and feature release\.
<a id="v2-5-0"></a> <a id="v2-5-0"></a>
## v2\.5\.0 ## v2\.5\.0
<a id="release-summary-27"></a> <a id="release-summary-28"></a>
### Release Summary ### Release Summary
Feature and bugfix release\. Feature and bugfix release\.
@ -656,7 +672,7 @@ Feature and bugfix release\.
* api\_info\, api\_modify \- support API paths <code>interface ethernet poe</code>\, <code>interface gre6</code>\, <code>interface vrrp</code> and also support all previously missing fields of entries in <code>ip dhcp\-server</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/137](https\://github\.com/ansible\-collections/community\.routeros/pull/137)\)\. * api\_info\, api\_modify \- support API paths <code>interface ethernet poe</code>\, <code>interface gre6</code>\, <code>interface vrrp</code> and also support all previously missing fields of entries in <code>ip dhcp\-server</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/137](https\://github\.com/ansible\-collections/community\.routeros/pull/137)\)\.
<a id="bugfixes-11"></a> <a id="bugfixes-12"></a>
### Bugfixes ### Bugfixes
* api\_modify \- <code>address\-pool</code> field of entries in API path <code>ip dhcp\-server</code> is not required anymore \([https\://github\.com/ansible\-collections/community\.routeros/pull/137](https\://github\.com/ansible\-collections/community\.routeros/pull/137)\)\. * api\_modify \- <code>address\-pool</code> field of entries in API path <code>ip dhcp\-server</code> is not required anymore \([https\://github\.com/ansible\-collections/community\.routeros/pull/137](https\://github\.com/ansible\-collections/community\.routeros/pull/137)\)\.
@ -664,7 +680,7 @@ Feature and bugfix release\.
<a id="v2-4-0"></a> <a id="v2-4-0"></a>
## v2\.4\.0 ## v2\.4\.0
<a id="release-summary-28"></a> <a id="release-summary-29"></a>
### Release Summary ### Release Summary
Feature release improving the <code>api\*</code> modules\. Feature release improving the <code>api\*</code> modules\.
@ -690,7 +706,7 @@ Feature release improving the <code>api\*</code> modules\.
* api\_modify\, api\_info \- support for fields <code>blackhole</code>\, <code>pref\-src</code>\, <code>routing\-table</code>\, <code>suppress\-hw\-offload</code>\, <code>type</code>\, <code>vrf\-interface</code> in <code>ip route</code> path \([https\://github\.com/ansible\-collections/community\.routeros/pull/131](https\://github\.com/ansible\-collections/community\.routeros/pull/131)\)\. * api\_modify\, api\_info \- support for fields <code>blackhole</code>\, <code>pref\-src</code>\, <code>routing\-table</code>\, <code>suppress\-hw\-offload</code>\, <code>type</code>\, <code>vrf\-interface</code> in <code>ip route</code> path \([https\://github\.com/ansible\-collections/community\.routeros/pull/131](https\://github\.com/ansible\-collections/community\.routeros/pull/131)\)\.
* api\_modify\, api\_info \- support paths <code>system ntp client servers</code> and <code>system ntp server</code> available in ROS7\, as well as new fields <code>servers</code>\, <code>mode</code>\, and <code>vrf</code> for <code>system ntp client</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/122](https\://github\.com/ansible\-collections/community\.routeros/pull/122)\)\. * api\_modify\, api\_info \- support paths <code>system ntp client servers</code> and <code>system ntp server</code> available in ROS7\, as well as new fields <code>servers</code>\, <code>mode</code>\, and <code>vrf</code> for <code>system ntp client</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/122](https\://github\.com/ansible\-collections/community\.routeros/pull/122)\)\.
<a id="bugfixes-12"></a> <a id="bugfixes-13"></a>
### Bugfixes ### Bugfixes
* api\_modify \- <code>ip route</code> entry can be defined without the need of <code>gateway</code> field\, which is correct for unreachable/blackhole type of routes \([https\://github\.com/ansible\-collections/community\.routeros/pull/131](https\://github\.com/ansible\-collections/community\.routeros/pull/131)\)\. * api\_modify \- <code>ip route</code> entry can be defined without the need of <code>gateway</code> field\, which is correct for unreachable/blackhole type of routes \([https\://github\.com/ansible\-collections/community\.routeros/pull/131](https\://github\.com/ansible\-collections/community\.routeros/pull/131)\)\.
@ -708,7 +724,7 @@ Feature release improving the <code>api\*</code> modules\.
<a id="v2-3-1"></a> <a id="v2-3-1"></a>
## v2\.3\.1 ## v2\.3\.1
<a id="release-summary-29"></a> <a id="release-summary-30"></a>
### Release Summary ### Release Summary
Maintenance release with improved documentation\. Maintenance release with improved documentation\.
@ -721,7 +737,7 @@ Maintenance release with improved documentation\.
<a id="v2-3-0"></a> <a id="v2-3-0"></a>
## v2\.3\.0 ## v2\.3\.0
<a id="release-summary-30"></a> <a id="release-summary-31"></a>
### Release Summary ### Release Summary
Feature and bugfix release\. Feature and bugfix release\.
@ -733,7 +749,7 @@ Feature and bugfix release\.
* api\* modules \- added <code>timeout</code> parameter \([https\://github\.com/ansible\-collections/community\.routeros/pull/109](https\://github\.com/ansible\-collections/community\.routeros/pull/109)\)\. * api\* modules \- added <code>timeout</code> parameter \([https\://github\.com/ansible\-collections/community\.routeros/pull/109](https\://github\.com/ansible\-collections/community\.routeros/pull/109)\)\.
* api\_modify\, api\_info \- support API path <code>ip firewall mangle</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/110](https\://github\.com/ansible\-collections/community\.routeros/pull/110)\)\. * api\_modify\, api\_info \- support API path <code>ip firewall mangle</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/110](https\://github\.com/ansible\-collections/community\.routeros/pull/110)\)\.
<a id="bugfixes-13"></a> <a id="bugfixes-14"></a>
### Bugfixes ### Bugfixes
* api\_modify\, api\_info \- make API path <code>ip dhcp\-server</code> support <code>script</code>\, and <code>ip firewall nat</code> support <code>in\-interface</code> and <code>in\-interface\-list</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/110](https\://github\.com/ansible\-collections/community\.routeros/pull/110)\)\. * api\_modify\, api\_info \- make API path <code>ip dhcp\-server</code> support <code>script</code>\, and <code>ip firewall nat</code> support <code>in\-interface</code> and <code>in\-interface\-list</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/110](https\://github\.com/ansible\-collections/community\.routeros/pull/110)\)\.
@ -741,12 +757,12 @@ Feature and bugfix release\.
<a id="v2-2-1"></a> <a id="v2-2-1"></a>
## v2\.2\.1 ## v2\.2\.1
<a id="release-summary-31"></a> <a id="release-summary-32"></a>
### Release Summary ### Release Summary
Bugfix release\. Bugfix release\.
<a id="bugfixes-14"></a> <a id="bugfixes-15"></a>
### Bugfixes ### Bugfixes
* api\_modify\, api\_info \- make API path <code>ip dhcp\-server lease</code> support <code>server\=all</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/104](https\://github\.com/ansible\-collections/community\.routeros/issues/104)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/107](https\://github\.com/ansible\-collections/community\.routeros/pull/107)\)\. * api\_modify\, api\_info \- make API path <code>ip dhcp\-server lease</code> support <code>server\=all</code> \([https\://github\.com/ansible\-collections/community\.routeros/issues/104](https\://github\.com/ansible\-collections/community\.routeros/issues/104)\, [https\://github\.com/ansible\-collections/community\.routeros/pull/107](https\://github\.com/ansible\-collections/community\.routeros/pull/107)\)\.
@ -755,7 +771,7 @@ Bugfix release\.
<a id="v2-2-0"></a> <a id="v2-2-0"></a>
## v2\.2\.0 ## v2\.2\.0
<a id="release-summary-32"></a> <a id="release-summary-33"></a>
### Release Summary ### Release Summary
New feature release\. New feature release\.
@ -765,7 +781,7 @@ New feature release\.
* All software licenses are now in the <code>LICENSES/</code> directory of the collection root\. Moreover\, <code>SPDX\-License\-Identifier\:</code> is used to declare the applicable license for every file that is not automatically generated \([https\://github\.com/ansible\-collections/community\.routeros/pull/101](https\://github\.com/ansible\-collections/community\.routeros/pull/101)\)\. * All software licenses are now in the <code>LICENSES/</code> directory of the collection root\. Moreover\, <code>SPDX\-License\-Identifier\:</code> is used to declare the applicable license for every file that is not automatically generated \([https\://github\.com/ansible\-collections/community\.routeros/pull/101](https\://github\.com/ansible\-collections/community\.routeros/pull/101)\)\.
<a id="bugfixes-15"></a> <a id="bugfixes-16"></a>
### Bugfixes ### Bugfixes
* Include <code>LICENSES/BSD\-2\-Clause\.txt</code> file for the <code>routeros</code> module utils \([https\://github\.com/ansible\-collections/community\.routeros/pull/101](https\://github\.com/ansible\-collections/community\.routeros/pull/101)\)\. * Include <code>LICENSES/BSD\-2\-Clause\.txt</code> file for the <code>routeros</code> module utils \([https\://github\.com/ansible\-collections/community\.routeros/pull/101](https\://github\.com/ansible\-collections/community\.routeros/pull/101)\)\.
@ -779,7 +795,7 @@ New feature release\.
<a id="v2-1-0"></a> <a id="v2-1-0"></a>
## v2\.1\.0 ## v2\.1\.0
<a id="release-summary-33"></a> <a id="release-summary-34"></a>
### Release Summary ### Release Summary
Feature and bugfix release with new modules\. Feature and bugfix release with new modules\.
@ -793,7 +809,7 @@ Feature and bugfix release with new modules\.
* api \- update <code>query</code> to accept symbolic parameters \([https\://github\.com/ansible\-collections/community\.routeros/pull/63](https\://github\.com/ansible\-collections/community\.routeros/pull/63)\)\. * api \- update <code>query</code> to accept symbolic parameters \([https\://github\.com/ansible\-collections/community\.routeros/pull/63](https\://github\.com/ansible\-collections/community\.routeros/pull/63)\)\.
* api\* modules \- allow to set an encoding other than the default ASCII for communicating with the API \([https\://github\.com/ansible\-collections/community\.routeros/pull/95](https\://github\.com/ansible\-collections/community\.routeros/pull/95)\)\. * api\* modules \- allow to set an encoding other than the default ASCII for communicating with the API \([https\://github\.com/ansible\-collections/community\.routeros/pull/95](https\://github\.com/ansible\-collections/community\.routeros/pull/95)\)\.
<a id="bugfixes-16"></a> <a id="bugfixes-17"></a>
### Bugfixes ### Bugfixes
* query \- fix query function check for <code>\.id</code> vs\. <code>id</code> arguments to not conflict with routeros arguments like <code>identity</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/68](https\://github\.com/ansible\-collections/community\.routeros/pull/68)\, [https\://github\.com/ansible\-collections/community\.routeros/issues/67](https\://github\.com/ansible\-collections/community\.routeros/issues/67)\)\. * query \- fix query function check for <code>\.id</code> vs\. <code>id</code> arguments to not conflict with routeros arguments like <code>identity</code> \([https\://github\.com/ansible\-collections/community\.routeros/pull/68](https\://github\.com/ansible\-collections/community\.routeros/pull/68)\, [https\://github\.com/ansible\-collections/community\.routeros/issues/67](https\://github\.com/ansible\-collections/community\.routeros/issues/67)\)\.
@ -808,7 +824,7 @@ Feature and bugfix release with new modules\.
<a id="v2-0-0"></a> <a id="v2-0-0"></a>
## v2\.0\.0 ## v2\.0\.0
<a id="release-summary-34"></a> <a id="release-summary-35"></a>
### Release Summary ### Release Summary
A new major release with breaking changes in the behavior of <code>community\.routeros\.api</code> and <code>community\.routeros\.command</code>\. A new major release with breaking changes in the behavior of <code>community\.routeros\.api</code> and <code>community\.routeros\.command</code>\.
@ -827,7 +843,7 @@ A new major release with breaking changes in the behavior of <code>community\.ro
* api \- splitting commands no longer uses a naive split by whitespace\, but a more RouterOS CLI compatible splitting algorithm \([https\://github\.com/ansible\-collections/community\.routeros/pull/45](https\://github\.com/ansible\-collections/community\.routeros/pull/45)\)\. * api \- splitting commands no longer uses a naive split by whitespace\, but a more RouterOS CLI compatible splitting algorithm \([https\://github\.com/ansible\-collections/community\.routeros/pull/45](https\://github\.com/ansible\-collections/community\.routeros/pull/45)\)\.
* command \- the module now always indicates that a change happens\. If this is not correct\, please use <code>changed\_when</code> to determine the correct changed status for a task \([https\://github\.com/ansible\-collections/community\.routeros/pull/50](https\://github\.com/ansible\-collections/community\.routeros/pull/50)\)\. * command \- the module now always indicates that a change happens\. If this is not correct\, please use <code>changed\_when</code> to determine the correct changed status for a task \([https\://github\.com/ansible\-collections/community\.routeros/pull/50](https\://github\.com/ansible\-collections/community\.routeros/pull/50)\)\.
<a id="bugfixes-17"></a> <a id="bugfixes-18"></a>
### Bugfixes ### Bugfixes
* api \- improve splitting of <code>WHERE</code> queries \([https\://github\.com/ansible\-collections/community\.routeros/pull/47](https\://github\.com/ansible\-collections/community\.routeros/pull/47)\)\. * api \- improve splitting of <code>WHERE</code> queries \([https\://github\.com/ansible\-collections/community\.routeros/pull/47](https\://github\.com/ansible\-collections/community\.routeros/pull/47)\)\.
@ -849,7 +865,7 @@ A new major release with breaking changes in the behavior of <code>community\.ro
<a id="v1-2-0"></a> <a id="v1-2-0"></a>
## v1\.2\.0 ## v1\.2\.0
<a id="release-summary-35"></a> <a id="release-summary-36"></a>
### Release Summary ### Release Summary
Bugfix and feature release\. Bugfix and feature release\.
@ -862,7 +878,7 @@ Bugfix and feature release\.
* api \- rename option <code>ssl</code> to <code>tls</code>\, and keep the old name as an alias \([https\://github\.com/ansible\-collections/community\.routeros/pull/37](https\://github\.com/ansible\-collections/community\.routeros/pull/37)\)\. * api \- rename option <code>ssl</code> to <code>tls</code>\, and keep the old name as an alias \([https\://github\.com/ansible\-collections/community\.routeros/pull/37](https\://github\.com/ansible\-collections/community\.routeros/pull/37)\)\.
* fact \- add fact <code>ansible\_net\_config\_nonverbose</code> to get idempotent config \(no date\, no verbose\) \([https\://github\.com/ansible\-collections/community\.routeros/pull/23](https\://github\.com/ansible\-collections/community\.routeros/pull/23)\)\. * fact \- add fact <code>ansible\_net\_config\_nonverbose</code> to get idempotent config \(no date\, no verbose\) \([https\://github\.com/ansible\-collections/community\.routeros/pull/23](https\://github\.com/ansible\-collections/community\.routeros/pull/23)\)\.
<a id="bugfixes-18"></a> <a id="bugfixes-19"></a>
### Bugfixes ### Bugfixes
* api \- when using TLS/SSL\, remove explicit cipher configuration to insecure values\, which also makes it impossible to connect to newer RouterOS versions \([https\://github\.com/ansible\-collections/community\.routeros/pull/34](https\://github\.com/ansible\-collections/community\.routeros/pull/34)\)\. * api \- when using TLS/SSL\, remove explicit cipher configuration to insecure values\, which also makes it impossible to connect to newer RouterOS versions \([https\://github\.com/ansible\-collections/community\.routeros/pull/34](https\://github\.com/ansible\-collections/community\.routeros/pull/34)\)\.
@ -870,7 +886,7 @@ Bugfix and feature release\.
<a id="v1-1-0"></a> <a id="v1-1-0"></a>
## v1\.1\.0 ## v1\.1\.0
<a id="release-summary-36"></a> <a id="release-summary-37"></a>
### Release Summary ### Release Summary
This release allow dashes in usernames for SSH\-based modules\. This release allow dashes in usernames for SSH\-based modules\.
@ -884,12 +900,12 @@ This release allow dashes in usernames for SSH\-based modules\.
<a id="v1-0-1"></a> <a id="v1-0-1"></a>
## v1\.0\.1 ## v1\.0\.1
<a id="release-summary-37"></a> <a id="release-summary-38"></a>
### Release Summary ### Release Summary
Maintenance release with a bugfix for <code>api</code>\. Maintenance release with a bugfix for <code>api</code>\.
<a id="bugfixes-19"></a> <a id="bugfixes-20"></a>
### Bugfixes ### Bugfixes
* api \- remove <code>id to \.id</code> as default requirement which conflicts with RouterOS <code>id</code> configuration parameter \([https\://github\.com/ansible\-collections/community\.routeros/pull/15](https\://github\.com/ansible\-collections/community\.routeros/pull/15)\)\. * api \- remove <code>id to \.id</code> as default requirement which conflicts with RouterOS <code>id</code> configuration parameter \([https\://github\.com/ansible\-collections/community\.routeros/pull/15](https\://github\.com/ansible\-collections/community\.routeros/pull/15)\)\.
@ -897,12 +913,12 @@ Maintenance release with a bugfix for <code>api</code>\.
<a id="v1-0-0"></a> <a id="v1-0-0"></a>
## v1\.0\.0 ## v1\.0\.0
<a id="release-summary-38"></a> <a id="release-summary-39"></a>
### Release Summary ### Release Summary
This is the first production \(non\-prerelease\) release of <code>community\.routeros</code>\. This is the first production \(non\-prerelease\) release of <code>community\.routeros</code>\.
<a id="bugfixes-20"></a> <a id="bugfixes-21"></a>
### Bugfixes ### Bugfixes
* routeros terminal plugin \- allow slashes in hostnames for terminal detection\. Without this\, slashes in hostnames will result in connection timeouts \([https\://github\.com/ansible\-collections/community\.network/pull/138](https\://github\.com/ansible\-collections/community\.network/pull/138)\)\. * routeros terminal plugin \- allow slashes in hostnames for terminal detection\. Without this\, slashes in hostnames will result in connection timeouts \([https\://github\.com/ansible\-collections/community\.network/pull/138](https\://github\.com/ansible\-collections/community\.network/pull/138)\)\.
@ -910,12 +926,12 @@ This is the first production \(non\-prerelease\) release of <code>community\.rou
<a id="v0-1-1"></a> <a id="v0-1-1"></a>
## v0\.1\.1 ## v0\.1\.1
<a id="release-summary-39"></a> <a id="release-summary-40"></a>
### Release Summary ### Release Summary
Small improvements and bugfixes over the initial release\. Small improvements and bugfixes over the initial release\.
<a id="bugfixes-21"></a> <a id="bugfixes-22"></a>
### Bugfixes ### Bugfixes
* api \- fix crash when the <code>ssl</code> parameter is used \([https\://github\.com/ansible\-collections/community\.routeros/pull/3](https\://github\.com/ansible\-collections/community\.routeros/pull/3)\)\. * api \- fix crash when the <code>ssl</code> parameter is used \([https\://github\.com/ansible\-collections/community\.routeros/pull/3](https\://github\.com/ansible\-collections/community\.routeros/pull/3)\)\.
@ -923,7 +939,7 @@ Small improvements and bugfixes over the initial release\.
<a id="v0-1-0"></a> <a id="v0-1-0"></a>
## v0\.1\.0 ## v0\.1\.0
<a id="release-summary-40"></a> <a id="release-summary-41"></a>
### Release Summary ### Release Summary
The <code>community\.routeros</code> continues the work on the Ansible RouterOS modules from their state in <code>community\.network</code> 1\.2\.0\. The changes listed here are thus relative to the modules <code>community\.network\.routeros\_\*</code>\. The <code>community\.routeros</code> continues the work on the Ansible RouterOS modules from their state in <code>community\.network</code> 1\.2\.0\. The changes listed here are thus relative to the modules <code>community\.network\.routeros\_\*</code>\.

13
CHANGELOG.rst
View file

@ -4,6 +4,19 @@ Community RouterOS Release Notes
.. contents:: Topics .. contents:: Topics
v3.8.1
======
Release Summary
---------------
Bugfix release.
Bugfixes
--------
- facts and api_facts modules - prevent deprecation warnings when used with ansible-core 2.19 (https://github.com/ansible-collections/community.routeros/pull/384).
v3.8.0 v3.8.0
====== ======

10
changelogs/changelog.yaml
View file

@ -934,3 +934,13 @@ releases:
- 375-port_isolation-and-routing_bfd_configuration.yml - 375-port_isolation-and-routing_bfd_configuration.yml
- 376-ipsec-mode-config.yml - 376-ipsec-mode-config.yml
release_date: '2025-06-14' release_date: '2025-06-14'
3.8.1:
changes:
bugfixes:
- facts and api_facts modules - prevent deprecation warnings when used with
ansible-core 2.19 (https://github.com/ansible-collections/community.routeros/pull/384).
release_summary: Bugfix release.
fragments:
- 3.8.1.yml
- 384-warnings.yml
release_date: '2025-07-26'

1
changelogs/fragments/3.8.1.yml
View file

@ -1 +0,0 @@
release_summary: Bugfix release.

2
changelogs/fragments/384-warnings.yml
View file

@ -1,2 +0,0 @@
bugfixes:
- "facts and api_facts modules - prevent deprecation warnings when used with ansible-core 2.19 (https://github.com/ansible-collections/community.routeros/pull/384)."