zscaler-sdk-python 0.9.7__tar.gz → 0.10.1__tar.gz

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zscaler-sdk-python
-Version: 0.9.7
+Version: 0.10.1
 Summary: Official Python SDK for the Zscaler Products (Beta)
 Home-page: https://github.com/zscaler/zscaler-sdk-python
 License: MIT
@@ -22,7 +22,7 @@ Classifier: Topic :: Security
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Provides-Extra: dev
 Requires-Dist: aenum ; extra == "dev"
-Requires-Dist: aiohttp (>=3.10.2)
+Requires-Dist: aiohttp (>=3.11.11)
 Requires-Dist: arrow
 Requires-Dist: black (>=24.3.0) ; extra == "dev"
 Requires-Dist: certifi (>=2024.2.2)
@@ -34,16 +34,16 @@ Requires-Dist: idna (>=3.10)
 Requires-Dist: okta (>=2.9.7)
 Requires-Dist: pycryptodomex (>=3.20.0)
 Requires-Dist: pydash (>=8.0.3) ; extra == "dev"
-Requires-Dist: python-box (>=7.2.0)
+Requires-Dist: python-box (>=7.3.0)
 Requires-Dist: python-dateutil
 Requires-Dist: pytz (>=2024.2)
 Requires-Dist: pyyaml
 Requires-Dist: requests (>=2.32.3)
 Requires-Dist: responses (>=0.25.3)
 Requires-Dist: restfly (>=1.5.0)
-Requires-Dist: six
+Requires-Dist: six (>=1.17.0)
 Requires-Dist: xmltodict (>=0.14.2)
-Requires-Dist: yarl (>=1.14.0)
+Requires-Dist: yarl (>=1.17.0)
 Project-URL: Bug Tracker, https://github.com/zscaler/zscaler-sdk-python/issues
 Project-URL: Documentation, https://zscaler-sdk-python.readthedocs.io
 Project-URL: Repository, https://github.com/zscaler/zscaler-sdk-python

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "zscaler-sdk-python"
-version = "0.9.7"
+version = "0.10.1"
 description = "Official Python SDK for the Zscaler Products (Beta)"
 authors = ["Zscaler, Inc. <devrel@zscaler.com>"]
 license = "MIT"
@@ -33,16 +33,16 @@ arrow = "*"
 certifi = ">=2024.2.2"
 charset-normalizer = "*"
 idna = ">=3.10"
-python-box = ">=7.2.0"
+python-box = ">=7.3.0"
 python-dateutil = "*"
 requests = ">=2.32.3"
 responses = ">=0.25.3"
 restfly = ">=1.5.0"
-six = "*"
+six = ">=1.17.0"
 flatdict = "*"
 pyyaml = "*"
 xmltodict = ">=0.14.2"
-yarl = ">=1.14.0"
+yarl = ">=1.17.0"
 pycryptodomex = ">=3.20.0"
 aenum = "*"
 pydash = ">=8.0.3"
@@ -51,7 +51,7 @@ pytz = ">=2024.2"
 black = ">=24.3.0"
 cryptography = ">=43.0.0"
 okta = ">=2.9.7"
-aiohttp = ">=3.10.2"
+aiohttp = ">=3.11.11"
 
 [tool.poetry.dev-dependencies]
 black = ">=24.3.0"
@@ -62,7 +62,7 @@ pytest-recording = "^0.13.2"
 pytest-cov = "*"
 pyfakefs = ">=5.6.0"
 isort = "*"
-wheel = "*"
+wheel = ">=0.45.1"
 sphinx = "^7.4.7"
 sphinx-autobuild = "*"
 sphinx_rtd_theme = "*"

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/__init__.py

@@ -29,7 +29,7 @@ __license__ = "MIT"
 __contributors__ = [
     "William Guilherme",
 ]
-__version__ = "0.9.7"
+__version__ = "0.10.1"
 
 from zscaler.zdx import ZDXClientHelper  # noqa
 from zscaler.zia import ZIAClientHelper  # noqa

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/zia/__init__.py

@@ -39,6 +39,7 @@ from zscaler.zia.forwarding_control import ForwardingControlAPI
 from zscaler.zia.cloudappcontrol import CloudAppControlAPI
 from zscaler.zia.isolation_profile import IsolationProfileAPI
 from zscaler.zia.labels import RuleLabelsAPI
