zscaler-sdk-python 1.9.30__tar.gz → 1.9.31__tar.gz

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zscaler-sdk-python
-Version: 1.9.30
+Version: 1.9.31
 Summary: Official Python SDK for the Zscaler Products
 Home-page: https://github.com/zscaler/zscaler-sdk-python
 License: MIT

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "zscaler-sdk-python"
-version = "1.9.30"
+version = "1.9.31"
 description = "Official Python SDK for the Zscaler Products"
 authors = ["Zscaler, Inc. <devrel@zscaler.com>"]
 license = "MIT"

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/zscaler/__init__.py

@@ -29,7 +29,7 @@ __license__ = "MIT"
 __contributors__ = [
     "William Guilherme",
 ]
-__version__ = "1.9.30"
+__version__ = "1.9.31"
 
 
 from zscaler.oneapi_client import Client as ZscalerClient  # noqa

zscaler_sdk_python-1.9.31/zscaler/zia/email_profiles.py

@@ -0,0 +1,279 @@
+"""
+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 typing import List, Optional
+
+from zscaler.api_client import APIClient
+from zscaler.request_executor import RequestExecutor
+from zscaler.types import APIResult
+from zscaler.utils import format_url
+from zscaler.zia.models.email_profiles import EmailProfiles
+
+
+class EmailProfilesAPI(APIClient):
+    """
+    A Client object for the Email profiles resource.
+    """
+
+    _zia_base_endpoint = "/zia/api/v1"
+
+    def __init__(self, request_executor: "RequestExecutor") -> None:
+        super().__init__()
+        self._request_executor: RequestExecutor = request_executor
+
+    def list_email_profiles(self, query_params: Optional[dict] = None) -> APIResult[List[EmailProfiles]]:
+        """
+        Lists email profiles in your organization with pagination.
+        A subset of email profiles can be returned that match a supported
+        filter expression or query.
+
+        Args:
+            query_params {dict}: Map of query parameters for the request.
+                ``[query_params.page]`` {int}: Specifies the page offset.
+
+                ``[query_params.page_size]`` {int}: Page size for pagination.
+
+                ``[query_params.search]`` {str}: Search string for filtering results.
+
+        Returns:
+            tuple: A tuple containing (list of Email Profiles instances, Response, error)
+
+        Examples:
+            List Email Profiles using default settings:
+
+            >>> profile_list, _, error = client.zia.email_profiles.list_email_profiles(
+                query_params={'search': updated_profile.name})
+            >>> if error:
+            ...     print(f"Error listing email profiles: {error}")
+            ...     return
+            ... print(f"Total email profiles found: {len(profile_list)}")
+            ... for profile in profile_list:
+            ...     print(profile.as_dict())
+
+            Client-side filtering with JMESPath:
+
+            The response object supports client-side filtering and
+            projection via ``resp.search(expression)``.  See the
+            `JMESPath documentation <https://jmespath.org/>`_ for
+            expression syntax.
+
+        """
+        http_method = "get".upper()
+        api_url = format_url(f"""
+            {self._zia_base_endpoint}
+            /emailRecipientProfile
+        """)
+
+        query_params = query_params or {}
+
+        body = {}
+        headers = {}
+
+        request, error = self._request_executor.create_request(http_method, api_url, body, headers, params=query_params)
+
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request)
+
+        if error:
+            return (None, response, error)
+
+        try:
+            result = []
+            for item in response.get_results():
+                result.append(EmailProfiles(self.form_response_body(item)))
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)
+
+    def get_email_profile(self, profile_id: int) -> APIResult[dict]:
+        """
+        Fetches a specific email profile by ID.
+
+        Args:
+            profile_id (int): The unique identifier for the email profile.
+
+        Returns:
+            tuple: A tuple containing (Email Profile instance, Response, error).
+
+        Examples:
+            Print a specific Email Profile
+
+            >>> fetched_profile, _, error = client.zia.email_profiles.get_email_profile(
+                '1254654')
+            >>> if error:
+            ...     print(f"Error fetching Email Profile by ID: {error}")
+            ...     return
+            ... print(f"Fetched Email Profile by ID: {fetched_profile.as_dict()}")
+        """
+        http_method = "get".upper()
+        api_url = format_url(f"""
+            {self._zia_base_endpoint}
+            /emailRecipientProfile/{profile_id}
+        """)
+
+        body = {}
+        headers = {}
+
+        request, error = self._request_executor.create_request(http_method, api_url, body, headers)
+
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request, EmailProfiles)
+        if error:
+            return (None, response, error)
+
+        try:
+            result = EmailProfiles(self.form_response_body(response.get_body()))
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)
+
+    def add_email_profile(self, **kwargs) -> APIResult[dict]:
+        """
+        Creates a new ZIA Email Profile.
+
+        Args:
+            name (str): The name of the email profile.
+            **kwargs: Optional keyword args.
+
+        Keyword Args:
+            description (str): Additional notes or information
+
+        Returns:
+            tuple: A tuple containing the newly added Email Profile, response, and error.
+
+        Examples:
+            Add a new Email Profile :
+
+            >>> added_profile, _, error = client.zia.email_profiles.add_email_profile(
+            ...     name=f"NewProfile_{random.randint(1000, 10000)}",
+            ...     description=f"NewProfile_{random.randint(1000, 10000)}",
+            ...     emails=['john.doe@example.com', 'mary.jane@example.com']
+            ... )
+            >>> if error:
+            ...     print(f"Error adding email profile: {error}")
+            ...     return
+            ... print(f"Email Profile added successfully: {added_profile.as_dict()}")
+        """
+        http_method = "post".upper()
+        api_url = format_url(f"""
+            {self._zia_base_endpoint}
+            /emailRecipientProfile
+        """)
+
+        body = kwargs
+
+        request, error = self._request_executor.create_request(
+            method=http_method,
+            endpoint=api_url,
+            body=body,
+        )
+
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request, EmailProfiles)
+        if error:
+            return (None, response, error)
+
+        try:
+            result = EmailProfiles(self.form_response_body(response.get_body()))
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)
+
+    def update_email_profile(self, profile_id: int, **kwargs) -> APIResult[dict]:
+        """
+        Updates information for the specified ZIA Email Profile.
+
+        Args:
+            profile_id (int): The unique ID for the Email Profile.
+
+        Returns:
+            tuple: A tuple containing the updated Email Profile, response, and error.
+
+        Examples:
+            Update an existing Email Profile :
+
+            >>> updated_profile, _, error = client.zia.email_profiles.update_email_profile(
+                profile_id='1524566'
+            ... name=f"UpdatedEmailProfile_{random.randint(1000, 10000)}",
+            ... description=f"UpdatedEmailProfile_{random.randint(1000, 10000)}",
+            ... )
+            >>> if error:
+            ...     print(f"Error updating Email Profile: {error}")
+            ...     return
+            ... print(f"Email Profile updated successfully: {updated_profile.as_dict()}")
+        """
+        http_method = "put".upper()
+        api_url = format_url(f"""
+            {self._zia_base_endpoint}
+            /emailRecipientProfile/{profile_id}
+        """)
+        body = kwargs
+
+        request, error = self._request_executor.create_request(http_method, api_url, body, {}, {})
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request, EmailProfiles)
+        if error:
+            return (None, response, error)
+
+        try:
+            result = EmailProfiles(self.form_response_body(response.get_body()))
+        except Exception as error:
+            return (None, response, error)
+        return (result, response, None)
+
+    def delete_email_profile(self, profile_id: int) -> APIResult[dict]:
+        """
+        Deletes the specified Email Profile.
+
+        Args:
+            profile_id (str): The unique identifier of the Email Profile.
+
+        Returns:
+            tuple: A tuple containing the response object and error (if any).
+
+        Examples:
+            Delete an Email Profile:
+
+            >>> _, _, error = client.zia.email_profiles.delete_email_profile('73459')
+            >>> if error:
+            ...     print(f"Error deleting Email Profile: {error}")
+            ...     return
+            ... print(f"Email Profile with ID {'73459'} deleted successfully.")
+        """
+        http_method = "delete".upper()
+        api_url = format_url(f"""
+            {self._zia_base_endpoint}
+            /emailRecipientProfile/{profile_id}
+        """)
+
+        params = {}
+
+        request, error = self._request_executor.create_request(http_method, api_url, params=params)
+        if error:
+            return (None, None, error)
+
+        response, error = self._request_executor.execute(request)
+        if error:
+            return (None, response, error)
+        return (None, response, None)

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/zscaler/zia/legacy.py

@@ -75,6 +75,7 @@ if TYPE_CHECKING:
     from zscaler.zia.dlp_templates import DLPTemplatesAPI
     from zscaler.zia.dlp_web_rules import DLPWebRuleAPI
     from zscaler.zia.dns_gatways import DNSGatewayAPI
+    from zscaler.zia.email_profiles import EmailProfilesAPI
     from zscaler.zia.end_user_notification import EndUserNotificationAPI
     from zscaler.zia.file_type_control_rule import FileTypeControlRuleAPI
     from zscaler.zia.ftp_control_policy import FTPControlPolicyAPI
@@ -1272,6 +1273,13 @@ class LegacyZIAClientHelper:
         """
         return SecureBrowsingAPI(self.request_executor)
 
