fortios_configuration_fact – Retrieve Facts of FortiOS Configurable Objects.

New in version 2.10.

Synopsis

  • Collects facts from network devices running the fortios operating system. This module places the facts gathered in the fact tree keyed by the respective resource name. This facts module will only collect those facts which user specified in playbook.

Requirements

The below requirements are needed on the host that executes this module.

  • install galaxy collection fortinet.fortios

Parameters

  • vdom - 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. type: str required: False default: root
  • access_token - Token-based authentication. Generated from GUI of Fortigate. type: str required: False
  • selector - selector of the retrieved fortimanager facts type: str choices:
    • log_gui-display
    • system_fortiguard-service
    • router_route-map param: name type: str
    • system_sso-admin param: name type: str
    • wireless-controller_address param: id type: str
    • vpn.ssl_monitor
    • system.auto-update_status
    • system_cmdb
    • test_openstackd
    • authentication_rule param: name type: str
    • log.fortianalyzer_override-setting
    • firewall.ssl_setting
    • vpn.ipsec_phase2-interface param: name type: str
    • router_key-chain param: name type: str
    • system_ddns param: ddnsid type: int
    • firewall_traffic-class param: class_id type: int
    • system_replacemsg-group param: name type: str
    • system_ftm-push
    • system_sms-server param: name type: str
    • firewall_central-snat-map param: policyid type: int
    • firewall_multicast-address6 param: name type: str
    • test_forticldd
    • system.replacemsg_sslvpn param: msg_type type: str
    • ips_view-map param: id type: int
    • system_pppoe-interface param: name type: str
    • webfilter_categories
    • firewall_addrgrp6 param: name type: str
    • log.disk_filter
    • system_affinity-packet-redistribution param: id type: int
    • firewall_proxy-address param: name type: str
    • router_bgp
    • router_auth-path param: name type: str
    • system_resource-limits
    • system.replacemsg_auth param: msg_type type: str
    • system.autoupdate_schedule
    • test_uploadd
    • switch-controller.qos_ip-dscp-map param: name type: str
    • firewall_local-in-policy6 param: policyid type: int
    • log.fortianalyzer2_override-setting
    • log.fortianalyzer_override-filter
    • system.replacemsg_icap param: msg_type type: str
    • system_object-tagging param: category type: str
    • switch-controller_remote-log param: name type: str
    • router_rip
    • test_ipsmonitor
    • switch-controller.security-policy_local-access param: name type: str
    • vpn.ipsec.stats_tunnel
    • log.fortianalyzer-cloud_override-filter
    • firewall.shaper_traffic
    • user_adgrp param: name type: str
    • system_auto-script param: name type: str
    • switch-controller_quarantine
    • firewall.service_category param: name type: str
    • system_standalone-cluster
    • system_link-monitor param: name type: str
    • switch-controller_stp-settings
    • user_security-exempt-list param: name type: str
    • log.fortianalyzer-cloud_setting
    • switch-controller.qos_qos-policy param: name type: str
    • firewall_sniffer param: id type: int
    • test_pop3
    • wireless-controller_wag-profile param: name type: str
    • firewall_internet-service-reputation param: id type: int
    • test_wf_monitor
    • firewall_internet-service param: id type: int
    • firewall.iprope.appctrl_status
    • firewall_vipgrp46 param: name type: str
    • log.webtrends_filter
    • application_name param: name type: str
    • router_prefix-list6 param: name type: str
    • log_setting
    • firewall_address6-template param: name type: str
    • wireless-controller_scan
    • wireless-controller.hotspot20_h2qp-wan-metric param: name type: str
    • system_automation-action param: name type: str
    • system.autoupdate_tunneling
    • webfilter_ips-urlfilter-setting
    • switch-controller_network-monitor-settings
    • system_alias param: name type: str
    • switch-controller.auto-config_policy param: name type: str
    • switch-controller_port-policy param: name type: str
    • system_session-helper param: id type: int
    • router_community-list param: name type: str
    • wireless-controller_qos-profile param: name type: str
    • firewall_dnstranslation param: id type: int
    • vpn.ssl.web_portal param: name type: str
    • firewall_internet-service-custom param: name type: str
    • system.replacemsg_device-detection-portal param: msg_type type: str
    • wireless-controller_ble-profile param: name type: str
    • firewall_internet-service-custom-group param: name type: str
    • system.performance.firewall_statistics
    • firewall_profile-group param: name type: str
    • firewall.service_group param: name type: str
    • test_radvd
    • system.autoupdate_push-update
    • firewall_address6 param: name type: str
    • system.performance_top
    • wireless-controller_vap-status
    • wireless-controller_wids-profile param: name type: str
    • emailfilter_bword param: id type: int
    • log.fortiguard_filter
    • firewall_ipv6-eh-filter
    • webfilter_search-engine param: name type: str
    • endpoint-control_fctems param: name type: str
    • firewall_identity-based-route param: name type: str
    • system.session-helper-info_list
    • system_console
    • certificate_local param: name type: str
    • system_ntp
    • system_nat64
    • report_layout param: name type: str
    • firewall.consolidated_policy param: policyid type: int
    • wireless-controller.hotspot20_icon param: name type: str
    • test_dhcp6r
    • log.memory_global-setting
    • router_multicast-flow param: name type: str
    • ssh-filter_profile param: name type: str
    • system_fortisandbox
    • system_virtual-wan-link
    • ips_sensor param: name type: str
    • firewall.wildcard-fqdn_custom param: name type: str
    • router_static param: seq_num type: int
    • alertemail_setting
    • user_peergrp param: name type: str
    • user_fortitoken param: serial_number type: str
    • web-proxy_debug-url param: name type: str
    • vpn.ike_gateway
    • webfilter_override param: id type: int
    • test_reportd
    • switch-controller_nac-device param: id type: int
    • system_fsso-polling
    • user_peer param: name type: str
    • vpn.ssl.web_host-check-software param: name type: str
    • test_info-sslvpnd
    • switch-controller_lldp-profile param: name type: str
    • vpn.ssl.web_realm param: url_path type: str
    • system_stp
    • user_nac-policy param: name type: str
    • wireless-controller_snmp
    • emailfilter_fortishield
    • test_ftpd
    • firewall_shaping-policy param: id type: int
    • wireless-controller_wlchanlistlic
    • log_custom-field param: id type: str
    • switch-controller_mac-policy param: name type: str
    • firewall_address param: name type: str
    • certificate_crl param: name type: str
    • firewall.ssh_setting
    • system.session-info_full-stat
    • system_nd-proxy
    • log.memory_setting
    • system_alarm
    • system_ips-urlfilter-dns6 param: address6 type: str
    • wireless-controller_log
    • webfilter_ftgd-statistics
    • firewall_vendor-mac-summary
    • system_cluster-sync param: sync_id type: int
    • wanopt_settings
    • emailfilter_dnsbl param: id type: int
    • system_dedicated-mgmt
    • test_ipamd
    • log.fortianalyzer-cloud_override-setting
    • firewall_policy46 param: policyid type: int
    • system.source-ip_status
    • system_modem
    • certificate_remote param: name type: str
    • firewall_decrypted-traffic-mirror param: name type: str
    • antivirus_settings
    • switch-controller_storm-control-policy param: name type: str
    • switch-controller_802-1X-settings
    • system_session-ttl
    • system_storage param: name type: str
    • log.memory_filter
    • firewall_auth-portal
    • system_sflow
    • test_hasync
    • test_wad
    • user_ldap param: name type: str
    • ips_global
    • wanopt_remote-storage
    • wireless-controller.hotspot20_qos-map param: name type: str
    • system.session-info_ttl
    • vpn_l2tp
    • system_npu
    • firewall_vip46 param: name type: str
    • test_harelay
    • authentication_setting
    • vpn.certificate_ocsp-server param: name type: str
    • antivirus_heuristic
    • system_custom-language param: name type: str
    • web-proxy_explicit
    • vpn.ipsec_concentrator param: name type: str
    • test_snmpd
    • wireless-controller_wtp-group param: name type: str
    • system_vdom-sflow
    • switch-controller_igmp-snooping
    • waf_signature param: id type: int
    • test_hatalk
    • log.null-device_setting
    • ips_rule-settings param: id type: int
    • log.syslogd_setting
    • system.session-info_expectation
    • switch-controller.security-policy_802-1X param: name type: str
    • ips_decoder param: name type: str
    • firewall_proute6
    • user_setting
    • system.performance_status
    • system_geoip-override param: name type: str
    • vpn.ipsec_phase1 param: name type: str
    • vpn.ipsec_phase2 param: name type: str
    • wireless-controller.hotspot20_anqp-network-auth-type param: name type: str
    • webfilter_ips-urlfilter-cache-setting
    • firewall.ipmacbinding_setting
    • log.fortianalyzer2_filter
    • system.ip-conflict_status
    • application_rule-settings param: id type: int
    • switch-controller_flow-tracking
    • log.syslogd4_filter
    • system_speed-test-server param: name type: str
    • test_ocid
    • system_proxy-arp param: id type: int
    • webfilter_ftgd-local-rating param: url type: str
    • switch-controller_snmp-user param: name type: str
    • ips_custom param: tag type: str
    • switch-controller_switch-interface-tag param: name type: str
    • router_policy6 param: seq_num type: int
    • test_lnkmtd
    • test_fas
    • router_prefix-list param: name type: str
    • waf_sub-class param: id type: int
    • log_eventfilter
    • system_vdom-property param: name type: str
    • switch-controller_traffic-sniffer
    • firewall_security-policy param: policyid type: int
    • system_external-resource param: name type: str
    • test_azd
    • user_exchange param: name type: str
    • system_ipv6-neighbor-cache param: id type: int
    • vpn.ipsec.tunnel_details
    • report_style param: name type: str
    • log.syslogd2_override-filter
    • wireless-controller_wtp param: wtp_id type: str
    • wireless-controller_rf-analysis
    • wanopt_peer param: peer_host_id type: str
    • system_saml
    • test_sdncd
    • system.dhcp6_server param: id type: int
    • emailfilter_profile param: name type: str
    • log.fortianalyzer3_override-filter
    • hardware_status
    • firewall_multicast-policy param: id type: int
    • vpn_ocvpn
    • system_arp
    • firewall_internet-service-addition param: id type: int
    • test_dhcp6c
    • test_miglogd
    • webfilter_status
    • test_iotd
    • emailfilter_bwl param: id type: int
    • system_password-policy
    • switch-controller_virtual-port-pool param: name type: str
    • wireless-controller_setting
    • router_static6 param: seq_num type: int
    • wireless-controller.hotspot20_anqp-ip-address-type param: name type: str
    • test_dsd
    • firewall_vipgrp param: name type: str
    • firewall_city param: id type: int
    • web-proxy_profile param: name type: str
    • system_switch-interface param: name type: str
    • router_isis
    • firewall_policy param: policyid type: int
    • log.syslogd_override-setting
    • test_gcpd
    • hardware_memory
    • router_info
    • system.performance.firewall_packet-distribution
    • webfilter_content param: id type: int
    • firewall_vipgrp6 param: name type: str
    • switch-controller.initial-config_template param: name type: str
    • firewall.schedule_onetime param: name type: str
    • vpn.status_pptp
    • log.fortianalyzer_setting
    • test_autod
    • vpn.ipsec.tunnel_name
    • firewall_ippool6 param: name type: str
    • wireless-controller_status
    • system_central-management
    • system.replacemsg_http param: msg_type type: str
    • vpn.status.ssl_list
    • vpn.ipsec.tunnel_summary
    • cifs_domain-controller param: server_name type: str
    • system_zone param: name type: str
    • system_vdom-dns
    • firewall_multicast-address param: name type: str
    • wireless-controller_wtp-profile param: name type: str
    • vpn.ssl_settings
    • router_ospf
    • test_smtp
    • switch-controller.qos_queue-policy param: name type: str
    • dpdk_cpus
    • system.3g-modem_custom param: id type: int
    • test_fcnacd
    • ftp-proxy_explicit
    • system_fortimanager
    • system.lldp_network-policy param: name type: str
    • vpn.certificate_crl param: name type: str
    • system.replacemsg_admin param: msg_type type: str
    • router_multicast
    • webfilter_profile param: name type: str
    • switch-controller_storm-control
    • firewall_ssl-ssh-profile param: name type: str
    • firewall_country param: id type: int
    • log.disk_setting
    • dlp_filepattern param: id type: int
    • firewall_ippool param: name type: str
    • web-proxy_url-match param: name type: str
    • vpn.status.ssl_hw-acceleration-status
    • system_interface param: name type: str
    • log.syslogd3_override-filter
    • router_bfd
    • switch-controller_custom-command param: command_name type: str
    • firewall_internet-service-extension param: id type: int
    • system.replacemsg_webproxy param: msg_type type: str
    • user_password-policy param: name type: str
    • test_forticron
    • test_radiusd
    • wireless-controller_inter-controller
    • test_zebos_launcher
    • log.syslogd4_setting
    • log.fortianalyzer_filter
    • hardware_cpu
    • switch-controller_switch-group param: name type: str
    • user_fsso param: name type: str
    • emailfilter_mheader param: id type: int
    • firewall_vipgrp64 param: name type: str
    • test_bfd
    • user_quarantine
    • system_ips-urlfilter-dns param: address type: str
    • wireless-controller_addrgrp param: id type: str
    • system_fm
    • wireless-controller_apcfg-profile param: name type: str
    • system_global
    • vpn.ipsec.stats_crypto
    • wireless-controller.hotspot20_anqp-nai-realm param: name type: str
    • system_physical-switch param: name type: str
    • test_dnsproxy
    • system_status
    • log.fortiguard_override-setting
    • firewall_proute
    • test_dlpfingerprint
    • log.fortianalyzer3_setting
    • system.auto-update_versions
    • firewall_vip param: name type: str
    • system_virtual-switch param: name type: str
    • wanopt_auth-group param: name type: str
    • wanopt_webcache
    • system.snmp_user param: name type: str
    • firewall_ip-translation param: transid type: int
    • system_settings
    • log.fortianalyzer2_setting
    • wireless-controller_vap param: name type: str
    • ipsec_tunnel
    • wanopt_cache-service
    • log.syslogd4_override-filter
    • switch-controller_switch-log
    • firewall_internet-service-group param: name type: str
    • system.replacemsg_mail param: msg_type type: str
    • extender_modem-status
    • system_replacemsg-image param: name type: str
    • test_radius-das
    • test_ipsengine
    • antivirus_quarantine
    • log.fortianalyzer2_override-filter
    • system.session-info_list
    • vpn.certificate_ca param: name type: str
    • test_acid
    • test_awsd
    • system_sdn-connector param: name type: str
    • vpn.ssl.web_user-group-bookmark param: name type: str
    • system_fortiguard-log-service
    • system_central-mgmt
    • hardware_nic
    • log.null-device_filter
    • firewall.shaper_per-ip-shaper param: name type: str
    • test_sflowd
    • wireless-controller_utm-profile param: name type: str
    • router_aspath-list param: name type: str
    • firewall.schedule_group param: name type: str
    • firewall_internet-service-list param: id type: int
    • system_dscp-based-priority param: id type: int
    • dlp_sensitivity param: name type: str
    • icap_server param: name type: str
    • vpn.ipsec_phase1-interface param: name type: str
    • authentication_scheme param: name type: str
    • log.fortianalyzer3_filter
    • system_email-server
    • dlp_sensor param: name type: str
    • application_list param: name type: str
    • vpn.ssl.web_user-bookmark param: name type: str
    • firewall.shaper_traffic-shaper param: name type: str
    • switch-controller_traffic-policy param: name type: str
    • test_dhcprelay
    • system_csf
    • system.replacemsg_nntp param: msg_type type: str
    • switch-controller_stp-instance param: id type: str
    • mgmt-data_status
    • dnsfilter_profile param: name type: str
    • system_ha-monitor
    • test_mrd
    • test_ovrd
    • wireless-controller.hotspot20_anqp-venue-name param: name type: str
    • system.snmp_sysinfo
    • application_custom param: tag type: str
    • ips_session
    • system_api-user param: name type: str
    • system.info.admin_ssh
    • ips_rule param: name type: str
    • log.fortianalyzer-cloud_filter
    • system_netflow
    • vpn.ipsec_forticlient param: realm type: str
    • system_automation-trigger param: name type: str
    • firewall_policy64 param: policyid type: int
    • wireless-controller.hotspot20_h2qp-osu-provider param: name type: str
    • webfilter_ips-urlfilter-setting6
    • switch-controller_sflow
    • firewall.service_custom param: name type: str
    • firewall_internet-service-botnet param: id type: int
    • firewall_internet-service-definition param: id type: int
    • system_mobile-tunnel param: name type: str
    • log.syslogd3_override-setting
    • user_saml param: name type: str
    • firewall_ttl-policy param: id type: int
    • wireless-controller_client-info
    • webfilter_fortiguard
    • vpn_pptp
    • wireless-controller.hotspot20_hs-profile param: name type: str
    • log.webtrends_setting
    • firewall_local-in-policy param: policyid type: int
    • wireless-controller_region param: name type: str
    • router_policy param: seq_num type: int
    • web-proxy_forward-server-group param: name type: str
    • switch-controller.qos_dot1p-map param: name type: str
    • firewall_multicast-policy6 param: id type: int
    • switch-controller.initial-config_vlans
    • wanopt_content-delivery-network-rule param: name type: str
    • firewall_region param: id type: int
    • system_dns-database param: name type: str
    • waf_main-class param: id type: int
    • system.replacemsg_nac-quar param: msg_type type: str
    • system_vdom-radius-server param: name type: str
    • system_vdom param: name type: str
    • test_fsvrd
    • user_tacacs+ param: name type: str
    • system_ipip-tunnel param: name type: str
    • log.syslogd3_setting
    • test_wccpd
    • report_dataset param: name type: str
    • webfilter_ftgd-local-cat param: desc type: str
    • router_multicast6
    • test_init
    • vpn.certificate_remote param: name type: str
    • dlp_settings
    • system_fips-cc
    • switch-controller_snmp-community param: id type: int
    • system_geneve param: name type: str
    • system_ha
    • log.syslogd3_filter
    • test_ddnscd
    • user_radius param: name type: str
    • firewall_DoS-policy6 param: policyid type: int
    • switch-controller.auto-config_default
    • system_tos-based-priority param: id type: int
    • vpn.certificate_local param: name type: str
    • system_accprofile param: name type: str
    • wireless-controller_global
    • log.syslogd_filter
    • vpn.status_l2tp
    • system_ipsec-aggregate param: name type: str
    • wireless-controller_ap-status param: id type: int
    • switch-controller_poe
    • log.syslogd2_filter
    • log.syslogd2_setting
    • system_password-policy-guest-admin
    • user_pop3 param: name type: str
    • switch-controller_vlan-policy param: name type: str
    • system_geoip-country param: id type: str
    • switch-controller_system
    • voip_profile param: name type: str
    • vpn.ipsec_manualkey-interface param: name type: str
    • emailfilter_options
    • system.info.admin_status
    • switch-controller_snmp-sysinfo
    • firewall_internet-service-sld param: id type: int
    • system_vdom-netflow
    • test_dlpfpcache
    • firewall.ipmacbinding_table param: seq_num type: int
    • system_automation-destination param: name type: str
    • dlp_fp-doc-source param: name type: str
    • firewall_ldb-monitor param: name type: str
    • system_lte-modem
    • firewall.ssh_host-key param: name type: str
    • system_vdom-link param: name type: str
    • test_urlfilter
    • system_fortianalyzer-connectivity
    • test_l2tpcd
    • router_ospf6
    • log.fortiguard_setting
    • system.snmp_community param: id type: int
    • ips_settings
    • firewall_internet-service-ipbl-vendor param: id type: int
    • system_vdom-exception param: id type: int
    • system_wccp param: service_id type: str
    • router_info6
    • system_ha-nonsync-csum
    • system_automation-stitch param: name type: str
    • test_csfd
    • firewall_profile-protocol-options param: name type: str
    • report_theme param: name type: str
    • test_kubed
    • firewall.ssh_local-key param: name type: str
    • test_pptpcd
    • system_mgmt-csum
    • firewall_vip64 param: name type: str
    • web-proxy_wisp param: name type: str
    • switch-controller_switch-profile param: name type: str
    • system.checksum_status
    • system_dns-server param: name type: str
    • system.replacemsg_alertmail param: msg_type type: str
    • log.fortiguard_override-filter
    • system_fortiguard
    • web-proxy_global
    • wanopt_profile param: name type: str
    • system_management-tunnel
    • wireless-controller.hotspot20_anqp-3gpp-cellular param: name type: str
    • report_setting
    • system_vxlan param: name type: str
    • switch-controller_snmp-trap-threshold
    • switch-controller_nac-settings param: name type: str
    • system_ipv6-tunnel param: name type: str
    • firewall.iprope.appctrl_list
    • test_acd
    • user_fsso-polling param: id type: int
    • system.dhcp_server param: id type: int
    • report_chart param: name type: str
    • vpn.certificate_setting
    • router_bfd6
    • router_access-list param: name type: str
    • system.session-info_statistics
    • firewall_proxy-policy param: policyid type: int
    • system_dns
    • icap_profile param: name type: str
    • firewall_internet-service-ipbl-reason param: id type: int
    • webfilter_override-usr
    • system_session
    • dnsfilter_domain-filter param: id type: int
    • report.sql_status
    • switch-controller.auto-config_custom param: name type: str
    • wireless-controller_vap-group param: name type: str
    • emailfilter_iptrust param: id type: int
    • antivirus_profile param: name type: str
    • system_startup-error-log
    • firewall_internet-service-name param: name type: str
    • system_affinity-interrupt param: id type: int
    • firewall_shaping-profile param: profile_name type: str
    • log.syslogd4_override-setting
    • firewall_interface-policy6 param: policyid type: int
    • vpn.ipsec_manualkey param: name type: str
    • firewall.shaper_per-ip
    • firewall_vendor-mac param: id type: int
    • switch-controller_global
    • router_setting
    • user_local param: name type: str
    • firewall.schedule_recurring param: name type: str
    • system_sit-tunnel param: name type: str
    • system_arp-table param: id type: int
    • switch-controller_lldp-settings
    • webfilter_content-header param: id type: int
    • system_auto-install
    • log.fortianalyzer3_override-setting
    • user_domain-controller param: name type: str
    • wireless-controller_wtp-status
    • firewall_ssl-server param: name type: str
    • test_imap
    • system.replacemsg_traffic-quota param: msg_type type: str
    • system_virtual-wire-pair param: name type: str
    • system_mac-address-table param: mac type: str
    • firewall_internet-service-owner param: id type: int
    • system_network-visibility
    • log.syslogd_override-filter
    • test_fsd
    • test_sessionsync
    • test_nntp
    • firewall_interface-policy param: policyid type: int
    • system.replacemsg_fortiguard-wf param: msg_type type: str
    • wireless-controller_bonjour-profile param: name type: str
    • test_ipsufd
    • webfilter_urlfilter param: id type: int
    • wireless-controller_spectral-info
    • credential-store_domain-controller param: server_name type: str
    • dpdk_global
    • system_probe-response
    • wireless-controller.hotspot20_h2qp-operator-name param: name type: str
    • wireless-controller_access-control-list param: name type: str
    • cifs_profile param: name type: str
    • system.replacemsg_utm param: msg_type type: str
    • extender_sys-info
    • wireless-controller.hotspot20_anqp-roaming-consortium param: name type: str
    • firewall_DoS-policy param: policyid type: int
    • firewall_proxy-addrgrp param: name type: str
    • firewall_addrgrp param: name type: str
    • test_fnbamd
    • firewall_policy6 param: policyid type: int
    • router_ripng
    • firewall_vip6 param: name type: str
    • web-proxy_forward-server param: name type: str
    • system.replacemsg_spam param: msg_type type: str
    • certificate_ca param: name type: str
    • test_netxd
    • firewall.ssh_local-ca param: name type: str
    • system_admin param: name type: str
    • test_vmwd
    • switch-controller_location param: name type: str
    • wireless-controller_timers
    • router_access-list6 param: name type: str
    • waf_profile param: name type: str
    • firewall.wildcard-fqdn_group param: name type: str
    • system_gre-tunnel param: name type: str
    • user_group param: name type: str
    • log.syslogd2_override-setting
    • user_krb-keytab param: name type: str
    • firewall.iprope_list
    • test_quarantined
    • system_ptp
    • test_sepmd
    • application_group param: name type: str
    • system.replacemsg_ftp param: msg_type type: str
    • test_ipldbd
    • log_threat-weight
    • extender-controller_extender param: id type: str
    • wireless-controller.hotspot20_h2qp-conn-capability param: name type: str
    • system_session6
    • switch-controller_managed-switch param: switch_id type: str
    • test_lted
  • params - the parameter for each selector, see definition in above list.type: dict