+from zscaler.zia.pac_files import PacFilesAPI
 from zscaler.zia.locations import LocationsAPI
 from zscaler.zia.sandbox import CloudSandboxAPI
 from zscaler.zia.security import SecurityPolicyAPI
@@ -406,9 +407,13 @@ class ZIAClientHelper(ZIAClient):
         page=None,
         pagesize=None,
         search=None,
-        max_page_size=1000,  # Default to 1000, can be adjusted based on endpoint constraints
         max_items=None,  # Maximum number of items to retrieve across pages
         max_pages=None,  # Maximum number of pages to retrieve
+        type=None,  # Specify type of VPN credentials (CN, IP, UFQDN, XAUTH)
+        include_only_without_location=None,  # Include only VPN credentials not associated with any location
+        location_id=None,  # VPN credentials for a specific location ID
+        managed_by=None,  # VPN credentials managed by a given partner
+        prefix=None,  # VPN credentials managed by a given partner
     ):
         """
         Fetches paginated data from the API based on specified parameters and handles pagination.
@@ -421,6 +426,11 @@ class ZIAClientHelper(ZIAClient):
             search (str): Search query to filter the results.
             max_items (int): Maximum number of items to retrieve.
             max_pages (int): Maximum number of pages to fetch.
+            type (str, optional): Type of VPN credentials (e.g., CN, IP, UFQDN, XAUTH).
+            include_only_without_location (bool, optional): Filter to include only VPN credentials not associated with a location.
+            location_id (int, optional): Retrieve VPN credentials for the specified location ID.
+            managed_by (int, optional): Retrieve VPN credentials managed by the specified partner.
+            prefix (int, optional): Retrieve VPN credentials managed by the specified partner.
 
         Returns:
             tuple: A tuple containing:
@@ -435,16 +445,32 @@ class ZIAClientHelper(ZIAClient):
         }
 
         # Initialize pagination parameters
+        # params = {
+        #     "page": page if page is not None else 1,  # Start at page 1 if not specified
+        #     "pagesize": min(pagesize if pagesize is not None else 100, max_page_size),  # Apply max_page_size limit
+        # }
+
         params = {
             "page": page if page is not None else 1,  # Start at page 1 if not specified
-            "pagesize": min(pagesize if pagesize is not None else 100, max_page_size)  # Apply max_page_size limit
+            "pagesize": max(100, min(pagesize or 100, 10000)),  # Ensure pagesize is within API limits
         }
-
+        
+        # Add optional filters to the params if provided
         if search:
             params["search"] = search
+        if type:
+            params["type"] = type
+        if include_only_without_location is not None:
+            params["includeOnlyWithoutLocation"] = include_only_without_location
+        if location_id:
+            params["locationId"] = location_id
+        if managed_by:
+            params["managedBy"] = managed_by
+        if prefix:
+            params["prefix"] = prefix
 
         ret_data = []
-        total_collected = 0  # Track total items collected
+        total_collected = 0
 
         try:
             while True:
@@ -482,13 +508,14 @@ class ZIAClientHelper(ZIAClient):
 
                 # Limit data collection based on max_items
                 if max_items is not None:
-                    data = data[:max_items - total_collected]  # Limit items on the current page
+                    data = data[: max_items - total_collected]  # Limit items on the current page
                 ret_data.extend(data)
                 total_collected += len(data)
 
                 # Check if we've reached max_items or max_pages limits
-                if (max_items is not None and total_collected >= max_items) or \
-                   (max_pages is not None and params["page"] >= max_pages):
+                if (max_items is not None and total_collected >= max_items) or (
+                    max_pages is not None and params["page"] >= max_pages
+                ):
                     break
 
                 # Stop if we've processed all available pages (i.e., less than requested page size)
@@ -508,7 +535,6 @@ class ZIAClientHelper(ZIAClient):
 
         return BoxList(ret_data), None
 
-
     @property
     def admin_and_role_management(self):
         """
@@ -597,7 +623,7 @@ class ZIAClientHelper(ZIAClient):
 
         """
         return CloudSandboxAPI(self)
-
+    
     @property
     def security(self):
         """