+    @property
+    def email_profiles(self) -> "EmailProfilesAPI":
+        """
+        The interface object for the :ref:`ZIA Email Profiles API interface <zia-email_profiles>`.
+
+        """
+        return EmailProfilesAPI(self.request_executor)
 
     """
     Misc

zscaler_sdk_python-1.9.31/zscaler/zia/models/email_profiles.py

@@ -0,0 +1,67 @@
+"""
+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.
+"""
+
+# AUTO-GENERATED! DO NOT EDIT FILE DIRECTLY
+# SEE CONTRIBUTOR DOCUMENTATION
+from typing import Any, Dict, List, Optional
+
+from zscaler.oneapi_collection import ZscalerCollection
+from zscaler.oneapi_object import ZscalerObject
+
+
+class EmailProfiles(ZscalerObject):
+    """
+    A class for EmailProfiles objects.
+    """
+
+    def __init__(self, config: Optional[Dict[str, Any]] = None) -> None:
+        """
+        Initialize the EmailProfiles model based on API response.
+
+        Args:
+            config (dict): A dictionary representing the configuration.
+        """
+        super().__init__(config)
+
+        if config:
+            self.id: Optional[Any] = config["id"] \
+                if "id" in config else None
+            self.name: Optional[Any] = config["name"] \
+                if "name" in config else None
+            self.description: Optional[Any] = config["description"] \
+                if "description" in config else None
+            self.emails: List[Any] = ZscalerCollection.form_list(
+                config["emails"] if "emails" in config else [], str
+            )
+        else:
+            self.id: Optional[Any] = None
+            self.name: Optional[Any] = None
+            self.description: Optional[Any] = None
+            self.emails: List[Any] = []
+
+    def request_format(self) -> Dict[str, Any]:
+        """
+        Return the object as a dictionary in the format expected for API requests.
+        """
+        parent_req_format = super().request_format()
+        current_obj_format = {
+            "id": self.id,
+            "name": self.name,
+            "description": self.description,
+            "emails": self.emails
+        }
+        parent_req_format.update(current_obj_format)
+        return parent_req_format

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/zscaler/zia/zia_service.py

@@ -48,6 +48,7 @@ from zscaler.zia.dlp_resources import DLPResourcesAPI
 from zscaler.zia.dlp_templates import DLPTemplatesAPI
 from zscaler.zia.dlp_web_rules import DLPWebRuleAPI
 from zscaler.zia.dns_gatways import DNSGatewayAPI
+from zscaler.zia.email_profiles import EmailProfilesAPI
 from zscaler.zia.end_user_notification import EndUserNotificationAPI
 from zscaler.zia.file_type_control_rule import FileTypeControlRuleAPI
 from zscaler.zia.forwarding_control import ForwardingControlAPI
@@ -742,4 +743,12 @@ class ZIAService:
         The interface object for the :ref:`ZIA Secure Browsing API interface <zia-secure_browsing>`.
 
         """
