Note
This module is part of the fortinet.fortios collection (version 2.4.0).
You might already have this collection installed if you are using the ansible package. 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 fortinet.fortios. You need further requirements to be able to use this module, see Requirements for details.
To use it in a playbook, specify: fortinet.fortios.fortios_extension_controller_extender_profile.
New in fortinet.fortios 2.0.0
The below requirements are needed on the host that executes this module.
Parameter | Comments |
|---|---|
access_token string | Token-based authentication. Generated from GUI of Fortigate. |
enable_log boolean | Enable/Disable logging for task. Choices:
|
extension_controller_extender_profile dictionary | FortiExtender extender profile configuration. |
|
allowaccess list / elements=string |
Control management access to the managed extender. Separate entries with a space. Choices:
|
|
bandwidth_limit integer |
FortiExtender LAN extension bandwidth limit (Mbps). |
|
cellular dictionary |
FortiExtender cellular configuration. |
|
controller_report dictionary |
FortiExtender controller report configuration. |
|
interval integer |
Controller report interval. |
|
signal_threshold integer |
Controller report signal threshold. |
|
status string |
FortiExtender controller report status. Choices:
|
|
dataplan list / elements=dictionary |
Dataplan names. |
|
name string / required |
Dataplan name. Source extension-controller.dataplan.name. |
|
modem1 dictionary |
Configuration options for modem 1. |
|
auto_switch dictionary |
FortiExtender auto switch configuration. |
|
dataplan string |
Automatically switch based on data usage. Choices:
|
|
disconnect string |
Auto switch by disconnect. Choices:
|
|
disconnect_period integer |
Automatically switch based on disconnect period. |
|
disconnect_threshold integer |
Automatically switch based on disconnect threshold. |
|
signal string |
Automatically switch based on signal strength. Choices:
|
|
switch_back list / elements=string |
Auto switch with switch back multi-options. Choices:
|
|
switch_back_time string |
Automatically switch over to preferred SIM/carrier at a specified time in UTC (HH:MM). |
|
switch_back_timer integer |
Automatically switch over to preferred SIM/carrier after the given time (3600 - 2147483647 sec). |
|
default_sim string |
Default SIM selection. Choices:
|
|
gps string |
FortiExtender GPS enable/disable. Choices:
|
|
multiple_PDN string |
Multiple-PDN enable/disable. Choices:
|
|
pdn1_dataplan string |
PDN1-dataplan. Source extension-controller.dataplan.name. |
|
pdn2_dataplan string |
PDN2-dataplan. Source extension-controller.dataplan.name. |
|
pdn3_dataplan string |
PDN3-dataplan. Source extension-controller.dataplan.name. |
|
pdn4_dataplan string |
PDN4-dataplan. Source extension-controller.dataplan.name. |
|
preferred_carrier string |
Preferred carrier. |
|
redundant_intf string |
Redundant interface. |
|
redundant_mode string |
FortiExtender mode. Choices:
|
|
sim1_pin string |
SIM Choices:
|
|
sim1_pin_code string |
SIM |
|
sim2_pin string |
SIM Choices:
|
|
sim2_pin_code string |
SIM |
|
modem2 dictionary |
Configuration options for modem 2. |
|
auto_switch dictionary |
FortiExtender auto switch configuration. |
|
dataplan string |
Automatically switch based on data usage. Choices:
|
|
disconnect string |
Auto switch by disconnect. Choices:
|
|
disconnect_period integer |
Automatically switch based on disconnect period. |
|
disconnect_threshold integer |
Automatically switch based on disconnect threshold. |
|
signal string |
Automatically switch based on signal strength. Choices:
|
|
switch_back list / elements=string |
Auto switch with switch back multi-options. Choices:
|
|
switch_back_time string |
Automatically switch over to preferred SIM/carrier at a specified time in UTC (HH:MM). |
|
switch_back_timer integer |
Automatically switch over to preferred SIM/carrier after the given time (3600 - 2147483647 sec). |
|
default_sim string |
Default SIM selection. Choices:
|
|
gps string |
FortiExtender GPS enable/disable. Choices:
|
|
multiple_PDN string |
Multiple-PDN enable/disable. Choices:
|
|
pdn1_dataplan string |
PDN1-dataplan. Source extension-controller.dataplan.name. |
|
pdn2_dataplan string |
PDN2-dataplan. Source extension-controller.dataplan.name. |
|
pdn3_dataplan string |
PDN3-dataplan. Source extension-controller.dataplan.name. |
|
pdn4_dataplan string |
PDN4-dataplan. Source extension-controller.dataplan.name. |
|
preferred_carrier string |
Preferred carrier. |
|
redundant_intf string |
Redundant interface. |
|
redundant_mode string |
FortiExtender mode. Choices:
|
|
sim1_pin string |
SIM Choices:
|
|
sim1_pin_code string |
SIM |
|
sim2_pin string |
SIM Choices:
|
|
sim2_pin_code string |
SIM |
|
sms_notification dictionary |
FortiExtender cellular SMS notification configuration. |
|
alert dictionary |
SMS alert list. |
|
data_exhausted string |
Display string when data exhausted. |
|
fgt_backup_mode_switch string |
Display string when FortiGate backup mode switched. |
|
low_signal_strength string |
Display string when signal strength is low. |
|
mode_switch string |
Display string when mode is switched. |
|
os_image_fallback string |
Display string when falling back to a previous OS image. |
|
session_disconnect string |
Display string when session disconnected. |
|
system_reboot string |
Display string when system rebooted. |
|
receiver list / elements=dictionary |
SMS notification receiver list. |
|
alert list / elements=string |
Alert multi-options. Choices:
|
|
name string / required |
FortiExtender SMS notification receiver name. |
|
phone_number string |
Receiver phone number. Format: [+][country code][area code][local phone number]. For example, +16501234567. |
|
status string |
SMS notification receiver status. Choices:
|
|
status string |
FortiExtender SMS notification status. Choices:
|
|
enforce_bandwidth string |
Enable/disable enforcement of bandwidth on LAN extension interface. Choices:
|
|
extension string |
Extension option. Choices:
|
|
id integer |
ID. |
|
lan_extension dictionary |
FortiExtender LAN extension configuration. |
|
backhaul list / elements=dictionary |
LAN extension backhaul tunnel configuration. |
|
name string / required |
FortiExtender LAN extension backhaul name. |
|
port string |
FortiExtender uplink port. Choices:
|
|
role string |
FortiExtender uplink port. Choices:
|
|
weight integer |
WRR weight parameter. |
|
backhaul_interface string |
IPsec phase1 interface. Source system.interface.name. |
|
backhaul_ip string |
IPsec phase1 IPv4/FQDN. Used to specify the external IP/FQDN when the FortiGate unit is behind a NAT device. |
|
downlinks list / elements=dictionary |
Config FortiExtender downlink interface for LAN extension. |
|
name string / required |
FortiExtender LAN extension downlink config entry name. |
|
port string |
FortiExtender LAN extension downlink port. Choices:
|
|
pvid integer |
FortiExtender LAN extension downlink PVID. |
|
type string |
FortiExtender LAN extension downlink type [port/vap]. Choices:
|
|
vap string |
FortiExtender LAN extension downlink vap. Source extension-controller.extender-vap.name. |
|
ipsec_tunnel string |
IPsec tunnel name. |
|
link_loadbalance string |
LAN extension link load balance strategy. Choices:
|
|
traffic_split_services list / elements=dictionary |
Config FortiExtender traffic split interface for LAN extension. |
|
address string |
Address selection. Source firewall.address.name. |
|
name string / required |
FortiExtender LAN extension tunnel split entry name. |
|
service string |
Service selection. Source firewall.service.custom.name. |
|
vsdb string |
Select vsdb [enable/disable]. Choices:
|
|
login_password string |
Set the managed extender”s administrator password. |
|
login_password_change string |
Change or reset the administrator password of a managed extender (yes, default, or no). Choices:
|
|
model string |
Model. Choices:
|
|
name string / required |
FortiExtender profile name. |
|
wifi dictionary |
FortiExtender Wi-Fi configuration. |
|
country string |
Country in which this FEX will operate . Choices:
|
|
radio_1 dictionary |
Radio-1 config for Wi-Fi 2.4GHz |
|
band string |
Wi-Fi band selection 2.4GHz / 5GHz. Choices:
|
|
bandwidth string |
Wi-Fi channel bandwidth. Choices:
|
|
beacon_interval integer |
Wi-Fi beacon interval in miliseconds (100 - 3500). |
|
bss_color integer |
Wi-Fi 802.11AX BSS color value (0 - 63, 0 = disable). |
|
bss_color_mode string |
Wi-Fi 802.11AX BSS color mode. Choices:
|
|
channel list / elements=string |
Wi-Fi channels. Choices:
|
|
extension_channel string |
Wi-Fi extension channel. Choices:
|
|
guard_interval string |
Wi-Fi guard interval. Choices:
|
|
lan_ext_vap string |
Wi-Fi LAN-Extention VAP. Select only one VAP. Source extension-controller.extender-vap.name. |
|
local_vaps list / elements=dictionary |
Wi-Fi local VAP. Select up to three VAPs. |
|
name string / required |
Wi-Fi local VAP name. Source extension-controller.extender-vap.name. |
|
max_clients integer |
Maximum number of Wi-Fi radio clients (0 - 512, 0 = unlimited). |
|
mode string |
Wi-Fi radio mode AP(LAN mode) / Client(WAN mode). Choices:
|
|
operating_standard string |
Wi-Fi operating standard. Choices:
|
|
power_level integer |
Wi-Fi power level in percent (0 - 100, 0 = auto). |
|
set_80211d string |
Enable/disable Wi-Fi 802.11d. Choices:
|
|
status string |
Enable/disable Wi-Fi radio. Choices:
|
|
radio_2 dictionary |
Radio-2 config for Wi-Fi 5GHz |
|
band string |
Wi-Fi band selection 2.4GHz / 5GHz. Choices:
|
|
bandwidth string |
Wi-Fi channel bandwidth. Choices:
|
|
beacon_interval integer |
Wi-Fi beacon interval in miliseconds (100 - 3500). |
|
bss_color integer |
Wi-Fi 802.11AX BSS color value (0 - 63, 0 = disable). |
|
bss_color_mode string |
Wi-Fi 802.11AX BSS color mode. Choices:
|
|
channel list / elements=string |
Wi-Fi channels. Choices:
|
|
extension_channel string |
Wi-Fi extension channel. Choices:
|
|
guard_interval string |
Wi-Fi guard interval. Choices:
|
|
lan_ext_vap string |
Wi-Fi LAN-Extention VAP. Select only one VAP. Source extension-controller.extender-vap.name. |
|
local_vaps list / elements=dictionary |
Wi-Fi local VAP. Select up to three VAPs. |
|
name string / required |
Wi-Fi local VAP name. Source extension-controller.extender-vap.name. |
|
max_clients integer |
Maximum number of Wi-Fi radio clients (0 - 512, 0 = unlimited). |
|
mode string |
Wi-Fi radio mode AP(LAN mode) / Client(WAN mode). Choices:
|
|
operating_standard string |
Wi-Fi operating standard. Choices:
|
|
power_level integer |
Wi-Fi power level in percent (0 - 100, 0 = auto). |
|
set_80211d string |
Enable/disable Wi-Fi 802.11d. Choices:
|
|
status string |
Enable/disable Wi-Fi radio. Choices:
|
member_path string | Member attribute path to operate on. Delimited by a slash character if there are more than one attribute. Parameter marked with member_path is legitimate for doing member operation. |
member_state string | Add or delete a member under specified attribute path. When member_state is specified, the state option is ignored. Choices:
|
state string / required | Indicates whether to create or remove the object. Choices:
|
vdom string | Virtual domain, among those defined previously. A vdom is a virtual instance of the FortiGate that can be configured and used as a different unit. Default: |
Note
- name: FortiExtender extender profile configuration.
fortinet.fortios.fortios_extension_controller_extender_profile:
vdom: "{{ vdom }}"
state: "present"
access_token: "<your_own_value>"
extension_controller_extender_profile:
allowaccess: "ping"
bandwidth_limit: "1024"
cellular:
controller_report:
interval: "300"
signal_threshold: "10"
status: "disable"
dataplan:
-
name: "default_name_11 (source extension-controller.dataplan.name)"
modem1:
auto_switch:
dataplan: "disable"
disconnect: "disable"
disconnect_period: "600"
disconnect_threshold: "3"
signal: "disable"
switch_back: "time"
switch_back_time: "<your_own_value>"
switch_back_timer: "86400"
default_sim: "sim1"
gps: "disable"
multiple_PDN: "disable"
pdn1_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
pdn2_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
pdn3_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
pdn4_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
preferred_carrier: "<your_own_value>"
redundant_intf: "<your_own_value>"
redundant_mode: "disable"
sim1_pin: "disable"
sim1_pin_code: "<your_own_value>"
sim2_pin: "disable"
sim2_pin_code: "<your_own_value>"
modem2:
auto_switch:
dataplan: "disable"
disconnect: "disable"
disconnect_period: "600"
disconnect_threshold: "3"
signal: "disable"
switch_back: "time"
switch_back_time: "<your_own_value>"
switch_back_timer: "86400"
default_sim: "sim1"
gps: "disable"
multiple_PDN: "disable"
pdn1_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
pdn2_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
pdn3_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
pdn4_dataplan: "<your_own_value> (source extension-controller.dataplan.name)"
preferred_carrier: "<your_own_value>"
redundant_intf: "<your_own_value>"
redundant_mode: "disable"
sim1_pin: "disable"
sim1_pin_code: "<your_own_value>"
sim2_pin: "disable"
sim2_pin_code: "<your_own_value>"
sms_notification:
alert:
data_exhausted: "<your_own_value>"
fgt_backup_mode_switch: "<your_own_value>"
low_signal_strength: "<your_own_value>"
mode_switch: "<your_own_value>"
os_image_fallback: "<your_own_value>"
session_disconnect: "<your_own_value>"
system_reboot: "<your_own_value>"
receiver:
-
alert: "system-reboot"
name: "default_name_71"
phone_number: "<your_own_value>"
status: "disable"
status: "disable"
enforce_bandwidth: "enable"
extension: "wan-extension"
id: "77"
lan_extension:
backhaul:
-
name: "default_name_80"
port: "wan"
role: "primary"
weight: "1"
backhaul_interface: "<your_own_value> (source system.interface.name)"
backhaul_ip: "<your_own_value>"
downlinks:
-
name: "default_name_87"
port: "port1"
pvid: "0"
type: "port"
vap: "<your_own_value> (source extension-controller.extender-vap.name)"
ipsec_tunnel: "<your_own_value>"
link_loadbalance: "activebackup"
traffic_split_services:
-
address: "<your_own_value> (source firewall.address.name)"
name: "default_name_96"
service: "<your_own_value> (source firewall.service.custom.name)"
vsdb: "disable"
login_password: "<your_own_value>"
login_password_change: "yes"
model: "FX201E"
name: "default_name_102"
wifi:
country: "--"
radio_1:
band: "2.4GHz"
bandwidth: "auto"
beacon_interval: "100"
bss_color: "0"
bss_color_mode: "auto"
channel: "CH1"
extension_channel: "auto"
guard_interval: "auto"
lan_ext_vap: "<your_own_value> (source extension-controller.extender-vap.name)"
local_vaps:
-
name: "default_name_116 (source extension-controller.extender-vap.name)"
max_clients: "0"
mode: "AP"
operating_standard: "auto"
power_level: "100"
set_80211d: "disable"
status: "disable"
radio_2:
band: "5GHz"
bandwidth: "auto"
beacon_interval: "100"
bss_color: "0"
bss_color_mode: "auto"
channel: "CH36"
extension_channel: "auto"
guard_interval: "auto"
lan_ext_vap: "<your_own_value> (source extension-controller.extender-vap.name)"
local_vaps:
-
name: "default_name_134 (source extension-controller.extender-vap.name)"
max_clients: "0"
mode: "AP"
operating_standard: "auto"
power_level: "100"
set_80211d: "disable"
status: "disable"
Common return values are documented here, the following are the fields unique to this module:
Key | Description |
|---|---|
build string | Build number of the fortigate image Returned: always Sample: |
http_method string | Last method used to provision the content into FortiGate Returned: always Sample: |
http_status string | Last result given by FortiGate on last operation applied Returned: always Sample: |
mkey string | Master key (id) used in the last call to FortiGate Returned: success Sample: |
name string | Name of the table used to fulfill the request Returned: always Sample: |
path string | Path of the table used to fulfill the request Returned: always Sample: |
revision string | Internal revision number Returned: always Sample: |
serial string | Serial number of the unit Returned: always Sample: |
status string | Indication of the operation’s result Returned: always Sample: |
vdom string | Virtual domain used Returned: always Sample: |
version string | Version of the FortiGate Returned: always Sample: |
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/fortinet/fortios/fortios_extension_controller_extender_profile_module.html