@@ -693,3 +719,11 @@ class ZIAClientHelper(ZIAClient):
 
         """
         return WorkloadGroupsAPI(self)
+
+    @property
+    def pac_files(self):
+        """
+        The interface object for the :ref:`ZIA Pac Files interface <zia-pac_files>`.
+
+        """
+        return PacFilesAPI(self)

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/zia/labels.py

@@ -18,7 +18,7 @@
 from box import Box, BoxList
 from requests import Response
 
-from zscaler.utils import Iterator, convert_keys, snake_to_camel
+from zscaler.utils import convert_keys, snake_to_camel
 from zscaler.zia import ZIAClient
 
 

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/zia/locations.py

@@ -18,7 +18,7 @@
 from box import Box, BoxList
 from requests import Response
 
-from zscaler.utils import Iterator, snake_to_camel
+from zscaler.utils import snake_to_camel
 from zscaler.zia import ZIAClient
 
 
@@ -188,7 +188,7 @@ class LocationsAPI:
                 Additional notes or information regarding the location or sub-location. The description cannot
                 exceed 1024 characters.
             static_location_groups (list): IDs for static location groups.
-            
+
         Returns:
             :obj:`Box`: The newly created location resource record
 
@@ -258,14 +258,8 @@ class LocationsAPI:
             ...    pprint(sub_location)
 
         """
-        return BoxList(
-            Iterator(
-                self.rest,
-                f"locations/{location_id}/sublocations",
-                max_pages=1,
-                **kwargs,
-            )
-        )
+        list, _ = self.rest.get_paginated_data(path=f"/locations/{location_id}/sublocations", **kwargs)
+        return list
 
     def list_locations_lite(self, **kwargs) -> BoxList:
         """
@@ -305,7 +299,8 @@ class LocationsAPI:
             ...    print(location)
 
         """
-        return BoxList(Iterator(self.rest, "locations/lite", **kwargs))
+        list, _ = self.rest.get_paginated_data(path="/locations/lite", **kwargs)
+        return list
 
     def update_location(self, location_id: str, **kwargs) -> Box:
         """
@@ -504,14 +499,8 @@ class LocationsAPI:
             Get a list of all configured location groups:
             >>> location = zia.locations.list_location_groups()
         """
-        return BoxList(
-        Iterator(
-            self.rest,
-            f"locations/groups",
-            max_pages=1,
-            **kwargs,
-        )
-    )
+        list, _ = self.rest.get_paginated_data(path="/locations/groups", **kwargs)
+        return list
 
     def get_location_group_by_id(self, group_id: int) -> Box:
         """
@@ -665,5 +654,5 @@ class LocationsAPI:
             returned. Ensure you narrow your search result as much as possible to avoid this.
 
         """
-        return BoxList(Iterator(self.rest, "region/search", **kwargs))
-
+        list, _ = self.rest.get_paginated_data(path="/region/search", **kwargs)
+        return list

zscaler_sdk_python-0.10.1/zscaler/zia/pac_files.py

