fortinet.fortimanager.fmgr_dvmdb_device – Device table, most attributes are read-only and can only be changed internally.
Note
This plugin is part of the fortinet.fortimanager collection (version 2.1.3).
You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.
To install it, use: ansible-galaxy collection install fortinet.fortimanager.
To use it in a playbook, specify: fortinet.fortimanager.fmgr_dvmdb_device.
New in version 2.10: of fortinet.fortimanager
Synopsis
- 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.
Parameters
| Parameter | Choices/Defaults | Comments | ||
|---|---|---|---|---|
| adom
string / required
|
the parameter (adom) in requested url
|
|||
| bypass_validation
boolean
|
|
only set to True when module schema diffs with FortiManager API structure, module continues to execute without validating parameters
|
||
| device
string / required
|
the parameter (device) in requested url
|
|||
| dvmdb_device
dictionary
|
the top level parameters set
|
|||
| adm_pass
string
|
no description
|
|||
| adm_usr
string
|
no description
|
|||
| app_ver
string
|
no description
|
|||
| av_ver
string
|
no description
|
|||
| beta
integer
|
no description
|
|||
| branch_pt
integer
|
no description
|
|||
| build
integer
|
no description
|
|||
| checksum
string
|
no description
|
|||
| conf_status
string
|
|
no description
|
||
| conn_mode
string
|
|
no description
|
||
| conn_status
string
|
|
no description
|
||
| db_status
string
|
|
no description
|
||
| desc
string
|
no description
|
|||
| dev_status
string
|
|
no description
|
||
| fap_cnt
integer
|
no description
|
|||
| faz.full_act
integer
|
no description
|
|||
| faz.perm
integer
|
no description
|
|||
| faz.quota
integer
|
no description
|
|||
| faz.used
integer
|
no description
|
|||
| fex_cnt
integer
|
no description
|
|||
| flags
list / elements=string
|
|
no description
|
||
| foslic_cpu
integer
|
VM Meter vCPU count.
|
|||
| foslic_dr_site
string
|
|
VM Meter DR Site status.
|
||
| foslic_inst_time
integer
|
VM Meter first deployment time (in UNIX timestamp).
|
|||
| foslic_last_sync
integer
|
VM Meter last synchronized time (in UNIX timestamp).
|
|||
| foslic_ram
integer
|
VM Meter device RAM size (in MB).
|
|||
| foslic_type
string
|
|
VM Meter license type.
|
||
| foslic_utm
list / elements=string
|
|
no description
|
||
| fsw_cnt
integer
|
no description
|
|||
| ha_group_id
integer
|
no description
|
|||
| ha_group_name
string
|
no description
|
|||
| ha_mode
string
|
|
enabled - Value reserved for non-FOS HA devices.
|
||
| hdisk_size
integer
|
no description
|
|||
| hostname
string
|
no description
|
|||
| hw_rev_major
integer
|
no description
|
|||
| hw_rev_minor
integer
|
no description
|
|||
| hyperscale
integer
|
no description
|
|||
| ip
string
|
no description
|
|||
| ips_ext
integer
|
no description
|
|||
| ips_ver
string
|
no description
|
|||
| last_checked
integer
|
no description
|
|||
| last_resync
integer
|
no description
|
|||
| latitude
string
|
no description
|
|||
| lic_flags
integer
|
no description
|
|||
| lic_region
string
|
no description
|
|||
| location_from
string
|
no description
|
|||
| logdisk_size
integer
|
no description
|
|||
| longitude
string
|
no description
|
|||
| maxvdom
integer
|
Default:
10
|
no description
|
||
| meta fields
dictionary
|
no description
|
|||
| mgmt_id
integer
|
no description
|
|||
| mgmt_if
string
|
no description
|
|||
| mgmt_mode
string
|
|
no description
|
||
| mgt_vdom
string
|
no description
|
|||
| module_sn
string
|
no description
|
|||
| mr
integer
|
Default:
-1
|
no description
|
||
| name
string
|
Unique name for the device.
|
|||
| nsxt_service_name
string
|
no description
|
|||
| os_type
string
|
|
no description
|
||
| os_ver
string
|
|
no description
|
||
| patch
integer
|
no description
|
|||
| platform_str
string
|
no description
|
|||
| prefer_img_ver
string
|
no description
|
|||
| prio
integer
|
no description
|
|||
| private_key
string
|
no description
|
|||
| private_key_status
integer
|
no description
|
|||
| psk
string
|
no description
|
|||
| role
string
|
|
no description
|
||
| sn
string
|
Unique value for each device.
|
|||
| vdom
list / elements=string
|
no description
|
|||
| comments
string
|
no description
|
|||
| meta fields
dictionary
|
no description
|
|||
| name
string
|
no description
|
|||
| opmode
string
|
|
no description
|
||
| rtm_prof_id
integer
|
no description
|
|||
| status
string
|
no description
|
|||
| vpn_id
integer
|
no description
|
|||
| version
integer
|
no description
|
|||
| vm_cpu
integer
|
no description
|
|||
| vm_cpu_limit
integer
|
no description
|
|||
| vm_lic_expire
integer
|
no description
|
|||
| vm_mem
integer
|
no description
|
|||
| vm_mem_limit
integer
|
no description
|
|||
| vm_status
integer
|
no description
|
|||
| enable_log
boolean
|
|
Enable/Disable logging for task
|
||
| proposed_method
string
|
|
The overridden method for the underlying Json RPC request
|
||
| rc_failed
list / elements=string
|
the rc codes list with which the conditions to fail will be overriden
|
|||
| rc_succeeded
list / elements=string
|
the rc codes list with which the conditions to succeed will be overriden
|
|||
| state
string / required
|
|
the directive to create, update or delete an object
|
||
| workspace_locking_adom
string
|
the adom to lock for FortiManager running in workspace mode, the value can be global and others including root
|
|||
| workspace_locking_timeout
integer
|
Default:
300
|
the maximum time in seconds to wait for other user to release the workspace lock
|
||
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 here, the following are the fields unique to this module:
| Key | Returned | Description |
|---|---|---|
| request_url
string
|
always |
The full url requested
Sample:
/sys/login/user
|
| response_code
integer
|
always |
The status of api request
|
| response_message
string
|
always |
The descriptive message of the api response
Sample:
OK.
|
Authors
- Link Zheng (@chillancezen)
- Jie Xue (@JieX19)
- Frank Shen (@fshen01)
- Hongbin Lu (@fgtdev-hblu)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/fortinet/fortimanager/fmgr_dvmdb_device_module.html