msfabricpysdkcore 0.1.8__py3-none-any.whl → 0.2.2__py3-none-any.whl

msfabricpysdkcore/adminapi.py

@@ -279,7 +279,7 @@ class FabricClientAdmin(FabricClient):
 
         return response.status_code
     
-    def update_domain(self, domain_id, description = None, display_name = None, contributors_scope = None, return_item = "Default"):
+    def update_domain(self, domain_id, description = None, display_name = None, contributors_scope = None, return_item = False):
         """Method to update a domain
         
         Args:
@@ -301,15 +301,7 @@ class FabricClientAdmin(FabricClient):
         response_json = self.calling_routine(url = url, operation = "PATCH", body = body,
                                              response_codes = [200, 429], error_message = "Error updating domain",
                                              return_format="json")
-  
-        if return_item == "Default":
-            warn(
-                message="Updating a domain currently will make invoke an additional API call to get the domain "
-                        "object. This default behaviour will change in newer versions of the SDK. To keep this "
-                        "behaviour, set return_item=True in the function call.",
-                category=FutureWarning,
-                stacklevel=2
-            )
+
         if return_item:
             return self.get_domain_by_id(domain_id)
         return response_json
@@ -513,6 +505,25 @@ class FabricClientAdmin(FabricClient):
 
     # Tenant Settings APIs
 
+    # DELETE https://api.fabric.microsoft.com/v1/admin/capacities/{capacityId}/delegatedTenantSettingOverrides/{tenantSettingName}
+    def delete_capacity_tenant_setting_override(self, capacity_id, tenant_setting_name):
+        """Delete a tenant setting override at the capacity
+        
+        Args:
+            capacity_id (str): The ID of the capacity
+            tenant_setting_name (str): The name of the tenant setting
+            
+        Returns:
+            int: The status code of the response
+        """
+        url = f"https://api.fabric.microsoft.com/v1/admin/capacities/{capacity_id}/delegatedTenantSettingOverrides/{tenant_setting_name}"
+
+        response:requests.Response = self.calling_routine(url = url, operation = "DELETE", response_codes = [200, 429],
+                                                          error_message = "Error deleting capacity tenant setting override",
+                                                          return_format="response")
+
+        return response.status_code
+
     def list_capacities_tenant_settings_overrides(self):
         """Returns list of tenant setting overrides that override at the capacities
         
@@ -524,10 +535,42 @@ class FabricClientAdmin(FabricClient):
 
         items: list = self.calling_routine(url = url, operation = "GET", response_codes = [200, 429],
                                            error_message = "Error listing capacities tenant settings overrides",
-                                           return_format="Overrides", paging=True)
+                                           return_format="value", paging=True)
+
+        return items
+    
+    # GET https://api.fabric.microsoft.com/v1/admin/capacities/{capacityId}/delegatedTenantSettingOverrides?continuationToken={continuationToken}
+    def list_capacity_tenant_settings_overrides_by_capacity_id(self, capacity_id):
+        """Returns list of tenant setting overrides that override at the capacity
+        
+        Args:
+            capacity_id (str): The ID of the capacity
+        Returns:
+            list: The capacities tenant settings overrides
+        """
+        url = f"https://api.fabric.microsoft.com/v1/admin/capacities/{capacity_id}/delegatedTenantSettingOverrides"
+
+        items: list = self.calling_routine(url = url, operation = "GET", response_codes = [200, 429],
+                                           error_message = "Error listing capacity tenant settings overrides",
+                                           return_format="value", paging=True)
 
         return items
 