-        return SecureBrowsingAPI(self._request_executor)
+        return SecureBrowsingAPI(self._request_executor)
+    
+    @property
+    def email_profiles(self) -> "EmailProfilesAPI":
+        """
+        The interface object for the :ref:`ZIA Email Profiles API interface <zia-email_profiles>`.
+
+        """
+        return EmailProfilesAPI(self._request_executor)

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/zscaler/zpa/legacy.py

@@ -429,9 +429,9 @@ class LegacyZPAClientHelper:
         return AppConnectorScheduleAPI(self.request_executor, self.config)
 
     @property
-    def connectors(self) -> AppConnectorControllerAPI:
+    def app_connectors(self) -> AppConnectorControllerAPI:
         """
-        The interface object for the :ref:`ZPA Connectors interface <zpa-connectors>`.
+        The interface object for the :ref:`ZPA Connectors interface <zpa-app_connectors>`.
 
         """
         from zscaler.zpa.app_connectors import AppConnectorControllerAPI

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/zscaler/zpa/models/app_connector_groups.py

@@ -80,6 +80,16 @@ class AppConnectorGroup(ZscalerObject):
             self.server_groups = ZscalerCollection.form_list(
                 config["serverGroups"] if "serverGroups" in config else [], server_group.ServerGroup
             )
