lix_fortinet / lix_fortinet.fortios / 102.2.120 / module / fortios_system_ddns Configure DDNS in Fortinet's FortiOS and FortiGate. | "added in version" 2.0.0 of lix_fortinet.fortios" Authors: Link Zheng (@chillancezen), Jie Xue (@JieX19), Hongbin Lu (@fgtdev-hblu), Frank Shen (@frankshen01), Miguel Angel Munoz (@mamunozgonzalez), Nicolas Thomas (@thomnico) preview | supported by communitylix_fortinet.fortios.fortios_system_ddns (102.2.120) — module
Install with ansible-galaxy collection install lix_fortinet.fortios:==102.2.120
collections: - name: lix_fortinet.fortios version: 102.2.120
This module is able to configure a FortiGate or FortiOS (FOS) device by allowing the user to set and modify system feature and ddns category. Examples include all parameters and values need to be adjusted to datasources before usage. Tested with FOS v6.0.0
- hosts: fortigates collections: - fortinet.fortios connection: httpapi vars: vdom: "root" ansible_httpapi_use_ssl: yes ansible_httpapi_validate_certs: no ansible_httpapi_port: 443 tasks: - name: Configure DDNS. fortios_system_ddns: vdom: "{{ vdom }}" state: "present" access_token: "<your_own_value>" system_ddns: addr_type: "ipv4" bound_ip: "<your_own_value>" clear_text: "disable" ddns_auth: "disable" ddns_domain: "<your_own_value>" ddns_key: "<your_own_value>" ddns_keyname: "<your_own_value>" ddns_password: "<your_own_value>" ddns_server: "dyndns.org" ddns_server_addr: - addr: "<your_own_value>" ddns_server_ip: "<your_own_value>" ddns_sn: "<your_own_value>" ddns_ttl: "300" ddns_username: "<your_own_value>" ddns_zone: "<your_own_value>" ddnsid: "0" monitor_interface: - interface_name: "<your_own_value> (source system.interface.name)" server_type: "ipv4" ssl_certificate: "<your_own_value> (source certificate.local.name)" update_interval: "300" use_public_ip: "disable"
vdom: default: root description: - Virtual domain, among those defined previously. A vdom is a virtual instance of the FortiGate that can be configured and used as a different unit. type: str state: choices: - present - absent description: - Indicates whether to create or remove the object. required: true type: str enable_log: default: false description: - Enable/Disable logging for task. required: false type: bool member_path: description: - Member attribute path to operate on. - Delimited by a slash character if there are more than one attribute. - Parameter marked with member_path is legitimate for doing member operation. type: str system_ddns: default: null description: - Configure DDNS. suboptions: addr_type: choices: - ipv4 - ipv6 description: - Address type of interface address in DDNS update. type: str bound_ip: description: - Bound IP address. type: str clear_text: choices: - disable - enable description: - Enable/disable use of clear text connections. type: str ddns_auth: choices: - disable - tsig description: - Enable/disable TSIG authentication for your DDNS server. type: str ddns_domain: description: - Your fully qualified domain name. For example, yourname.ddns.com. type: str ddns_key: description: - DDNS update key (base 64 encoding). type: str ddns_keyname: description: - DDNS update key name. type: str ddns_password: description: - DDNS password. type: str ddns_server: choices: - dyndns.org - dyns.net - tzo.com - vavic.com - dipdns.net - now.net.cn - dhs.org - easydns.com - genericDDNS - FortiGuardDDNS - noip.com description: - Select a DDNS service provider. type: str ddns_server_addr: description: - Generic DDNS server IP/FQDN list. elements: dict suboptions: addr: description: - IP address or FQDN of the server. type: str type: list ddns_server_ip: description: - Generic DDNS server IP. type: str ddns_sn: description: - DDNS Serial Number. type: str ddns_ttl: description: - Time-to-live for DDNS packets. type: int ddns_username: description: - DDNS user name. type: str ddns_zone: description: - Zone of your domain name (for example, DDNS.com). type: str ddnsid: description: - DDNS ID. required: true type: int monitor_interface: description: - Monitored interface. elements: dict suboptions: interface_name: description: - Interface name. Source system.interface.name. type: str type: list server_type: choices: - ipv4 - ipv6 description: - Address type of the DDNS server. type: str ssl_certificate: description: - Name of local certificate for SSL connections. Source certificate.local.name. type: str update_interval: description: - DDNS update interval (60 - 2592000 sec, 0 means default). type: int use_public_ip: choices: - disable - enable description: - Enable/disable use of public IP address. type: str type: dict access_token: description: - Token-based authentication. Generated from GUI of Fortigate. required: false type: str member_state: choices: - present - absent description: - Add or delete a member under specified attribute path. - When member_state is specified, the state option is ignored. type: str
build: description: Build number of the fortigate image returned: always sample: '1547' type: str http_method: description: Last method used to provision the content into FortiGate returned: always sample: PUT type: str http_status: description: Last result given by FortiGate on last operation applied returned: always sample: '200' type: str mkey: description: Master key (id) used in the last call to FortiGate returned: success sample: id type: str name: description: Name of the table used to fulfill the request returned: always sample: urlfilter type: str path: description: Path of the table used to fulfill the request returned: always sample: webfilter type: str revision: description: Internal revision number returned: always sample: 17.0.2.10658 type: str serial: description: Serial number of the unit returned: always sample: FGVMEVYYQT3AB5352 type: str status: description: Indication of the operation's result returned: always sample: success type: str vdom: description: Virtual domain used returned: always sample: root type: str version: description: Version of the FortiGate returned: always sample: v5.6.3 type: str