ancestor: null
releases:
  2.0.0:
    changes:
      breaking_changes:
        - Generic FortiOS Module - FOS module to issue generic request with Ansible.
        - Support for FOS Monitor API - several modules are new for monitor API.
        - Unified Collection - The fortios collection itself will be adapting any FOS
          platforms.
      bugfixes:
        - Deprecated second-layer state module parameter
        - enable_log - Explicit logging option.
      known_issues:
        - Modules for monitor API are not versioned yet.
      major_changes:
        - New module fortios_configuration_fact
        - New module fortios_json_generic
        - New module fortios_monitor
        - New module fortios_monitor_fact
      release_summary: The major breaking release of FOS 2.x collections.
      removed_features:
        - Removed module fortios_facts
        - Removed module fortios_registration_forticare
        - Removed module fortios_registration_vdom
        - Removed module fortios_system_config_backup_restore
        - Removed module fortios_system_vmlicense
    fragments:
      - overall.yml
    release_date: "2021-04-05"
  2.0.1:
    changes:
      minor_changes:
        - fixed pylint testing errors.
    fragments:
      - 2.0.1.yml
    release_date: "2021-04-07"
  2.0.2:
    changes:
      bugfixes:
        - Fix the authorization fails at log in with username and password in FOS7.0.
        - Github Issue 103
        - Github Issue 105
      major_changes:
        - Improve ``fortios_configuration_fact`` to use multiple selectors concurrently.
        - Support ``check_mode`` in all cofigurationAPI-based modules.
        - Support filtering for fact gathering modules ``fortios_configuration_fact``
          and ``fortios_monitor_fact``.
        - Support moving policy in ``firewall_central_snat_map``.
        - Unify schemas for monitor API.
      release_summary: patch release of 2.0.2
    fragments:
      - release_2.0.2.yml
    release_date: "2021-05-14"
  2.1.0:
    changes:
      bugfixes:
        - Disable check_mode feature from all global objects of configuration modules
          due to 'state' issue.
        - Fix a bug in IP_PREFIX.match().
        - Fix the issue that the ``server_type`` is not updated in ``fortios_system_central_management``.
        - Fix the unexpected warning caused by optinal params in ``fortios_monitor_fact``
          and ``fortios_monitor``.
      major_changes:
        - New module fortios_monitor_fact.
        - Support Fortios 7.0.
        - Support Log APIs.
      release_summary: minor release of 2.1.0
    fragments:
      - release_2.1.0.yml
    release_date: "2021-06-25"
  2.1.1:
    changes:
      bugfixes:
        - Fix the KeyError caused by non-required multi-value attributes in an object.
      release_summary: patch release of 2.1.1
    fragments:
      - 2.1.1_release.yml
    release_date: "2021-06-29"
  2.1.2:
    changes:
      bugfixes:
        - Fix a regression bug caused by non-required attributes.
        - Fix an intentional exception for listed options.
      release_summary: patch release of 2.1.2
    fragments:
      - 2.1.2_release.yml
    release_date: "2021-07-15"
  2.1.3:
    changes:
      bugfixes:
        - Fix Github issue
        - Fix the corner cases that response does not have status in it.
        - Fix the filters error when fetching multiple facts with selectors for a configuration
          module (Github issue
      major_changes:
        - Add real-world use cases in the example section for some configuration modules.
        - Collect the current configurations of the modules and convert them into playbooks.
        - Support FortiOS 7.0.1.
        - Support member operation (delete/add extra members) on an object that has
          a list of members in it.
        - Support selectors feature in ``fortios_monitor_fact`` and ``fortios_log_fact``.
      release_summary: patch release of 2.1.3
    fragments:
      - 2.1.3_release.yml
    release_date: "2021-11-11"
  2.1.4:
    release_date: "2022-02-04"
  2.1.5:
    changes:
      bugfixes:
        - Fix issues in version mismatch logic.
        - Fix status issue in fortios_json_generic().
        - Fix the issue of inconsistent data types in different schemas.
      major_changes:
        - Support FortiOS 7.0.2, 7.0.3, 7.0.4, 7.0.5.
      release_summary: patch release of 2.1.5
    fragments:
      - 2.1.5_release.yml
    release_date: "2022-04-22"
  2.1.6:
    changes:
      bugfixes:
        - Add defaut value for enable_log param.
        - Fix import issues in sanity-test and improve unit tests.
        - Fix parameter-list-no-elements error in sanity-test.
        - Fix syntax issue in python2.7.
        - Fix the syntax error in the three wireless_controller_hotspot20 modules.
        - Relicense the FortiOS Collection under GPLv3+.
        - Update the logic in check_legacy_fortiosapi.
        - Use collection version number in the doc.
      release_summary: patch release of 2.1.6
    fragments:
      - 2.1.6_release.yml
    release_date: "2022-05-20"
  2.1.7:
    changes:
      bugfixes:
        - Fix the Github Issue 187.
        - Fix the Github Issue 188 and 189.
        - Fix the Github Issue 190.
        - Fix the Github Issue 191.
        - Fix the error message in the debugging log when using ``access_token``.
        - Fix the issue when filtering out parameter with space in the module ``fortios_configuration_fact``.
        - Fix typo in the documentation of ``Install FortiOS Galaxy Collection``.
      major_changes:
        - Support Diff feature in check_mode.
        - Support Fortios 7.2.0.
      release_summary: patch release of 2.1.7
    fragments:
      - 2.1.7_release.yml
    release_date: "2022-08-12"
  2.2.0:
    changes:
      bugfixes:
        - Fix issue of filter content could not contain spaces (#208);
        - Fix issue of missing some options for monitor modules (#196);
        - Fix list type not match issue;
      major_changes:
        - Support FortiOS v7.0.6, v7.0.7, v7.0.8, v7.2.1, v7.2.2.
      release_summary: patch release of 2.2.0
    fragments:
      - 2.2.0_release.yml
    release_date: "2022-11-09"
  2.2.1:
    changes:
      bugfixes:
        - Fix invalid arguments in version_schemas;
        - Fix list type arguments inconsistency;
        - Fix supports_check_mode issue for _info and _facts modules;
      release_summary: patch release of 2.2.1
    fragments:
      - 2.2.1_release.yml
    release_date: "2022-12-02"
  2.2.2:
    changes:
      bugfixes:
        - Add required field for module log_fact;
        - Fix runtime issue (#214);
        - Fix sanity test errors in validate-modules test;
      release_summary: patch release of 2.2.2
    fragments:
      - 2.2.2_release.yml
    release_date: "2022-12-08"
  2.2.3:
    changes:
      bugfixes:
        - Fix the issue that all the params with underscore cannot be set under member
          operation;
        - Fix the login issue (#232);
        - Fix the output path issue (#227);
      major_changes:
        - Add annotations of member operation for every module.
        - Update ``fortios.py`` for higher performance;
        - supports temporary session key and pre/post login banner;
        - update the examples on how to use member operation in Q&A.
      release_summary: patch release of 2.2.3
    fragments:
      - 2.2.3_release.yml
    release_date: "2023-03-17"
  2.3.0:
    changes:
      bugfixes:
        - Fix the error of pure number password.
      major_changes:
        - Improve the `no_log` feature in some modules;
        - Improve the documentation and example for `seq_num` in `fortios_router_static`;
        - Improve the documentation for `member_path` in all the modules;
        - Support new FOS versions.
      release_summary: patch release of 2.3.0
    fragments:
      - 2.3.0_release.yml
    release_date: "2023-05-19"
  2.3.1:
    changes:
      bugfixes:
        - Fix the issue while comparing the changes in before and after data in check_mode;
        - Fix the issues that some parameters are not in a specific fos vm versions.
        - Fix the request error when updating global object;
        - Fix the sanity test error;
        - Fix the wrong credential error when using username/password in fos verion
          6;
      major_changes:
        - Add readthedocs.yaml file.
        - Update Q&A regarding setting up FortiToken multi-factor authentication;
      release_summary: patch release of 2.3.1
    fragments:
      - 2.3.1_release.yml
    release_date: "2023-08-04"
  2.3.2:
    changes:
      bugfixes:
        - Fix the hyperlink issue for the supported FOS versions in USER's GUIDE.
      major_changes:
        - Improve the document for adding notes and examples in Q&A for modules using
          Integer number as the mkey.
      release_summary: patch release of 2.3.2
    fragments:
      - 2.3.2_release.yml
    release_date: "2023-08-30"
  2.3.3:
    changes:
      bugfixes:
        - Fix the issue of one session remaining open after the task is finished.
        - To optimize the json_generic module and reduce the time spent while sending
          GET requests.
      major_changes:
        - Add new fortios version 7.4.1.
        - Update Ansible version from 2.9 to 2.14.
        - Update Q&A with a resolution for Ansible Always Sending GET/PUT Requests as
          POST Requests.
        - Update the requirement.txt file to specify the sphinx_rtd_theme==1.3.0
      release_summary: patch release of 2.3.3
    fragments:
      - 2.3.3_release.yml
    release_date: "2023-11-01"
  2.3.4:
    changes:
      major_changes:
        - Format the contents in the changelog.yml file.
        - update the required Ansible version to 2.14.0 in the runtime.yml file.
      release_summary: patch release of 2.3.4
    fragments:
      - 2.3.4_release.yml
    release_date: "2023-11-02"
  2.3.5:
    changes:
      bugfixes:
        - Github issue
        - Github issue
        - Github issue
      major_changes:
        - Update all the boolean values to true/false in the documents and examples.
        - Update the document of log_fact.
        - Update the mismatched version message with version ranges.
        - Update the required ansible version to 2.14.
        - Update the supported version ranges instead of concrete version numbers to
          reduce the collection size.
      release_summary: patch release of 2.3.5
    fragments:
      - 2.3.5_release.yml
    release_date: "2024-02-06"
  2.3.6:
    changes:
      bugfixes:
        - Fix the issue that ssl-certificate cannot be set in `fortios_firewall_vip`
          and `fortios_firewall_vip6`.
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - mantis issue
      major_changes:
        - Add notes for backup modules in the documentation in both monitor and monitor_fact
          modules.
        - Supported new FOS versions 7.4.2 and 7.4.3, and support data type mac_address
          in the collection.
        - Update the documentation for the supported versions from latest to a fix version
          number.
        - Update the required ansible version to 2.15.
      release_summary: patch release of 2.3.6
    fragments:
      - 2.3.6_relase.yml
    release_date: "2024-04-03"
  2.3.7:
    changes:
      bugfixes:
        - Fix some issues in sanity test.
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - Github issue
        - mantis issue
        - mantis issue
        - mantis issue
      major_changes:
        - Add a sanity_test.yaml file to trigger CI tests in GitHub.
        - Support Ansible-core 2.17.
        - Support new FOS versions 7.4.4.
      release_summary: patch release of 2.3.7
    fragments:
      - release_2.3.7.yml
    release_date: "2024-07-10"
  2.3.8:
    changes:
      bugfixes:
        - Fix the issue using diff feature in check_mode.
        - Github
        - Github
        - Github
        - Mantis
        - Mantis
        - Mantis
        - Mantis
        - Mantis
        - Mantis
        - Mantis
        - Return invalid json content instead of error while adding redundant comma
          at the end of the last variable in `fortios_json_generic`.
      major_changes:
        - Improve the logic for SET function to send GET request first then PUT or POST
        - Mantis
        - Remove Tokens from URLs for Improved Security
        - Support new FOS versions 7.6.0.
      release_summary: patch release of 2.3.8
    fragments:
      - 2.3.8_release.yml
    release_date: "2024-10-11"
  2.3.9:
    changes:
      bugfixes:
        - Fix errors in Ansible sanity test with Ansible-core 2.18
        - Github
        - Github
        - Github
        - Github
      major_changes:
        - Support check_mode on all the configuration modules.
      release_summary: patch release of 2.3.9
    fragments:
      - release_2.3.9.yml
    release_date: "2024-12-17"
  2.4.0:
    changes:
      bugfixes:
        - Github Issue
        - Github Issue
        - Github Issue
        - Github Issue
        - Github Issue
        - Github Issue
        - Github Issue
        - Mantis Issue
      major_changes:
        - Supported new versions 7.6.1 and 7.6.2.
        - Updated the examples with correct values that have minimum or maximum values.
      release_summary: minor release of 2.4.0
    fragments:
      - 2.4.0_release.yml
    release_date: "2025-04-14"