+            
+            if "version" in config:
+                if isinstance(config["version"], Version):
+                    self.version = config["version"]
+                elif config["version"] is not None:
+                    self.version = Version(config["version"])
+                else:
+                    self.version = None
+            else:
+                self.version = None
         else:
             self.id = None
             self.ip_acl = None
@@ -103,12 +113,12 @@ class AppConnectorGroup(ZscalerObject):
             self.connector_group_type = None
             self.city_country = None
             self.country_code = None
-            self.tcp_quick_ack_app = False
-            self.tcp_quick_ack_assistant = False
-            self.tcp_quick_ack_read_assistant = False
-            self.pra_enabled = False
-            self.use_in_dr_mode = False
-            self.waf_disabled = False
+            self.tcp_quick_ack_app = None
+            self.tcp_quick_ack_assistant = None
+            self.tcp_quick_ack_read_assistant = None
+            self.pra_enabled = None
+            self.use_in_dr_mode = None
+            self.waf_disabled = None
             self.microtenant_id = None
             self.microtenant_name = None
             self.site_id = None
@@ -119,6 +129,7 @@ class AppConnectorGroup(ZscalerObject):
             self.zscaler_managed = None
             self.dc_hosting_info = None
             self.enrollment_cert_id = None
+            self.version = None
             self.server_groups = []
 
     def request_format(self) -> Dict[str, Any]:
@@ -162,6 +173,7 @@ class AppConnectorGroup(ZscalerObject):
             "zscalerManaged": self.zscaler_managed,
             "dcHostingInfo": self.dc_hosting_info,
             "enrollmentCertId": self.enrollment_cert_id,
+            "version": self.version,
             "serverGroups": [server_group.request_format() for server_group in self.server_groups],
         }
         parent_req_format.update(current_obj_format)
@@ -296,3 +308,36 @@ class NPDnsNsRecord(ZscalerObject):
         }
         parent_req_format.update(current_obj_format)
         return parent_req_format
+
+
+class Version(ZscalerObject):
+    def __init__(self, config: Optional[Dict[str, Any]] = None) -> None:
+        """
+        Initialize the Version model based on API response.
+        """
+        super().__init__(config)
+        if config:
+            self.version_profile_gid = config["version_profile_gid"] if "version_profile_gid" in config else None
+            self.version_profile_name = config["versionProfileName"] if "versionProfileName" in config else None
+            self.sarge_version = config["sargeVersion"] if "sargeVersion" in config else None
+            self.child_version = config["childVersion"] if "childVersion" in config else None
+            self.latest_platform = config["latestPlatform"] if "latestPlatform" in config else None
+
+        else:
+            self.version_profile_gid = None
+            self.version_profile_name = None
+            self.sarge_version = None
+            self.child_version = None
+            self.latest_platform = None
+
+    def request_format(self) -> Dict[str, Any]:
+        parent_req_format = super().request_format()
+        current_obj_format = {
+            "versionProfileGid": self.version_profile_gid,
+            "versionProfileName": self.version_profile_name,
+            "sargeVersion": self.sarge_version,
+            "childVersion": self.child_version,
+            "latestPlatform": self.latest_platform,
+        }
+        parent_req_format.update(current_obj_format)
+        return parent_req_format

{zscaler_sdk_python-1.9.30 → zscaler_sdk_python-1.9.31}/zscaler/zpa/models/application_segment.py

@@ -873,6 +873,9 @@ class AppResource(ZscalerObject):
             self.health_check_type = config["healthCheckType"] if "healthCheckType" in config else None
             self.health_reporting = config["healthReporting"] if "healthReporting" in config else None
             self.icmp_access_type = config["icmpAccessType"] if "icmpAccessType" in config else None
+            self.inconsistent_config_details = (
+                config["inconsistentConfigDetails"] if "inconsistentConfigDetails" in config else None
+            )
             self.ip_anchored = config["ipAnchored"] if "ipAnchored" in config else None
             self.is_cname_enabled = config["isCnameEnabled"] if "isCnameEnabled" in config else None
             self.name = config["name"] if "name" in config else None