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

sempy_labs/_capacities.py

@@ -37,6 +37,8 @@ def create_fabric_capacity(
     """
     This function creates a new Fabric capacity within an Azure subscription.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Create Or Update <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/create-or-update?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -253,6 +255,8 @@ def suspend_fabric_capacity(
     """
     This function suspends a Fabric capacity.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Suspend <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/suspend?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -286,7 +290,7 @@ def suspend_fabric_capacity(
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been suspended.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been suspended.")
 
 
 def resume_fabric_capacity(
@@ -301,6 +305,8 @@ def resume_fabric_capacity(
     """
     This function resumes a Fabric capacity.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Resume <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/resume?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -335,7 +341,7 @@ def resume_fabric_capacity(
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been resumed.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been resumed.")
 
 
 def delete_embedded_capacity(
@@ -384,7 +390,7 @@ def delete_embedded_capacity(
     if response.status_code not in [200, 202]:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been deleted.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been deleted.")
 
 
 def delete_premium_capacity(capacity_name: str):
@@ -427,6 +433,8 @@ def delete_fabric_capacity(
     """
     This function deletes a Fabric capacity.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Delete <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/delete?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -461,7 +469,7 @@ def delete_fabric_capacity(
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
-    print(f"{icons.green_dot} The '{capacity_name} capacity has been deleted.")
+    print(f"{icons.green_dot} The '{capacity_name}' capacity has been deleted.")
 
 
 def update_fabric_capacity(
@@ -479,6 +487,8 @@ def update_fabric_capacity(
     """
     This function updates a Fabric capacity's properties.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Update <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/update?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -521,26 +531,47 @@ def update_fabric_capacity(
 
     url = f"https://management.azure.com/subscriptions/{azure_subscription_id}/resourceGroups/{resource_group}/providers/Microsoft.Fabric/capacities/{capacity_name}?api-version={icons.azure_api_version}"
 
+    get_response = requests.get(url, headers=headers)
+    if get_response.status_code != 200:
+        raise FabricHTTPException(get_response)
+
+    get_json = get_response.json()
+    current_sku = get_json.get("sku", {}).get("name")
+    current_admins = (
+        get_json.get("properties", {}).get("administration", {}).get("members")
+    )
+    current_tags = get_json.get("tags")
+
     payload = {}
+    payload["sku"] = {
+        "name": current_sku,
+        "tier": "Fabric",
+    }
+    payload["tags"] = current_tags
+    payload["properties"] = get_json["properties"]
+
     if sku is not None:
-        payload["sku"] = {"name": sku, "tier": "Fabric"}
+        payload["sku"]["name"] = sku
     if admin_members is not None:
-        payload["properties"] = {"administration": {"members": [admin_members]}}
-
-    payload = _add_sll_tag(payload, tags)
+        payload["properties"] = {"administration": {"members": admin_members}}
+    if tags is not None:
+        payload["tags"] = tags
 
-    if payload == {}:
-        raise ValueError(
-            f"{icons.warning} No parameters have been set to update the '{capacity_name}' capacity."
+    # Do not proceed if no properties are being changed
+    if current_sku == sku and current_admins == admin_members and current_tags == tags:
+        print(
+            f"{icons.yellow_dot} The properties of the '{capacity_name}' are the same as those specified in the parameters of this function. No changes have been made."
         )
+        return
 
-    response = requests.patch(url, headers=headers, data=payload)
+    payload = _add_sll_tag(payload, tags)
+    response = requests.patch(url, headers=headers, json=payload)
 
     if response.status_code != 202:
         raise FabricHTTPException(response)
 
     print(
-        f"{icons.green_dot} The '{capacity_name} capacity has been updated accordingly."
+        f"{icons.green_dot} The '{capacity_name}' capacity has been updated accordingly."
     )
 
 
@@ -556,6 +587,8 @@ def check_fabric_capacity_name_availablility(
     """
     This function updates a Fabric capacity's properties.
 
+    This is a wrapper function for the following API: `Fabric Capacities - Check Name Availability <https://learn.microsoft.com/rest/api/microsoftfabric/fabric-capacities/check-name-availability?view=rest-microsoftfabric-2023-11-01>`_.
+
     Parameters
     ----------
     capacity_name : str
@@ -611,6 +644,8 @@ def create_resource_group(
     """
     This function creates a resource group in a region within an Azure subscription.
 
+    This is a wrapper function for the following API: `ResourceGroupsOperations Class - CreateOrUpdate <https://learn.microsoft.com/python/api/azure-mgmt-resource/azure.mgmt.resource.resources.v2022_09_01.operations.resourcegroupsoperations?view=azure-python#azure-mgmt-resource-resources-v2022-09-01-operations-resourcegroupsoperations-create-or-update>`_.
+
     Parameters
     ----------
     azure_subscription_id : str
@@ -631,7 +666,7 @@ def create_resource_group(
 
     from azure.mgmt.resource import ResourceManagementClient
 
-    azure_token, credential, headers = get_azure_token_credentials(
+    azure_token, credential, headers = _get_azure_token_credentials(
         key_vault_uri=key_vault_uri,
         key_vault_tenant_id=key_vault_tenant_id,
         key_vault_client_id=key_vault_client_id,

sempy_labs/_capacity_migration.py

@@ -632,7 +632,6 @@ def migrate_fabric_trial_capacity(
     source_capacity: str,
     target_capacity: str,
     target_capacity_sku: str = "F64",
-    target_capacity_region: Optional[str] = None,
     target_capacity_admin_members: Optional[str | List[str]] = None,
 ):
     """
@@ -658,9 +657,6 @@ def migrate_fabric_trial_capacity(
         The name of the new Fabric capacity (F SKU). If this capacity does not exist, it will be created.
     target_capacity_sku : str, default="F64"
         If the target capacity does not exist, this property sets the SKU size for the target capacity.
-    target_capacity_region : str, default=None
-        If the target capacity does not exist, this property sets the region for the target capacity.
-        Defaults to None which resolves to the region in which the Trial SKU exists.
     target_capacity_admin_members : str, default=None
         If the target capacity does not exist, this property sets the admin members for the target capacity.
         Defaults to None which resolves to the admin members on the Trial SKU.
@@ -691,9 +687,7 @@ def migrate_fabric_trial_capacity(
         )
         return
 
-    # Use same region as source capacity if no region is specified
-    if target_capacity_region is None:
-        target_capacity_region = dfC_filt["Region"].iloc[0]
+    target_capacity_region = dfC_filt["Region"].iloc[0]
 
     # Use same admins as source capacity
     if isinstance(target_capacity_admin_members, str):

sempy_labs/_data_pipelines.py

@@ -15,6 +15,8 @@ def list_data_pipelines(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the data pipelines within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Data Pipelines <https://learn.microsoft.com/rest/api/fabric/datapipeline/items/list-data-pipelines`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -57,6 +59,8 @@ def create_data_pipeline(
     """
     Creates a Fabric data pipeline.
 
+    This is a wrapper function for the following API: `Items - Create Data Pipeline <https://learn.microsoft.com/rest/api/fabric/datapipeline/items/create-data-pipeline`_.
+
     Parameters
     ----------
     name: str
@@ -92,6 +96,8 @@ def delete_data_pipeline(name: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric data pipeline.
 
+    This is a wrapper function for the following API: `Items - Delete Data Pipeline <https://learn.microsoft.com/rest/api/fabric/datapipeline/items/delete-data-pipeline`_.
+
     Parameters
     ----------
     name: str

sempy_labs/_dataflows.py

@@ -59,6 +59,8 @@ def assign_workspace_to_dataflow_storage(
     """
     Assigns a dataflow storage account to a workspace.
 
+    This is a wrapper function for the following API: `Dataflow Storage Accounts - Groups AssignToDataflowStorage <https://learn.microsoft.com/rest/api/power-bi/dataflow-storage-accounts/groups-assign-to-dataflow-storage`_.
+
     Parameters
     ----------
     dataflow_storage_account : str
@@ -99,6 +101,8 @@ def list_dataflow_storage_accounts() -> pd.DataFrame:
     """
     Shows the accessible dataflow storage accounts.
 
+    This is a wrapper function for the following API: `Dataflow Storage Accounts - Get Dataflow Storage Accounts <https://learn.microsoft.com/rest/api/power-bi/dataflow-storage-accounts/get-dataflow-storage-accounts`_.
+
     Returns
     -------
     pandas.DataFrame

sempy_labs/_deployment_pipelines.py

@@ -11,6 +11,8 @@ def list_deployment_pipelines() -> pd.DataFrame:
     """
     Shows a list of deployment pipelines the user can access.
 
+    This is a wrapper function for the following API: `Deployment Pipelines - List Deployment Pipelines <https://learn.microsoft.com/rest/api/fabric/core/deployment-pipelines/list-deployment-pipelines`_.
+
     Returns
     -------
     pandas.DataFrame
@@ -45,6 +47,8 @@ def list_deployment_pipeline_stages(deployment_pipeline: str) -> pd.DataFrame:
     """
     Shows the specified deployment pipeline stages.
 
+    This is a wrapper function for the following API: `Deployment Pipelines - List Deployment Pipeline Stages <https://learn.microsoft.com/rest/api/fabric/core/deployment-pipelines/list-deployment-pipeline-stages`_.
+
     Parameters
     ----------
     deployment_pipeline : str
@@ -84,13 +88,13 @@ def list_deployment_pipeline_stages(deployment_pipeline: str) -> pd.DataFrame:
     for r in responses:
         for v in r.get("value", []):
             new_data = {
-                "Deployment Pipeline Stage Id": v["id"],
-                "Deployment Pipeline Stage Name": v["displayName"],
-                "Description": v["description"],
-                "Order": v["order"],
-                "Workspace Id": v["workspaceId"],
-                "Workspace Name": v["workspaceName"],
-                "Public": v["isPublic"],
+                "Deployment Pipeline Stage Id": v.get("id"),
+                "Deployment Pipeline Stage Name": v.get("displayName"),
+                "Description": v.get("description"),
+                "Order": v.get("order"),
+                "Workspace Id": v.get("workspaceId"),
+                "Workspace Name": v.get("workspaceName"),
+                "Public": v.get("isPublic"),
             }
             df = pd.concat([df, pd.DataFrame(new_data, index=[0])], ignore_index=True)
 
@@ -106,6 +110,8 @@ def list_deployment_pipeline_stage_items(
     """
     Shows the supported items from the workspace assigned to the specified stage of the specified deployment pipeline.
 
+    This is a wrapper function for the following API: `Deployment Pipelines - List Deployment Pipeline Stage Items <https://learn.microsoft.com/rest/api/fabric/core/deployment-pipelines/list-deployment-pipeline-stage-items`_.
+
     Parameters
     ----------
     deployment_pipeline : str

sempy_labs/_environments.py

@@ -16,6 +16,8 @@ def create_environment(
     """
     Creates a Fabric environment.
 
+    This is a wrapper function for the following API: `Items - Create Environment <https://learn.microsoft.com/rest/api/fabric/environment/items/create-environment`_.
+
     Parameters
     ----------
     environment: str
@@ -51,6 +53,8 @@ def list_environments(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the environments within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Environments <https://learn.microsoft.com/rest/api/fabric/environment/items/list-environments`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -91,6 +95,8 @@ def delete_environment(environment: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric environment.
 
+    This is a wrapper function for the following API: `Items - Delete Environment <https://learn.microsoft.com/rest/api/fabric/environment/items/delete-environment`_.
+
     Parameters
     ----------
     environment: str

sempy_labs/_eventhouses.py

@@ -16,6 +16,8 @@ def create_eventhouse(
     """
     Creates a Fabric eventhouse.
 
+    This is a wrapper function for the following API: `Items - Create Eventhouse <https://learn.microsoft.com/rest/api/fabric/environment/items/create-eventhouse`_.
+
     Parameters
     ----------
     name: str
@@ -51,6 +53,8 @@ def list_eventhouses(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the eventhouses within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Eventhouses <https://learn.microsoft.com/rest/api/fabric/environment/items/list-eventhouses`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -91,6 +95,8 @@ def delete_eventhouse(name: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric eventhouse.
 
+    This is a wrapper function for the following API: `Items - Delete Eventhouse <https://learn.microsoft.com/rest/api/fabric/environment/items/delete-eventhouse`_.
+
     Parameters
     ----------
     name: str

sempy_labs/_eventstreams.py

@@ -14,6 +14,8 @@ def list_eventstreams(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Shows the eventstreams within a workspace.
 
+    This is a wrapper function for the following API: `Items - List Eventstreams <https://learn.microsoft.com/rest/api/fabric/environment/items/list-eventstreams`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -56,6 +58,8 @@ def create_eventstream(
     """
     Creates a Fabric eventstream.
 
+    This is a wrapper function for the following API: `Items - Create Eventstream <https://learn.microsoft.com/rest/api/fabric/environment/items/create-eventstream`_.
+
     Parameters
     ----------
     name: str
@@ -91,6 +95,8 @@ def delete_eventstream(name: str, workspace: Optional[str] = None):
     """
     Deletes a Fabric eventstream.
 
+    This is a wrapper function for the following API: `Items - Delete Eventstream <https://learn.microsoft.com/rest/api/fabric/environment/items/delete-eventstream`_.
+
     Parameters
     ----------
     name: str

sempy_labs/_external_data_shares.py

@@ -20,6 +20,8 @@ def create_external_data_share(
     """
     Creates an external data share for a given path or list of paths in the specified item.
 
+    This is a wrapper function for the following API: `External Data Shares - Create External Data Share <https://learn.microsoft.com/rest/api/fabric/core/external-data-shares/create-external-data-share`_.
+
     Parameters
     ----------
     item_name : str
@@ -71,6 +73,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/core/external-data-shares/revoke-external-data-share`_.
+
     Parameters
     ----------
     external_data_share_id : UUID
@@ -85,8 +89,6 @@ def revoke_external_data_share(
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/external-data-shares/revoke-external-data-share?tabs=HTTP
-
     (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
     item_id = fabric.resolve_item_id(
         item_name=item_name, type=item_type, workspace=workspace
@@ -111,6 +113,8 @@ def list_external_data_shares_in_item(
     """
     Returns a list of the external data shares that exist for the specified item.
 
+    This is a wrapper function for the following API: `External Data Shares - List External Data Shares In Item <https://learn.microsoft.com/rest/api/fabric/core/external-data-shares/list-external-data-shares-in-item`_.
+
     Parameters
     ----------
     item_name : str
@@ -128,8 +132,6 @@ def list_external_data_shares_in_item(
         A pandas dataframe showing a list of the external data shares that exist for the specified item.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/external-data-shares/list-external-data-shares-in-item?tabs=HTTP
-
     (workspace, workspace_id) = resolve_workspace_name_and_id(workspace)
     item_id = fabric.resolve_item_id(
         item_name=item_name, type=item_type, workspace=workspace

sempy_labs/_generate_semantic_model.py

@@ -64,11 +64,28 @@ def create_blank_semantic_model(
             "name": '{dataset}',
             "compatibilityLevel": {compatibility_level},
             "model": {{
-            "culture": "en-US",
-            "defaultPowerBIDataSourceVersion": "powerBI_V3"
+                "cultures": [
+                    {{
+                        "name": "en-US",
+                        "linguisticMetadata": {{
+                            "content": {{
+                                "Version": "1.0.0",
+                                "Language": "en-US"
+                            }},
+                            "contentType": "json"
+                        }}
+                    }}
+                ],
+                "collation": "Latin1_General_100_BIN2_UTF8",
+                "dataAccessOptions": {{
+                    "legacyRedirects": true,
+                    "returnErrorValuesAsNull": true,
+                }},
+                "defaultPowerBIDataSourceVersion": "powerBI_V3",
+                "sourceQueryCulture": "en-US",
+                }}
             }}
         }}
-        }}
     }}
     """
 
@@ -85,6 +102,8 @@ def create_semantic_model_from_bim(
     """
     Creates a new semantic model based on a Model.bim file.
 
+    This is a wrapper function for the following API: `Items - Create Semantic Model <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/create-semantic-model`_.
+
     Parameters
     ----------
     dataset : str
@@ -149,6 +168,8 @@ def update_semantic_model_from_bim(
     """
     Updates a semantic model definition based on a Model.bim file.
 
+    This is a wrapper function for the following API: `Items - Update Semantic Model Definition <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/update-semantic-model-definition`_.
+
     Parameters
     ----------
     dataset : str
@@ -287,6 +308,8 @@ def get_semantic_model_bim(
     """
     Extracts the Model.bim file for a given semantic model.
 
+    This is a wrapper function for the following API: `Items - Get Semantic Model Definition <https://learn.microsoft.com/rest/api/fabric/semanticmodel/items/get-semantic-model-definition`_.
+
     Parameters
     ----------
     dataset : str

sempy_labs/_git.py

@@ -21,6 +21,8 @@ def connect_workspace_to_git(
     """
     Connects a workspace to a git repository.
 
+    This is a wrapper function for the following API: `Git - Connect <https://learn.microsoft.com/rest/api/fabric/core/git/connect`_.
+
     Parameters
     ----------
     organization_name : str
@@ -41,8 +43,6 @@ def connect_workspace_to_git(
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/git/connect?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     request_body = {
@@ -72,6 +72,8 @@ def disconnect_workspace_from_git(workspace: Optional[str] = None):
     """
     Disconnects a workpsace from a git repository.
 
+    This is a wrapper function for the following API: `Git - Disconnect <https://learn.microsoft.com/rest/api/fabric/core/git/disconnect`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -80,8 +82,6 @@ def disconnect_workspace_from_git(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/git/disconnect?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     client = fabric.FabricRestClient()
@@ -98,6 +98,8 @@ def get_git_status(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Obtains the Git status of items in the workspace, that can be committed to Git.
 
+    This is a wrapper function for the following API: `Git - Get Status <https://learn.microsoft.com/rest/api/fabric/core/git/get-status`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -111,8 +113,6 @@ def get_git_status(workspace: Optional[str] = None) -> pd.DataFrame:
         A pandas dataframe showing the Git status of items in the workspace.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/git/get-status?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     df = pd.DataFrame(
@@ -161,6 +161,8 @@ def get_git_connection(workspace: Optional[str] = None) -> pd.DataFrame:
     """
     Obtains the Git status of items in the workspace, that can be committed to Git.
 
+    This is a wrapper function for the following API: `Git - Get Connection <https://learn.microsoft.com/rest/api/fabric/core/git/get-connection`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -174,8 +176,6 @@ def get_git_connection(workspace: Optional[str] = None) -> pd.DataFrame:
         A pandas dataframe showing the Git status of items in the workspace.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/git/get-status?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     df = pd.DataFrame(
@@ -221,6 +221,8 @@ def initialize_git_connection(workspace: Optional[str] = None):
     """
     Initializes a connection for a workspace that is connected to Git.
 
+    This is a wrapper function for the following API: `Git - Initialize Connection <https://learn.microsoft.com/rest/api/fabric/core/git/initialize-connection`_.
+
     Parameters
     ----------
     workspace : str, default=None
@@ -229,8 +231,6 @@ def initialize_git_connection(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/git/initialize-connection?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     client = fabric.FabricRestClient()
@@ -252,6 +252,8 @@ def commit_to_git(
     """
     Commits all or a selection of items within a workspace to Git.
 
+    This is a wrapper function for the following API: `Git - Commit to Git <https://learn.microsoft.com/rest/api/fabric/core/git/commit-to-git`_.
+
     Parameters
     ----------
     comment : str
@@ -265,8 +267,6 @@ def commit_to_git(
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/git/commit-to-git?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     gs = get_git_status(workspace=workspace)
@@ -320,6 +320,8 @@ def update_from_git(
     """
     Updates the workspace with commits pushed to the connected branch.
 
+    This is a wrapper function for the following API: `Git - Update From Git <https://learn.microsoft.com/rest/api/fabric/core/git/update-from-git`_.
+
     Parameters
     ----------
     workspace_head : str
@@ -336,8 +338,6 @@ def update_from_git(
         or if no lakehouse attached, resolves to the workspace of the notebook.
     """
 
-    # https://learn.microsoft.com/en-us/rest/api/fabric/core/git/update-from-git?tabs=HTTP
-
     workspace, workspace_id = resolve_workspace_name_and_id(workspace)
 
     conflict_resolution_policies = ["PreferWorkspace", "PreferRemote"]