new release 7.0.0 with new maestro modules

Author: chkp-majds

CHANGELOG.rst

@@ -3,14 +3,15 @@ Check_Point.gaia Release Notes
 ==============================
 
 .. contents:: Topics
-    
+
+
 v7.0.0
 ======
 
 Release Summary
 ---------------
 
-This is release 6.0.0 of ``check_point.gaia``, released on 2025-01-28.
+This is release 7.0.0 of ``check_point.gaia``, released on 2025-02-07.
 
 New Modules
 -----------

check_point-gaia-7.0.0.tar.gz

@@ -0,0 +1,79 @@
+.. _cp_gaia_maestro_changes_module:
+
+
+cp_gaia_maestro_changes -- Handle pending changes, either apply or delete them.
+===============================================================================
+
+.. contents::
+   :local:
+   :depth: 1
+
+
+Synopsis
+--------
+
+Handle pending changes, either apply or delete them.
+
+
+
+Requirements
+------------
+The below requirements are needed on the host that executes this module.
+
+- supported starting from gaia\_api \>= 1.8
+
+
+
+Parameters
+----------
+
+  version (False, str, None)
+    Gaia API version for example 1.6.
+
+
+  state (False, str, present)
+    Ansible state which can be :literal:`present` or :literal:`absent`. absent will delete the pending changes, present will apply them
+
+
+  virtual_system_id (False, int, None)
+    Virtual System ID.
+
+
+
+
+
+Notes
+-----
+
+.. note::
+   - Supports :literal:`check\_mode`.
+
+
+
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+    
+    - name: Delete pending changes
+      check_point.gaia.cp_gaia_user:
+        state: absent
+
+
+
+
+
+Status
+------
+
+
+
+
+
+Authors
+~~~~~~~
+
+- Roi Tal (@chkp-roital)
+

docs/cp_gaia_maestro_changes.rst

@@ -0,0 +1,97 @@
+.. _cp_gaia_maestro_gateways_module:
+
+
+cp_gaia_maestro_gateways -- Modify Security Group Members.
+==========================================================
+
+.. contents::
+   :local:
+   :depth: 1
+
+
+Synopsis
+--------
+
+Assign, re-assign or un-assign Gateways to Security Groups, and change GW descriptions.
+
+
+
+Requirements
+------------
+The below requirements are needed on the host that executes this module.
+
+- supported starting from gaia\_api \>= 1.8
+
+
+
+Parameters
+----------
+
+  version (False, str, None)
+    Gaia API version for example 1.6.
+
+
+  id (True, str, None)
+    The serial of the Gateway you wish to modify
+
+
+  security_group (False, int, None)
+    Choose ID of Security Group to assign this Gateway to
+
+
+  description (False, str, None)
+    Description of this Gateway
+
+
+  virtual_system_id (False, int, None)
+    Virtual System ID.
+
+
+
+
+
+Notes
+-----
+
+.. note::
+   - Supports :literal:`check\_mode`.
+
+
+
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+    
+    - name: Assign GW to SG and add description
+      check_point.gaia.cp_gaia_gateways:
+        id: 1007RT1992
+        security_group: 1
+        description: "1007RT1992 GW Description"
+
+
+
+Return Values
+-------------
+
+maestro_gateway (always., dict, )
+  The updated Maestro Gateway details.
+
+
+
+
+
+Status
+------
+
+
+
+
+
+Authors
+~~~~~~~
+
+- Roi Tal (@chkp-roital)
+

docs/cp_gaia_maestro_gateways.rst

@@ -0,0 +1,149 @@
+.. _cp_gaia_maestro_gateways_facts_module:
+
+
+cp_gaia_maestro_gateways_facts -- Show Gateway/s.
+=================================================
+
+.. contents::
+   :local:
+   :depth: 1
+
+
+Synopsis
+--------
+
+Show information regarding Maestro Gateways, either assigned to Security Groups or unassigned.
+
+
+
+
+
+
+Parameters
+----------
+
+  version (False, str, None)
+    Gaia API version for example 1.6.
+
+
+  id (False, str, None)
+    ID (serial number) of Maestro Gateway to show. If not specified, all gateways information is returned.
+
+
+  include_pending_changes (False, bool, None)
+    If true, show pending topology. If false, show deployed topology
+
+
+  virtual_system_id (False, int, None)
+    Virtual System ID.
+
+
+
+
+
+Notes
+-----
+
+.. note::
+   - Supports :literal:`check\_mode`.
+
+
+
+
+Examples
+--------
+
+.. code-block:: yaml+jinja
+
+    
+    - name: Show Maestro Gateways
+      check_point.gaia.cp_gaia_gateways_facts:
+
+    - name: Show Maestro Gateway by specifying it's ID
+      check_point.gaia.cp_gaia_gateways_facts:
+        id: 1007RT1992
+
+
+
+Return Values
+-------------
+
+ansible_facts (always., dict, )
+  The Maestro Gateway/s facts.
+
+
+  gateways (always, list, )
+    List of Maestro Gateways.
+
+
+    id (always, str, )
+      Maestro Gateway ID.
+
+
+    site (always, int, )
+      Site this Gateway belongs to.
+
+
+    security_group (always, int, )
+      The Security Group this Gateway belongs to.
+
+
+    member_id (always, int, )
+      The member ID of this Gateway, if it's assigned to a Security Group.
+
+
+    model (always, str, )
+      Model of this Gateway.
+
+
+    version (always, dict, )
+      OS version installed on this Gateway.
+
+
+      major (always, str, )
+        Major version
+
+
+
+    downlink_ports (always, list, )
+      The Orchestrator ports which are connected to the Gateway.
+
+
+      orchestrator_id (always, str, )
+        ID of the Orchestrator to which this port belongs
+
+
+      port (always, str, )
+        Port ID
+
+
+
+    description (always, str, )
+      Description of this Gateway.
+
+
+    state (always, str, )
+      State of this Gateway.
+
+
+    weight (always, int, )
+      Weight assigned to this Gateway, in case it's assigned to a Security Group.
+
+
+
+
+
+
+
+Status
+------
+
+
+
+
+
+Authors
+~~~~~~~
+
+- Roi Tal (@chkp-roital)
+