semantic-link-labs 0.8.3__py3-none-any.whl → 0.8.4__py3-none-any.whl

sempy_labs/_warehouses.py

@@ -19,6 +19,8 @@ def create_warehouse(
     """
     Creates a Fabric warehouse.
 
+    This is a wrapper function for the following API: `Items - Create Warehouse <https://learn.microsoft.com/rest/api/fabric/warehouse/items/create-warehouse`_.
+
     Parameters
     ----------
     warehouse: str
@@ -61,6 +63,8 @@ def list_warehouses(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the warehouses within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Warehouses <https://learn.microsoft.com/rest/api/fabric/warehouse/items/list-warehouses`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -115,6 +119,8 @@ def delete_warehouse(name: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric warehouse.
 
+    This is a wrapper function for the following API: `Items - Delete Warehouse <https://learn.microsoft.com/rest/api/fabric/warehouse/items/delete-warehouse`_.
+
     Parameters
     ----------
     name: str
@@ -140,3 +146,76 @@ def delete_warehouse(name: str, workspace: Optional[str] = None):
     print(
         f"{icons.green_dot} The '{name}' warehouse within the '{workspace}' workspace has been deleted."
     )
+
+
+def get_warehouse_tables(
+    warehouse: str, workspace: Optional[str] = None
+) -> pd.DataFrame:
+    """
+    Shows a list of the tables in the Fabric warehouse. This function is based on INFORMATION_SCHEMA.TABLES.
+
+    Parameters
+    ----------
+    warehouse : str
+        Name of the Fabric warehouse.
+    workspace : str, default=None
+        The Fabric workspace name.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of the tables in the Fabric warehouse.
+    """
+
+    from sempy_labs._sql import ConnectWarehouse
+
+    with ConnectWarehouse(warehouse=warehouse, workspace=workspace) as sql:
+        df = sql.query(
+            """
+        SELECT TABLE_SCHEMA AS [Schema], TABLE_NAME AS [Table Name], TABLE_TYPE AS [Table Type]
+        FROM INFORMATION_SCHEMA.TABLES
+        WHERE TABLE_TYPE = 'BASE TABLE'
+        """
+        )
+
+    return df
+
+
+def get_warehouse_columns(
+    warehouse: str, workspace: Optional[str] = None
+) -> pd.DataFrame:
+    """
+    Shows a list of the columns in each table within the Fabric warehouse. This function is based on INFORMATION_SCHEMA.COLUMNS.
+
+    Parameters
+    ----------
+    warehouse : str
+        Name of the Fabric warehouse.
+    workspace : str, default=None
+        The Fabric workspace name.
+        Defaults to None which resolves to the workspace of the attached lakehouse
+        or if no lakehouse attached, resolves to the workspace of the notebook.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing a list of the columns in each table within the Fabric warehouse.
+    """
+
+    from sempy_labs._sql import ConnectWarehouse
+
+    with ConnectWarehouse(warehouse=warehouse, workspace=workspace) as sql:
+        df = sql.query(
+            """
+        SELECT t.TABLE_SCHEMA AS [Schema], t.TABLE_NAME AS [Table Name], c.COLUMN_NAME AS [Column Name], c.DATA_TYPE AS [Data Type], c.IS_NULLABLE AS [Is Nullable], c.CHARACTER_MAXIMUM_LENGTH AS [Character Max Length]
+        FROM INFORMATION_SCHEMA.TABLES AS t
+        LEFT JOIN INFORMATION_SCHEMA.COLUMNS AS c
+        ON t.TABLE_NAME = c.TABLE_NAME
+        AND t.TABLE_SCHEMA = c.TABLE_SCHEMA
+        WHERE t.TABLE_TYPE = 'BASE TABLE'
+        """
+        )
+
+    return df

sempy_labs/_workloads.py

@@ -0,0 +1,128 @@
+import sempy.fabric as fabric
+import pandas as pd
+from typing import Optional
+import sempy_labs._icons as icons
+from sempy.fabric.exceptions import FabricHTTPException
+
+
+def list_workloads(capacity_name: str) -> pd.DataFrame:
+    """
+    Returns the current state of the specified capacity workloads.
+    If a workload is enabled, the percentage of maximum memory that the workload can consume is also returned.
+
+    This is a wrapper function for the following API: `Capacities - Get Workloads <https://learn.microsoft.com/rest/api/power-bi/capacities/get-workloads>`_.
+
+    Parameters
+    ----------
+    capacity_name : str
+        The capacity name.
+
+    Returns
+    -------
+    pandas.DataFrame
+        A pandas dataframe showing the current state of the specified capacity workloads.
+    """
+
+    from sempy_labs._helper_functions import resolve_capacity_id
+
+    df = pd.DataFrame(
+        columns=["Workload Name", "State", "Max Memory Percentage Set By User"]
+    )
+
+    capacity_id = resolve_capacity_id(capacity_name=capacity_name)
+
+    client = fabric.PowerBIRestClient()
+    response = client.get(f"/v1.0/myorg/capacities/{capacity_id}/Workloads")
+
+    if response.status_code != 200:
+        raise FabricHTTPException(response)
+
+    for v in response.json().get("value", []):
+        new_data = {
+            "Workload Name": v.get("name"),
+            "State": v.get("state"),
+            "Max Memory Percentage Set By User": v.get("maxMemoryPercentageSetByUser"),
+        }
+        df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
+
+    int_cols = ["Max Memory Percentage Set By User"]
+    df[int_cols] = df[int_cols].astype(int)
+
+    return df
+
+
+def patch_workload(
+    capacity_name: str,
+    workload_name: str,
+    state: Optional[str] = None,
+    max_memory_percentage: Optional[int] = None,
+):
+    """
+    Changes the state of a specific workload to Enabled or Disabled.
+    When enabling a workload, specify the percentage of maximum memory that the workload can consume.
+
+    This is a wrapper function for the following API: `Capacities - Patch Workload <https://learn.microsoft.com/rest/api/power-bi/capacities/patch-workload>`_.
+
+    Parameters
+    ----------
+    capacity_name : str
+        The capacity name.
+    workload_name : str
+        The workload name.
+    state : str, default=None
+        The capacity workload state.
+    max_memory_percentage : int, default=None
+        The percentage of the maximum memory that a workload can consume (set by the user).
+    """
+
+    from sempy_labs._helper_functions import resolve_capacity_id
+
+    capacity_id = resolve_capacity_id(capacity_name=capacity_name)
+
+    states = ["Disabled", "Enabled", "Unsupported"]
+    state = state.capitalize()
+    if state is not None and state not in states:
+        raise ValueError(
+            f"{icons.red_dot} Invalid 'state' parameter. Please choose from these options: {states}."
+        )
+    if max_memory_percentage is not None and (
+        max_memory_percentage < 0 or max_memory_percentage > 100
+    ):
+        raise ValueError(
+            f"{icons.red_dot} Invalid max memory percentage. Must be a value between 0-100."
+        )
+
+    client = fabric.PowerBIRestClient()
+    url = f"/v1.0/myorg/capacities/{capacity_id}/Workloads/{workload_name}"
+    get_response = client.get(url)
+    if get_response.status_code != 200:
+        raise FabricHTTPException(get_response)
+
+    get_json = get_response.json().get("value")
+    current_state = get_json.get("state")
+    current_max_memory = get_json.get("maxMemoryPercentageSetByUser")
+
+    if current_state == state and str(current_max_memory) == str(max_memory_percentage):
+        print(
+            f"{icons.info} The current workload settings are the same as those specified in the parameters of this function. The workload has not been updated."
+        )
+        return
+
+    payload = {}
+    if state is not None:
+        payload["state"] = state
+    else:
+        payload["state"] = current_state
+    if max_memory_percentage is not None:
+        payload["maxMemoryPercentageSetByUser"] = max_memory_percentage
+    else:
+        payload["maxMemoryPercentageSetByUser"] = current_max_memory
+
+    response = client.patch(url, json=payload)
+
+    if response.status_code != 200:
+        raise FabricHTTPException(response)
+
+    print(
+        f"The '{workload_name}' workload within the '{capacity_name}' capacity has been updated accordingly."
+    )

sempy_labs/_workspace_identity.py

@@ -12,6 +12,8 @@ def provision_workspace_identity(workspace: Optional[str] = None):
     """
     Provisions a workspace identity for a workspace.
 
+    This is a wrapper function for the following API: `Workspaces - Provision Identity <https://learn.microsoft.com/rest/api/fabric/core/workspaces/provision-identity`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -20,8 +22,6 @@ def provision_workspace_identity(workspace: Optional[str] = None):
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/workspaces/provision-identity?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     client = fabric.FabricRestClient()
@@ -41,6 +41,8 @@ def deprovision_workspace_identity(workspace: Optional[str] = None):
     """
     Deprovisions a workspace identity for a workspace.
 
+    This is a wrapper function for the following API: `Workspaces - Derovision Identity <https://learn.microsoft.com/rest/api/fabric/core/workspaces/deprovision-identity`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -49,8 +51,6 @@ def deprovision_workspace_identity(workspace: Optional[str] = None):
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/workspaces/deprovision-identity?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     client = fabric.FabricRestClient()

sempy_labs/_workspaces.py

@@ -14,6 +14,8 @@ def delete_user_from_workspace(email_address: str, workspace: Optional[str] = No
     """
     Removes a user from a workspace.
 
+    This is a wrapper function for the following API: `Groups - Delete User In Group <https://learn.microsoft.com/rest/api/power-bi/groups/delete-user-in-group`_.
+
     Parameters
     ----------
     email_address : str
@@ -45,6 +47,8 @@ def update_workspace_user(
     """
     Updates a user's role within a workspace.
 
+    This is a wrapper function for the following API: `Groups - Update Group User <https://learn.microsoft.com/rest/api/power-bi/groups/update-group-user`_.
+
     Parameters
     ----------
     email_address : str
@@ -95,6 +99,8 @@ def list_workspace_users(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     A list of all the users of a workspace and their roles.
 
+    This is a wrapper function for the following API: `Workspaces - List Workspace Role Assignments <https://learn.microsoft.com/rest/api/fabric/core/workspaces/list-workspace-role-assignments`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -142,6 +148,8 @@ def add_user_to_workspace(
     """
     Adds a user to a workspace.
 
+    This is a wrapper function for the following API: `Groups - Add Group User <https://learn.microsoft.com/rest/api/power-bi/groups/add-group-user`_.
+
     Parameters
     ----------
     email_address : str
@@ -196,6 +204,8 @@ def assign_workspace_to_capacity(capacity_name: str, workspace: Optional[str] =
     """
     Assigns a workspace to a capacity.
 
+    This is a wrapper function for the following API: `Workspaces - Assign To Capacity <https://learn.microsoft.com/rest/api/fabric/core/workspaces/assign-to-capacity`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -228,6 +238,8 @@ def unassign_workspace_from_capacity(workspace: Optional[str] = None):
     """
     Unassigns a workspace from its assigned capacity.
 
+    This is a wrapper function for the following API: `Workspaces - Unassign From Capacity <https://learn.microsoft.com/rest/api/fabric/core/workspaces/unassign-from-capacity`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -236,7 +248,6 @@ def unassign_workspace_from_capacity(workspace: Optional[str] = None):
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/workspaces/unassign-from-capacity?tabs=HTTP
     (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
 
     client = fabric.FabricRestClient()
@@ -253,6 +264,8 @@ def list_workspace_role_assignments(workspace: Optional[str] = None) -> pd.DataF
     """
     Shows the members of a given workspace.
 
+    This is a wrapper function for the following API: `Workspaces - List Workspace Role Assignments <https://learn.microsoft.com/rest/api/fabric/core/workspaces/list-workspace-role-assignments`_.
+
     Parameters
     ----------
     workspace : str, default=None

sempy_labs/admin/_basic_functions.py

@@ -1,5 +1,5 @@
 import sempy.fabric as fabric
-from typing import Optional, List, Union
+from typing import Optional, List, Union, Tuple
 from uuid import UUID
 import sempy_labs._icons as icons
 from sempy.fabric.exceptions import FabricHTTPException
@@ -10,18 +10,26 @@ from sempy_labs._helper_functions import (
 import numpy as np
 import pandas as pd
 import time
+import urllib.parse
+from datetime import datetime
 
 
 def list_workspaces(
-    top: Optional[int] = 5000, skip: Optional[int] = None
+    top: Optional[int] = 5000,
+    filter: Optional[str] = None,
+    skip: Optional[int] = None,
 ) -> pd.DataFrame:
     """
     Lists workspaces for the organization. This function is the admin version of list_workspaces.
 
+    This is a wrapper function for the following API: `Admin - Groups GetGroupsAsAdmin <https://learn.microsoft.com/rest/api/power-bi/admin/groups-get-groups-as-admin>`_.
+
     Parameters
     ----------
     top : int, default=5000
         Returns only the first n results. This parameter is mandatory and must be in the range of 1-5000.
+    filter : str, default=None
+        Returns a subset of a results based on `Odata filter <https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html#sec_SystemQueryOptions>`_ query parameter condition.
     skip : int, default=None
         Skips the first n results. Use with top to fetch results beyond the first 5000.
 
@@ -48,6 +56,8 @@ def list_workspaces(
     url = f"/v1.0/myorg/admin/groups?$top={top}"
     if skip is not None:
         url = f"{url}&$skip={skip}"
+    if filter is not None:
+        url = f"{url}&$filter={filter}"
 
     client = fabric.PowerBIRestClient()
     response = client.get(url)
@@ -91,6 +101,8 @@ def assign_workspaces_to_capacity(
     """
     Assigns a workspace to a capacity. This function is the admin version.
 
+    This is a wrapper function for the following API: `Admin - Capacities AssignWorkspacesToCapacity <https://learn.microsoft.com/rest/api/power-bi/admin/capacities-assign-workspaces-to-capacity>`_.
+
     Parameters
     ----------
     source_capacity : str
@@ -113,9 +125,6 @@ def assign_workspaces_to_capacity(
     target_capacity_id = dfC_filt["Capacity Id"].iloc[0]
 
     if workspace is None:
-        # workspaces = fabric.list_workspaces(
-        #    filter=f"capacityId eq '{source_capacity_id.upper()}'"
-        # )["Id"].values
         dfW = list_workspaces()
         dfW = dfW[dfW["Capacity Id"].str.upper() == source_capacity_id.upper()]
         workspaces = dfW["Id"].tolist()
@@ -153,6 +162,8 @@ def list_capacities() -> pd.DataFrame:
     """
     Shows the a list of capacities and their properties. This function is the admin version.
 
+    This is a wrapper function for the following API: `Admin - Get Capacities As Admin <https://learn.microsoft.com/rest/api/power-bi/admin/get-capacities-as-admin>`_.
+
     Returns
     -------
     pandas.DataFrame
@@ -189,14 +200,14 @@ def list_tenant_settings() -> pd.DataFrame:
     """
     Lists all tenant settings.
 
+    This is a wrapper function for the following API: `Tenants - List Tenant Settings <https://learn.microsoft.com/rest/api/fabric/admin/tenants/list-tenant-settings>`_.
+
     Returns
     -------
     pandas.DataFrame
         A pandas dataframe showing the tenant settings.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/tenants/list-tenant-settings?tabs=HTTP
-
     client = fabric.FabricRestClient()
     response = client.get("/v1/admin/tenantsettings")
 
@@ -262,7 +273,9 @@ def _list_capacities_meta() -> pd.DataFrame:
 
 def unassign_workspaces_from_capacity(workspaces: str | List[str]):
     """
-    Unassigns workspace(s) from their capacity. This function is the admin version of list_workspaces.
+    Unassigns workspace(s) from their capacity.
+
+    This is a wrapper function for the following API: `Admin - Capacities UnassignWorkspacesFromCapacity <https://learn.microsoft.com/rest/api/power-bi/admin/capacities-unassign-workspaces-from-capacity>`_.
 
     Parameters
     ----------
@@ -270,8 +283,6 @@ def unassign_workspaces_from_capacity(workspaces: str | List[str]):
         The Fabric workspace name(s).
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/power-bi/admin/capacities-unassign-workspaces-from-capacity
-
     if isinstance(workspaces, str):
         workspaces = [workspaces]
 
@@ -293,14 +304,14 @@ def list_external_data_shares():
     """
     Lists external data shares in the tenant. This function is for admins.
 
+    This is a wrapper function for the following API: `External Data Shares - List External Data Shares <https://learn.microsoft.com/rest/api/fabric/admin/external-data-shares/list-external-data-shares>`_.
+
     Returns
     -------
     pandas.DataFrame
         A pandas dataframe showing a list of external data shares in the tenant.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/external-data-shares/list-external-data-shares?tabs=HTTP
-
     df = pd.DataFrame(
         columns=[
             "External Data Share Id",
@@ -355,6 +366,8 @@ def revoke_external_data_share(
     """
     Revokes the specified external data share. Note: This action cannot be undone.
 
+    This is a wrapper function for the following API: `External Data Shares - Revoke External Data Share <https://learn.microsoft.com/rest/api/fabric/admin/external-data-shares/revoke-external-data-share`_.
+
     Parameters
     ----------
     external_data_share_id : UUID
@@ -365,8 +378,6 @@ def revoke_external_data_share(
         The Fabric workspace name.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/external-data-shares/revoke-external-data-share?tabs=HTTP
-
     (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
 
     client = fabric.FabricRestClient()
@@ -384,23 +395,23 @@ def revoke_external_data_share(
 
 def list_capacities_delegated_tenant_settings(
     return_dataframe: bool = True,
-) -> Optional[pd.DataFrame | dict]:
+) -> pd.DataFrame | dict:
     """
     Returns list of tenant setting overrides that override at the capacities.
 
+    This is a wrapper function for the following API: `Tenants - List Capacities Tenant Settings Overrides <https://learn.microsoft.com/rest/api/fabric/admin/tenants/list-capacities-tenant-settings-overrides`_.
+
     Parameters
     ----------
     return_dataframe : bool, default=True
-        If True, returns a dataframe. If False, returns a dictionary
+        If True, returns a dataframe. If False, returns a dictionary.
 
     Returns
     -------
-    pandas.DataFrame
+    pandas.DataFrame | dict
         A pandas dataframe showing a list of tenant setting overrides that override at the capacities.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/tenants/list-capacities-tenant-settings-overrides?tabs=HTTP
-
     df = pd.DataFrame(
         columns=[
             "Capacity Id",
@@ -519,14 +530,14 @@ def list_datasets() -> pd.DataFrame:
     """
     Shows a list of datasets for the organization.
 
+    This is a wrapper function for the following API: `Admin - Datasets GetDatasetsAsAdmin <https://learn.microsoft.com/rest/api/power-bi/admin/datasets-get-datasets-as-admin`_.
+
     Returns
     -------
     pandas.DataFrame
         A pandas dataframe showing a list of datasets for the organization.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/power-bi/admin/datasets-get-datasets-as-admin
-
     df = pd.DataFrame(
         columns=[
             "Dataset Id",
@@ -609,6 +620,8 @@ def list_item_access_details(
     """
     Returns a list of users (including groups and service principals) and lists their workspace roles.
 
+    This is a wrapper function for the following API: `Items - List Item Access Details <https://learn.microsoft.com/rest/api/fabric/admin/items/list-item-access-details`_.
+
     Parameters
     ----------
     item_name : str
@@ -626,13 +639,8 @@ def list_item_access_details(
         A pandas dataframe showing a list of users (including groups and service principals) and lists their workspace roles.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/items/list-item-access-details?tabs=HTTP
-
-    workspace = fabric.resolve_workspace_name(workspace)
-    workspace_id = fabric.resolve_workspace_id(workspace)
-    item_id = fabric.resolve_item_id(
-        item_name=item_name, type=type, workspace=workspace
-    )
+    workspace_name, workspace_id = _resolve_workspace_name_and_id(workspace)
+    item_id = _resolve_item_id(item_name=item_name, type=type, workspace=workspace_name)
 
     df = pd.DataFrame(
         columns=[
@@ -678,7 +686,9 @@ def list_access_entities(
     user_email_address: str,
 ) -> pd.DataFrame:
     """
-    Shows a list of permission details for Fabric and PowerBI items the specified user can access.
+    Shows a list of permission details for Fabric and Power BI items the specified user can access.
+
+    This is a wrapper function for the following API: `Users - List Access Entities <https://learn.microsoft.com/rest/api/fabric/admin/users/list-access-entities`_.
 
     Parameters
     ----------
@@ -688,11 +698,9 @@ def list_access_entities(
     Returns
     -------
     pandas.DataFrame
-        A pandas dataframe showing a list of permission details for Fabric and PowerBI items the specified user can access.
+        A pandas dataframe showing a list of permission details for Fabric and Power BI items the specified user can access.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/users/list-access-entities?tabs=HTTP
-
     df = pd.DataFrame(
         columns=[
             "Item Id",
@@ -732,6 +740,8 @@ def list_workspace_access_details(
     """
     Shows a list of users (including groups and Service Principals) that have access to the specified workspace.
 
+    This is a wrapper function for the following API: `Workspaces - List Workspace Access Details <https://learn.microsoft.com/rest/api/fabric/admin/workspaces/list-workspace-access-details`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -745,10 +755,7 @@ def list_workspace_access_details(
         A pandas dataframe showing a list of users (including groups and Service Principals) that have access to the specified workspace.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/workspaces/list-workspace-access-details?tabs=HTTP
-
-    workspace_name = fabric.resolve_workspace_name(workspace)
-    workspace_id = fabric.resolve_workspace_id(workspace_name)
+    workspace_name, workspace_id = _resolve_workspace_name_and_id(workspace)
 
     df = pd.DataFrame(
         columns=[
@@ -779,6 +786,32 @@ def list_workspace_access_details(
     return df
 
 
+def _resolve_item_id(
+    item_name: str, type: str, workspace: Optional[str] = None
+) -> UUID:
+
+    workspace_name, workspace_id = _resolve_workspace_name_and_id(workspace)
+    dfI = list_items(workspace=workspace_name, type=type)
+    dfI_filt = dfI[dfI["Item Name"] == item_name]
+
+    if len(dfI_filt) == 0:
+        raise ValueError(
+            f"The '{item_name}' {type} does not exist within the '{workspace_name}' workspace."
+        )
+
+    return dfI_filt["Item Id"].iloc[0]
+
+
+def _resolve_workspace_name_and_id(workspace: str) -> Tuple[str, UUID]:
+
+    filter_condition = urllib.parse.quote(workspace)
+    dfW_filt = list_workspaces(filter=f"name eq '{filter_condition}'")
+    workspace_name = dfW_filt["Name"].iloc[0]
+    workspace_id = dfW_filt["Id"].iloc[0]
+
+    return workspace_name, workspace_id
+
+
 def list_items(
     capacity_name: Optional[str] = None,
     workspace: Optional[str] = None,
@@ -786,7 +819,9 @@ def list_items(
     type: Optional[str] = None,
 ) -> pd.DataFrame:
     """
-    Shows a list of active Fabric and PowerBI items.
+    Shows a list of active Fabric and Power BI items.
+
+    This is a wrapper function for the following API: `Items - List Items <https://learn.microsoft.com/rest/api/fabric/admin/items/list-items`_.
 
     Parameters
     ----------
@@ -807,8 +842,6 @@ def list_items(
         A pandas dataframe showing a list of active Fabric and Power BI items.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/admin/items/list-items?tabs=HTTP
-
     url = "/v1/admin/items?"
 
     df = pd.DataFrame(
@@ -829,8 +862,7 @@ def list_items(
     )
 
     if workspace is not None:
-        workspace = fabric.resolve_workspace_name(workspace)
-        workspace_id = fabric.resolve_workspace_id(workspace)
+        workspace_name, workspace_id = _resolve_workspace_name_and_id(workspace)
         url += f"workspaceId={workspace_id}&"
     if capacity_name is not None:
         dfC = list_capacities()
@@ -891,6 +923,8 @@ def list_activity_events(
     """
     Shows a list of audit activity events for a tenant.
 
+    This is a wrapper function for the following API: `Admin - Get Activity Events <https://learn.microsoft.com/rest/api/power-bi/admin/get-activity-events`_.
+
     Parameters
     ----------
     start_time : str
@@ -908,7 +942,13 @@ def list_activity_events(
         A pandas dataframe showing a list of audit activity events for a tenant.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/power-bi/admin/get-activity-events
+    start_dt = datetime.strptime(start_time, "%Y-%m-%dT%H:%M:%S")
+    end_dt = datetime.strptime(end_time, "%Y-%m-%dT%H:%M:%S")
+
+    if not start_dt.date() == end_dt.date():
+        raise ValueError(
+            f"{icons.red_dot} Start and End Times must be within the same UTC day. Please refer to the documentation here: https://learn.microsoft.com/rest/api/power-bi/admin/get-activity-events#get-audit-activity-events-within-a-time-window-and-for-a-specific-activity-type-and-user-id-example"
+        )
 
     df = pd.DataFrame(
         columns=[
@@ -948,7 +988,7 @@ def list_activity_events(
         conditions.append(f"UserId{space}eq{space}{tic}{user_id_filter}{tic}")
 
     filter_value = (
-        f"&filter={f'{space}and{space}'.join(conditions)}" if conditions else ""
+        f"&$filter={f'{space}and{space}'.join(conditions)}" if conditions else ""
     )
 
     full_url = f"{base_url}?startDateTime={tic}{start_time}{tic}&endDateTime={tic}{end_time}{tic}{filter_value}"
@@ -988,4 +1028,6 @@ def list_activity_events(
                 ignore_index=True,
             )
 
+    df["Creation Time"] = pd.to_datetime(df["Creation Time"])
+
     return df