+    # GET https://api.fabric.microsoft.com/v1/admin/domains/delegatedTenantSettingOverrides?continuationToken={continuationToken}
+    def list_domain_tenant_settings_overrides(self):
+        """Returns list of tenant setting overrides that override at the domains
+
+        Returns:
+            list: The domains tenant settings overrides
+        """
+        url = "https://api.fabric.microsoft.com/v1/admin/domains/delegatedTenantSettingOverrides"
+
+        items: list = self.calling_routine(url = url, operation = "GET", response_codes = [200, 429],
+                                           error_message = "Error listing domain tenant settings overrides",
+                                           return_format="value", paging=True)
+
+        return items
+    
     def list_tenant_settings(self):
         """Get the tenant settings
         
@@ -537,8 +580,97 @@ class FabricClientAdmin(FabricClient):
         url = "https://api.fabric.microsoft.com/v1/admin/tenantsettings"
 
         response_json = self.calling_routine(url = url, operation = "GET", response_codes = [200, 429],
-                                             error_message = "Error getting tenant settings", return_format="json")
+                                             error_message = "Error getting tenant settings", paging= True, return_format="value")
+        return response_json
+    
+    # GET https://api.fabric.microsoft.com/v1/admin/workspaces/delegatedTenantSettingOverrides?continuationToken={continuationToken}
+    def list_workspace_tenant_settings_overrides(self):
+        """Returns list of tenant setting overrides that override at the workspaces
+        
+        Returns:
+            list: The workspaces tenant settings overrides
+        """
+        url = "https://api.fabric.microsoft.com/v1/admin/workspaces/delegatedTenantSettingOverrides"
+
+        items: list = self.calling_routine(url = url, operation = "GET", response_codes = [200, 429],
+                                           error_message = "Error listing workspace tenant settings overrides",
+                                           return_format="value", paging=True)
+
+        return items
+    
+    # POST https://api.fabric.microsoft.com/v1/admin/capacities/{capacityId}/delegatedTenantSettingOverrides/{tenantSettingName}/update
+    def update_capacity_tenant_setting_override(self, capacity_id, tenant_setting_name, enabled, delegate_to_workspace = None,
+                                                enabled_security_groups = None, excluded_security_groups = None):
+        """Update a tenant setting override at the capacity
+        
+        Args:
+            capacity_id (str): The ID of the capacity
+            tenant_setting_name (str): The name of the tenant setting
+            enabled (bool): Whether the tenant setting is enabled
+            delegate_to_workspace (bool): Indicates whether the tenant setting can be delegated to a workspace admin. False - Workspace admin cannot override the tenant setting. True - Workspace admin can override the tenant setting.
+            enabled_security_groups (list): The list of enabled security groups
+            excluded_security_groups (list): The list of excluded security groups
+        Returns:
+            dict: The overrides
+        """
+        url = f"https://api.fabric.microsoft.com/v1/admin/capacities/{capacity_id}/delegatedTenantSettingOverrides/{tenant_setting_name}/update"
+        body = {
+            "enabled": enabled
+        }
+        if delegate_to_workspace:
+            body["delegateToWorkspace"] = delegate_to_workspace
+        if enabled_security_groups:
+            body["enabledSecurityGroups"] = enabled_security_groups
+        if excluded_security_groups:
+            body["excludedSecurityGroups"] = excluded_security_groups
+
+        response_json : dict = self.calling_routine(url = url, operation = "POST", body = body, response_codes = [200, 429],
+                                                    error_message = "Error updating capacity tenant setting override", return_format="json")
+
+        return response_json
+
+    # POST https://api.fabric.microsoft.com/v1/admin/tenantsettings/{tenantSettingName}/update
+    def update_tenant_setting(self, tenant_setting_name, enabled, delegate_to_capacity = None, delegate_to_domain = None,
+                              delegate_to_workspace = None, enabled_security_groups = None, excluded_security_groups = None, properties = None):
+        """Update a tenant setting
+
+        Args:
+            capacity_id (str): The ID of the capacity
+            tenant_setting_name (str): The name of the tenant setting
+            enabled (bool): Whether the tenant setting is enabled
+            delegate_to_capacity (bool): Indicates whether the tenant setting can be delegated to a capacity admin. False - Capacity admin cannot override the tenant setting. True - Capacity admin can override the tenant setting.
+            delegate_to_domain (bool): Indicates whether the tenant setting can be delegated to a domain admin. False - Domain admin cannot override the tenant setting. True - Domain admin can override the tenant setting.
+            delegate_to_workspace (bool): Indicates whether the tenant setting can be delegated to a workspace admin. False - Workspace admin cannot override the tenant setting. True - Workspace admin can override the tenant setting.
+            enabled_security_groups (list): The list of enabled security groups
+            excluded_security_groups (list): The list of excluded security groups
+        Returns:
+            dict: The tenant settings
+        """
+
+        url = f"https://api.fabric.microsoft.com/v1/admin/tenantsettings/{tenant_setting_name}/update"
+
+        body = {
+            "enabled": enabled
+        }
+        if delegate_to_capacity:
+            body["delegateToCapacity"] = delegate_to_capacity
+        if delegate_to_domain:
+            body["delegateToDomain"] = delegate_to_domain
+        if delegate_to_workspace:
+            body["delegateToWorkspace"] = delegate_to_workspace
+        if enabled_security_groups:
+            body["enabledSecurityGroups"] = enabled_security_groups
+        if excluded_security_groups:
+            body["excludedSecurityGroups"] = excluded_security_groups
+        if properties:
+            body["properties"] = properties
+
+        response_json : dict = self.calling_routine(url = url, operation = "POST", body = body, response_codes = [200, 429],
+                                                    error_message = "Error updating tenant setting", return_format="json")
+        
         return response_json
+
+
     
     # Users APIs
 
@@ -581,6 +713,19 @@ class FabricClientAdmin(FabricClient):
     
         workspace = AdminWorkspace.from_dict(response_json, self)
         return workspace
+    
+    # GET https://api.fabric.microsoft.com/v1/admin/workspaces/discoverGitConnections
+    def discover_git_connections(self):
+        """Discover Git connections
+        
+        Returns:
+            dict: The Git connections
+        """
+        url = "https://api.fabric.microsoft.com/v1/admin/workspaces/discoverGitConnections"
+
+        response_json = self.calling_routine(url = url, operation = "GET", response_codes = [200, 429],
+                                             error_message = "Error discovering Git connections", return_format="value_json", paging=True)
+        return response_json
 
     def list_workspace_access_details(self, workspace_id):
         """Get the access details of the workspace
@@ -639,3 +784,24 @@ class FabricClientAdmin(FabricClient):
         workspaces = [AdminWorkspace.from_dict(i, self) for i in workspaces]
 
         return workspaces
+    
+    def restore_workspace(self, workspace_id, new_workspace_admin_principal, new_workspace_name = None):
+        """Restore a workspace
+        
+        Args:
+            workspace_id (str): The ID of the workspace
+        Returns:
+            response: The response from the API
+        """
+
+        restore_request = {
+            "newWorkspaceAdminPrincipal": new_workspace_admin_principal,
+            "newWorkspaceName": new_workspace_name
+        }
+        url = f"https://api.fabric.microsoft.com/v1/admin/workspaces/{workspace_id}/restore"
+
+        response_json = self.calling_routine(url = url, operation = "POST", body = restore_request,
+                                             response_codes = [200, 429], error_message = "Error restoring workspace",
+                                             return_format="response")
+
+        return response_json