:source: fmgd_router_multicast.py :orphan: .. _fmgd_router_multicast: fmgd_router_multicast -- Configure router multicast. ++++++++++++++++++++++++++++++++++++++++++++++++++++ .. versionadded:: 1.0.0 .. contents:: :local: :depth: 1 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 v7.x. Requirements ------------ The below requirements are needed on the host that executes this module. - ansible-core>=2.16.0 FortiManager Version Compatibility ---------------------------------- .. raw:: html

Supported Version Ranges: v7.2.6 -> v7.2.12, v7.4.3 -> latest

Parameters ---------- .. raw:: html 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 -------- .. code-block:: yaml+jinja - name: Example playbook (generated based on argument schema) hosts: fortimanagers connection: httpapi gather_facts: false vars: ansible_httpapi_use_ssl: true ansible_httpapi_validate_certs: false ansible_httpapi_port: 443 tasks: - name: Configure router multicast. fortinet.fmgdevice.fmgd_router_multicast: # bypass_validation: false # workspace_locking_adom: # workspace_locking_timeout: 300 # rc_succeeded: [0, -2, -3, ...] # rc_failed: [-2, -3, ...] device: vdom: router_multicast: # interface: # - bfd: # cisco_exclude_genid: # dr_priority: # hello_holdtime: # hello_interval: # igmp: # access_group: # immediate_leave_group: # last_member_query_count: # last_member_query_interval: # query_interval: # query_max_response_time: # query_timeout: # router_alert_check: # version: # join_group: # - address: # multicast_flow: # name: # neighbour_filter: # passive: # pim_mode: # propagation_delay: # rp_candidate: # rp_candidate_group: # rp_candidate_interval: # rp_candidate_priority: # rpf_nbr_fail_back: # rpf_nbr_fail_back_filter: # state_refresh_interval: # static_group: # ttl_threshold: # multicast_routing: # pim_sm_global: # accept_register_list: # accept_source_list: # bsr_allow_quick_refresh: # bsr_candidate: # bsr_hash: # bsr_interface: # bsr_priority: # cisco_crp_prefix: # cisco_ignore_rp_set_priority: # cisco_register_checksum: # cisco_register_checksum_group: # join_prune_holdtime: # message_interval: # null_register_retries: # pim_use_sdwan: # register_rate_limit: # register_rp_reachability: # register_source: # register_source_interface: # register_source_ip: # register_supression: # rp_address: # - group: # id: # ip_address: # rp_register_keepalive: # spt_threshold: # spt_threshold_group: # ssm: # ssm_range: # route_limit: # route_threshold: # pim_sm_global_vrf: # - bsr_allow_quick_refresh: # bsr_candidate: # bsr_hash: # bsr_interface: # bsr_priority: # cisco_crp_prefix: # rp_address: # - group: # id: # ip_address: # vrf: 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
  • meta - The result of the request.returned: always type: dict
    • 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_data - The data body of the api response. returned: optional type: list or dict
    • response_message - The descriptive message of the api response. returned: always type: str sample: OK
    • system_information - The information of the target system. returned: always type: dict
  • rc - The status the request. returned: always type: int sample: 0
  • version_check_warning - Warning if the parameters used in the playbook are not supported by the current FortiManager version. returned: if at least one parameter not supported by the current FortiManager version type: list
Status ------ - This module is not guaranteed to have a backwards compatible interface. Authors ------- - Xinwei Du (@dux-fortinet) - Xing Li (@lix-fortinet) - Jie Xue (@JieX19) - Link Zheng (@chillancezen) - Frank Shen (@fshen01) - Hongbin Lu (@fgtdev-hblu)