Add a method for obtaining the connected domain (#133)

* Add a method for obtaining the connected domain

Author: saimonation

cterasdk/core/directoryservice.py

@@ -59,6 +59,7 @@ def connect(self, domain, username, password, directory=DirectoryServiceType.Mic
         param.accessControlRules = None
         param.idMapping = None
         param.fetchMode = fetch
+        param.ipAddresses = None
 
         if domain_controllers:
             param.ipAddresses = Object()
@@ -167,6 +168,19 @@ def _configure_access_control(self, acl, default=None):
 
         return response
 
+    def get_connected_domain(self):
+        """
+        Get the connected domain information. Returns `None` if the Portal tenant is not connected to a domain
+
+        :return str: The connected domain
+        """
+        domain = None
+        try:
+            domain = self._portal.get('/directoryConnector/domain')
+        except CTERAException:
+            pass
+        return domain
+
     def domains(self):
         """
         Get domains

docs/source/user_guides/Portal/GlobalAdmin.rst

@@ -714,6 +714,21 @@ Directory Services
    )
    admin.directoryservice.connect('demo.local', 'svc_account', 'P@ssw0rd1', mapping=mapping, domain_controllers=portal_types.DomainControllers('172.54.3.52'), acl=[rw_admin, ro_admin])
 
+.. automethod:: cterasdk.core.directoryservice.DirectoryService.domains
+   :noindex:
+
+.. code-block:: python
+
+   print(admin.directoryservice.domains())
+
+
+.. automethod:: cterasdk.core.directoryservice.DirectoryService.get_connected_domain
+   :noindex:
+
+.. code-block:: python
+
+   print(admin.directoryservice.get_connected_domain())
+
 .. automethod:: cterasdk.core.directoryservice.DirectoryService.get_advanced_mapping
    :noindex: