drmofu.fortimanager.fmgr_dvm_cmd_import_devlist (2.2.2) — module

Import a list of ADOMs and devices.

| "added in version" 2.0.0 of drmofu.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 community

Install collection

Install with ansible-galaxy collection install drmofu.fortimanager:==2.2.2


Add to requirements.yml

  collections:
    - name: drmofu.fortimanager
      version: 2.2.2

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: fortimanager-inventory
   collections:
     - fortinet.fortimanager
   connection: httpapi
   vars:
      ansible_httpapi_use_ssl: True
      ansible_httpapi_validate_certs: False
      ansible_httpapi_port: 443
   tasks:
    - name: Import a list of ADOMs and devices.
      fmgr_dvm_cmd_import_devlist:
         bypass_validation: False
         workspace_locking_adom: <value in [global, custom adom including root]>
         workspace_locking_timeout: 300
         rc_succeeded: [0, -2, -3, ...]
         rc_failed: [-2, -3, ...]
         dvm_cmd_import_devlist:
            adom: <value of string>
            flags:
              - none
              - create_task
              - nonblocking
              - log_dev
            import-adom-members:
              -
                  adom: <value of string>
                  dev: <value of string>
                  vdom: <value of string>
            import-adoms:
              -
                  desc: <value of string>
                  flags:
                    - migration
                    - db_export
                    - no_vpn_console
                    - backup
                    - other_devices
                    - central_sdwan
                    - is_autosync
                    - per_device_wtp
                    - policy_check_on_install
                    - install_on_policy_check_fail
                    - auto_push_cfg
                    - per_device_fsw
                  log_db_retention_hours: <value of integer>
                  log_disk_quota: <value of integer>
                  log_disk_quota_alert_thres: <value of integer>
                  log_disk_quota_split_ratio: <value of integer>
                  log_file_retention_hours: <value of integer>
                  meta fields: <value of dict>
                  mig_mr: <value of integer>
                  mig_os_ver: <value in [unknown, 0.0, 1.0, ...]>
                  mode: <value in [ems, gms, provider]>
                  mr: <value of integer>
                  name: <value of string>
                  os_ver: <value in [unknown, 0.0, 1.0, ...]>
                  restricted_prds:
                    - fos
                    - foc
                    - fml
                    - fch
                    - fwb
                    - log
                    - fct
                    - faz
                    - fsa
                    - fsw
                    - fmg
                    - fdd
                    - fac
                    - fpx
                    - fna
                    - fdc
                    - ffw
                    - fsr
                    - fad
                    - fap
                    - fxt
                    - fts
                    - fai
                    - fwc
                  state: <value of integer>
                  uuid: <value of string>
                  create_time: <value of integer>
                  workspace_mode: <value of integer>
                  tz: <value of integer>
            import-devices:
              -
                  adm_pass: <value of string>
                  adm_usr: <value of string>
                  app_ver: <value of string>
                  av_ver: <value of string>
                  beta: <value of integer>
                  branch_pt: <value of integer>
                  build: <value of integer>
                  checksum: <value of string>
                  conf_status: <value in [unknown, insync, outofsync]>
                  conn_mode: <value in [active, passive]>
                  conn_status: <value in [UNKNOWN, up, down]>
                  db_status: <value in [unknown, nomod, mod]>
                  desc: <value of string>
                  dev_status: <value in [none, unknown, checkedin, ...]>
                  fap_cnt: <value of integer>
                  faz.full_act: <value of integer>
                  faz.perm: <value of integer>
                  faz.quota: <value of integer>
                  faz.used: <value of integer>
                  fex_cnt: <value of integer>
                  flags:
                    - has_hdd
                    - vdom_enabled
                    - discover
                    - reload
                    - interim_build
                    - offline_mode
                    - is_model
                    - fips_mode
                    - linked_to_model
                    - ip-conflict
                    - faz-autosync
                    - need_reset
                    - backup_mode
                    - azure_vwan_nva
                    - fgsp_configured
                    - cnf_mode
                    - sase_managed
                  foslic_cpu: <value of integer>
                  foslic_dr_site: <value in [disable, enable]>
                  foslic_inst_time: <value of integer>
                  foslic_last_sync: <value of integer>
                  foslic_ram: <value of integer>
                  foslic_type: <value in [temporary, trial, regular, ...]>
                  foslic_utm:
                    - fw
                    - av
                    - ips
                    - app
                    - url
                    - utm
                    - fwb
                  fsw_cnt: <value of integer>
                  ha_group_id: <value of integer>
                  ha_group_name: <value of string>
                  ha_mode: <value in [standalone, AP, AA, ...]>
                  ha_slave:
                    -
                        idx: <value of integer>
                        name: <value of string>
                        prio: <value of integer>
                        role: <value in [slave, master]>
                        sn: <value of string>
                        status: <value of integer>
                        conf_status: <value of integer>
                  hdisk_size: <value of integer>
                  hostname: <value of string>
                  hw_rev_major: <value of integer>
                  hw_rev_minor: <value of integer>
                  ip: <value of string>
                  ips_ext: <value of integer>
                  ips_ver: <value of string>
                  last_checked: <value of integer>
                  last_resync: <value of integer>
                  latitude: <value of string>
                  lic_flags: <value of integer>
                  lic_region: <value of string>
                  location_from: <value of string>
                  logdisk_size: <value of integer>
                  longitude: <value of string>
                  maxvdom: <value of integer>
                  meta fields: <value of dict>
                  mgmt_id: <value of integer>
                  mgmt_if: <value of string>
                  mgmt_mode: <value in [unreg, fmg, faz, ...]>
                  mgt_vdom: <value of string>
                  mr: <value of integer>
                  name: <value of string>
                  os_type: <value in [unknown, fos, fsw, ...]>
                  os_ver: <value in [unknown, 0.0, 1.0, ...]>
                  patch: <value of integer>
                  platform_str: <value of string>
                  psk: <value of string>
                  sn: <value of string>
                  vdom:
                    -
                        comments: <value of string>
                        name: <value of string>
                        opmode: <value in [nat, transparent]>
                        rtm_prof_id: <value of integer>
                        status: <value of string>
                        vpn_id: <value of integer>
                        meta fields: <value of dict>
                        vdom_type: <value in [traffic, admin]>
                  version: <value of integer>
                  vm_cpu: <value of integer>
                  vm_cpu_limit: <value of integer>
                  vm_lic_expire: <value of integer>
                  vm_mem: <value of integer>
                  vm_mem_limit: <value of integer>
                  vm_status: <value in [N/A, No License, Startup, ...]>
                  module_sn: <value of string>
                  prefer_img_ver: <value of string>
                  prio: <value of integer>
                  role: <value in [master, ha-slave, autoscale-slave]>
                  hyperscale: <value of integer>
                  nsxt_service_name: <value of string>
                  private_key: <value of string>
                  private_key_status: <value of integer>
                  vm_lic_overdue_since: <value of integer>
                  first_tunnel_up: <value of integer>
                  eip: <value of string>
                  mgmt_uuid: <value of string>
            import-group-members:
              -
                  adom: <value of string>
                  dev: <value of string>
                  grp: <value of string>
                  vdom: <value of string>

Inputs

    
rc_failed:
    description: The rc codes list with which the conditions to fail will be overriden.
    elements: int
    required: false
    type: list

enable_log:
    default: false
    description: Enable/Disable logging for task.
    required: false
    type: bool

access_token:
    description: The token to access FortiManager without using username and password.
    required: false
    type: str

rc_succeeded:
    description: The rc codes list with which the conditions to succeed will be overriden.
    elements: int
    required: false
    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.
    required: false
    type: bool

dvm_cmd_import_devlist:
    description: the top level parameters set
    required: false
    suboptions:
      adom:
        description: Name or ID of the ADOM where the command is to be executed on.
        type: str
      flags:
        choices:
        - none
        - create_task
        - nonblocking
        - log_dev
        description: description
        elements: str
        type: list
      import-adom-members:
        description: description
        elements: dict
        suboptions:
          adom:
            description: Target ADOM to associate device VDOM with.
            type: str
          dev:
            description: no description
            type: str
          vdom:
            description: no description
            type: str
        type: list
      import-adoms:
        description: description
        elements: dict
        suboptions:
          create_time:
            description: no description
            type: int
          desc:
            description: no description
            type: str
          flags:
            choices:
            - migration
            - db_export
            - no_vpn_console
            - backup
            - other_devices
            - central_sdwan
            - is_autosync
            - per_device_wtp
            - policy_check_on_install
            - install_on_policy_check_fail
            - auto_push_cfg
            - per_device_fsw
            description: description
            elements: str
            type: list
          log_db_retention_hours:
            description: no description
            type: int
          log_disk_quota:
            description: no description
            type: int
          log_disk_quota_alert_thres:
            description: no description
            type: int
          log_disk_quota_split_ratio:
            description: no description
            type: int
          log_file_retention_hours:
            description: no description
            type: int
          meta fields:
            description: no description
            type: dict
          mig_mr:
            description: no description
            type: int
          mig_os_ver:
            choices:
            - unknown
            - '0.0'
            - '1.0'
            - '2.0'
            - '3.0'
            - '4.0'
            - '5.0'
            - '6.0'
            - '7.0'
            - '8.0'
            - '9.0'
            description: no description
            type: str
          mode:
            choices:
            - ems
            - gms
            - provider
            description:
            - ems -
            - provider - Global database.
            type: str
          mr:
            description: no description
            type: int
          name:
            description: no description
            type: str
          os_ver:
            choices:
            - unknown
            - '0.0'
            - '1.0'
            - '2.0'
            - '3.0'
            - '4.0'
            - '5.0'
            - '6.0'
            - '7.0'
            - '8.0'
            - '9.0'
            description: no description
            type: str
          restricted_prds:
            choices:
            - fos
            - foc
            - fml
            - fch
            - fwb
            - log
            - fct
            - faz
            - fsa
            - fsw
            - fmg
            - fdd
            - fac
            - fpx
            - fna
            - fdc
            - ffw
            - fsr
            - fad
            - fap
            - fxt
            - fts
            - fai
            - fwc
            description: description
            elements: str
            type: list
          state:
            description: no description
            type: int
          tz:
            description: no description
            type: int
          uuid:
            description: no description
            type: str
          workspace_mode:
            description: no description
            type: int
        type: list
      import-devices:
        description: description
        elements: dict
        suboptions:
          adm_pass:
            description: description
            type: str
          adm_usr:
            description: no description
            type: str
          app_ver:
            description: no description
            type: str
          av_ver:
            description: no description
            type: str
          beta:
            description: no description
            type: int
          branch_pt:
            description: no description
            type: int
          build:
            description: no description
            type: int
          checksum:
            description: no description
            type: str
          conf_status:
            choices:
            - unknown
            - insync
            - outofsync
            description: no description
            type: str
          conn_mode:
            choices:
            - active
            - passive
            description: no description
            type: str
          conn_status:
            choices:
            - UNKNOWN
            - up
            - down
            description: no description
            type: str
          db_status:
            choices:
            - unknown
            - nomod
            - mod
            description: no description
            type: str
          desc:
            description: no description
            type: str
          dev_status:
            choices:
            - none
            - unknown
            - checkedin
            - inprogress
            - installed
            - aborted
            - sched
            - retry
            - canceled
            - pending
            - retrieved
            - changed_conf
            - sync_fail
            - timeout
            - rev_revert
            - auto_updated
            description: no description
            type: str
          eip:
            description: no description
            type: str
          fap_cnt:
            description: no description
            type: int
          faz.full_act:
            description: no description
            type: int
          faz.perm:
            description: no description
            type: int
          faz.quota:
            description: no description
            type: int
          faz.used:
            description: no description
            type: int
          fex_cnt:
            description: no description
            type: int
          first_tunnel_up:
            description: no description
            type: int
          flags:
            choices:
            - has_hdd
            - vdom_enabled
            - discover
            - reload
            - interim_build
            - offline_mode
            - is_model
            - fips_mode
            - linked_to_model
            - ip-conflict
            - faz-autosync
            - need_reset
            - backup_mode
            - azure_vwan_nva
            - fgsp_configured
            - cnf_mode
            - sase_managed
            description: description
            elements: str
            type: list
          foslic_cpu:
            description: VM Meter vCPU count.
            type: int
          foslic_dr_site:
            choices:
            - disable
            - enable
            description: VM Meter DR Site status.
            type: str
          foslic_inst_time:
            description: VM Meter first deployment time
            type: int
          foslic_last_sync:
            description: VM Meter last synchronized time
            type: int
          foslic_ram:
            description: VM Meter device RAM size
            type: int
          foslic_type:
            choices:
            - temporary
            - trial
            - regular
            - trial_expired
            description: VM Meter license type.
            type: str
          foslic_utm:
            choices:
            - fw
            - av
            - ips
            - app
            - url
            - utm
            - fwb
            description: description
            elements: str
            type: list
          fsw_cnt:
            description: no description
            type: int
          ha_group_id:
            description: no description
            type: int
          ha_group_name:
            description: no description
            type: str
          ha_mode:
            choices:
            - standalone
            - AP
            - AA
            - ELBC
            - DUAL
            - enabled
            - unknown
            - fmg-enabled
            - autoscale
            description: enabled - Value reserved for non-FOS HA devices.
            type: str
          ha_slave:
            description: description
            elements: dict
            suboptions:
              conf_status:
                description: no description
                type: int
              idx:
                description: no description
                type: int
              name:
                description: no description
                type: str
              prio:
                description: no description
                type: int
              role:
                choices:
                - slave
                - master
                description: no description
                type: str
              sn:
                description: no description
                type: str
              status:
                description: no description
                type: int
            type: list
          hdisk_size:
            description: no description
            type: int
          hostname:
            description: no description
            type: str
          hw_rev_major:
            description: no description
            type: int
          hw_rev_minor:
            description: no description
            type: int
          hyperscale:
            description: no description
            type: int
          ip:
            description: no description
            type: str
          ips_ext:
            description: no description
            type: int
          ips_ver:
            description: no description
            type: str
          last_checked:
            description: no description
            type: int
          last_resync:
            description: no description
            type: int
          latitude:
            description: no description
            type: str
          lic_flags:
            description: no description
            type: int
          lic_region:
            description: no description
            type: str
          location_from:
            description: no description
            type: str
          logdisk_size:
            description: no description
            type: int
          longitude:
            description: no description
            type: str
          maxvdom:
            description: no description
            type: int
          meta fields:
            description: no description
            type: dict
          mgmt_id:
            description: no description
            type: int
          mgmt_if:
            description: no description
            type: str
          mgmt_mode:
            choices:
            - unreg
            - fmg
            - faz
            - fmgfaz
            description: no description
            type: str
          mgmt_uuid:
            description: no description
            type: str
          mgt_vdom:
            description: no description
            type: str
          module_sn:
            description: no description
            type: str
          mr:
            description: no description
            type: int
          name:
            description: Unique name for the device.
            type: str
          nsxt_service_name:
            description: no description
            type: str
          os_type:
            choices:
            - unknown
            - fos
            - fsw
            - foc
            - fml
            - faz
            - fwb
            - fch
            - fct
            - log
            - fmg
            - fsa
            - fdd
            - fac
            - fpx
            - fna
            - fdc
            - ffw
            - fsr
            - fad
            - fap
            - fxt
            - fts
            - fai
            - fwc
            - fis
            - fed
            description: no description
            type: str
          os_ver:
            choices:
            - unknown
            - '0.0'
            - '1.0'
            - '2.0'
            - '3.0'
            - '4.0'
            - '5.0'
            - '6.0'
            - '7.0'
            - '8.0'
            - '9.0'
            description: no description
            type: str
          patch:
            description: no description
            type: int
          platform_str:
            description: no description
            type: str
          prefer_img_ver:
            description: no description
            type: str
          prio:
            description: no description
            type: int
          private_key:
            description: no description
            type: str
          private_key_status:
            description: no description
            type: int
          psk:
            description: no description
            type: str
          role:
            choices:
            - master
            - ha-slave
            - autoscale-slave
            description: no description
            type: str
          sn:
            description: Unique value for each device.
            type: str
          vdom:
            description: description
            elements: dict
            suboptions:
              comments:
                description: no description
                type: str
              meta fields:
                description: no description
                type: dict
              name:
                description: no description
                type: str
              opmode:
                choices:
                - nat
                - transparent
                description: no description
                type: str
              rtm_prof_id:
                description: no description
                type: int
              status:
                description: no description
                type: str
              vdom_type:
                choices:
                - traffic
                - admin
                description: no description
                type: str
              vpn_id:
                description: no description
                type: int
            type: list
          version:
            description: no description
            type: int
          vm_cpu:
            description: no description
            type: int
          vm_cpu_limit:
            description: no description
            type: int
          vm_lic_expire:
            description: no description
            type: int
          vm_lic_overdue_since:
            description: no description
            type: int
          vm_mem:
            description: no description
            type: int
          vm_mem_limit:
            description: no description
            type: int
          vm_status:
            description: no description
            type: int
        type: list
      import-group-members:
        description: description
        elements: dict
        suboptions:
          adom:
            description: ADOM where the device group is located.
            type: str
          dev:
            description: no description
            type: str
          grp:
            description: Target device group to associate device VDOM with.
            type: str
          vdom:
            description: no description
            type: str
        type: list
    type: dict

workspace_locking_adom:
    description: The adom to lock for FortiManager running in workspace mode, the value
      can be global and others including root.
    required: false
    type: str

forticloud_access_token:
    description: Authenticate Ansible client with forticloud API access token.
    required: false
    type: str

workspace_locking_timeout:
    default: 300
    description: The maximum time in seconds to wait for other user to release the workspace
      lock.
    required: false
    type: int

Outputs

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