fortinet / fortinet.fortimanager / 2.4.0 / module / fmgr_securityconsole_install_package Copy and install a policy package to devices. | "added in version" 1.0.0 of fortinet.fortimanager" Authors: Xinwei Du (@dux-fortinet), Xing Li (@lix-fortinet), Jie Xue (@JieX19), Link Zheng (@chillancezen), Frank Shen (@fshen01), Hongbin Lu (@fgtdev-hblu) preview | supported by communityfortinet.fortimanager.fmgr_securityconsole_install_package (2.4.0) — module
Install with ansible-galaxy collection install fortinet.fortimanager:==2.4.0
collections: - name: fortinet.fortimanager version: 2.4.0
This module is able to configure a FortiManager device.
Examples include all parameters and values which need to be adjusted to data sources before usage.
- name: Example playbook hosts: fortimanagers connection: httpapi vars: ansible_httpapi_use_ssl: true ansible_httpapi_validate_certs: false ansible_httpapi_port: 443 tasks: - name: Copy and install a policy package to devices. fortinet.fortimanager.fmgr_securityconsole_install_package: bypass_validation: false securityconsole_install_package: adom: ansible adom_rev_comments: ansible-comment adom_rev_name: ansible-test dev_rev_comments: ansible-comment flags: - none - cp_all_objs - preview - generate_rev - copy_assigned_pkg - unassign - ifpolicy_only - no_ifpolicy - objs_only - auto_lock_ws - check_pkg_st - copy_only pkg: ansible scope: - name: Ansible-test vdom: root
- name: INSTALL PREVIEW - POLICY PACKAGE hosts: fmg connection: httpapi vars: adom: demo ppkg: ppkg_hubs device: fgt_00_1 tasks: - name: Install for policy package [preview mode] {{ ppkg }} fortinet.fortimanager.fmgr_securityconsole_install_package: securityconsole_install_package: adom: "{{ adom }}" flags: - preview pkg: "{{ ppkg }}" scope: - name: "{{ device }}" vdom: root register: r - name: Poll the task fortinet.fortimanager.fmgr_fact: facts: selector: "task_task" params: task: "{{ r.meta.response_data.task }}" register: taskinfo until: taskinfo.meta.response_data.percent == 100 retries: 30 delay: 5 - name: Trigger the preview report generation for policy package {{ ppkg }} fortinet.fortimanager.fmgr_securityconsole_install_preview: securityconsole_install_preview: adom: "{{ adom }}" device: "{{ device }}" flags: - json vdoms: root register: r - name: Poll the task fortinet.fortimanager.fmgr_fact: facts: selector: "task_task" params: task: "{{ r.meta.response_data.task }}" register: taskinfo until: taskinfo.meta.response_data.percent == 100 retries: 30 delay: 5 - name: Get the preview report for policy package {{ ppkg }} fortinet.fortimanager.fmgr_securityconsole_preview_result: securityconsole_preview_result: adom: "{{ adom }}" device: "{{ device }}" register: r - name: Cancel install task for policy package {{ ppkg }} fortinet.fortimanager.fmgr_securityconsole_package_cancel_install: securityconsole_package_cancel_install: adom: "{{ adom }}" - name: Show preview report ansible.builtin.debug: msg: "{{ r }}"
rc_failed: description: The rc codes list with which the conditions to fail will be overriden. elements: int type: list enable_log: default: false description: Enable/Disable logging for task. type: bool access_token: description: The token to access FortiManager without using username and password. type: str rc_succeeded: description: The rc codes list with which the conditions to succeed will be overriden. elements: int type: list bypass_validation: default: false description: Only set to True when module schema diffs with FortiManager API structure, module continues to execute without validating parameters. type: bool workspace_locking_adom: description: The adom to lock for FortiManager running in workspace mode, the value can be global and others including root. type: str forticloud_access_token: description: Authenticate Ansible client with forticloud API access token. type: str workspace_locking_timeout: default: 300 description: The maximum time in seconds to wait for other user to release the workspace lock. type: int securityconsole_install_package: description: The top level parameters set. required: false suboptions: adom: description: Source ADOM name. type: str adom_rev_comments: description: If generate_rev flag is set, the comment for the new ADOM revision. type: str adom_rev_name: description: If generate_rev flag is set, the name for the new ADOM revision. type: str dev_rev_comments: description: Comments for the device configuration revision that will be generated during install. type: str flags: choices: - none - cp_all_objs - preview - generate_rev - copy_assigned_pkg - unassign - ifpolicy_only - no_ifpolicy - objs_only - auto_lock_ws - check_pkg_st - copy_only description: No description. elements: str type: list pkg: description: Source package path and name. type: str scope: description: No description. elements: dict suboptions: name: description: No description. type: str vdom: description: No description. type: str type: list type: dict
meta: contains: request_url: description: The full url requested. returned: always sample: /sys/login/user type: str response_code: description: The status of api request. returned: always sample: 0 type: int response_data: description: The api response. returned: always type: list response_message: description: The descriptive message of the api response. returned: always sample: OK. type: str system_information: description: The information of the target system. returned: always type: dict description: The result of the request. returned: always type: dict rc: description: The status the request. returned: always sample: 0 type: int version_check_warning: description: Warning if the parameters used in the playbook are not supported by the current FortiManager version. returned: complex type: list