:source: fmgr_fact.py :orphan: .. _fmgr_fact: fmgr_fact -- Gather FortiManager Facts. +++++++++++++++++++++++++++++++++++++++ .. versionadded:: 2.0.0 .. contents:: :local: :depth: 1 Synopsis -------- - This module is able to configure a FortiManager device. - Examples include all parameters and values need to be adjusted to data sources before usage. - Tested with FortiManager v7.x. Requirements ------------ The below requirements are needed on the host that executes this module. - ansible-core>=2.16.0 Parameters ---------- .. raw:: html Notes ----- .. note:: - Running in workspace locking mode is supported in this FortiManager module, the top level parameters workspace_locking_adom and workspace_locking_timeout help do the work. - Selector is a mandatory parameter for the module, and the params is varying depending on the selector. - Parameter ``adom`` can be ``null`` or ``''`` for all administrative domains, ``global`` for global domain and any other custom domain strings. and a particular fact may not support all kinds of domains. - In parameters section, ``null`` and ``''`` are identical if you are fetching all objects under that selector category. - Normally, running one module can fail when a non-zero rc is returned. you can also override the conditions to fail or succeed with parameters ``rc_failed`` and ``rc_succeeded`` Examples -------- .. code-block:: yaml+jinja - name: Gathering fortimanager facts hosts: fortimanagers gather_facts: false connection: httpapi vars: ansible_httpapi_use_ssl: true ansible_httpapi_validate_certs: false ansible_httpapi_port: 443 tasks: - name: Retrieve all the scripts fortinet.fortimanager.fmgr_fact: facts: selector: "dvmdb_script" params: adom: "root" script: "" - name: Retrive all the interfaces fortinet.fortimanager.fmgr_fact: facts: selector: "system_interface" params: interface: "" - name: Retrieve the interface port1 fortinet.fortimanager.fmgr_fact: facts: selector: "system_interface" params: interface: "port1" - name: Fetch urlfilter with name urlfilter4 fortinet.fortimanager.fmgr_fact: facts: selector: "webfilter_urlfilter" params: adom: "root" urlfilter: "" filter: - - "name" - "==" - "urlfilter4" fields: - "id" - "name" - "comment" # option: "object member" # "count", "object member" or "syntax" sortings: - "id": 1 "name": -1 - name: Retrieve device fortinet.fortimanager.fmgr_fact: facts: selector: "dvmdb_device" params: adom: "root" device: "" option: - "get meta" 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: .. raw:: html Status ------ - This module is not guaranteed to have a backwards compatible interface. Authors ------- - Xinwei Du (@dux-fortinet) - Xing Li (@lix-fortinet) - Jie Xue (@JieX19) - Link Zheng (@chillancezen) - Frank Shen (@fshen01) - Hongbin Lu (@fgtdev-hblu) .. hint:: If you notice any issues in this documentation, you can create a pull request to improve it.