@@ -0,0 +1,419 @@
+# -*- coding: utf-8 -*-
+
+# Copyright (c) 2023, Zscaler Inc.
+#
+# Permission to use, copy, modify, and/or distribute this software for any
+# purpose with or without fee is hereby granted, provided that the above
+# copyright notice and this permission notice appear in all copies.
+#
+# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+
+
+from box import Box, BoxList
+from requests import Response
+
+from zscaler.utils import snake_to_camel
+from zscaler.zia import ZIAClient
+
+
+class PacFilesAPI:
+    def __init__(self, client: ZIAClient):
+        self.rest = client
+
+    def list_pac_files(self, **kwargs) -> BoxList:
+        """
+        Returns the list of ZIA Pac Files.
+
+        Keyword Args:
+            **max_items (int, optional):
+                The maximum number of items to request before stopping iteration.
+            **max_pages (int, optional):
+                The maximum number of pages to request before stopping iteration.
+            **page_size (int, optional):
+                Specifies the page size. The default size is 100, but the maximum size is 1000.
+
+        Returns:
+            :obj:`BoxList`: The list of PAC Files configured in ZIA.
+
+        Examples:
+            List PAC Files using default settings:
+
+            >>> for pac_files in zia.pac_files.list_pac_files():
+            ...   print(pac_files)
+
+        """
+        list, _ = self.rest.get_paginated_data(path="/pacFiles", **kwargs)
+        return list
+
+    def get_pac_file(self, pac_id: str, filter: str = None) -> Box:
+        """
+        Returns the PAC file details for a given PAC ID.
+
+        Args:
+            pac_id (str): The unique identifier for the PAC file.
+            filter (str, optional): Excludes specific information about the PAC file from
+                                    the response such as the PAC file content.
+                                    Accepts only the value 'pac_content'.
+
+        Returns:
+            :obj:`Box`: The PAC file resource record.
+
+        Example:
+            >>> pac_file = zia.get_pac_file('12345', filter='pac_content')
+        """
+        # Construct URL with optional filter
+        url = f"/pacFiles/{pac_id}/version"
+        if filter == "pac_content":
+            url += f"?filter={filter}"
+
+        response = self.rest.get(url)
+        if isinstance(response, Response):
+            if response.status_code != 200:
+                return None
+        return response
+
+    def get_pac_file_version(self, pac_id: str, pac_version: str, filter: str = None) -> Box:
+        """
+        Returns the PAC file version details for a given PAC ID and version.
+
+        Args:
+            pac_id (str): The unique identifier for the PAC file.
+            pac_version (str): The specific version of the PAC file.
+            filter (str, optional): Excludes specific information about the PAC file from
+                                    the response such as the PAC file content.
+                                    Accepts only the value 'pac_content'.
+
+        Returns:
+            :obj:`Box`: The PAC file version resource record.
+
+        Example:
+            >>> pac_file_version = zia.get_pac_file_version('12345', '1', filter='pac_content')
+        """
+        # Construct URL with optional filter
+        url = f"/pacFiles/{pac_id}/version/{pac_version}"
+        if filter == "pac_content":
+            url += f"?filter={filter}"
+
+        response = self.rest.get(url)
+        if isinstance(response, Response):
+            if response.status_code != 200:
+                return None
+        return response
+
+    def validate_pac_file(self, pac_file_content: str) -> Box:
+        """
+        Sends the PAC file content for validation and returns the validation result.
+
+        Args:
+            pac_file_content (str): The PAC file content to be validated.
+
+        Returns:
+            Box: The API response containing the validation result.
+
+        Raises:
+            Exception: If the API call fails with a non-2xx status code.
+
+        Example:
+            To validate PAC file content:
+
+            .. code-block:: python
+
+                pac_file_content = '''
+                function FindProxyForURL(url, host) {
+                    return "PROXY gateway.example.com:80";
+                }
+                '''
+                
+                response = client.validate_pac_file(pac_file_content=pac_file_content)
+                if response["success"]:
+                    print("PAC file is valid.")
+                else:
+                    print("PAC file validation failed.")
+        """
+        # Send only the PAC content as the raw body
+        response = self.rest.post("pacFiles/validate", data=pac_file_content)
+
+        # Check if the response is successful and already in Box format
+        if isinstance(response, Box):
+            return response
+        elif isinstance(response, Response):
+            if response.status_code != 200:
+                raise Exception(f"API call failed with status {response.status_code}: {response.json()}")
+            # Convert to Box if needed
+            return Box(response.json())
+
+    def add_pac_file(
+        self,
+        name: str,
+        description: str,
+        domain: str,
+        pac_commit_message: str,
+        pac_verification_status: str,
+        pac_version_status: str,
+        pac_content: str,
+        **kwargs,
+    ) -> Box:
+        """
+        Adds a new custom PAC file after validating the PAC content.
+
+        Args:
+            name (str): The name of the new PAC file.
+            description (str): The description of the new PAC file.
+            domain (str): The domain of your organization to which the PAC file applies.
+            pac_commit_message (str): The commit message entered while saving the PAC file version as indicated by the pacVersion field.
+            pac_verification_status (str): Indicates the verification status of the PAC file and if any errors are identified in the syntax.
+                                           Supported Values: `VERIFY_NOERR`, `VERIFY_ERR`, `NOVERIFY`
+            pac_version_status (str): Version status of the new PAC file.
+                                      Supported Values: `DEPLOYED`, `STAGE`, `LKG`
+            pac_content (str): The actual PAC file content to be validated and cloned.
+
+        Keyword Args:
+            Additional optional parameters as key-value pairs.
+
+        Returns:
+            Box: The newly added PAC file resource record.
+
+        Example:
+            >>> pac_file = zia.add_pac_file(
+                    name="Test_Pac_File_01",
+                    description="Test_Pac_File_01",
+                    domain="bd-hashicorp.com",
+                    pacCommitMessage="Test_Pac_File_01",
+                    pacVerificationStatus="VERIFY_NOERR",
+                    pacVersionStatus="DEPLOYED",
+                    pacContent="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }"
+                )
+        """
+        validation_result = self.validate_pac_file(pac_content)
+        if not validation_result.success:
+            raise Exception("PAC content validation failed: {}".format(validation_result))
+
+        payload = {
+            "name": name,
+            "description": description,
+            "domain": domain,
+            "pacCommitMessage": pac_commit_message,
+            "pacVerificationStatus": pac_verification_status,
+            "pacVersionStatus": pac_version_status,
+            "pacContent": pac_content,
+        }
+
+        for key, value in kwargs.items():
+            payload[snake_to_camel(key)] = value
+
+        response = self.rest.post("pacFiles", json=payload)
+        if isinstance(response, Response):
+            if response.status_code != 200:
+                raise Exception(f"API call failed with status {response.status_code}: {response.json()}")
+            return Box(response.json())
+        return response
+
+    def clone_pac_file(
+        self,
+        pac_id: str,
+        pac_version: str,
+        name: str,
+        description: str,
+        domain: str,
+        pac_commit_message: str,
+        pac_verification_status: str,
+        pac_version_status: str,
+        pac_content: str,
+        delete_version: int = None,
+        **kwargs,
+    ) -> Box:
+        """
+        Clones an existing PAC file by creating a new PAC file based on the specified PAC ID and version.
+
+        Args:
+            pac_id (str): The unique identifier of the PAC file to be cloned.
+            pac_version (str): The specific version of the PAC file to be cloned.
+            name (str): The name of the new PAC file.
+            domain (str): The domain associated with the new PAC file.
+            pac_commit_message (str): Commit message for the new PAC file.
+            pac_verification_status (str): Verification status of the new PAC file.
+                                        Supported Values: `VERIFY_NOERR`, `VERIFY_ERR`, `NOVERIFY`
+            pac_version_status (str): Version status of the new PAC file.
+                                    Supported Values: `DEPLOYED`, `STAGE`, `LKG`
+            pac_content (str): The actual PAC file content to be validated and cloned.
+            delete_version (int, optional): Specifies the PAC file version to replace if the version limit of 10 is reached.
+
+        Keyword Args:
+            Additional optional parameters as key-value pairs.
+
+        Returns:
+            Box: The newly cloned PAC file resource record.
+
+        Example:
+            >>> pac_file = zia.clone_pac_file(
+                    pac_id="12345",
+                    pac_version="1",
+                    name="Cloned_Pac_File_01",
+                    description="Cloned_Pac_File_01",
+                    domain="bd-hashicorp.com",
+                    pac_commit_message="Clone of Test_Pac_File_01",
+                    pac_verification_status="VERIFY_NOERR",
+                    pac_version_status="DEPLOYED",
+                    pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }",
+                    delete_version=5
+                )
+        """
+        # Step 1: Validate the PAC content
+        validation_result = self.validate_pac_file(pac_content)
+        if not validation_result.success:
+            raise Exception("PAC content validation failed: {}".format(validation_result))
+
+        # Step 2: Check the number of PAC file versions
+        pac_file_details = self.get_pac_file(pac_id)
+        if isinstance(pac_file_details, Box):
+            pac_file_details = pac_file_details.to_list()  # Convert Box to a list of dictionaries if needed
+
+        # Extract pac versions from details
+        pac_versions = [entry.get("pacVersion") for entry in pac_file_details] if pac_file_details else []
+        total_versions = len(pac_versions)
+
+        # Step 3: Decide on including delete_version in the URL
+        if total_versions >= 10:
+            if delete_version is None:
+                # If delete_version was not provided, default to the oldest version (smallest number)
+                delete_version = min(pac_versions)
+            url = f"/pacFiles/{pac_id}/version/{pac_version}?deleteVersion={delete_version}"
+        else:
+            url = f"/pacFiles/{pac_id}/version/{pac_version}"
+
+        # Step 4: Construct the payload with mandatory fields
+        payload = {
+            "name": name,
+            "description": description,
+            "domain": domain,
+            "pacCommitMessage": pac_commit_message,
+            "pacVerificationStatus": pac_verification_status,
+            "pacVersionStatus": pac_version_status,
+            "pacContent": pac_content,
+        }
+
+        # Add any additional optional parameters
+        for key, value in kwargs.items():
+            payload[snake_to_camel(key)] = value
+
+        # Step 5: Make the request to clone the PAC file
+        response = self.rest.post(url, json=payload)
+        if isinstance(response, Response):
+            if response.status_code != 200:
+                raise Exception(f"API call failed with status {response.status_code}: {response.json()}")
+            return Box(response.json())
+        return response
+
+    def update_pac_file(
+        self,
+        pac_id: str,
+        pac_version: str,
+        pac_version_action: str,
+        name: str,
+        description: str,
+        domain: str,
+        pac_commit_message: str,
+        pac_verification_status: str,
+        # pac_version_status: str,
+        pac_content: str,
+        new_lkg_ver: int = None,
+        **kwargs,
+    ) -> Box:
+        """
+        Performs the specified action on the PAC file version and updates the file status.
+        Supported actions include deploying, staging, unstaging, and marking or unmarking
+        the file as last known good version.
+
+        Args:
+            pac_id (str): The unique identifier of the PAC file to be updated.
+            pac_version (str): The specific version of the PAC file to be updated.
+            pac_version_action (str): Action to perform on the PAC version.
+                                    Supported Values: `DEPLOY`, `STAGE`, `LKG`, `UNSTAGE`, `REMOVE_LKG`
+            name (str): The name of the PAC file.
+            description (str): Description of the PAC file.
+            domain (str): The domain associated with the PAC file.
+            pac_commit_message (str): Commit message for the PAC file.
+            pac_verification_status (str): Verification status of the PAC file.
+                                        Supported Values: `VERIFY_NOERR`, `VERIFY_ERR`, `NOVERIFY`
+            pac_version_status (str): Version status of the PAC file.
+                                    Supported Values: `DEPLOYED`, `STAGE`, `LKG`
+            pac_content (str): The actual PAC file content to be updated.
+            new_lkg_ver (int, optional): Specifies a different version to be marked as the last known good version
+                                        if the action is removing the current last known good version.
+
+        Keyword Args:
+            Additional optional parameters as key-value pairs.
+
+        Returns:
+            Box: The updated PAC file resource record.
+
+        Example:
+            >>> pac_file = zia.update_pac_file(
+                    pac_id="12345",
+                    pac_version="1",
+                    pac_version_action="DEPLOY",
+                    name="Update_Pac_File_01",
+                    description="Update_Pac_File_01",
+                    domain="bd-hashicorp.com",
+                    pac_commit_message="Update_Pac_File_01",
+                    pac_verification_status="VERIFY_NOERR",
+                    pac_version_status="DEPLOYED",
+                    pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }",
+                    new_lkg_ver=5
+                )
+        """
+        # Step 1: Validate the PAC content
+        validation_result = self.validate_pac_file(pac_content)
+        if not validation_result.success:
+            raise Exception("PAC content validation failed: {}".format(validation_result))
+
+        # Step 2: Construct the URL with mandatory parameters and optional newLKGVer
+        url = f"/pacFiles/{pac_id}/version/{pac_version}/action/{pac_version_action}"
+        if new_lkg_ver is not None:
+            url += f"?newLKGVer={new_lkg_ver}"
+
+        # Step 3: Construct the payload with required fields
+        payload = {
+            "name": name,
+            "description": description,
+            "domain": domain,
+            "pacCommitMessage": pac_commit_message,
+            "pacVerificationStatus": pac_verification_status,
+            # "pacVersionStatus": pac_version_status,
+            "pacContent": pac_content,
+        }
+
+        # Add any additional optional parameters
+        for key, value in kwargs.items():
+            payload[snake_to_camel(key)] = value
+
+        # Step 4: Make the request to update the PAC file
+        response = self.rest.put(url, json=payload)
+        if isinstance(response, Response):
+            if response.status_code != 200:
+                raise Exception(f"API call failed with status {response.status_code}: {response.json()}")
+            return Box(response.json())
+        return response
+
+    def delete_pac_file(self, pac_id):
+        """
+        Deletes the specified Pac File.
+
+        Args:
+            pac_id (str): The unique identifier of the Pac File that will be deleted.
+
+        Returns:
+            :obj:`int`: The response code for the request.
+
+        Examples
+            >>> user = zia.pac_files.delete_pac_file('99999')
+
+        """
+        return self.rest.delete(f"pacFiles/{pac_id}").status_code
+

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/zia/security.py

