:source: fortios_system_standalone_cluster.py
:orphan:
.. fortios_system_standalone_cluster:
fortios_system_standalone_cluster -- Configure FortiGate Session Life Support Protocol (FGSP) cluster attributes in Fortinet's FortiOS and FortiGate.
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
.. versionadded:: 2.0.0
.. contents::
:local:
:depth: 1
Synopsis
--------
- This module is able to configure a FortiGate or FortiOS (FOS) device by allowing the user to set and modify system feature and standalone_cluster category. Examples include all parameters and values need to be adjusted to datasources before usage. Tested with FOS v6.0.0
Requirements
------------
The below requirements are needed on the host that executes this module.
- ansible>=2.16
Tips
----
Using member operation to add an element to an existing object.
FortiOS Version Compatibility
-----------------------------
Supported Version Ranges: v6.4.0 -> v7.6.6
Parameters
----------
.. raw:: html
- access_token - Token-based authentication. Generated from GUI of Fortigate. type: str required: false
- enable_log - Enable/Disable logging for task. type: bool required: false default: False
- vdom - 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 default: root
- member_path - Member attribute path to operate on. type: str
- member_state - Add or delete a member under specified attribute path. type: str choices: present, absent
- system_standalone_cluster - Configure FortiGate Session Life Support Protocol (FGSP) cluster attributes. type: dict
more...
| Supported Version Ranges |
| system_standalone_cluster |
v6.4.0 -> 7.6.6 |
- asymmetric_traffic_control - Asymmetric traffic control mode. type: str choices: cps-preferred, strict-anti-replay
more...
|
Supported Version Ranges |
| asymmetric_traffic_control |
v7.4.2 -> 7.6.6 |
| [cps-preferred] |
v7.4.2 -> 7.6.6 |
| [strict-anti-replay] |
v7.4.2 -> 7.6.6 |
- cluster_peer - Configure FortiGate Session Life Support Protocol (FGSP) session synchronization. type: list member_path: cluster_peer:sync_id
more...
| Supported Version Ranges |
| cluster_peer |
v7.2.1 -> 7.6.6 |
- down_intfs_before_sess_sync - List of interfaces to be turned down before session synchronization is complete. type: list member_path: cluster_peer:sync_id/down_intfs_before_sess_sync:name
more...
| Supported Version Ranges |
| down_intfs_before_sess_sync |
v7.2.1 -> 7.6.6 |
- name - Interface name. Source system.interface.name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v7.2.1 -> 7.6.6 |
- hb_interval - Heartbeat interval (1 - 20 (100*ms). Increase to reduce false positives. type: int
more...
|
Supported Version Ranges |
| hb_interval |
v7.2.1 -> 7.6.6 |
- hb_lost_threshold - Lost heartbeat threshold (1 - 60). Increase to reduce false positives. type: int
more...
|
Supported Version Ranges |
| hb_lost_threshold |
v7.2.1 -> 7.6.6 |
- ipsec_tunnel_sync - Enable/disable IPsec tunnel synchronization. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| ipsec_tunnel_sync |
v7.2.1 -> 7.6.6 |
| [enable] |
v7.2.1 -> 7.6.6 |
| [disable] |
v7.2.1 -> 7.6.6 |
- peerip - IP address of the interface on the peer unit that is used for the session synchronization link. type: str
more...
|
Supported Version Ranges |
| peerip |
v7.2.1 -> 7.6.6 |
- peervd - VDOM that contains the session synchronization link interface on the peer unit. Usually both peers would have the same peervd. Source system.vdom.name. type: str
more...
|
Supported Version Ranges |
| peervd |
v7.2.1 -> 7.6.6 |
- secondary_add_ipsec_routes - Enable/disable IKE route announcement on the backup unit. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| secondary_add_ipsec_routes |
v7.2.1 -> 7.6.6 |
| [enable] |
v7.2.1 -> 7.6.6 |
| [disable] |
v7.2.1 -> 7.6.6 |
- session_sync_filter - Add one or more filters if you only want to synchronize some sessions. Use the filter to configure the types of sessions to synchronize. type: dict
more...
| Supported Version Ranges |
| session_sync_filter |
v7.2.1 -> 7.6.6 |
- custom_service - Only sessions using these custom services are synchronized. Use source and destination port ranges to define these custom services. type: list member_path: cluster_peer:sync_id/session_sync_filter/custom_service:id
more...
| Supported Version Ranges |
| custom_service |
v7.2.1 -> 7.6.6 |
- dst_port_range - Custom service destination port range. type: str
more...
|
Supported Version Ranges |
| dst_port_range |
v7.2.1 -> 7.6.6 |
- id - Custom service ID. see Notes. type: int required: true
more...
|
Supported Version Ranges |
| id |
v7.2.1 -> 7.6.6 |
- src_port_range - Custom service source port range. type: str
more...
|
Supported Version Ranges |
| src_port_range |
v7.2.1 -> 7.6.6 |
- dstaddr - Only sessions to this IPv4 address are synchronized. type: str
more...
|
Supported Version Ranges |
| dstaddr |
v7.2.1 -> 7.6.6 |
- dstaddr6 - Only sessions to this IPv6 address are synchronized. type: str
more...
|
Supported Version Ranges |
| dstaddr6 |
v7.2.1 -> 7.6.6 |
- dstintf - Only sessions to this interface are synchronized. Source system.interface.name. type: str
more...
|
Supported Version Ranges |
| dstintf |
v7.2.1 -> 7.6.6 |
- srcaddr - Only sessions from this IPv4 address are synchronized. type: str
more...
|
Supported Version Ranges |
| srcaddr |
v7.2.1 -> 7.6.6 |
- srcaddr6 - Only sessions from this IPv6 address are synchronized. type: str
more...
|
Supported Version Ranges |
| srcaddr6 |
v7.2.1 -> 7.6.6 |
- srcintf - Only sessions from this interface are synchronized. Source system.interface.name. type: str
more...
|
Supported Version Ranges |
| srcintf |
v7.2.1 -> 7.6.6 |
- sync_id - Sync ID. see Notes. type: int required: true
more...
|
Supported Version Ranges |
| sync_id |
v7.2.1 -> 7.6.6 |
- syncvd - Sessions from these VDOMs are synchronized using this session synchronization configuration. type: list member_path: cluster_peer:sync_id/syncvd:name
more...
| Supported Version Ranges |
| syncvd |
v7.2.1 -> 7.6.6 |
- name - VDOM name. Source system.vdom.name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v7.2.1 -> 7.6.6 |
- encryption - Enable/disable encryption when synchronizing sessions. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| encryption |
v6.4.0 -> 7.6.6 |
| [enable] |
v6.4.0 -> 7.6.6 |
| [disable] |
v6.4.0 -> 7.6.6 |
- group_member_id - Cluster member ID (0 - 15). type: int
more...
|
Supported Version Ranges |
| group_member_id |
v6.4.0 -> 7.6.6 |
- helper_traffic_bounce - Enable/disable helper related traffic bounce. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| helper_traffic_bounce |
v7.6.4 -> 7.6.6 |
| [enable] |
v7.6.4 -> 7.6.6 |
| [disable] |
v7.6.4 -> 7.6.6 |
- layer2_connection - Indicate whether layer 2 connections are present among FGSP members. type: str choices: available, unavailable
more...
|
Supported Version Ranges |
| layer2_connection |
v6.4.0 -> 7.6.6 |
| [available] |
v6.4.0 -> 7.6.6 |
| [unavailable] |
v6.4.0 -> 7.6.6 |
- monitor_interface - Configure a list of interfaces on which to monitor itself. Monitoring is performed on the status of the interface. type: list member_path: monitor_interface:name
more...
| Supported Version Ranges |
| monitor_interface |
v7.6.0 -> 7.6.6 |
- name - Interface name. Source system.interface.name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v7.6.0 -> 7.6.6 |
- monitor_prefix - Configure a list of routing prefixes to monitor. type: list member_path: monitor_prefix:id
more...
| Supported Version Ranges |
| monitor_prefix |
v7.6.1 -> 7.6.6 |
- id - ID. see Notes. type: int required: true
more...
|
Supported Version Ranges |
| id |
v7.6.1 -> 7.6.6 |
- prefix - Prefix. type: str
more...
|
Supported Version Ranges |
| prefix |
v7.6.1 -> 7.6.6 |
- vdom - VDOM name. Source system.vdom.name. type: str
more...
|
Supported Version Ranges |
| vdom |
v7.6.1 -> 7.6.6 |
- vrf - VRF ID. type: int
more...
|
Supported Version Ranges |
| vrf |
v7.6.1 -> 7.6.6 |
- pingsvr_monitor_interface - List of pingsvr monitor interface to check for remote IP monitoring. type: list member_path: pingsvr_monitor_interface:name
more...
| Supported Version Ranges |
| pingsvr_monitor_interface |
v7.6.0 -> 7.6.6 |
- name - Interface name. Source system.interface.name. type: str required: true
more...
|
Supported Version Ranges |
| name |
v7.6.0 -> 7.6.6 |
- psksecret - Pre-shared secret for session synchronization (ASCII string or hexadecimal encoded with a leading 0x). type: str
more...
|
Supported Version Ranges |
| psksecret |
v6.4.0 -> 7.6.6 |
- session_sync_dev - Offload session-sync process to kernel and sync sessions using connected interface(s) directly. Source system.interface.name. type: list
- standalone_group_id - Cluster group ID (0 - 255). Must be the same for all members. type: int
more...
|
Supported Version Ranges |
| standalone_group_id |
v6.4.0 -> 7.6.6 |
- utm_traffic_bounce - Enable/disable UTM related traffic bounce. type: str choices: enable, disable
more...
|
Supported Version Ranges |
| utm_traffic_bounce |
v7.6.4 -> 7.6.6 |
| [enable] |
v7.6.4 -> 7.6.6 |
| [disable] |
v7.6.4 -> 7.6.6 |
Notes
-----
.. note::
- Legacy fortiosapi has been deprecated, httpapi is the preferred way to run playbooks
- The module supports check_mode.
Examples
--------
.. code-block:: yaml+jinja
- name: Configure FortiGate Session Life Support Protocol (FGSP) cluster attributes.
fortinet.fortios.fortios_system_standalone_cluster:
vdom: "{{ vdom }}"
system_standalone_cluster:
asymmetric_traffic_control: "cps-preferred"
cluster_peer:
-
down_intfs_before_sess_sync:
-
name: "default_name_6 (source system.interface.name)"
hb_interval: "2"
hb_lost_threshold: "10"
ipsec_tunnel_sync: "enable"
peerip: ""
peervd: " (source system.vdom.name)"
secondary_add_ipsec_routes: "enable"
session_sync_filter:
custom_service:
-
dst_port_range: ""
id: "16"
src_port_range: ""
dstaddr: ""
dstaddr6: ""
dstintf: " (source system.interface.name)"
srcaddr: ""
srcaddr6: ""
srcintf: " (source system.interface.name)"
sync_id: ""
syncvd:
-
name: "default_name_26 (source system.vdom.name)"
encryption: "enable"
group_member_id: "0"
helper_traffic_bounce: "enable"
layer2_connection: "available"
monitor_interface:
-
name: "default_name_32 (source system.interface.name)"
monitor_prefix:
-
id: "34"
prefix: ""
vdom: " (source system.vdom.name)"
vrf: "0"
pingsvr_monitor_interface:
-
name: "default_name_39 (source system.interface.name)"
psksecret: ""
session_sync_dev: " (source system.interface.name)"
standalone_group_id: "0"
utm_traffic_bounce: "enable"
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:
.. raw:: html
- build - Build number of the fortigate image returned: always type: str sample: 1547
- http_method - Last method used to provision the content into FortiGate returned: always type: str sample: PUT
- http_status - Last result given by FortiGate on last operation applied returned: always type: str sample: 200
- mkey - Master key (id) used in the last call to FortiGate returned: success type: str sample: id
- name - Name of the table used to fulfill the request returned: always type: str sample: urlfilter
- path - Path of the table used to fulfill the request returned: always type: str sample: webfilter
- revision - Internal revision number returned: always type: str sample: 17.0.2.10658
- serial - Serial number of the unit returned: always type: str sample: FGVMEVYYQT3AB5352
- status - Indication of the operation's result returned: always type: str sample: success
- vdom - Virtual domain used returned: always type: str sample: root
- version - Version of the FortiGate returned: always type: str sample: v5.6.3
Status
------
- This module is not guaranteed to have a backwards compatible interface.
Authors
-------
- Link Zheng (@chillancezen)
- Jie Xue (@JieX19)
- Hongbin Lu (@fgtdev-hblu)
- Frank Shen (@frankshen01)
- Miguel Angel Munoz (@mamunozgonzalez)
- Nicolas Thomas (@thomnico)
.. hint::
If you notice any issues in this documentation, you can create a pull request to improve it.