Notes

Note

  • Different selector may have different parameters, users are expected to look up them for a specific selector.
  • For some selectors, the objects are global, no params are allowed to appear.
  • If params is empty a non-unique object, the whole object list is returned.
  • This module has support for all configuration API, excluding any monitor API.
  • The result of API request is stored in results as a list.

Examples

- hosts: fortigateslab
  connection: httpapi
  collections:
    - fortinet.fortios
  vars:
    ansible_httpapi_use_ssl: yes
    ansible_httpapi_validate_certs: no
    ansible_httpapi_port: 443
    vdom: "root"
  tasks:
  - name: get all
    fortios_configuration_fact:
      vdom: ""
      access_token: ""
      selector: log_custom-field

  - name: get single
    fortios_configuration_fact:
      vdom: ""
      access_token: ""
      selector: log_custom-field
      #optionally list or single get
      params:
        id: "3"

  - name: fetch one firewall address
    fortios_configuration_fact:
      selector: firewall_address
      params:
        name: "login.microsoft.com"

  - name: fetch all firewall addresses
    fortios_configuration_fact:
      selector: firewall_address

Return Values

Common return values are documented: https://docs.ansible.com/ansible/latest/reference_appendices/common_return_values.html#common-return-values, the following are the fields unique to this module:

  • build - Build number of the fortigate image returned: always type: str sample: 1547
  • http_method - Last method used to provision the content into FortiGate returned: always type: str sample: GET
  • name - Name of the table used to fulfill the request returned: always type: str sample: firmware
  • path - Path of the table used to fulfill the request returned: always type: str sample: system
  • results - Object list retrieved from device. returned: always type: list
  • revision - Internal revision number returned: always type: str sample: 17.0.2.10658
  • serial - Serial number of the unit returned: always type: str sample: FGVMEVYYQT3AB5352
  • status - Indication of the operation's result returned: always type: str sample: success
  • vdom - Virtual domain used returned: always type: str sample: root
  • version - Version of the FortiGate returned: always type: str sample: v5.6.3
  • ansible_facts - The list of fact subsets collected from the device returned: always type: dict

Status

  • This module is not guaranteed to have a backwards compatible interface.

Authors

  • Link Zheng (@chillancezen)
  • Jie Xue (@JieX19)
  • Hongbin Lu (@fgtdev-hblu)
  • Frank Shen (@fshen01)

Hint

If you notice any issues in this documentation, you can create a pull request to improve it.