@@ -166,7 +166,7 @@ class SecurityPolicyAPI:
         try:
             # Send the POST request to add URLs to the blacklist
             response = self.rest.post("security/advanced/blacklistUrls?action=ADD_TO_LIST", json=payload)
-            
+
             # Check if the response includes an empty 'blacklistUrls', signaling no update
             if "blacklistUrls" in response and not response["blacklistUrls"]:
                 raise Exception("Failed to add URLs to blacklist: The API response returned an empty 'blacklistUrls' list.")
@@ -177,7 +177,7 @@ class SecurityPolicyAPI:
                 return updated_blacklist
             else:
                 raise Exception("Failed to add URLs to blacklist: URLs were not present in the updated blacklist.")
-                
+
         except Exception as exc:
             raise Exception(f"Failed to add URLs to blacklist: {exc}")
 

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/zia/users.py

@@ -17,7 +17,7 @@
 
 from box import Box, BoxList
 
-from zscaler.utils import Iterator, convert_keys, snake_to_camel
+from zscaler.utils import convert_keys, snake_to_camel
 from zscaler.zia import ZIAClient
 
 
@@ -71,7 +71,7 @@ class UserManagementAPI:
         """
         list, _ = self.rest.get_paginated_data(path="/departments", **kwargs)
         return list
-    
+
     def get_department(self, department_id: str) -> Box:
         """
         Returns the department details for a given department.
