fmgr_dvmdb_device – Device table, most attributes are read-only and can only be changed internally.¶

New in version 2.10.

Synopsis
Requirements
FortiManager Version Compatibility
Parameters
Notes
Examples
Return Values
Status
Authors

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 v6.0.0.

Requirements ¶

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

ansible>=2.9.0

FortiManager Version Compatibility ¶

	`6.0.0`	`6.2.1`	`6.2.3`	`6.2.5`	`6.4.0`	`6.4.2`	`6.4.5`	`7.0.0`
dvmdb_device	yes	yes	yes	yes	yes	yes	yes	yes

Parameters ¶

enable_log - Enable/Disable logging for task type: bool required: false default: False
proposed_method - The overridden method for the underlying Json RPC request type: str required: false choices: set, update, add
bypass_validation - Only set to True when module schema diffs with FortiManager API structure, module continues to execute without validating parameters type: bool required: false default: False
workspace_locking_adom - Acquire the workspace lock if FortiManager is running in workspace mode type: str required: false choices: global, custom adom including root
workspace_locking_timeout - The maximum time in seconds to wait for other users to release workspace lock type: integer required: false default: 300
rc_succeeded - The rc codes list with which the conditions to succeed will be overriden type: list required: false
rc_failed - The rc codes list with which the conditions to fail will be overriden type: list required: false
adom - The parameter in requested url type: str required: true
device - The parameter in requested url type: str required: true
dvmdb_device - Device table, most attributes are read-only and can only be changed internally. type: dict

adm_pass - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

adm_pass True True True True True True True True
adm_usr - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

adm_usr True True True True True True True True
app_ver - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

app_ver True True True True True True True True
av_ver - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

av_ver True True True True True True True True
beta - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

beta True True True True True True True True
branch_pt - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

branch_pt True True True True True True True True
build - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

build True True True True True True True True
checksum - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

checksum True True True True True True True True
conf_status - No description for the parameter type: str choices: [unknown, insync, outofsync] default: unknown more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

conf_status True True True True True True True True
conn_mode - No description for the parameter type: str choices: [active, passive] default: passive more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

conn_mode True True True True True True True True
conn_status - No description for the parameter type: str choices: [UNKNOWN, up, down] default: UNKNOWN more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

conn_status True True True True True True True True
db_status - No description for the parameter type: str choices: [unknown, nomod, mod] default: unknown more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

db_status True True True True True True True True
desc - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

desc True True True True True True True True
dev_status - No description for the parameter type: str choices: [none, unknown, checkedin, inprogress, installed, aborted, sched, retry, canceled, pending, retrieved, changed_conf, sync_fail, timeout, rev_revert, auto_updated] default: unknown more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

dev_status True True True True True True True True
fap_cnt - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

fap_cnt True True True True True True True True
faz.full_act - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

faz.full_act True True True True True True True True
faz.perm - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

faz.perm True True True True True True True True
faz.quota - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

faz.quota True True True True True True True True
faz.used - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

faz.used True True True True True True True True
fex_cnt - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

fex_cnt True True True True True True True True
flags - No description for the parameter type: array choices: [has_hdd, vdom_enabled, discover, reload, interim_build, offline_mode, is_model, fips_mode, linked_to_model, ip-conflict, faz-autosync] more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

flags True True True True True True True True
foslic_cpu - VM Meter vCPU count. type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

foslic_cpu True True True True True True True True
foslic_dr_site - VM Meter DR Site status. type: str choices: [disable, enable] default: disable more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

foslic_dr_site True True True True True True True True
foslic_inst_time - VM Meter first deployment time (in UNIX timestamp). type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

foslic_inst_time True True True True True True True True
foslic_last_sync - VM Meter last synchronized time (in UNIX timestamp). type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

foslic_last_sync True True True True True True True True
foslic_ram - VM Meter device RAM size (in MB). type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

foslic_ram True True True True True True True True
foslic_type - VM Meter license type. type: str choices: [temporary, trial, regular, trial_expired] default: temporary more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

foslic_type True True True True True True True True
foslic_utm - No description for the parameter type: array choices: [fw, av, ips, app, url, utm, fwb] more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

foslic_utm True True True True True True True True
fsw_cnt - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

fsw_cnt True True True True True True True True
ha_group_id - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

ha_group_id True True True True True True True True
ha_group_name - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

ha_group_name True True True True True True True True
ha_mode - enabled - Value reserved for non-FOS HA devices. type: str choices: [standalone, AP, AA, ELBC, DUAL, enabled, unknown, fmg-enabled, autoscale] default: standalone more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

ha_mode True True True True True True True True
hdisk_size - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

hdisk_size True True True True True True True True
hostname - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

hostname True True True True True True True True
hw_rev_major - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

hw_rev_major True True True True True True True True
hw_rev_minor - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

hw_rev_minor True True True True True True True True
ip - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

ip True True True True True True True True
ips_ext - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

ips_ext True True True True True True True True
ips_ver - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

ips_ver True True True True True True True True
last_checked - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

last_checked True True True True True True True True
last_resync - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

last_resync True True True True True True True True
latitude - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

latitude True True True True True True True True
lic_flags - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

lic_flags True True True True True True True True
lic_region - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

lic_region True True True True True True True True
location_from - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

location_from True True True True True True True True
logdisk_size - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

logdisk_size True True True True True True True True
longitude - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

longitude True True True True True True True True
maxvdom - No description for the parameter type: int default: 10 more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

maxvdom True True True True True True True True
meta fields - No description for the parameter type: dict more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

meta fields True True True True True True True True
mgmt_id - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

mgmt_id True True True True True True True True
mgmt_if - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

mgmt_if True True True True True True True True
mgmt_mode - No description for the parameter type: str choices: [unreg, fmg, faz, fmgfaz] default: unreg more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

mgmt_mode True True True True True True True True
mgt_vdom - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

mgt_vdom True True True True True True True True
mr - No description for the parameter type: int default: -1 more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

mr True True True True True True True True
name - Unique name for the device. type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

name True True True True True True True True
os_type - No description for the parameter type: str choices: [unknown, fos, fsw, foc, fml, faz, fwb, fch, fct, log, fmg, fsa, fdd, fac, fpx, fna, fdc, ffw, fsr, fad, fap, fxt] default: unknown more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

os_type True True True True True True True True
os_ver - No description for the parameter type: str choices: [unknown, 0.0, 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0] default: unknown more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

os_ver True True True True True True True True
patch - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

patch True True True True True True True True
platform_str - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

platform_str True True True True True True True True
psk - No description for the parameter type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

psk True True True True True True True True
sn - Unique value for each device. type: str more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

sn True True True True True True True True
vdom - No description for the parameter type: array more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

vdom True True True True True True True True
- comments - No description for the parameter type: str more...
  
  6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0
  
  comments True True True True True True True True
- name - No description for the parameter type: str more...
  
  6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0
  
  name True True True True True True True True
- opmode - No description for the parameter type: str choices: [nat, transparent] default: nat more...
  
  6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0
  
  opmode True True True True True True True True
- rtm_prof_id - No description for the parameter type: int more...
  
  6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0
  
  rtm_prof_id True True True True True True True True
- status - No description for the parameter type: str more...
  
  6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0
  
  status True True True True True True True True
- vpn_id - No description for the parameter type: int more...
  
  6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0
  
  vpn_id True True True True True True
- meta fields - No description for the parameter type: dict more...
  
  6.4.5 7.0.0
  
  meta fields True True
version - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

version True True True True True True True True
vm_cpu - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

vm_cpu True True True True True True True True
vm_cpu_limit - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

vm_cpu_limit True True True True True True True True
vm_lic_expire - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

vm_lic_expire True True True True True True True True
vm_mem - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

vm_mem True True True True True True True True
vm_mem_limit - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

vm_mem_limit True True True True True True True True
vm_status - No description for the parameter type: int more...

6.0.0 6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

vm_status True True True True True True True True
module_sn - No description for the parameter type: str more...

6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

module_sn True True True True True True True
prefer_img_ver - No description for the parameter type: str more...

6.2.1 6.2.3 6.2.5 6.4.0 6.4.2 6.4.5 7.0.0

prefer_img_ver True True True True True True True
prio - No description for the parameter type: int more...

6.4.2 6.4.5 7.0.0

prio True True True
role - No description for the parameter type: str choices: [master, ha-slave, autoscale-slave] default: master more...

6.4.2 6.4.5 7.0.0

role True True True
hyperscale - No description for the parameter type: int more...

6.4.5 7.0.0

hyperscale True True
nsxt_service_name - No description for the parameter type: str more...

6.4.5 7.0.0

nsxt_service_name True True
private_key - No description for the parameter type: str more...

6.4.5 7.0.0

private_key True True
private_key_status - No description for the parameter type: int more...

6.4.5 7.0.0

private_key_status True True

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.
To create or update an object, use state: present directive.
To delete an object, use state: absent directive
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 ¶

- 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: Device table, most attributes are read-only and can only be changed internally.
     fmgr_dvmdb_device:
        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, ...]
        adom: <your own value>
        device: <your own value>
        dvmdb_device:
           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
           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, ...]>
           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>
           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 of integer>
           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>

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:

request_url - The full url requested returned: always type: str sample: /sys/login/user
response_code - The status of api request returned: always type: int sample: 0
response_message - The descriptive message of the api response returned: always type: str sample: OK
response_data - The data body of the api response returned: optional type: list or dict

Status ¶

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

Authors ¶

Link Zheng (@chillancezen)
Jie Xue (@JieX19)
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.