2022-11-26 09:11:24 +00:00
<!DOCTYPE html>
< html class = "writer-html5" lang = "en" >
< head >
2023-02-08 05:27:47 +00:00
< meta charset = "utf-8" / > < meta name = "generator" content = "Docutils 0.18.1: http://docutils.sourceforge.net/" / >
2023-09-30 20:17:11 +00:00
< meta content = "2.5.0" name = "antsibull-docs" / >
2022-11-26 09:11:24 +00:00
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" / >
2022-12-18 21:18:26 +00:00
< title > community.routeros.api_modify module – — Community.Routeros Collection documentation< / title >
2022-11-26 09:11:24 +00:00
< link rel = "stylesheet" href = "_static/pygments.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/css/ansible.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/antsibull-minimal.css" type = "text/css" / >
< link rel = "stylesheet" href = "_static/css/rtd-ethical-ads.css" type = "text/css" / >
< link rel = "shortcut icon" href = "_static/images/Ansible-Mark-RGB_Black.png" / >
<!-- [if lt IE 9]>
< script src = "_static/js/html5shiv.min.js" > < / script >
<![endif]-->
2023-08-21 20:13:03 +00:00
< script src = "_static/jquery.js?v=5d32c60e" > < / script >
< script src = "_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c" > < / script >
< script src = "_static/documentation_options.js?v=7f41d439" > < / script >
< script src = "_static/doctools.js?v=888ff710" > < / script >
< script src = "_static/sphinx_highlight.js?v=dc90522c" > < / script >
2022-11-26 09:11:24 +00:00
< script src = "_static/js/theme.js" > < / script >
< link rel = "search" title = "Search" href = "search.html" / >
< link rel = "next" title = "community.routeros.command module – href = "command_module.html" / >
< link rel = "prev" title = "community.routeros.api_info module – href = "api_info_module.html" / > <!-- extra head elements for Ansible beyond RTD Sphinx Theme -->
< / head >
< body class = "wy-body-for-nav" > <!-- extra body elements for Ansible beyond RTD Sphinx Theme -->
< div class = "DocSite-globalNav ansibleNav" >
< ul >
< li > < a href = "https://www.ansible.com/ansiblefest" target = "_blank" > AnsibleFest< / a > < / li >
< li > < a href = "https://www.ansible.com/tower" target = "_blank" > Products< / a > < / li >
< li > < a href = "https://www.ansible.com/community" target = "_blank" > Community< / a > < / li >
< li > < a href = "https://www.ansible.com/webinars-training" target = "_blank" > Webinars & Training< / a > < / li >
< li > < a href = "https://www.ansible.com/blog" target = "_blank" > Blog< / a > < / li >
< / ul >
< / div >
2022-12-18 21:18:26 +00:00
< a class = "DocSite-nav" href = "https://ansible-collections.github.io/community.routeros/branch/main/" style = "padding-bottom: 30px;" >
2022-11-26 09:11:24 +00:00
< img class = "DocSiteNav-logo"
src="_static/images/Ansible-Mark-RGB_White.png"
alt="Ansible Logo">
2022-12-18 21:18:26 +00:00
< div class = "DocSiteNav-title" > Community.Routeros Collection Docs< / div >
2022-11-26 09:11:24 +00:00
< / a >
< div class = "wy-grid-for-nav" >
< nav data-toggle = "wy-nav-shift" class = "wy-nav-side" >
< div class = "wy-side-scroll" >
< div class = "wy-side-nav-search" >
2023-02-08 05:27:47 +00:00
< a href = "index.html" class = "icon icon-home" >
Community.Routeros Collection
2022-11-26 09:11:24 +00:00
< / a > <!-- - Based on https://github.com/rtfd/sphinx_rtd_theme/pull/438/files -->
< div class = "version" >
< / div >
< div role = "search" >
< form id = "rtd-search-form" class = "wy-form" action = "search.html" method = "get" >
< label class = "sr-only" for = "q" > Search docs:< / label >
< input type = "text" class = "st-default-search-input" id = "q" name = "q" placeholder = "Search docs" / >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< / div >
< / div > < div class = "wy-menu wy-menu-vertical" data-spy = "affix" role = "navigation" aria-label = "Navigation menu" >
< ul >
< li class = "toctree-l1" > < a class = "reference internal" href = "docsite/api-guide.html" > How to connect to RouterOS devices with the RouterOS API< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "docsite/ssh-guide.html" > How to connect to RouterOS devices with SSH< / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "docsite/quoting.html" > How to quote and unquote commands and arguments< / a > < / li >
< / ul >
< ul class = "current" >
< li class = "toctree-l1" > < a class = "reference internal" href = "api_module.html" > community.routeros.api module – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "api_facts_module.html" > community.routeros.api_facts module – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "api_find_and_modify_module.html" > community.routeros.api_find_and_modify module – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "api_info_module.html" > community.routeros.api_info module – < / a > < / li >
< li class = "toctree-l1 current" > < a class = "current reference internal" href = "#" > community.routeros.api_modify module – < / a > < ul >
< li class = "toctree-l2" > < a class = "reference internal" href = "#synopsis" > Synopsis< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#requirements" > Requirements< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#parameters" > Parameters< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#attributes" > Attributes< / a > < / li >
2023-09-17 13:32:33 +00:00
< li class = "toctree-l2" > < a class = "reference internal" href = "#notes" > Notes< / a > < / li >
2022-11-26 09:11:24 +00:00
< li class = "toctree-l2" > < a class = "reference internal" href = "#see-also" > See Also< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#examples" > Examples< / a > < / li >
< li class = "toctree-l2" > < a class = "reference internal" href = "#return-values" > Return Values< / a > < ul >
< li class = "toctree-l3" > < a class = "reference internal" href = "#authors" > Authors< / a > < / li >
< li class = "toctree-l3" > < a class = "reference internal" href = "#collection-links" > Collection links< / a > < / li >
< / ul >
< / li >
< / ul >
< / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "command_module.html" > community.routeros.command module – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "facts_module.html" > community.routeros.facts module – < / a > < / li >
< / ul >
2022-12-17 19:14:16 +00:00
< ul >
< li class = "toctree-l1" > < a class = "reference internal" href = "routeros_cliconf.html" > community.routeros.routeros cliconf – < / a > < / li >
< / ul >
< ul >
< li class = "toctree-l1" > < a class = "reference internal" href = "join_filter.html" > community.routeros.join filter – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "list_to_dict_filter.html" > community.routeros.list_to_dict filter – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "quote_argument_filter.html" > community.routeros.quote_argument filter – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "quote_argument_value_filter.html" > community.routeros.quote_argument_value filter – < / a > < / li >
< li class = "toctree-l1" > < a class = "reference internal" href = "split_filter.html" > community.routeros.split filter – < / a > < / li >
< / ul >
2022-11-26 09:11:24 +00:00
<!-- extra nav elements for Ansible beyond RTD Sphinx Theme -->
< / div >
< / div >
< / nav >
< section data-toggle = "wy-nav-shift" class = "wy-nav-content-wrap" > < nav class = "wy-nav-top" aria-label = "Mobile navigation menu" >
< i data-toggle = "wy-nav-top" class = "fa fa-bars" > < / i >
2022-12-18 21:18:26 +00:00
< a href = "index.html" > Community.Routeros Collection< / a >
2022-11-26 09:11:24 +00:00
< / nav >
< div class = "wy-nav-content" >
< div class = "rst-content" >
< div role = "navigation" aria-label = "Page navigation" >
< ul class = "wy-breadcrumbs" >
2023-02-08 05:27:47 +00:00
< li > < a href = "index.html" class = "icon icon-home" aria-label = "Home" > < / a > < / li >
2022-11-26 09:11:24 +00:00
< li class = "breadcrumb-item active" > community.routeros.api_modify module – < / li >
< li class = "wy-breadcrumbs-aside" >
<!-- User defined GitHub URL -->
< a href = "https://github.com/ansible-collections/community.routeros/edit/main/plugins/modules/api_modify.py?description=%23%23%23%23%23%20SUMMARY%0A%3C!—%20Your%20description%20here%20– class = "fa fa-github" > Edit on GitHub< / a >
< / li >
< / ul >
< hr / >
< / div >
< div role = "main" class = "document" itemscope = "itemscope" itemtype = "http://schema.org/Article" >
< div itemprop = "articleBody" >
< span class = "target" id = "ansible-collections-community-routeros-api-modify-module" > < / span > < section id = "community-routeros-api-modify-module-modify-data-at-paths-with-api" >
2023-08-21 20:13:03 +00:00
< h1 > community.routeros.api_modify module – < a class = "headerlink" href = "#community-routeros-api-modify-module-modify-data-at-paths-with-api" title = "Link to this heading" > < / a > < / h1 >
2022-11-26 09:11:24 +00:00
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
2023-09-30 20:17:11 +00:00
< p > This module is part of the < a class = "reference external" href = "https://galaxy.ansible.com/ui/repo/published/community/routeros/" > community.routeros collection< / a > (version 2.10.0).< / p >
2023-09-28 05:31:43 +00:00
< p > It is not included in < code class = "docutils literal notranslate" > < span class = "pre" > ansible-core< / span > < / code > .
To check whether it is installed, run < code class = "code docutils literal notranslate" > < span class = "pre" > ansible-galaxy< / span > < span class = "pre" > collection< / span > < span class = "pre" > list< / span > < / code > .< / p >
2022-11-26 09:11:24 +00:00
< p > To install it, use: < code class = "code docutils literal notranslate" > < span class = "pre" > ansible-galaxy< / span > < span class = "pre" > collection< / span > < span class = "pre" > install< / span > < span class = "pre" > community.routeros< / span > < / code > .
You need further requirements to be able to use this module,
see < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-requirements" > < span class = "std std-ref" > Requirements< / span > < / a > for details.< / p >
< p > To use it in a playbook, specify: < code class = "code docutils literal notranslate" > < span class = "pre" > community.routeros.api_modify< / span > < / code > .< / p >
< / div >
< p class = "ansible-version-added" > New in community.routeros 2.2.0< / p >
2023-02-08 05:27:47 +00:00
< nav class = "contents local" id = "contents" >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
< li > < p > < a class = "reference internal" href = "#synopsis" id = "id1" > Synopsis< / a > < / p > < / li >
< li > < p > < a class = "reference internal" href = "#requirements" id = "id2" > Requirements< / a > < / p > < / li >
< li > < p > < a class = "reference internal" href = "#parameters" id = "id3" > Parameters< / a > < / p > < / li >
< li > < p > < a class = "reference internal" href = "#attributes" id = "id4" > Attributes< / a > < / p > < / li >
2023-09-17 13:32:33 +00:00
< li > < p > < a class = "reference internal" href = "#notes" id = "id5" > Notes< / a > < / p > < / li >
< li > < p > < a class = "reference internal" href = "#see-also" id = "id6" > See Also< / a > < / p > < / li >
< li > < p > < a class = "reference internal" href = "#examples" id = "id7" > Examples< / a > < / p > < / li >
< li > < p > < a class = "reference internal" href = "#return-values" id = "id8" > Return Values< / a > < / p > < / li >
2022-11-26 09:11:24 +00:00
< / ul >
2023-02-08 05:27:47 +00:00
< / nav >
2022-11-26 09:11:24 +00:00
< section id = "synopsis" >
2023-08-21 20:13:03 +00:00
< h2 > < a class = "toc-backref" href = "#id1" role = "doc-backlink" > Synopsis< / a > < a class = "headerlink" href = "#synopsis" title = "Link to this heading" > < / a > < / h2 >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
< li > < p > Allows to modify information for a path using the API.< / p > < / li >
< li > < p > Use the < a class = "reference internal" href = "api_find_and_modify_module.html#ansible-collections-community-routeros-api-find-and-modify-module" > < span class = "std std-ref" > community.routeros.api_find_and_modify< / span > < / a > module to modify one or multiple entries in a controlled way depending on some search conditions.< / p > < / li >
< li > < p > To make a backup of a path that can be restored with this module, use the < a class = "reference internal" href = "api_info_module.html#ansible-collections-community-routeros-api-info-module" > < span class = "std std-ref" > community.routeros.api_info< / span > < / a > module.< / p > < / li >
< li > < p > The module ignores dynamic and builtin entries.< / p > < / li >
< li > < p > < strong > Note< / strong > that this module is still heavily in development, and only supports < strong > some< / strong > paths. If you want to support new paths, or think you found problems with existing paths, please first < a class = "reference external" href = "https://github.com/ansible-collections/community.routeros/issues/" > create an issue in the community.routeros Issue Tracker< / a > .< / p > < / li >
< / ul >
< / section >
< section id = "requirements" >
2023-08-21 20:13:03 +00:00
< span id = "ansible-collections-community-routeros-api-modify-module-requirements" > < / span > < h2 > < a class = "toc-backref" href = "#id2" role = "doc-backlink" > Requirements< / a > < a class = "headerlink" href = "#requirements" title = "Link to this heading" > < / a > < / h2 >
2022-11-26 09:11:24 +00:00
< p > The below requirements are needed on the host that executes this module.< / p >
< ul class = "simple" >
< li > < p > Needs < a class = "reference external" href = "https://pypi.org/project/ordereddict" > ordereddict< / a > for Python 2.6< / p > < / li >
< li > < p > Python > = 3.6 (for librouteros)< / p > < / li >
< li > < p > librouteros< / p > < / li >
< / ul >
< / section >
< section id = "parameters" >
2023-08-21 20:13:03 +00:00
< h2 > < a class = "toc-backref" href = "#id3" role = "doc-backlink" > Parameters< / a > < a class = "headerlink" href = "#parameters" title = "Link to this heading" > < / a > < / h2 >
2023-09-28 05:31:43 +00:00
< table class = "longtable ansible-option-table docutils align-default" style = "width: 100%" >
2022-11-26 09:11:24 +00:00
< thead >
< tr class = "row-odd" > < th class = "head" > < p > Parameter< / p > < / th >
< th class = "head" > < p > Comments< / p > < / th >
< / tr >
< / thead >
< tbody >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-ca_path" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-ca-path" > < strong > ca_path< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-ca_path" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > path< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 1.2.0< / em > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > PEM formatted file that contains a CA certificate to be used for certificate validation.< / p >
2023-06-22 18:46:32 +00:00
< p > See also < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-validate-cert-hostname" > < span class = "std std-ref" > < span class = "pre" > validate_cert_hostname< / span > < / span > < / a > < / strong > < / code > . Only used when < code class = "ansible-option-value docutils literal notranslate" > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-tls" > < span class = "std std-ref" > < span class = "pre" > tls=true< / span > < / span > < / a > < / code > and < code class = "ansible-option-value docutils literal notranslate" > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-validate-certs" > < span class = "std std-ref" > < span class = "pre" > validate_certs=true< / span > < / span > < / a > < / code > .< / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-data" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-data" > < strong > data< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-data" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > list< / span > / < span class = "ansible-option-elements" > elements=dictionary< / span > / < span class = "ansible-option-required" > required< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Data to ensure that is present for this path.< / p >
< p > Fields not provided will not be modified.< / p >
< p > If < code class = "docutils literal notranslate" > < span class = "pre" > .id< / span > < / code > appears in an entry, it will be ignored.< / p >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-encoding" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-encoding" > < strong > encoding< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-encoding" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 2.1.0< / em > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Use the specified encoding when communicating with the RouterOS device.< / p >
2023-06-22 18:46:32 +00:00
< p > Default is < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > ASCII< / span > < / code > . Note that < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > UTF-8< / span > < / code > requires librouteros 3.2.1 or newer.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-default-bold" > Default:< / strong > < code class = "ansible-option-default docutils literal notranslate" > < span class = "pre" > " ASCII" < / span > < / code > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-ensure_order" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-ensure-order" > < strong > ensure_order< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-ensure_order" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > boolean< / span > < / p >
< / div > < / td >
2023-06-22 18:46:32 +00:00
< td > < div class = "ansible-option-cell" > < p > Whether to ensure the same order of the config as present in < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-data" > < span class = "std std-ref" > < span class = "pre" > data< / span > < / span > < / a > < / strong > < / code > .< / p >
< p > Requires < code class = "ansible-option-value docutils literal notranslate" > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-handle-absent-entries" > < span class = "std std-ref" > < span class = "pre" > handle_absent_entries=remove< / span > < / span > < / a > < / code > .< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > false< / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > true< / span > < / code > < / p > < / li >
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-force_no_cert" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-force-no-cert" > < strong > force_no_cert< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-force_no_cert" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > boolean< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 2.4.0< / em > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
2023-06-22 18:46:32 +00:00
< td > < div class = "ansible-option-cell" > < p > Set to < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > true< / span > < / code > to connect without a certificate when < code class = "ansible-option-value docutils literal notranslate" > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-tls" > < span class = "std std-ref" > < span class = "pre" > tls=true< / span > < / span > < / a > < / code > .< / p >
< p > See also < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-validate-certs" > < span class = "std std-ref" > < span class = "pre" > validate_certs< / span > < / span > < / a > < / strong > < / code > .< / p >
< p > < strong > Note:< / strong > this forces the use of anonymous Diffie-Hellman (ADH) ciphers. The protocol is susceptible to Man-in-the-Middle attacks, because the keys used in the exchange are not authenticated. Instead of simply connecting without a certificate to “make things work” have a look at < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-validate-certs" > < span class = "std std-ref" > < span class = "pre" > validate_certs< / span > < / span > < / a > < / strong > < / code > and < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-ca-path" > < span class = "std std-ref" > < span class = "pre" > ca_path< / span > < / span > < / a > < / strong > < / code > .< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > false< / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > true< / span > < / code > < / p > < / li >
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-handle_absent_entries" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-handle-absent-entries" > < strong > handle_absent_entries< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-handle_absent_entries" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > < / p >
< / div > < / td >
2023-06-22 18:46:32 +00:00
< td > < div class = "ansible-option-cell" > < p > How to handle entries that are present in the current config, but not in < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-data" > < span class = "std std-ref" > < span class = "pre" > data< / span > < / span > < / a > < / strong > < / code > .< / p >
< p > < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > ignore< / span > < / code > ignores them.< / p >
< p > < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > remove< / span > < / code > removes them.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > " ignore" < / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " remove" < / span > < / code > < / p > < / li >
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-handle_entries_content" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-handle-entries-content" > < strong > handle_entries_content< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-handle_entries_content" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > < / p >
< / div > < / td >
2023-06-22 18:46:32 +00:00
< td > < div class = "ansible-option-cell" > < p > For a single entry in < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-data" > < span class = "std std-ref" > < span class = "pre" > data< / span > < / span > < / a > < / strong > < / code > , this describes how to handle fields that are not mentioned in that entry, but appear in the actual config.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > ignore< / span > < / code > , they are not modified.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > remove< / span > < / code > , they are removed. If at least one cannot be removed, the module will fail.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > remove_as_much_as_possible< / span > < / code > , all that can be removed will be removed. The ones that cannot be removed will be kept.< / p >
2023-09-17 13:32:33 +00:00
< p > Note that < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > remove< / span > < / code > and < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > remove_as_much_as_possible< / span > < / code > do not apply to write-only fields.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > " ignore" < / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " remove" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " remove_as_much_as_possible" < / span > < / code > < / p > < / li >
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
2023-09-17 13:32:33 +00:00
< div class = "ansibleOptionAnchor" id = "parameter-handle_read_only" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-handle-read-only" > < strong > handle_read_only< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-handle_read_only" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 2.10.0< / em > < / p >
2023-09-17 13:32:33 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > How to handle values passed in for read-only fields.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > ignore< / span > < / code > , they are not passed to the API.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > validate< / span > < / code > , the values are not passed for creation, and for updating they are compared to the value returned for the object. If they differ, the module fails.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > error< / span > < / code > , the module will fail if read-only fields are provided.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2023-09-17 13:32:33 +00:00
< ul class = "simple" >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ignore" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " validate" < / span > < / code > < / p > < / li >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > " error" < / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2023-09-17 13:32:33 +00:00
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-handle_write_only" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-handle-write-only" > < strong > handle_write_only< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-handle_write_only" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 2.10.0< / em > < / p >
2023-09-17 13:32:33 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > How to handle values passed in for write-only fields.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > create_only< / span > < / code > , they are passed on creation, and ignored for updating.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > always_update< / span > < / code > , they are always passed to the API. This means that if such a value is present, the module will always result in < code class = "docutils literal notranslate" > < span class = "pre" > changed< / span > < / code > since there is no way to validate whether the value actually changed.< / p >
< p > If < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > error< / span > < / code > , the module will fail if write-only fields are provided.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2023-09-17 13:32:33 +00:00
< ul class = "simple" >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > " create_only" < / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2023-09-17 13:32:33 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " always_update" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " error" < / span > < / code > < / p > < / li >
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
2022-11-26 09:11:24 +00:00
< div class = "ansibleOptionAnchor" id = "parameter-hostname" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-hostname" > < strong > hostname< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-hostname" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > / < span class = "ansible-option-required" > required< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > RouterOS hostname API.< / p >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-password" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-password" > < strong > password< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-password" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > / < span class = "ansible-option-required" > required< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > RouterOS user password.< / p >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-path" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-path" > < strong > path< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-path" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > / < span class = "ansible-option-required" > required< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Path to query.< / p >
2023-06-22 18:46:32 +00:00
< p > An example value is < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > ip< / span > < span class = "pre" > address< / span > < / code > . This is equivalent to running modification commands in < code class = "docutils literal notranslate" > < span class = "pre" > /ip< / span > < span class = "pre" > address< / span > < / code > in the RouterOS CLI.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > aaa" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > access-list" < / span > < / code > < / p > < / li >
2023-08-12 14:01:26 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > channel" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > configuration" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > datapath" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > manager" < / span > < / code > < / p > < / li >
2023-08-12 14:01:26 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > manager< / span > < span class = "pre" > interface" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > provisioning" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " caps-man< / span > < span class = "pre" > security" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " certificate< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bonding" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bridge" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bridge< / span > < span class = "pre" > mlag" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bridge< / span > < span class = "pre" > port" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bridge< / span > < span class = "pre" > port-controller" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bridge< / span > < span class = "pre" > port-extender" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bridge< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > bridge< / span > < span class = "pre" > vlan" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > detect-internet" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > eoip" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > ethernet" < / span > < / code > < / p > < / li >
2022-11-29 12:10:44 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > ethernet< / span > < span class = "pre" > poe" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > ethernet< / span > < span class = "pre" > switch" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > ethernet< / span > < span class = "pre" > switch< / span > < span class = "pre" > port" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > gre" < / span > < / code > < / p > < / li >
2022-11-29 12:10:44 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > gre6" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > l2tp-server< / span > < span class = "pre" > server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > list" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > list< / span > < span class = "pre" > member" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > ovpn-server< / span > < span class = "pre" > server" < / span > < / code > < / p > < / li >
2023-08-20 12:38:19 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > ppp-client" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > pppoe-client" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > pptp-server< / span > < span class = "pre" > server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > sstp-server< / span > < span class = "pre" > server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > vlan" < / span > < / code > < / p > < / li >
2022-11-29 12:10:44 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > vrrp" < / span > < / code > < / p > < / li >
2022-12-27 20:50:01 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireguard" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireguard< / span > < span class = "pre" > peers" < / span > < / code > < / p > < / li >
2023-08-20 12:32:02 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireless" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireless< / span > < span class = "pre" > align" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireless< / span > < span class = "pre" > cap" < / span > < / code > < / p > < / li >
2023-08-21 20:13:03 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireless< / span > < span class = "pre" > security-profiles" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireless< / span > < span class = "pre" > sniffer" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " interface< / span > < span class = "pre" > wireless< / span > < span class = "pre" > snooper" < / span > < / code > < / p > < / li >
2023-08-26 09:48:47 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " iot< / span > < span class = "pre" > modbus" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > accounting" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > accounting< / span > < span class = "pre" > web-access" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > address" < / span > < / code > < / p > < / li >
2023-01-01 21:22:01 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > arp" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > cloud" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > cloud< / span > < span class = "pre" > advanced" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-client" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-client< / span > < span class = "pre" > option" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-server< / span > < span class = "pre" > config" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-server< / span > < span class = "pre" > lease" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-server< / span > < span class = "pre" > network" < / span > < / code > < / p > < / li >
2023-10-07 12:30:34 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-server< / span > < span class = "pre" > option" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dhcp-server< / span > < span class = "pre" > option< / span > < span class = "pre" > sets" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dns" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > dns< / span > < span class = "pre" > static" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > address-list" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > connection< / span > < span class = "pre" > tracking" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > filter" < / span > < / code > < / p > < / li >
2023-04-16 16:58:36 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > layer7-protocol" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > mangle" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > nat" < / span > < / code > < / p > < / li >
2023-01-01 21:22:01 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > raw" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > firewall< / span > < span class = "pre" > service-port" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > hotspot< / span > < span class = "pre" > service-port" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > ipsec< / span > < span class = "pre" > identity" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > ipsec< / span > < span class = "pre" > peer" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > ipsec< / span > < span class = "pre" > policy" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > ipsec< / span > < span class = "pre" > profile" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > ipsec< / span > < span class = "pre" > proposal" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > ipsec< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > neighbor< / span > < span class = "pre" > discovery-settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > pool" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > proxy" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > route" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > route< / span > < span class = "pre" > vrf" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > service" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > smb" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > socks" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > ssh" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > tftp< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > traffic-flow" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > traffic-flow< / span > < span class = "pre" > ipfix" < / span > < / code > < / p > < / li >
2023-07-23 19:31:47 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > traffic-flow< / span > < span class = "pre" > target" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ip< / span > < span class = "pre" > upnp" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > address" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > dhcp-client" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > dhcp-server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > dhcp-server< / span > < span class = "pre" > option" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > firewall< / span > < span class = "pre" > address-list" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > firewall< / span > < span class = "pre" > filter" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > firewall< / span > < span class = "pre" > mangle" < / span > < / code > < / p > < / li >
2023-08-26 09:44:31 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > firewall< / span > < span class = "pre" > nat" < / span > < / code > < / p > < / li >
2023-01-01 21:22:01 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > firewall< / span > < span class = "pre" > raw" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > nd" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > nd< / span > < span class = "pre" > prefix< / span > < span class = "pre" > default" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > route" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ipv6< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " mpls" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " mpls< / span > < span class = "pre" > ldp" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " port< / span > < span class = "pre" > firmware" < / span > < / code > < / p > < / li >
2023-10-07 12:30:34 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " port< / span > < span class = "pre" > remote-access" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ppp< / span > < span class = "pre" > aaa" < / span > < / code > < / p > < / li >
2023-09-17 13:50:39 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " ppp< / span > < span class = "pre" > profile" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " queue< / span > < span class = "pre" > interface" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " queue< / span > < span class = "pre" > tree" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " radius< / span > < span class = "pre" > incoming" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > bgp< / span > < span class = "pre" > instance" < / span > < / code > < / p > < / li >
2023-08-20 12:38:29 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > filter< / span > < span class = "pre" > rule" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > filter< / span > < span class = "pre" > select-rule" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > mme" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > ospf< / span > < span class = "pre" > area" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > ospf< / span > < span class = "pre" > area< / span > < span class = "pre" > range" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > ospf< / span > < span class = "pre" > instance" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > ospf< / span > < span class = "pre" > interface-template" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > pimsm< / span > < span class = "pre" > instance" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > pimsm< / span > < span class = "pre" > interface-template" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > rip" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > ripng" < / span > < / code > < / p > < / li >
2023-09-10 20:44:30 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " routing< / span > < span class = "pre" > table" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " snmp" < / span > < / code > < / p > < / li >
2023-03-11 17:25:38 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " snmp< / span > < span class = "pre" > community" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > clock" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > clock< / span > < span class = "pre" > manual" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > identity" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > leds< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > logging" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > logging< / span > < span class = "pre" > action" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > note" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > ntp< / span > < span class = "pre" > client" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > ntp< / span > < span class = "pre" > client< / span > < span class = "pre" > servers" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > ntp< / span > < span class = "pre" > server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > package< / span > < span class = "pre" > update" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > routerboard< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > scheduler" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > script" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > upgrade< / span > < span class = "pre" > mirror" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > ups" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " system< / span > < span class = "pre" > watchdog" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > bandwidth-server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > e-mail" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > graphing" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > mac-server" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > mac-server< / span > < span class = "pre" > mac-winbox" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > mac-server< / span > < span class = "pre" > ping" < / span > < / code > < / p > < / li >
2023-09-17 13:51:03 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > netwatch" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > romon" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > sms" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > sniffer" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " tool< / span > < span class = "pre" > traffic-generator" < / span > < / code > < / p > < / li >
2023-09-18 05:05:18 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " user" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " user< / span > < span class = "pre" > aaa" < / span > < / code > < / p > < / li >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " user< / span > < span class = "pre" > group" < / span > < / code > < / p > < / li >
2023-08-20 12:45:31 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > " user< / span > < span class = "pre" > settings" < / span > < / code > < / p > < / li >
2022-11-26 09:11:24 +00:00
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-port" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-port" > < strong > port< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-port" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > integer< / span > < / p >
< / div > < / td >
2023-06-22 18:46:32 +00:00
< td > < div class = "ansible-option-cell" > < p > RouterOS api port. If < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-tls" > < span class = "std std-ref" > < span class = "pre" > tls< / span > < / span > < / a > < / strong > < / code > is set, port will apply to TLS/SSL connection.< / p >
< p > Defaults are < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > 8728< / span > < / code > for the HTTP API, and < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > 8729< / span > < / code > for the HTTPS API.< / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-timeout" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-timeout" > < strong > timeout< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-timeout" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > integer< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 2.3.0< / em > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Timeout for the request.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-default-bold" > Default:< / strong > < code class = "ansible-option-default docutils literal notranslate" > < span class = "pre" > 10< / span > < / code > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-tls" > < / div >
< div class = "ansibleOptionAnchor" id = "parameter-ssl" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-tls" > < span id = "ansible-collections-community-routeros-api-modify-module-parameter-ssl" > < / span > < strong > tls< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-tls" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-aliases" > aliases: ssl< / span > < / p >
< p class = "ansible-option-type-line" > < span class = "ansible-option-type" > boolean< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > If is set TLS will be used for RouterOS API connection.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > false< / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > true< / span > < / code > < / p > < / li >
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-username" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-username" > < strong > username< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-username" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > string< / span > / < span class = "ansible-option-required" > required< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > RouterOS login user.< / p >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-validate_cert_hostname" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-validate-cert-hostname" > < strong > validate_cert_hostname< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-validate_cert_hostname" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > boolean< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 1.2.0< / em > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
2023-06-22 18:46:32 +00:00
< td > < div class = "ansible-option-cell" > < p > Set to < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > true< / span > < / code > to validate hostnames in certificates.< / p >
< p > See also < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-validate-certs" > < span class = "std std-ref" > < span class = "pre" > validate_certs< / span > < / span > < / a > < / strong > < / code > . Only used when < code class = "ansible-option-value docutils literal notranslate" > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-tls" > < span class = "std std-ref" > < span class = "pre" > tls=true< / span > < / span > < / a > < / code > and < code class = "ansible-option-value docutils literal notranslate" > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-validate-certs" > < span class = "std std-ref" > < span class = "pre" > validate_certs=true< / span > < / span > < / a > < / code > .< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > false< / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2022-11-26 09:11:24 +00:00
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > true< / span > < / code > < / p > < / li >
< / ul >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "parameter-validate_certs" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-parameter-validate-certs" > < strong > validate_certs< / strong > < / p >
< a class = "ansibleOptionLink" href = "#parameter-validate_certs" title = "Permalink to this option" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > boolean< / span > < / p >
2023-09-28 05:31:43 +00:00
< p > < em class = "ansible-option-versionadded" > added in community.routeros 1.2.0< / em > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
2023-06-22 18:46:32 +00:00
< td > < div class = "ansible-option-cell" > < p > Set to < code class = "ansible-value docutils literal notranslate" > < span class = "pre" > false< / span > < / code > to skip validation of TLS certificates.< / p >
< p > See also < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-validate-cert-hostname" > < span class = "std std-ref" > < span class = "pre" > validate_cert_hostname< / span > < / span > < / a > < / strong > < / code > . Only used when < code class = "ansible-option-value docutils literal notranslate" > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-tls" > < span class = "std std-ref" > < span class = "pre" > tls=true< / span > < / span > < / a > < / code > .< / p >
< p > < strong > Note:< / strong > instead of simply deactivating certificate validations to “make things work”, please consider creating your own CA certificate and using it to sign certificates used for your router. You can tell the module about your CA certificate with the < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-ca-path" > < span class = "std std-ref" > < span class = "pre" > ca_path< / span > < / span > < / a > < / strong > < / code > option.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-choices" > Choices:< / strong > < / p >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
< li > < p > < code class = "ansible-option-choices-entry docutils literal notranslate" > < span class = "pre" > false< / span > < / code > < / p > < / li >
2023-09-28 05:31:43 +00:00
< li > < p > < code class = "ansible-option-default-bold docutils literal notranslate" > < strong > < span class = "pre" > true< / span > < / strong > < / code > < span class = "ansible-option-choices-default-mark" > ← (default)< / span > < / p > < / li >
2022-11-26 09:11:24 +00:00
< / ul >
< / div > < / td >
< / tr >
< / tbody >
< / table >
< / section >
< section id = "attributes" >
2023-08-21 20:13:03 +00:00
< h2 > < a class = "toc-backref" href = "#id4" role = "doc-backlink" > Attributes< / a > < a class = "headerlink" href = "#attributes" title = "Link to this heading" > < / a > < / h2 >
2023-09-28 05:31:43 +00:00
< table class = "longtable ansible-option-table docutils align-default" style = "width: 100%" >
2022-11-26 09:11:24 +00:00
< thead >
< tr class = "row-odd" > < th class = "head" > < p > Attribute< / p > < / th >
< th class = "head" > < p > Support< / p > < / th >
< th class = "head" > < p > Description< / p > < / th >
< / tr >
< / thead >
< tbody >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "attribute-action_group" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-attribute-action-group" > < strong > action_group< / strong > < / p >
< a class = "ansibleOptionLink" href = "#attribute-action_group" title = "Permalink to this attribute" > < / a > < / div > < / td >
2023-09-28 05:31:43 +00:00
< td > < div class = "ansible-option-cell" > < p > < strong class = "ansible-attribute-support-property" > Action group:< / strong > < strong class = "ansible-attribute-support-full" > community.routeros.api< / strong > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Use < code class = "docutils literal notranslate" > < span class = "pre" > group/community.routeros.api< / span > < / code > in < code class = "docutils literal notranslate" > < span class = "pre" > module_defaults< / span > < / code > to set defaults for this module.< / p >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "attribute-check_mode" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-attribute-check-mode" > < strong > check_mode< / strong > < / p >
< a class = "ansibleOptionLink" href = "#attribute-check_mode" title = "Permalink to this attribute" > < / a > < / div > < / td >
2023-09-28 05:31:43 +00:00
< td > < div class = "ansible-option-cell" > < p > < strong class = "ansible-attribute-support-label" > Support: < / strong > < strong class = "ansible-attribute-support-full" > full< / strong > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Can run in < code class = "docutils literal notranslate" > < span class = "pre" > check_mode< / span > < / code > and return changed status prediction without modifying target.< / p >
< / div > < / td >
< / tr >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "attribute-diff_mode" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-attribute-diff-mode" > < strong > diff_mode< / strong > < / p >
< a class = "ansibleOptionLink" href = "#attribute-diff_mode" title = "Permalink to this attribute" > < / a > < / div > < / td >
2023-09-28 05:31:43 +00:00
< td > < div class = "ansible-option-cell" > < p > < strong class = "ansible-attribute-support-label" > Support: < / strong > < strong class = "ansible-attribute-support-full" > full< / strong > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Will return details on what has changed (or possibly needs changing in < code class = "docutils literal notranslate" > < span class = "pre" > check_mode< / span > < / code > ), when in diff mode.< / p >
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "attribute-platform" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-attribute-platform" > < strong > platform< / strong > < / p >
< a class = "ansibleOptionLink" href = "#attribute-platform" title = "Permalink to this attribute" > < / a > < / div > < / td >
2023-09-28 05:31:43 +00:00
< td > < div class = "ansible-option-cell" > < p > < strong class = "ansible-attribute-support-property" > Platform:< / strong > < strong class = "ansible-attribute-support-full" > RouterOS< / strong > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > Target OS/families that can be operated against.< / p >
< / div > < / td >
< / tr >
< / tbody >
< / table >
< / section >
2023-09-17 13:32:33 +00:00
< section id = "notes" >
< h2 > < a class = "toc-backref" href = "#id5" role = "doc-backlink" > Notes< / a > < a class = "headerlink" href = "#notes" title = "Link to this heading" > < / a > < / h2 >
< div class = "admonition note" >
< p class = "admonition-title" > Note< / p >
< ul class = "simple" >
< li > < p > If write-only fields are present in the path, the module is < strong > not idempotent< / strong > in a strict sense, since it is not able to verify the current value of these fields. The behavior the module should assume can be controlled with the < code class = "ansible-option docutils literal notranslate" > < strong > < a class = "reference internal" href = "#ansible-collections-community-routeros-api-modify-module-parameter-handle-write-only" > < span class = "std std-ref" > < span class = "pre" > handle_write_only< / span > < / span > < / a > < / strong > < / code > option.< / p > < / li >
< / ul >
< / div >
< / section >
2022-11-26 09:11:24 +00:00
< section id = "see-also" >
2023-09-17 13:32:33 +00:00
< h2 > < a class = "toc-backref" href = "#id6" role = "doc-backlink" > See Also< / a > < a class = "headerlink" href = "#see-also" title = "Link to this heading" > < / a > < / h2 >
2022-11-26 09:11:24 +00:00
< div class = "admonition seealso" >
< p class = "admonition-title" > See also< / p >
< dl class = "simple" >
2022-12-07 12:48:00 +00:00
< dt > < a class = "reference internal" href = "api_module.html#ansible-collections-community-routeros-api-module" > < span class = "std std-ref" > community.routeros.api< / span > < / a > < / dt > < dd > < p > Ansible module for RouterOS API.< / p >
2022-11-26 09:11:24 +00:00
< / dd >
2022-12-07 12:48:00 +00:00
< dt > < a class = "reference internal" href = "api_facts_module.html#ansible-collections-community-routeros-api-facts-module" > < span class = "std std-ref" > community.routeros.api_facts< / span > < / a > < / dt > < dd > < p > Collect facts from remote devices running MikroTik RouterOS using the API.< / p >
2022-11-26 09:11:24 +00:00
< / dd >
2022-12-07 12:48:00 +00:00
< dt > < a class = "reference internal" href = "api_find_and_modify_module.html#ansible-collections-community-routeros-api-find-and-modify-module" > < span class = "std std-ref" > community.routeros.api_find_and_modify< / span > < / a > < / dt > < dd > < p > Find and modify information using the API.< / p >
2022-11-26 09:11:24 +00:00
< / dd >
2022-12-07 12:48:00 +00:00
< dt > < a class = "reference internal" href = "api_info_module.html#ansible-collections-community-routeros-api-info-module" > < span class = "std std-ref" > community.routeros.api_info< / span > < / a > < / dt > < dd > < p > Retrieve information from API.< / p >
2022-11-26 09:11:24 +00:00
< / dd >
< dt > < a class = "reference internal" href = "docsite/api-guide.html#ansible-collections-community-routeros-docsite-api-guide" > < span class = "std std-ref" > How to connect to RouterOS devices with the RouterOS API< / span > < / a > < / dt > < dd > < p > How to connect to RouterOS devices with the RouterOS API< / p >
< / dd >
< / dl >
< / div >
< / section >
< section id = "examples" >
2023-09-17 13:32:33 +00:00
< h2 > < a class = "toc-backref" href = "#id7" role = "doc-backlink" > Examples< / a > < a class = "headerlink" href = "#examples" title = "Link to this heading" > < / a > < / h2 >
2023-01-01 21:22:01 +00:00
< div class = "highlight-yaml+jinja notranslate" > < div class = "highlight" > < pre > < span > < / span > < span class = "nn" > ---< / span >
< span class = "p p-Indicator" > -< / span > < span class = "w" > < / span > < span class = "nt" > name< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > Setup DHCP server networks< / span >
< span class = "w" > < / span > < span class = "c1" > # Ensures that we have exactly two DHCP server networks (in the specified order)< / span >
< span class = "w" > < / span > < span class = "nt" > community.routeros.api_modify< / span > < span class = "p" > :< / span >
< span class = "w" > < / span > < span class = "nt" > path< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > ip dhcp-server network< / span >
< span class = "w" > < / span > < span class = "nt" > handle_absent_entries< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > remove< / span >
< span class = "w" > < / span > < span class = "nt" > handle_entries_content< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > remove_as_much_as_possible< / span >
< span class = "w" > < / span > < span class = "nt" > ensure_order< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > true< / span >
< span class = "w" > < / span > < span class = "nt" > data< / span > < span class = "p" > :< / span >
< span class = "w" > < / span > < span class = "p p-Indicator" > -< / span > < span class = "w" > < / span > < span class = "nt" > address< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > 192.168.88.0/24< / span >
< span class = "w" > < / span > < span class = "nt" > comment< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > admin network< / span >
< span class = "w" > < / span > < span class = "nt" > dns-server< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > 192.168.88.1< / span >
< span class = "w" > < / span > < span class = "nt" > gateway< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > 192.168.88.1< / span >
< span class = "w" > < / span > < span class = "p p-Indicator" > -< / span > < span class = "w" > < / span > < span class = "nt" > address< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > 192.168.1.0/24< / span >
< span class = "w" > < / span > < span class = "nt" > comment< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > customer network 1< / span >
< span class = "w" > < / span > < span class = "nt" > dns-server< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > 192.168.1.1< / span >
< span class = "w" > < / span > < span class = "nt" > gateway< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > 192.168.1.1< / span >
< span class = "w" > < / span > < span class = "nt" > netmask< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > 24< / span >
2022-11-26 09:11:24 +00:00
2023-01-01 21:22:01 +00:00
< span class = "p p-Indicator" > -< / span > < span class = "w" > < / span > < span class = "nt" > name< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > Adjust NAT< / span >
< span class = "w" > < / span > < span class = "nt" > community.routeros.api_modify< / span > < span class = "p" > :< / span >
< span class = "w" > < / span > < span class = "nt" > hostname< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s" > " < / span > < span class = "cp" > {{< / span > < span class = "nv" > hostname< / span > < span class = "cp" > }}< / span > < span class = "s" > " < / span >
< span class = "w" > < / span > < span class = "nt" > password< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s" > " < / span > < span class = "cp" > {{< / span > < span class = "nv" > password< / span > < span class = "cp" > }}< / span > < span class = "s" > " < / span >
< span class = "w" > < / span > < span class = "nt" > username< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "s" > " < / span > < span class = "cp" > {{< / span > < span class = "nv" > username< / span > < span class = "cp" > }}< / span > < span class = "s" > " < / span >
< span class = "w" > < / span > < span class = "nt" > path< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > ip firewall nat< / span >
< span class = "w" > < / span > < span class = "nt" > data< / span > < span class = "p" > :< / span >
< span class = "w" > < / span > < span class = "p p-Indicator" > -< / span > < span class = "w" > < / span > < span class = "nt" > action< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > masquerade< / span >
< span class = "w" > < / span > < span class = "nt" > chain< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > srcnat< / span >
< span class = "w" > < / span > < span class = "nt" > comment< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > NAT to WAN< / span >
< span class = "w" > < / span > < span class = "nt" > out-interface-list< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > WAN< / span >
< span class = "w" > < / span > < span class = "c1" > # Three ways to unset values:< / span >
< span class = "w" > < / span > < span class = "c1" > # - nothing after `:`< / span >
< span class = "w" > < / span > < span class = "c1" > # - " empty" value (null/~/None)< / span >
< span class = "w" > < / span > < span class = "c1" > # - prepend ' !' < / span >
< span class = "w" > < / span > < span class = "nt" > out-interface< / span > < span class = "p" > :< / span >
< span class = "w" > < / span > < span class = "nt" > to-addresses< / span > < span class = "p" > :< / span > < span class = "w" > < / span > < span class = "l l-Scalar l-Scalar-Plain" > ~< / span >
< span class = "w" > < / span > < span class = "s" > ' !to-ports' < / span > < span class = "p p-Indicator" > :< / span >
2022-11-26 09:11:24 +00:00
< / pre > < / div >
< / div >
< / section >
< section id = "return-values" >
2023-09-17 13:32:33 +00:00
< h2 > < a class = "toc-backref" href = "#id8" role = "doc-backlink" > Return Values< / a > < a class = "headerlink" href = "#return-values" title = "Link to this heading" > < / a > < / h2 >
2022-11-26 09:11:24 +00:00
< p > Common return values are documented < a class = "reference external" href = "https://docs.ansible.com/ansible/devel/reference_appendices/common_return_values.html#common-return-values" title = "(in Ansible vdevel)" > < span class = "xref std std-ref" > here< / span > < / a > , the following are the fields unique to this module:< / p >
2023-09-28 05:31:43 +00:00
< table class = "longtable ansible-option-table docutils align-default" style = "width: 100%" >
2022-11-26 09:11:24 +00:00
< thead >
< tr class = "row-odd" > < th class = "head" > < p > Key< / p > < / th >
< th class = "head" > < p > Description< / p > < / th >
< / tr >
< / thead >
< tbody >
< tr class = "row-even" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "return-new_data" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-return-new-data" > < strong > new_data< / strong > < / p >
< a class = "ansibleOptionLink" href = "#return-new_data" title = "Permalink to this return value" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > list< / span > / < span class = "ansible-option-elements" > elements=dictionary< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > A list of all elements for the current path after a change was made.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-returned-bold" > Returned:< / strong > always< / p >
< p class = "ansible-option-line ansible-option-sample" > < strong class = "ansible-option-sample-bold" > Sample:< / strong > < code class = "ansible-option-sample docutils literal notranslate" > < span class = "pre" > [{" .id" :< / span > < span class = "pre" > " *1" ,< / span > < span class = "pre" > " actual-interface" :< / span > < span class = "pre" > " bridge" ,< / span > < span class = "pre" > " address" :< / span > < span class = "pre" > " 192.168.1.1/24" ,< / span > < span class = "pre" > " comment" :< / span > < span class = "pre" > " awesome" ,< / span > < span class = "pre" > " disabled" :< / span > < span class = "pre" > false,< / span > < span class = "pre" > " dynamic" :< / span > < span class = "pre" > false,< / span > < span class = "pre" > " interface" :< / span > < span class = "pre" > " bridge" ,< / span > < span class = "pre" > " invalid" :< / span > < span class = "pre" > false,< / span > < span class = "pre" > " network" :< / span > < span class = "pre" > " 192.168.1.0" }]< / span > < / code > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< / tr >
< tr class = "row-odd" > < td > < div class = "ansible-option-cell" >
< div class = "ansibleOptionAnchor" id = "return-old_data" > < / div > < p class = "ansible-option-title" id = "ansible-collections-community-routeros-api-modify-module-return-old-data" > < strong > old_data< / strong > < / p >
< a class = "ansibleOptionLink" href = "#return-old_data" title = "Permalink to this return value" > < / a > < p class = "ansible-option-type-line" > < span class = "ansible-option-type" > list< / span > / < span class = "ansible-option-elements" > elements=dictionary< / span > < / p >
< / div > < / td >
< td > < div class = "ansible-option-cell" > < p > A list of all elements for the current path before a change was made.< / p >
2023-09-28 05:31:43 +00:00
< p class = "ansible-option-line" > < strong class = "ansible-option-returned-bold" > Returned:< / strong > always< / p >
< p class = "ansible-option-line ansible-option-sample" > < strong class = "ansible-option-sample-bold" > Sample:< / strong > < code class = "ansible-option-sample docutils literal notranslate" > < span class = "pre" > [{" .id" :< / span > < span class = "pre" > " *1" ,< / span > < span class = "pre" > " actual-interface" :< / span > < span class = "pre" > " bridge" ,< / span > < span class = "pre" > " address" :< / span > < span class = "pre" > " 192.168.88.1/24" ,< / span > < span class = "pre" > " comment" :< / span > < span class = "pre" > " defconf" ,< / span > < span class = "pre" > " disabled" :< / span > < span class = "pre" > false,< / span > < span class = "pre" > " dynamic" :< / span > < span class = "pre" > false,< / span > < span class = "pre" > " interface" :< / span > < span class = "pre" > " bridge" ,< / span > < span class = "pre" > " invalid" :< / span > < span class = "pre" > false,< / span > < span class = "pre" > " network" :< / span > < span class = "pre" > " 192.168.88.0" }]< / span > < / code > < / p >
2022-11-26 09:11:24 +00:00
< / div > < / td >
< / tr >
< / tbody >
< / table >
< section id = "authors" >
2023-08-21 20:13:03 +00:00
< h3 > Authors< a class = "headerlink" href = "#authors" title = "Link to this heading" > < / a > < / h3 >
2022-11-26 09:11:24 +00:00
< ul class = "simple" >
< li > < p > Felix Fontein (@ felixfontein)< / p > < / li >
< / ul >
< / section >
< section id = "collection-links" >
2023-08-21 20:13:03 +00:00
< h3 > Collection links< a class = "headerlink" href = "#collection-links" title = "Link to this heading" > < / a > < / h3 >
2023-09-28 05:31:43 +00:00
< ul class = "ansible-links" >
< li > < span > < a aria-role = "button" class = "ansible-link reference external" href = "https://github.com/ansible-collections/community.routeros/issues" rel = "noopener external" target = "_blank" > Issue Tracker< / a > < / span > < / li >
< li > < span > < a aria-role = "button" class = "ansible-link reference external" href = "https://github.com/ansible-collections/community.routeros" rel = "noopener external" target = "_blank" > Repository (Sources)< / a > < / span > < / li >
< li > < span > < a aria-role = "button" class = "ansible-link reference external" href = "https://github.com/ansible-collections/community.routeros/issues/new?assignees=&labels=&template=bug_report.md" rel = "noopener external" target = "_blank" > Submit a bug report< / a > < / span > < / li >
< li > < span > < a aria-role = "button" class = "ansible-link reference external" href = "https://github.com/ansible-collections/community.routeros/issues/new?assignees=&labels=&template=feature_request.md" rel = "noopener external" target = "_blank" > Request a feature< / a > < / span > < / li >
< li > < span > < a class = "reference internal" href = "index.html#communication-for-community-routeros" > < span class = "std std-ref" > Communication< / span > < / a > < / span > < / li >
< / ul >
< / section >
2022-11-26 09:11:24 +00:00
< / section >
< / section >
< / div >
< / div >
< footer > < div class = "rst-footer-buttons" role = "navigation" aria-label = "Footer" >
< a href = "api_info_module.html" class = "btn btn-neutral float-left" title = "community.routeros.api_info module – accesskey = "p" rel = "prev" > < span class = "fa fa-arrow-circle-left" aria-hidden = "true" > < / span > Previous< / a >
< a href = "command_module.html" class = "btn btn-neutral float-right" title = "community.routeros.command module – accesskey = "n" rel = "next" > Next < span class = "fa fa-arrow-circle-right" aria-hidden = "true" > < / span > < / a >
< / div >
< hr / >
< div role = "contentinfo" >
2022-12-18 21:18:26 +00:00
< p > © Copyright Community.Routeros Contributors.< / p >
2022-11-26 09:11:24 +00:00
< / div >
< / footer >
< / div >
< / div >
< / section >
< / div >
< script >
jQuery(function () {
SphinxRtdTheme.Navigation.enable(true);
});
< / script > <!-- extra footer elements for Ansible beyond RTD Sphinx Theme -->
< / body >
< / html >
