david_igou.routeros_configuration._reconcile role – Reconcile one RouterOS config path declaratively via the API.

Note

This role is part of the david_igou.routeros_configuration collection (version 0.0.8-alpha).

It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it use: ansible-galaxy collection install david_igou.routeros_configuration.

To use it in a playbook, specify: david_igou.routeros_configuration._reconcile.

Entry point main – Reconcile one RouterOS config path declaratively via the API.

Synopsis

  • Internal engine role. Subsystem roles include it with rcfg_* set.

Parameters

Parameter

Comments

rcfg_content

string

How to treat entry fields not present in rcfg_data.

Choices:

  • "ignore" ← (default)

  • "remove"

  • "remove_as_much_as_possible"

rcfg_data

list / elements=dictionary / required

Desired list of entry dicts for the path.

rcfg_order

boolean

Enforce entry order. Requires rcfg_purge.

Choices:

  • false ← (default)

  • true

rcfg_path

string / required

Space-separated RouterOS path, e.g. “ip firewall filter”.

rcfg_purge

boolean

Remove device entries not present in rcfg_data (exact-state).

Choices:

  • false ← (default)

  • true

routeros_api_hostname

string

API hostname/IP of the device.

Default: "{{ inventory_hostname }}"

routeros_api_password

string

API password. Secret — supply via vault/group_vars. Intentionally has no default so a missing value fails loudly rather than attempting an empty-password login. The module marks it no_log.

routeros_api_port

any

TCP port; empty lets the module choose from tls.

Default: ""

routeros_api_tls

boolean

Use TLS (api-ssl). Prefer true in production.

Choices:

  • false

  • true ← (default)

routeros_api_username

string

API username.

Default: "admin"

routeros_api_validate_certs

boolean

Validate the device TLS certificate.

Choices:

  • false

  • true ← (default)