community.network.fmgr_device_config – Edit device configurations

Note

This plugin is part of the community.network collection (version 1.3.2).

To install it use: ansible-galaxy collection install community.network.

To use it in a playbook, specify: community.network.fmgr_device_config.

Synopsis

  • Edit device configurations from FortiManager Device Manager using JSON RPC API.

Parameters

Parameter Choices/Defaults Comments
adom
string
Default:
"root"
The ADOM the configuration should belong to.
device_hostname
string
The device's new hostname.
device_unique_name
string / required
The unique device's name that you are editing. A.K.A. Friendly name of the device in FortiManager.
install_config
string
Default:
"disable"
Tells FMGR to attempt to install the config after making it.
interface
string
The interface/port number you are editing.
interface_allow_access
string
Specify what protocols are allowed on the interface, comma-separated list (see examples).
interface_ip
string
The IP and subnet of the interface/port you are editing.

Examples

- name: CHANGE HOSTNAME
  community.network.fmgr_device_config:
    device_hostname: "ChangedbyAnsible"
    device_unique_name: "FGT1"

- name: EDIT INTERFACE INFORMATION
  community.network.fmgr_device_config:
    adom: "root"
    device_unique_name: "FGT2"
    interface: "port3"
    interface_ip: "10.1.1.1/24"
    interface_allow_access: "ping, telnet, https"

- name: INSTALL CONFIG
  community.network.fmgr_device_config:
    adom: "root"
    device_unique_name: "FGT1"
    install_config: "enable"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key Returned Description
api_result
string
always
full API response, includes status code and message


Authors

  • Luke Weighall (@lweighall)

  • Andrew Welsh (@Ghilli3)

  • Jim Huber (@p4r4n0y1ng)