Modify data at paths with API.
How to connect to RouterOS devices with the RouterOS API
+How to connect to RouterOS devices with the RouterOS API.
Retrieve information from API.
How to connect to RouterOS devices with the RouterOS API
+How to connect to RouterOS devices with the RouterOS API.
---
-- name: Rename bridge from 'bridge' to 'my-bridge'
+- name: Rename bridge from 'bridge' to 'my-bridge'
community.routeros.api_find_and_modify:
hostname: "{{ hostname }}"
password: "{{ password }}"
@@ -463,8 +462,8 @@ see interface: bridge
values:
address: "192.168.1.1/24"
- # If there are zero entries, or more than one: fail! We expected that
- # exactly one is configured.
+ # If there are zero entries, or more than one: fail! We expected that
+ # exactly one is configured.
require_matches_min: 1
require_matches_max: 1
diff --git a/branch/main/api_info_module.html b/branch/main/api_info_module.html
index 836a9fe..c326f77 100644
--- a/branch/main/api_info_module.html
+++ b/branch/main/api_info_module.html
@@ -740,15 +740,14 @@ see community.routeros.api_modifyModify data at paths with API.
How to connect to RouterOS devices with the RouterOS API How to connect to RouterOS devices with the RouterOS API
+How to connect to RouterOS devices with the RouterOS API How to connect to RouterOS devices with the RouterOS API.
Examples
----
-- name: Get IP addresses
+- name: Get IP addresses
community.routeros.api_info:
hostname: "{{ hostname }}"
password: "{{ password }}"
diff --git a/branch/main/api_modify_module.html b/branch/main/api_modify_module.html
index 4d52dc0..1e34dcf 100644
--- a/branch/main/api_modify_module.html
+++ b/branch/main/api_modify_module.html
@@ -756,15 +756,14 @@ see community.routeros.api_info
Retrieve information from API.
How to connect to RouterOS devices with the RouterOS API How to connect to RouterOS devices with the RouterOS API
+How to connect to RouterOS devices with the RouterOS API How to connect to RouterOS devices with the RouterOS API.
Examples
----
-- name: Setup DHCP server networks
+- name: Setup DHCP server networks
# Ensures that we have exactly two DHCP server networks (in the specified order)
community.routeros.api_modify:
path: ip dhcp-server network
diff --git a/branch/main/api_module.html b/branch/main/api_module.html
index 5764580..e86a3ac 100644
--- a/branch/main/api_module.html
+++ b/branch/main/api_module.html
@@ -535,7 +535,7 @@ see
See also
-- How to quote and unquote commands and arguments
How to quote and unquote commands and arguments
+- How to quote and unquote commands and arguments
How to quote and unquote commands and arguments.
- community.routeros.api_facts
Collect facts from remote devices running MikroTik RouterOS using the API.
Modify data at paths with API.
- How to connect to RouterOS devices with the RouterOS API
How to connect to RouterOS devices with the RouterOS API
+- How to connect to RouterOS devices with the RouterOS API
How to connect to RouterOS devices with the RouterOS API.
@@ -610,8 +610,8 @@ see - attribute: "network"
is: "in"
value:
- - "10.20.36.0"
- - "192.168.255.0"
+ - "10.20.36.0"
+ - "192.168.255.0"
register: extended_queryout
- name: Dump "Extended query example" output
@@ -625,9 +625,9 @@ see username: "{{ username }}"
path: "ip address"
update: >-
- .id=*14
- address=192.168.255.20/24
- comment={{ 'Update 192.168.255.10/24 to 192.168.255.20/24 on ether2' | community.routeros.quote_argument_value }}
+ .id=*14
+ address=192.168.255.20/24
+ comment={{ 'Update 192.168.255.10/24 to 192.168.255.20/24 on ether2' | community.routeros.quote_argument_value }}
- name: Remove example - ether2 ip 192.168.255.20/24 with ".id = *14"
community.routeros.api:
diff --git a/branch/main/command_module.html b/branch/main/command_module.html
index b60f11a..8c4ec01 100644
--- a/branch/main/command_module.html
+++ b/branch/main/command_module.html
@@ -265,9 +265,9 @@ To check whether it is installed, run
See also
-- How to connect to RouterOS devices with SSH
How to connect to RouterOS devices with SSH
+- How to connect to RouterOS devices with SSH
How to connect to RouterOS devices with SSH.
- How to quote and unquote commands and arguments
How to quote and unquote commands and arguments
+- How to quote and unquote commands and arguments
How to quote and unquote commands and arguments.
@@ -314,7 +314,7 @@ To check whether it is installed, run
failed_conditions
list / elements=string
-The list of conditionals that have failed
+The list of conditionals that have failed.
Returned: failed
Sample: ["...", "..."]
stdout
list / elements=string
The set of responses from the commands
+The set of responses from the commands.
Returned: always apart from low level errors (such as action plugin)
Sample: ["...", "..."]
stdout_lines
list / elements=string
The value of stdout split into a list
+The value of stdout split into a list.
Returned: always apart from low level errors (such as action plugin)
Sample: [["...", "..."], ["..."], ["..."]]
See also
-- How to connect to RouterOS devices with SSH
How to connect to RouterOS devices with SSH
+- How to connect to RouterOS devices with SSH
How to connect to RouterOS devices with SSH.