@@ -170,7 +170,7 @@ class UserManagementAPI:
             **name (str, optional):
                 Filters by user name. This is a `partial` match.
             **page_size (int, optional):
-                Specifies the page size. The default size is 100, but the maximum size is 1000.
+                Specifies the page size. The default size is 100, but the maximum size is 10000.
             **sort_by (str):
                 The field name to sort by, supported values: id, name, creationTime or modifiedTime (default to name)
             **sort_order (str):

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/zpa/__init__.py

@@ -369,27 +369,27 @@ class ZPAClientHelper(ZPAClient):
         return self.send("DELETE", path, json, params, api_version=api_version)
 
     def get_paginated_data(
-    self,
-    path=None,
-    params=None,
-    expected_status_code=200,
-    api_version: str = None,
-    search=None,
-    search_field="name",
-    max_pages=None,
-    max_items=None,
-    all_entries=False,
-    sort_order=None,
-    sort_by=None,
-    sort_dir=None,
-    start_time=None,
-    end_time=None,
-    idp_group_id=None,
-    scim_user_id=None,
-    scim_username=None,
-    page=None,
-    pagesize=None,
-    microtenant_id=None,
+        self,
+        path=None,
+        params=None,
+        expected_status_code=200,
+        api_version: str = None,
+        search=None,
+        search_field="name",
+        max_pages=None,
+        max_items=None,
+        all_entries=False,
+        sort_order=None,
+        sort_by=None,
+        sort_dir=None,
+        start_time=None,
+        end_time=None,
+        idp_group_id=None,
+        scim_user_id=None,
+        scim_username=None,
+        page=None,
+        pagesize=None,
+        microtenant_id=None,
     ):
         """
         Fetches paginated data from the ZPA API based on specified parameters and handles various types of API pagination.

{zscaler_sdk_python-0.9.7 → zscaler_sdk_python-0.10.1}/zscaler/zpa/policies.py

@@ -15,8 +15,6 @@
 # OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 
-import functools
-
 from box import Box, BoxList
 from requests import Response
 
@@ -61,6 +59,7 @@ class PolicySetsAPI:
         """
         template = []
         app_and_app_group_operands = []
+        scim_and_scim_group_operands = []
         object_types_to_operands = {
             "CONSOLE": [],
             "MACHINE_GRP": [],
@@ -100,6 +99,8 @@ class PolicySetsAPI:
 
                 if object_type in ["APP", "APP_GROUP"]:
                     app_and_app_group_operands.append(operand)
+                elif object_type in ["SCIM","SCIM_GROUP"]:
+                    scim_and_scim_group_operands.append(operand)
                 elif object_type in object_types_to_operands:
                     object_types_to_operands[object_type].append(operand)
 
@@ -131,6 +132,11 @@ class PolicySetsAPI:
             app_group_operator = operators_for_types.get("APP", "OR")
             template.append({"operator": app_group_operator, "operands": app_and_app_group_operands})
 
+        # Combine SCIM and SCIM_GROUP operands with their specific operator
+        if scim_and_scim_group_operands:
+            scim_group_operator = operators_for_types.get("SCIM_GROUP", "OR")
+            template.append({"operator": scim_group_operator, "operands": scim_and_scim_group_operands})
+
         # Combine other object types into their blocks with their respective operator
         for object_type, operands in object_types_to_operands.items():
             if operands: