chillancezen.fortimanager.fmgr_firewall_address (2.1.6) — module

no description

| "added in version" 1.0.0 of chillancezen.fortimanager"

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

preview | supported by community

Install collection

Install with ansible-galaxy collection install chillancezen.fortimanager:==2.1.6


Add to requirements.yml

  collections:
    - name: chillancezen.fortimanager
      version: 2.1.6

Description

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.

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
 - hosts: fortimanager00
   collections:
     - fortinet.fortimanager
   connection: httpapi
   vars:
      ansible_httpapi_use_ssl: True
      ansible_httpapi_validate_certs: False
      ansible_httpapi_port: 443
   tasks:
    - name: Configure IPv4 addresses.
      fmgr_firewall_address:
         bypass_validation: False
         adom: ansible
         state: present
         firewall_address:
            allow-routing: disable
            associated-interface: any
            name: 'ansible-test1'
            visibility: disable
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
 - hosts: fortimanager00
   collections:
     - fortinet.fortimanager
   connection: httpapi
   vars:
      ansible_httpapi_use_ssl: True
      ansible_httpapi_validate_certs: False
      ansible_httpapi_port: 443
   tasks:

    - name: Configure IPv4 addresses.
      fmgr_firewall_address:
         bypass_validation: False
         adom: root
         state: present
         firewall_address:
            allow-routing: disable
            associated-interface: any
            name: 'address-orignal'
            visibility: enable
    - name: rename the firewall addressobject
      fmgr_rename:
         rename:
             selector: 'firewall_address'
             self:
              adom: 'root'
              address: 'address-orignal'
             target:
              name: 'address-new'

    - name: delete renamed object
      fmgr_firewall_address:
         adom: 'root'
         state: absent
         firewall_address:
             name: 'address-new'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.

 - hosts: fortimanager00
   collections:
     - fortinet.fortimanager
   connection: httpapi
   vars:
      ansible_httpapi_use_ssl: True
      ansible_httpapi_validate_certs: False
      ansible_httpapi_port: 443
   tasks:
    - name: create IPv4 addresses.
      fmgr_firewall_address:
         adom: root
         state: present
         firewall_address:
            allow-routing: disable
            associated-interface: any
            name: 'fooaddress'
            visibility: disable
      register: info
      failed_when: info.rc != 0
    - name: create IPv4 addresses.
      fmgr_firewall_address:
         adom: root
         state: present
         firewall_address:
            allow-routing: disable
            associated-interface: any
            name: 'fooaddress'
            visibility: disable
      register: info
      failed_when: info.message != 'Object update skipped!'
    - name: delete created address
      fmgr_firewall_address:
         adom: root
         state: absent
         firewall_address:
             name: 'fooaddress'
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
 - name: gathering fortimanager facts
   hosts: fortimanager00
   gather_facts: no
   connection: httpapi
   collections:
     - fortinet.fortimanager
   vars:
     ansible_httpapi_use_ssl: True
     ansible_httpapi_validate_certs: False
     ansible_httpapi_port: 443
   tasks:
    - name: retrieve all the IPv4 addresses
      fmgr_fact:
        facts:
            selector: 'firewall_address'
            params:
                adom: 'ansible'
                address: 'your_value'

Outputs

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_message:
  description: The descriptive message of the api response
  returned: always
  sample: OK.
  type: str