<liclass="toctree-l1"><aclass="reference internal"href="docsite/api-guide.html">How to connect to RouterOS devices with the RouterOS API</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="docsite/ssh-guide.html">How to connect to RouterOS devices with SSH</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="docsite/quoting.html">How to quote and unquote commands and arguments</a></li>
</ul>
<ul>
<liclass="toctree-l1"><aclass="reference internal"href="api_module.html">community.routeros.api module – Ansible module for RouterOS API</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="api_facts_module.html">community.routeros.api_facts module – Collect facts from remote devices running MikroTik RouterOS using the API</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="api_find_and_modify_module.html">community.routeros.api_find_and_modify module – Find and modify information using the API</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="api_info_module.html">community.routeros.api_info module – Retrieve information from API</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="api_modify_module.html">community.routeros.api_modify module – Modify data at paths with API</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="command_module.html">community.routeros.command module – Run commands on remote devices running MikroTik RouterOS</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="routeros_cliconf.html">community.routeros.routeros cliconf – Use routeros cliconf to run command on MikroTik RouterOS platform</a></li>
</ul>
<ul>
<liclass="toctree-l1"><aclass="reference internal"href="join_filter.html">community.routeros.join filter – Join a list of arguments to a command</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="list_to_dict_filter.html">community.routeros.list_to_dict filter – Convert a list of arguments to a dictionary</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="quote_argument_filter.html">community.routeros.quote_argument filter – Quote an argument</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="quote_argument_value_filter.html">community.routeros.quote_argument_value filter – Quote an argument value</a></li>
<liclass="toctree-l1"><aclass="reference internal"href="split_filter.html">community.routeros.split filter – Split a command into arguments</a></li>
</ul>
<!-- extra nav elements for Ansible beyond RTD Sphinx Theme -->
<h1><aclass="toc-backref"href="#id77"role="doc-backlink">Community.Routeros Release Notes</a><aclass="headerlink"href="#community-routeros-release-notes"title="Link to this heading"></a></h1>
<h2><aclass="toc-backref"href="#id78"role="doc-backlink">v2.20.0</a><aclass="headerlink"href="#v2-20-0"title="Link to this heading"></a></h2>
<sectionid="release-summary">
<h3><aclass="toc-backref"href="#id79"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#release-summary"title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<sectionid="minor-changes">
<h3><aclass="toc-backref"href="#id80"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#minor-changes"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info, api_modify - add new parameters from the RouterOS 7.16 release (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/323">https://github.com/ansible-collections/community.routeros/pull/323</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">cpu-frequency</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">memory-frequency</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">preboot-etherboot</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">preboot-etherboot-server</span></code> properties in <codeclass="docutils literal notranslate"><spanclass="pre">system</span><spanclass="pre">routerboard</span><spanclass="pre">settings</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/320">https://github.com/ansible-collections/community.routeros/pull/320</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">matching-type</span></code> property in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">matcher</span></code> introduced by RouterOS 7.16 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/321">https://github.com/ansible-collections/community.routeros/pull/321</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-19-0">
<h2><aclass="toc-backref"href="#id81"role="doc-backlink">v2.19.0</a><aclass="headerlink"href="#v2-19-0"title="Link to this heading"></a></h2>
<sectionid="id1">
<h3><aclass="toc-backref"href="#id82"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id1"title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<sectionid="id2">
<h3><aclass="toc-backref"href="#id83"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id2"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dns</span><spanclass="pre">adlist</span></code> path implemented by RouterOS 7.15 and newer (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/310">https://github.com/ansible-collections/community.routeros/pull/310</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">mld-version</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">multicast-querier</span></code> properties in <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">bridge</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/315">https://github.com/ansible-collections/community.routeros/pull/315</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">filter</span><spanclass="pre">num-list</span></code> path implemented by RouterOS 7 and newer (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/313">https://github.com/ansible-collections/community.routeros/pull/313</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">igmp-proxy</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/309">https://github.com/ansible-collections/community.routeros/pull/309</a>).</p></li>
<li><p>api_modify, api_info - add read-only <codeclass="docutils literal notranslate"><spanclass="pre">default</span></code> field to <codeclass="docutils literal notranslate"><spanclass="pre">snmp</span><spanclass="pre">community</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/311">https://github.com/ansible-collections/community.routeros/pull/311</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-18-0">
<h2><aclass="toc-backref"href="#id84"role="doc-backlink">v2.18.0</a><aclass="headerlink"href="#v2-18-0"title="Link to this heading"></a></h2>
<sectionid="id3">
<h3><aclass="toc-backref"href="#id85"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id3"title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<sectionid="id4">
<h3><aclass="toc-backref"href="#id86"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id4"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info - allow to restrict the output by limiting fields to specific values with the new <codeclass="docutils literal notranslate"><spanclass="pre">restrict</span></code> option (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/305">https://github.com/ansible-collections/community.routeros/pull/305</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">matcher</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/300">https://github.com/ansible-collections/community.routeros/pull/300</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">ipv6</span><spanclass="pre">nd</span><spanclass="pre">prefix</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/303">https://github.com/ansible-collections/community.routeros/pull/303</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">name</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">is-responder</span></code> properties under the <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireguard</span><spanclass="pre">peers</span></code> path introduced in RouterOS 7.15 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/304">https://github.com/ansible-collections/community.routeros/pull/304</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">ospf</span><spanclass="pre">static-neighbor</span></code> path in RouterOS 7 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/302">https://github.com/ansible-collections/community.routeros/pull/302</a>).</p></li>
<li><p>api_info, api_modify - set default for <codeclass="docutils literal notranslate"><spanclass="pre">force</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">option</span></code> to an explicit <codeclass="docutils literal notranslate"><spanclass="pre">false</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/300">https://github.com/ansible-collections/community.routeros/pull/300</a>).</p></li>
<li><p>api_modify - allow to restrict what is updated by limiting fields to specific values with the new <codeclass="docutils literal notranslate"><spanclass="pre">restrict</span></code> option (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/305">https://github.com/ansible-collections/community.routeros/pull/305</a>).</p></li>
</ul>
</section>
<sectionid="deprecated-features">
<h3><aclass="toc-backref"href="#id87"role="doc-backlink">Deprecated Features</a><aclass="headerlink"href="#deprecated-features"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>The collection deprecates support for all Ansible/ansible-base/ansible-core versions that are currently End of Life, <aclass="reference external"href="https://docs.ansible.com/ansible-core/devel/reference_appendices/release_and_maintenance.html#ansible-core-support-matrix">according to the ansible-core support matrix</a>. 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.</p></li>
</ul>
</section>
<sectionid="bugfixes">
<h3><aclass="toc-backref"href="#id88"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#bugfixes"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - change the default of <codeclass="docutils literal notranslate"><spanclass="pre">ingress-filtering</span></code> in paths <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">bridge</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">bridge</span><spanclass="pre">port</span></code> back to <codeclass="docutils literal notranslate"><spanclass="pre">false</span></code> for RouterOS before version 7 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/305">https://github.com/ansible-collections/community.routeros/pull/305</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-17-0">
<h2><aclass="toc-backref"href="#id89"role="doc-backlink">v2.17.0</a><aclass="headerlink"href="#v2-17-0"title="Link to this heading"></a></h2>
<sectionid="id5">
<h3><aclass="toc-backref"href="#id90"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id5"title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<sectionid="id6">
<h3><aclass="toc-backref"href="#id91"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id6"title="Link to this heading"></a></h3>
<li><p>api_info, api_modify - add default value for <codeclass="docutils literal notranslate"><spanclass="pre">from-pool</span></code> field in <codeclass="docutils literal notranslate"><spanclass="pre">/ipv6</span><spanclass="pre">address</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/270">https://github.com/ansible-collections/community.routeros/pull/270</a>).</p></li>
<li><p>api_info, api_modify - added support for <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wifi</span></code> and its sub-paths (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/266">https://github.com/ansible-collections/community.routeros/pull/266</a>).</p></li>
<li><p>api_info, api_modify - remove default value for read-only <codeclass="docutils literal notranslate"><spanclass="pre">running</span></code> field in <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireless</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/264">https://github.com/ansible-collections/community.routeros/pull/264</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-13-0">
<h2><aclass="toc-backref"href="#id101"role="doc-backlink">v2.13.0</a><aclass="headerlink"href="#v2-13-0"title="Link to this heading"></a></h2>
<sectionid="id13">
<h3><aclass="toc-backref"href="#id102"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id13"title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<sectionid="id14">
<h3><aclass="toc-backref"href="#id103"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id14"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info, api_modify - make path <codeclass="docutils literal notranslate"><spanclass="pre">user</span><spanclass="pre">group</span></code> modifiable and add <codeclass="docutils literal notranslate"><spanclass="pre">comment</span></code> attribute (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/256">https://github.com/ansible-collections/community.routeros/issues/256</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/257">https://github.com/ansible-collections/community.routeros/pull/257</a>).</p></li>
<li><p>api_modify, api_info - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">vrf</span></code> path in RouterOS 7 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/259">https://github.com/ansible-collections/community.routeros/pull/259</a>)</p></li>
</ul>
</section>
<sectionid="id15">
<h3><aclass="toc-backref"href="#id104"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id15"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>facts - fix date not getting removed for idempotent config export (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/262">https://github.com/ansible-collections/community.routeros/pull/262</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-12-0">
<h2><aclass="toc-backref"href="#id105"role="doc-backlink">v2.12.0</a><aclass="headerlink"href="#v2-12-0"title="Link to this heading"></a></h2>
<sectionid="id16">
<h3><aclass="toc-backref"href="#id106"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id16"title="Link to this heading"></a></h3>
<p>Feature release.</p>
</section>
<sectionid="id17">
<h3><aclass="toc-backref"href="#id107"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id17"title="Link to this heading"></a></h3>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">tx-power</span></code> attribute in <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireless</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/239">https://github.com/ansible-collections/community.routeros/pull/239</a>).</p></li>
<li><p>api_modify, api_info - added support for <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wifiwave2</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/226">https://github.com/ansible-collections/community.routeros/pull/226</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-11-0">
<h2><aclass="toc-backref"href="#id108"role="doc-backlink">v2.11.0</a><aclass="headerlink"href="#v2-11-0"title="Link to this heading"></a></h2>
<sectionid="id18">
<h3><aclass="toc-backref"href="#id109"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id18"title="Link to this heading"></a></h3>
<p>Feature and bugfix release.</p>
</section>
<sectionid="id19">
<h3><aclass="toc-backref"href="#id110"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id19"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info, api_modify - add missing DoH parameters <codeclass="docutils literal notranslate"><spanclass="pre">doh-max-concurrent-queries</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">doh-max-server-connections</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">doh-timeout</span></code> to the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dns</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/230">https://github.com/ansible-collections/community.routeros/issues/230</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/235">https://github.com/ansible-collections/community.routeros/pull/235</a>)</p></li>
<li><p>api_info, api_modify - add missing parameters <codeclass="docutils literal notranslate"><spanclass="pre">address-list</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">address-list-timeout</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">randomise-ports</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">realm</span></code> to subpaths of the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/236">https://github.com/ansible-collections/community.routeros/issues/236</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/237">https://github.com/ansible-collections/community.routeros/pull/237</a>).</p></li>
<li><p>api_info, api_modify - mark the <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireless</span></code> parameter <codeclass="docutils literal notranslate"><spanclass="pre">running</span></code> as read-only (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/233">https://github.com/ansible-collections/community.routeros/pull/233</a>).</p></li>
<li><p>api_info, api_modify - set the default value to <codeclass="docutils literal notranslate"><spanclass="pre">false</span></code> for the <codeclass="docutils literal notranslate"><spanclass="pre">disabled</span></code> parameter in some more paths where it can be seen in the documentation (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/237">https://github.com/ansible-collections/community.routeros/pull/237</a>).</p></li>
<li><p>api_modify - add missing attributes to the <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">bgp</span><spanclass="pre">connection</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/234">https://github.com/ansible-collections/community.routeros/pull/234</a>).</p></li>
<li><p>api_modify - add versioning to the <codeclass="docutils literal notranslate"><spanclass="pre">/tool</span><spanclass="pre">e-mail</span></code> path (RouterOS 7.12 release) (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/234">https://github.com/ansible-collections/community.routeros/pull/234</a>).</p></li>
<li><p>api_modify - make <codeclass="docutils literal notranslate"><spanclass="pre">/ip</span><spanclass="pre">traffic-flow</span><spanclass="pre">target</span></code> a multiple value attribute (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/234">https://github.com/ansible-collections/community.routeros/pull/234</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-10-0">
<h2><aclass="toc-backref"href="#id111"role="doc-backlink">v2.10.0</a><aclass="headerlink"href="#v2-10-0"title="Link to this heading"></a></h2>
<sectionid="id20">
<h3><aclass="toc-backref"href="#id112"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id20"title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<sectionid="id21">
<h3><aclass="toc-backref"href="#id113"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id21"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info - add new <codeclass="docutils literal notranslate"><spanclass="pre">include_read_only</span></code> option to select behavior for read-only values. By default these are not returned (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/213">https://github.com/ansible-collections/community.routeros/pull/213</a>).</p></li>
<li><p>api_info, api_modify - add support for <codeclass="docutils literal notranslate"><spanclass="pre">address-list</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">match-subdomain</span></code> introduced by RouterOS 7.7 in the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dns</span><spanclass="pre">static</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/197">https://github.com/ansible-collections/community.routeros/pull/197</a>).</p></li>
<li><p>api_info, api_modify - add support for <codeclass="docutils literal notranslate"><spanclass="pre">user</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">time</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">gmt-offset</span></code> under the <codeclass="docutils literal notranslate"><spanclass="pre">system</span><spanclass="pre">clock</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/210">https://github.com/ansible-collections/community.routeros/pull/210</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">ppp-client</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/199">https://github.com/ansible-collections/community.routeros/pull/199</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireless</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/195">https://github.com/ansible-collections/community.routeros/pull/195</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">iot</span><spanclass="pre">modbus</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/205">https://github.com/ansible-collections/community.routeros/pull/205</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">option</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">option</span><spanclass="pre">sets</span></code> paths (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/223">https://github.com/ansible-collections/community.routeros/pull/223</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">upnp</span><spanclass="pre">interfaces</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">tool</span><spanclass="pre">graphing</span><spanclass="pre">interface</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">tool</span><spanclass="pre">graphing</span><spanclass="pre">resource</span></code> paths (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/227">https://github.com/ansible-collections/community.routeros/pull/227</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">ipv6</span><spanclass="pre">firewall</span><spanclass="pre">nat</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/204">https://github.com/ansible-collections/community.routeros/pull/204</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">mode</span></code> property in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">neighbor</span><spanclass="pre">discovery-settings</span></code> introduced in RouterOS 7.7 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/198">https://github.com/ansible-collections/community.routeros/pull/198</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">port</span><spanclass="pre">remote-access</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/224">https://github.com/ansible-collections/community.routeros/pull/224</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">filter</span><spanclass="pre">rule</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">filter</span><spanclass="pre">select-rule</span></code> paths (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/200">https://github.com/ansible-collections/community.routeros/pull/200</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">table</span></code> path in RouterOS 7 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/215">https://github.com/ansible-collections/community.routeros/pull/215</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">tool</span><spanclass="pre">netwatch</span></code> path in RouterOS 7 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/216">https://github.com/ansible-collections/community.routeros/pull/216</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">user</span><spanclass="pre">settings</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/201">https://github.com/ansible-collections/community.routeros/pull/201</a>).</p></li>
<li><p>api_info, api_modify - add support for the <codeclass="docutils literal notranslate"><spanclass="pre">user</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/211">https://github.com/ansible-collections/community.routeros/pull/211</a>).</p></li>
<li><p>api_info, api_modify - finalize fields for the <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireless</span><spanclass="pre">security-profiles</span></code> path and enable it (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/203">https://github.com/ansible-collections/community.routeros/pull/203</a>).</p></li>
<li><p>api_info, api_modify - finalize fields for the <codeclass="docutils literal notranslate"><spanclass="pre">ppp</span><spanclass="pre">profile</span></code> path and enable it (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/217">https://github.com/ansible-collections/community.routeros/pull/217</a>).</p></li>
<li><p>api_modify - add new <codeclass="docutils literal notranslate"><spanclass="pre">handle_read_only</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">handle_write_only</span></code> options to handle the module’s behavior for read-only and write-only fields (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/213">https://github.com/ansible-collections/community.routeros/pull/213</a>).</p></li>
<li><p>api_modify, api_info - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">id</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">bgp</span><spanclass="pre">connection</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/220">https://github.com/ansible-collections/community.routeros/pull/220</a>).</p></li>
</ul>
</section>
<sectionid="id22">
<h3><aclass="toc-backref"href="#id114"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id22"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info, api_modify - in the <codeclass="docutils literal notranslate"><spanclass="pre">snmp</span></code> path, ensure that <codeclass="docutils literal notranslate"><spanclass="pre">engine-id-suffix</span></code> is only available on RouterOS 7.10+, and that <codeclass="docutils literal notranslate"><spanclass="pre">engine-id</span></code> is read-only on RouterOS 7.10+ (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/208">https://github.com/ansible-collections/community.routeros/issues/208</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/218">https://github.com/ansible-collections/community.routeros/pull/218</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-9-0">
<h2><aclass="toc-backref"href="#id115"role="doc-backlink">v2.9.0</a><aclass="headerlink"href="#v2-9-0"title="Link to this heading"></a></h2>
<sectionid="id23">
<h3><aclass="toc-backref"href="#id116"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id23"title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<sectionid="id24">
<h3><aclass="toc-backref"href="#id117"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id24"title="Link to this heading"></a></h3>
<h3><aclass="toc-backref"href="#id118"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id25"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - add missing parameter <codeclass="docutils literal notranslate"><spanclass="pre">engine-id-suffix</span></code> for the <codeclass="docutils literal notranslate"><spanclass="pre">snmp</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/189">https://github.com/ansible-collections/community.routeros/issues/189</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/190">https://github.com/ansible-collections/community.routeros/pull/190</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-8-3">
<h2><aclass="toc-backref"href="#id119"role="doc-backlink">v2.8.3</a><aclass="headerlink"href="#v2-8-3"title="Link to this heading"></a></h2>
<sectionid="id26">
<h3><aclass="toc-backref"href="#id120"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id26"title="Link to this heading"></a></h3>
<p>Maintenance release with updated documentation.</p>
<p>From this version on, community.routeros is using the new <aclass="reference external"href="https://docs.ansible.com/ansible/devel/dev_guide/developing_modules_documenting.html#semantic-markup-within-module-documentation">Ansible semantic markup</a>
in its documentation. If you look at documentation with the ansible-doc CLI tool
from ansible-core before 2.15, please note that it does not render the markup
correctly. You should be still able to read it in most cases, but you need
ansible-core 2.15 or later to see it as it is intended. Alternatively you can
look at <aclass="reference external"href="https://docs.ansible.com/ansible/devel/collections/community/routeros/">the devel docsite</a>
for the rendered HTML version of the documentation of the latest release.</p>
</section>
<sectionid="known-issues">
<h3><aclass="toc-backref"href="#id121"role="doc-backlink">Known Issues</a><aclass="headerlink"href="#known-issues"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>Ansible markup will show up in raw form on ansible-doc text output for ansible-core before 2.15. If you have trouble deciphering the documentation markup, please upgrade to ansible-core 2.15 (or newer), or read the HTML documentation on <aclass="reference external"href="https://docs.ansible.com/ansible/devel/collections/community/routeros/">https://docs.ansible.com/ansible/devel/collections/community/routeros/</a>.</p></li>
</ul>
</section>
</section>
<sectionid="v2-8-2">
<h2><aclass="toc-backref"href="#id122"role="doc-backlink">v2.8.2</a><aclass="headerlink"href="#v2-8-2"title="Link to this heading"></a></h2>
<sectionid="id27">
<h3><aclass="toc-backref"href="#id123"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id27"title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<sectionid="id28">
<h3><aclass="toc-backref"href="#id124"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id28"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - add missing parameter <codeclass="docutils literal notranslate"><spanclass="pre">tls</span></code> for the <codeclass="docutils literal notranslate"><spanclass="pre">tool</span><spanclass="pre">e-mail</span></code> path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/179">https://github.com/ansible-collections/community.routeros/issues/179</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/180">https://github.com/ansible-collections/community.routeros/pull/180</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-8-1">
<h2><aclass="toc-backref"href="#id125"role="doc-backlink">v2.8.1</a><aclass="headerlink"href="#v2-8-1"title="Link to this heading"></a></h2>
<sectionid="id29">
<h3><aclass="toc-backref"href="#id126"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id29"title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<sectionid="id30">
<h3><aclass="toc-backref"href="#id127"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id30"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>facts - do not crash in CLI output preprocessing in unexpected situations during line unwrapping (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/170">https://github.com/ansible-collections/community.routeros/issues/170</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/177">https://github.com/ansible-collections/community.routeros/pull/177</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-8-0">
<h2><aclass="toc-backref"href="#id128"role="doc-backlink">v2.8.0</a><aclass="headerlink"href="#v2-8-0"title="Link to this heading"></a></h2>
<sectionid="id31">
<h3><aclass="toc-backref"href="#id129"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id31"title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<sectionid="id32">
<h3><aclass="toc-backref"href="#id130"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id32"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify - adapt data for API paths <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">network</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/156">https://github.com/ansible-collections/community.routeros/pull/156</a>).</p></li>
<li><p>api_modify - add support for API path <codeclass="docutils literal notranslate"><spanclass="pre">snmp</span><spanclass="pre">community</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/159">https://github.com/ansible-collections/community.routeros/pull/159</a>).</p></li>
<li><p>api_modify - add support for <codeclass="docutils literal notranslate"><spanclass="pre">trap-interfaces</span></code> in API path <codeclass="docutils literal notranslate"><spanclass="pre">snmp</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/159">https://github.com/ansible-collections/community.routeros/pull/159</a>).</p></li>
<li><p>api_modify - add support to disable IPv6 in API paths <codeclass="docutils literal notranslate"><spanclass="pre">ipv6</span><spanclass="pre">settings</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/158">https://github.com/ansible-collections/community.routeros/pull/158</a>).</p></li>
<li><p>api_modify - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span><spanclass="pre">layer7-protocol</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/153">https://github.com/ansible-collections/community.routeros/pull/153</a>).</p></li>
<li><p>command - workaround for extra characters in stdout in RouterOS versions between 6.49 and 7.1.5 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/62">https://github.com/ansible-collections/community.routeros/issues/62</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/161">https://github.com/ansible-collections/community.routeros/pull/161</a>).</p></li>
</ul>
</section>
<sectionid="id33">
<h3><aclass="toc-backref"href="#id131"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id33"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info, api_modify - fix default and remove behavior for <codeclass="docutils literal notranslate"><spanclass="pre">dhcp-options</span></code> in path <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-client</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/148">https://github.com/ansible-collections/community.routeros/issues/148</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/154">https://github.com/ansible-collections/community.routeros/pull/154</a>).</p></li>
<li><p>api_modify - fix handling of disabled keys on creation (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/154">https://github.com/ansible-collections/community.routeros/pull/154</a>).</p></li>
<li><p>various plugins and modules - remove unnecessary imports (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/149">https://github.com/ansible-collections/community.routeros/pull/149</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-7-0">
<h2><aclass="toc-backref"href="#id132"role="doc-backlink">v2.7.0</a><aclass="headerlink"href="#v2-7-0"title="Link to this heading"></a></h2>
<sectionid="id34">
<h3><aclass="toc-backref"href="#id133"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id34"title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<sectionid="id35">
<h3><aclass="toc-backref"href="#id134"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id35"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">arp</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span><spanclass="pre">raw</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">ipv6</span><spanclass="pre">firewall</span><spanclass="pre">raw</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/144">https://github.com/ansible-collections/community.routeros/pull/144</a>).</p></li>
</ul>
</section>
<sectionid="id36">
<h3><aclass="toc-backref"href="#id135"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id36"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - defaults corrected for fields in <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireguard</span><spanclass="pre">peers</span></code> API path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/144">https://github.com/ansible-collections/community.routeros/pull/144</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-6-0">
<h2><aclass="toc-backref"href="#id136"role="doc-backlink">v2.6.0</a><aclass="headerlink"href="#v2-6-0"title="Link to this heading"></a></h2>
<sectionid="id37">
<h3><aclass="toc-backref"href="#id137"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id37"title="Link to this heading"></a></h3>
<p>Regular bugfix and feature release.</p>
</section>
<sectionid="id38">
<h3><aclass="toc-backref"href="#id138"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id38"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - add field <codeclass="docutils literal notranslate"><spanclass="pre">regexp</span></code> to <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dns</span><spanclass="pre">static</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/141">https://github.com/ansible-collections/community.routeros/issues/141</a>).</p></li>
<li><p>api_modify, api_info - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireguard</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">wireguard</span><spanclass="pre">peers</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/143">https://github.com/ansible-collections/community.routeros/pull/143</a>).</p></li>
</ul>
</section>
<sectionid="id39">
<h3><aclass="toc-backref"href="#id139"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id39"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify - do not use <codeclass="docutils literal notranslate"><spanclass="pre">name</span></code> as a unique key in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dns</span><spanclass="pre">static</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/141">https://github.com/ansible-collections/community.routeros/issues/141</a>).</p></li>
<li><p>api_modify, api_info - do not crash if router contains <codeclass="docutils literal notranslate"><spanclass="pre">regexp</span></code> DNS entries in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dns</span><spanclass="pre">static</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/141">https://github.com/ansible-collections/community.routeros/issues/141</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-5-0">
<h2><aclass="toc-backref"href="#id140"role="doc-backlink">v2.5.0</a><aclass="headerlink"href="#v2-5-0"title="Link to this heading"></a></h2>
<sectionid="id40">
<h3><aclass="toc-backref"href="#id141"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id40"title="Link to this heading"></a></h3>
<p>Feature and bugfix release.</p>
</section>
<sectionid="id41">
<h3><aclass="toc-backref"href="#id142"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id41"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_info, api_modify - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">ethernet</span><spanclass="pre">poe</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">gre6</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">vrrp</span></code> and also support all previously missing fields of entries in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/137">https://github.com/ansible-collections/community.routeros/pull/137</a>).</p></li>
</ul>
</section>
<sectionid="id42">
<h3><aclass="toc-backref"href="#id143"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id42"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify - <codeclass="docutils literal notranslate"><spanclass="pre">address-pool</span></code> field of entries in API path <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span></code> is not required anymore (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/137">https://github.com/ansible-collections/community.routeros/pull/137</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-4-0">
<h2><aclass="toc-backref"href="#id144"role="doc-backlink">v2.4.0</a><aclass="headerlink"href="#v2-4-0"title="Link to this heading"></a></h2>
<sectionid="id43">
<h3><aclass="toc-backref"href="#id145"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id43"title="Link to this heading"></a></h3>
<p>Feature release improving the <codeclass="docutils literal notranslate"><spanclass="pre">api*</span></code> modules.</p>
</section>
<sectionid="id44">
<h3><aclass="toc-backref"href="#id146"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id44"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api* modules - Add new option <codeclass="docutils literal notranslate"><spanclass="pre">force_no_cert</span></code> to connect with ADH ciphers (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/124">https://github.com/ansible-collections/community.routeros/pull/124</a>).</p></li>
<li><p>api_info - new parameter <codeclass="docutils literal notranslate"><spanclass="pre">include_builtin</span></code> which allows to include “builtin” entries that are automatically generated by ROS and cannot be modified by the user (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/130">https://github.com/ansible-collections/community.routeros/pull/130</a>).</p></li>
<li><p>api_modify, api_info - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">list</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">list</span><spanclass="pre">member</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/120">https://github.com/ansible-collections/community.routeros/pull/120</a>).</p></li>
<li><p>api_modify, api_info - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">pppoe-client</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">vlan</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">bridge</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">bridge</span><spanclass="pre">vlan</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/125">https://github.com/ansible-collections/community.routeros/pull/125</a>).</p></li>
<li><p>api_modify, api_info - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">route</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">route</span><spanclass="pre">vrf</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/123">https://github.com/ansible-collections/community.routeros/pull/123</a>).</p></li>
<li><p>api_modify, api_info - support API paths <codeclass="docutils literal notranslate"><spanclass="pre">system</span><spanclass="pre">logging</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">system</span><spanclass="pre">logging</span><spanclass="pre">action</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/127">https://github.com/ansible-collections/community.routeros/pull/127</a>).</p></li>
<li><p>api_modify, api_info - support field <codeclass="docutils literal notranslate"><spanclass="pre">hw-offload</span></code> for path <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span><spanclass="pre">filter</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/121">https://github.com/ansible-collections/community.routeros/pull/121</a>).</p></li>
<li><p>api_modify, api_info - support fields <codeclass="docutils literal notranslate"><spanclass="pre">jump-target</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">reject-with</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span><spanclass="pre">filter</span></code> API path, field <codeclass="docutils literal notranslate"><spanclass="pre">comment</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firwall</span><spanclass="pre">address-list</span></code> API path, field <codeclass="docutils literal notranslate"><spanclass="pre">jump-target</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span><spanclass="pre">mangle</span></code> API path, field <codeclass="docutils literal notranslate"><spanclass="pre">comment</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">ipv6</span><spanclass="pre">firewall</span><spanclass="pre">address-list</span></code> API path, fields <codeclass="docutils literal notranslate"><spanclass="pre">jump-target</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">reject-with</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">ipv6</span><spanclass="pre">firewall</span><spanclass="pre">filter</span></code> API path (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/133">https://github.com/ansible-collections/community.routeros/pull/133</a>).</p></li>
<li><p>api_modify, api_info - support for API fields that can be disabled and have default value at the same time, support API paths <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">gre</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">eoip</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/128">https://github.com/ansible-collections/community.routeros/pull/128</a>).</p></li>
<li><p>api_modify, api_info - support paths <codeclass="docutils literal notranslate"><spanclass="pre">system</span><spanclass="pre">ntp</span><spanclass="pre">client</span><spanclass="pre">servers</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">system</span><spanclass="pre">ntp</span><spanclass="pre">server</span></code> available in ROS7, as well as new fields <codeclass="docutils literal notranslate"><spanclass="pre">servers</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">mode</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">vrf</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">system</span><spanclass="pre">ntp</span><spanclass="pre">client</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/122">https://github.com/ansible-collections/community.routeros/pull/122</a>).</p></li>
</ul>
</section>
<sectionid="id45">
<h3><aclass="toc-backref"href="#id147"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id45"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify - <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">route</span></code> entry can be defined without the need of <codeclass="docutils literal notranslate"><spanclass="pre">gateway</span></code> field, which is correct for unreachable/blackhole type of routes (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/131">https://github.com/ansible-collections/community.routeros/pull/131</a>).</p></li>
<li><p>api_modify - <codeclass="docutils literal notranslate"><spanclass="pre">queue</span><spanclass="pre">interface</span></code> path works now (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/131">https://github.com/ansible-collections/community.routeros/pull/131</a>).</p></li>
<li><p>api_modify, api_info - removed wrong field <codeclass="docutils literal notranslate"><spanclass="pre">dynamic</span></code> from API path <codeclass="docutils literal notranslate"><spanclass="pre">ipv6</span><spanclass="pre">firewall</span><spanclass="pre">address-list</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/133">https://github.com/ansible-collections/community.routeros/pull/133</a>).</p></li>
<li><p>api_modify, api_info - the default of the field <codeclass="docutils literal notranslate"><spanclass="pre">ingress-filtering</span></code> in <codeclass="docutils literal notranslate"><spanclass="pre">interface</span><spanclass="pre">bridge</span><spanclass="pre">port</span></code> is now <codeclass="docutils literal notranslate"><spanclass="pre">true</span></code>, which is the default in ROS (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/125">https://github.com/ansible-collections/community.routeros/pull/125</a>).</p></li>
<li><p>command, facts - commands do not timeout in safe mode anymore (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/134">https://github.com/ansible-collections/community.routeros/pull/134</a>).</p></li>
</ul>
</section>
<sectionid="id46">
<h3><aclass="toc-backref"href="#id148"role="doc-backlink">Known Issues</a><aclass="headerlink"href="#id46"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify - when limits for entries in <codeclass="docutils literal notranslate"><spanclass="pre">queue</span><spanclass="pre">tree</span></code> are defined as human readable - for example <codeclass="docutils literal notranslate"><spanclass="pre">25M</span></code> -, the configuration will be correctly set in ROS, but the module will indicate the item is changed on every run even when there was no change done. This is caused by the ROS API which returns the number in bytes - for example <codeclass="docutils literal notranslate"><spanclass="pre">25000000</span></code> (which is inconsistent with the CLI behavior). In order to mitigate that, the limits have to be defined in bytes (those will still appear as human readable in the ROS CLI) (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/131">https://github.com/ansible-collections/community.routeros/pull/131</a>).</p></li>
<li><p>api_modify, api_info - <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">ospf</span><spanclass="pre">area</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">ospf</span><spanclass="pre">area</span><spanclass="pre">range</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">ospf</span><spanclass="pre">instance</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">routing</span><spanclass="pre">ospf</span><spanclass="pre">interface-template</span></code> paths are not fully implemented for ROS6 due to the significant changes between ROS6 and ROS7 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/131">https://github.com/ansible-collections/community.routeros/pull/131</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-3-1">
<h2><aclass="toc-backref"href="#id149"role="doc-backlink">v2.3.1</a><aclass="headerlink"href="#v2-3-1"title="Link to this heading"></a></h2>
<sectionid="id47">
<h3><aclass="toc-backref"href="#id150"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id47"title="Link to this heading"></a></h3>
<p>Maintenance release with improved documentation.</p>
</section>
<sectionid="id48">
<h3><aclass="toc-backref"href="#id151"role="doc-backlink">Known Issues</a><aclass="headerlink"href="#id48"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>The <codeclass="docutils literal notranslate"><spanclass="pre">community.routeros.command</span></code> module claims to support check mode. Since it cannot judge whether the commands executed modify state or not, this behavior is incorrect. Since this potentially breaks existing playbooks, we will not change this behavior until community.routeros 3.0.0.</p></li>
</ul>
</section>
</section>
<sectionid="v2-3-0">
<h2><aclass="toc-backref"href="#id152"role="doc-backlink">v2.3.0</a><aclass="headerlink"href="#v2-3-0"title="Link to this heading"></a></h2>
<sectionid="id49">
<h3><aclass="toc-backref"href="#id153"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id49"title="Link to this heading"></a></h3>
<p>Feature and bugfix release.</p>
</section>
<sectionid="id50">
<h3><aclass="toc-backref"href="#id154"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id50"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>The collection repository conforms to the <aclass="reference external"href="https://reuse.software/spec/">REUSE specification</a> except for the changelog fragments (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/108">https://github.com/ansible-collections/community.routeros/pull/108</a>).</p></li>
<li><p>api_modify, api_info - support API path <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span><spanclass="pre">mangle</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/110">https://github.com/ansible-collections/community.routeros/pull/110</a>).</p></li>
</ul>
</section>
<sectionid="id51">
<h3><aclass="toc-backref"href="#id155"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id51"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - make API path <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span></code> support <codeclass="docutils literal notranslate"><spanclass="pre">script</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">firewall</span><spanclass="pre">nat</span></code> support <codeclass="docutils literal notranslate"><spanclass="pre">in-interface</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">in-interface-list</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/110">https://github.com/ansible-collections/community.routeros/pull/110</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-2-1">
<h2><aclass="toc-backref"href="#id156"role="doc-backlink">v2.2.1</a><aclass="headerlink"href="#v2-2-1"title="Link to this heading"></a></h2>
<sectionid="id52">
<h3><aclass="toc-backref"href="#id157"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id52"title="Link to this heading"></a></h3>
<p>Bugfix release.</p>
</section>
<sectionid="id53">
<h3><aclass="toc-backref"href="#id158"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id53"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api_modify, api_info - make API path <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">lease</span></code> support <codeclass="docutils literal notranslate"><spanclass="pre">server=all</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/104">https://github.com/ansible-collections/community.routeros/issues/104</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/107">https://github.com/ansible-collections/community.routeros/pull/107</a>).</p></li>
<li><p>api_modify, api_info - make API path <codeclass="docutils literal notranslate"><spanclass="pre">ip</span><spanclass="pre">dhcp-server</span><spanclass="pre">network</span></code> support missing options <codeclass="docutils literal notranslate"><spanclass="pre">boot-file-name</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">dhcp-option-set</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">dns-none</span></code>, <codeclass="docutils literal notranslate"><spanclass="pre">domain</span></code>, and <codeclass="docutils literal notranslate"><spanclass="pre">next-server</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/104">https://github.com/ansible-collections/community.routeros/issues/104</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/106">https://github.com/ansible-collections/community.routeros/pull/106</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v2-2-0">
<h2><aclass="toc-backref"href="#id159"role="doc-backlink">v2.2.0</a><aclass="headerlink"href="#v2-2-0"title="Link to this heading"></a></h2>
<sectionid="id54">
<h3><aclass="toc-backref"href="#id160"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id54"title="Link to this heading"></a></h3>
<p>New feature release.</p>
</section>
<sectionid="id55">
<h3><aclass="toc-backref"href="#id161"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id55"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>All software licenses are now in the <codeclass="docutils literal notranslate"><spanclass="pre">LICENSES/</span></code> directory of the collection root. Moreover, <codeclass="docutils literal notranslate"><spanclass="pre">SPDX-License-Identifier:</span></code> is used to declare the applicable license for every file that is not automatically generated (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/101">https://github.com/ansible-collections/community.routeros/pull/101</a>).</p></li>
</ul>
</section>
<sectionid="id56">
<h3><aclass="toc-backref"href="#id162"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id56"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>Include <codeclass="docutils literal notranslate"><spanclass="pre">LICENSES/BSD-2-Clause.txt</span></code> file for the <codeclass="docutils literal notranslate"><spanclass="pre">routeros</span></code> module utils (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/101">https://github.com/ansible-collections/community.routeros/pull/101</a>).</p></li>
</ul>
</section>
<sectionid="new-modules">
<h3><aclass="toc-backref"href="#id163"role="doc-backlink">New Modules</a><aclass="headerlink"href="#new-modules"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>community.routeros.api_info - Retrieve information from API</p></li>
<li><p>community.routeros.api_modify - Modify data at paths with API</p></li>
</ul>
</section>
</section>
<sectionid="v2-1-0">
<h2><aclass="toc-backref"href="#id164"role="doc-backlink">v2.1.0</a><aclass="headerlink"href="#v2-1-0"title="Link to this heading"></a></h2>
<sectionid="id57">
<h3><aclass="toc-backref"href="#id165"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id57"title="Link to this heading"></a></h3>
<p>Feature and bugfix release with new modules.</p>
</section>
<sectionid="id58">
<h3><aclass="toc-backref"href="#id166"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id58"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>Added a <codeclass="docutils literal notranslate"><spanclass="pre">community.routeros.api</span></code> module defaults group. Use with <codeclass="docutils literal notranslate"><spanclass="pre">group/community.routeros.api</span></code> to provide options for all API-based modules (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/89">https://github.com/ansible-collections/community.routeros/pull/89</a>).</p></li>
<li><p>Prepare collection for inclusion in an Execution Environment by declaring its dependencies (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/83">https://github.com/ansible-collections/community.routeros/pull/83</a>).</p></li>
<li><p>api - add new option <codeclass="docutils literal notranslate"><spanclass="pre">extended</span><spanclass="pre">query</span></code> more complex queries against RouterOS API (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/63">https://github.com/ansible-collections/community.routeros/pull/63</a>).</p></li>
<li><p>api* modules - allow to set an encoding other than the default ASCII for communicating with the API (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/95">https://github.com/ansible-collections/community.routeros/pull/95</a>).</p></li>
</ul>
</section>
<sectionid="id59">
<h3><aclass="toc-backref"href="#id167"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id59"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>query - fix query function check for <codeclass="docutils literal notranslate"><spanclass="pre">.id</span></code> vs. <codeclass="docutils literal notranslate"><spanclass="pre">id</span></code> arguments to not conflict with routeros arguments like <codeclass="docutils literal notranslate"><spanclass="pre">identity</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/68">https://github.com/ansible-collections/community.routeros/pull/68</a>, <aclass="reference external"href="https://github.com/ansible-collections/community.routeros/issues/67">https://github.com/ansible-collections/community.routeros/issues/67</a>).</p></li>
<li><p>quoting and unquoting filter plugins, api module - handle the escape sequence <codeclass="docutils literal notranslate"><spanclass="pre">\_</span></code> correctly as escaping a space and not an underscore (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/89">https://github.com/ansible-collections/community.routeros/pull/89</a>).</p></li>
</ul>
</section>
<sectionid="id60">
<h3><aclass="toc-backref"href="#id168"role="doc-backlink">New Modules</a><aclass="headerlink"href="#id60"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>community.routeros.api_facts - Collect facts from remote devices running MikroTik RouterOS using the API</p></li>
<li><p>community.routeros.api_find_and_modify - Find and modify information using the API</p></li>
</ul>
</section>
</section>
<sectionid="v2-0-0">
<h2><aclass="toc-backref"href="#id169"role="doc-backlink">v2.0.0</a><aclass="headerlink"href="#v2-0-0"title="Link to this heading"></a></h2>
<sectionid="id61">
<h3><aclass="toc-backref"href="#id170"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id61"title="Link to this heading"></a></h3>
<p>A new major release with breaking changes in the behavior of <codeclass="docutils literal notranslate"><spanclass="pre">community.routeros.api</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">community.routeros.command</span></code>.</p>
</section>
<sectionid="id62">
<h3><aclass="toc-backref"href="#id171"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id62"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api - make validation of <codeclass="docutils literal notranslate"><spanclass="pre">WHERE</span></code> for <codeclass="docutils literal notranslate"><spanclass="pre">query</span></code> more strict (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/53">https://github.com/ansible-collections/community.routeros/pull/53</a>).</p></li>
<li><p>command - the <codeclass="docutils literal notranslate"><spanclass="pre">commands</span></code> and <codeclass="docutils literal notranslate"><spanclass="pre">wait_for</span></code> options now convert the list elements to strings (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/55">https://github.com/ansible-collections/community.routeros/pull/55</a>).</p></li>
<li><p>facts - the <codeclass="docutils literal notranslate"><spanclass="pre">gather_subset</span></code> option now converts the list elements to strings (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/55">https://github.com/ansible-collections/community.routeros/pull/55</a>).</p></li>
</ul>
</section>
<sectionid="breaking-changes-porting-guide">
<h3><aclass="toc-backref"href="#id172"role="doc-backlink">Breaking Changes / Porting Guide</a><aclass="headerlink"href="#breaking-changes-porting-guide"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api - due to a programming error, the module never failed on errors. This has now been fixed. If you are relying on the module not failing in case of idempotent commands (resulting in errors like <codeclass="docutils literal notranslate"><spanclass="pre">failure:</span><spanclass="pre">already</span><spanclass="pre">have</span><spanclass="pre">such</span><spanclass="pre">address</span></code>), you need to adjust your roles/playbooks. We suggest to use <codeclass="docutils literal notranslate"><spanclass="pre">failed_when</span></code> to accept failure in specific circumstances, for example <codeclass="docutils literal notranslate"><spanclass="pre">failed_when:</span><spanclass="pre">"'failure:</span><spanclass="pre">already</span><spanclass="pre">have</span><spanclass="pre">'</span><spanclass="pre">in</span><spanclass="pre">result.msg[0]"</span></code> (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/39">https://github.com/ansible-collections/community.routeros/pull/39</a>).</p></li>
<li><p>api - splitting commands no longer uses a naive split by whitespace, but a more RouterOS CLI compatible splitting algorithm (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/45">https://github.com/ansible-collections/community.routeros/pull/45</a>).</p></li>
<li><p>command - the module now always indicates that a change happens. If this is not correct, please use <codeclass="docutils literal notranslate"><spanclass="pre">changed_when</span></code> to determine the correct changed status for a task (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/50">https://github.com/ansible-collections/community.routeros/pull/50</a>).</p></li>
</ul>
</section>
<sectionid="id63">
<h3><aclass="toc-backref"href="#id173"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id63"title="Link to this heading"></a></h3>
<li><p>api - when converting result lists to dictionaries, no longer removes second <codeclass="docutils literal notranslate"><spanclass="pre">=</span></code> and text following that if present (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/47">https://github.com/ansible-collections/community.routeros/pull/47</a>).</p></li>
<li><p>routeros cliconf plugin - adjust function signature that was modified in Ansible after creation of this plugin (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/43">https://github.com/ansible-collections/community.routeros/pull/43</a>).</p></li>
</ul>
</section>
<sectionid="new-plugins">
<h3><aclass="toc-backref"href="#id174"role="doc-backlink">New Plugins</a><aclass="headerlink"href="#new-plugins"title="Link to this heading"></a></h3>
<sectionid="filter">
<h4><aclass="toc-backref"href="#id175"role="doc-backlink">Filter</a><aclass="headerlink"href="#filter"title="Link to this heading"></a></h4>
<ulclass="simple">
<li><p>community.routeros.join - Join a list of arguments to a command</p></li>
<li><p>community.routeros.list_to_dict - Convert a list of arguments to a list of dictionary</p></li>
<li><p>community.routeros.quote_argument - Quote an argument</p></li>
<li><p>community.routeros.quote_argument_value - Quote an argument value</p></li>
<li><p>community.routeros.split - Split a command into arguments</p></li>
</ul>
</section>
</section>
</section>
<sectionid="v1-2-0">
<h2><aclass="toc-backref"href="#id176"role="doc-backlink">v1.2.0</a><aclass="headerlink"href="#v1-2-0"title="Link to this heading"></a></h2>
<sectionid="id64">
<h3><aclass="toc-backref"href="#id177"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id64"title="Link to this heading"></a></h3>
<p>Bugfix and feature release.</p>
</section>
<sectionid="id65">
<h3><aclass="toc-backref"href="#id178"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id65"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>Avoid internal ansible-core module_utils in favor of equivalent public API available since at least Ansible 2.9 (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/38">https://github.com/ansible-collections/community.routeros/pull/38</a>).</p></li>
<li><p>api - add options <codeclass="docutils literal notranslate"><spanclass="pre">validate_certs</span></code> (default value <codeclass="docutils literal notranslate"><spanclass="pre">true</span></code>), <codeclass="docutils literal notranslate"><spanclass="pre">validate_cert_hostname</span></code> (default value <codeclass="docutils literal notranslate"><spanclass="pre">false</span></code>), and <codeclass="docutils literal notranslate"><spanclass="pre">ca_path</span></code> to control certificate validation (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/37">https://github.com/ansible-collections/community.routeros/pull/37</a>).</p></li>
<li><p>api - rename option <codeclass="docutils literal notranslate"><spanclass="pre">ssl</span></code> to <codeclass="docutils literal notranslate"><spanclass="pre">tls</span></code>, and keep the old name as an alias (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/37">https://github.com/ansible-collections/community.routeros/pull/37</a>).</p></li>
<li><p>fact - add fact <codeclass="docutils literal notranslate"><spanclass="pre">ansible_net_config_nonverbose</span></code> to get idempotent config (no date, no verbose) (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/23">https://github.com/ansible-collections/community.routeros/pull/23</a>).</p></li>
</ul>
</section>
<sectionid="id66">
<h3><aclass="toc-backref"href="#id179"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id66"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api - when using TLS/SSL, remove explicit cipher configuration to insecure values, which also makes it impossible to connect to newer RouterOS versions (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/34">https://github.com/ansible-collections/community.routeros/pull/34</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v1-1-0">
<h2><aclass="toc-backref"href="#id180"role="doc-backlink">v1.1.0</a><aclass="headerlink"href="#v1-1-0"title="Link to this heading"></a></h2>
<sectionid="id67">
<h3><aclass="toc-backref"href="#id181"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id67"title="Link to this heading"></a></h3>
<p>This release allow dashes in usernames for SSH-based modules.</p>
</section>
<sectionid="id68">
<h3><aclass="toc-backref"href="#id182"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id68"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>command - added support for a dash (<codeclass="docutils literal notranslate"><spanclass="pre">-</span></code>) in username (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/18">https://github.com/ansible-collections/community.routeros/pull/18</a>).</p></li>
<li><p>facts - added support for a dash (<codeclass="docutils literal notranslate"><spanclass="pre">-</span></code>) in username (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/18">https://github.com/ansible-collections/community.routeros/pull/18</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v1-0-1">
<h2><aclass="toc-backref"href="#id183"role="doc-backlink">v1.0.1</a><aclass="headerlink"href="#v1-0-1"title="Link to this heading"></a></h2>
<sectionid="id69">
<h3><aclass="toc-backref"href="#id184"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id69"title="Link to this heading"></a></h3>
<p>Maintenance release with a bugfix for <codeclass="docutils literal notranslate"><spanclass="pre">api</span></code>.</p>
</section>
<sectionid="id70">
<h3><aclass="toc-backref"href="#id185"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id70"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api - remove <codeclass="docutils literal notranslate"><spanclass="pre">id</span><spanclass="pre">to</span><spanclass="pre">.id</span></code> as default requirement which conflicts with RouterOS <codeclass="docutils literal notranslate"><spanclass="pre">id</span></code> configuration parameter (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/15">https://github.com/ansible-collections/community.routeros/pull/15</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v1-0-0">
<h2><aclass="toc-backref"href="#id186"role="doc-backlink">v1.0.0</a><aclass="headerlink"href="#v1-0-0"title="Link to this heading"></a></h2>
<sectionid="id71">
<h3><aclass="toc-backref"href="#id187"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id71"title="Link to this heading"></a></h3>
<p>This is the first production (non-prerelease) release of <codeclass="docutils literal notranslate"><spanclass="pre">community.routeros</span></code>.</p>
</section>
<sectionid="id72">
<h3><aclass="toc-backref"href="#id188"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id72"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>routeros terminal plugin - allow slashes in hostnames for terminal detection. Without this, slashes in hostnames will result in connection timeouts (<aclass="reference external"href="https://github.com/ansible-collections/community.network/pull/138">https://github.com/ansible-collections/community.network/pull/138</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v0-1-1">
<h2><aclass="toc-backref"href="#id189"role="doc-backlink">v0.1.1</a><aclass="headerlink"href="#v0-1-1"title="Link to this heading"></a></h2>
<sectionid="id73">
<h3><aclass="toc-backref"href="#id190"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id73"title="Link to this heading"></a></h3>
<p>Small improvements and bugfixes over the initial release.</p>
</section>
<sectionid="id74">
<h3><aclass="toc-backref"href="#id191"role="doc-backlink">Bugfixes</a><aclass="headerlink"href="#id74"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>api - fix crash when the <codeclass="docutils literal notranslate"><spanclass="pre">ssl</span></code> parameter is used (<aclass="reference external"href="https://github.com/ansible-collections/community.routeros/pull/3">https://github.com/ansible-collections/community.routeros/pull/3</a>).</p></li>
</ul>
</section>
</section>
<sectionid="v0-1-0">
<h2><aclass="toc-backref"href="#id192"role="doc-backlink">v0.1.0</a><aclass="headerlink"href="#v0-1-0"title="Link to this heading"></a></h2>
<sectionid="id75">
<h3><aclass="toc-backref"href="#id193"role="doc-backlink">Release Summary</a><aclass="headerlink"href="#id75"title="Link to this heading"></a></h3>
<p>The <codeclass="docutils literal notranslate"><spanclass="pre">community.routeros</span></code> continues the work on the Ansible RouterOS modules from their state in <codeclass="docutils literal notranslate"><spanclass="pre">community.network</span></code> 1.2.0. The changes listed here are thus relative to the modules <codeclass="docutils literal notranslate"><spanclass="pre">community.network.routeros_*</span></code>.</p>
</section>
<sectionid="id76">
<h3><aclass="toc-backref"href="#id194"role="doc-backlink">Minor Changes</a><aclass="headerlink"href="#id76"title="Link to this heading"></a></h3>
<ulclass="simple">
<li><p>facts - now also collecting data about BGP and OSPF (<aclass="reference external"href="https://github.com/ansible-collections/community.network/pull/101">https://github.com/ansible-collections/community.network/pull/101</a>).</p></li>
<li><p>facts - set configuration export on to verbose, for full configuration export (<aclass="reference external"href="https://github.com/ansible-collections/community.network/pull/104">https://github.com/ansible-collections/community.network/pull/104</a>).</p></li>
<ahref="docsite/api-guide.html"class="btn btn-neutral float-right"title="How to connect to RouterOS devices with the RouterOS API"accesskey="n"rel="next">Next <spanclass="fa fa-arrow-circle-right"aria-hidden="true"></span></a>
