Merge pull request #268038 from shellyhaverkamp/dicom-datalakeGA

DICOM + Azure Data Lake GA

Author: v-dirichards

articles/healthcare-apis/.openpublishing.redirection.healthcare-apis.json

@@ -496,6 +496,11 @@
        "source_path_from_root": "/articles/healthcare-apis/dicom/dicom-change-feed-overview.md",
        "redirect_url": "/azure/healthcare-apis/dicom/change-feed-overview",
        "redirect_document_id": true   
+    },
+    {  
+       "source_path_from_root": "/articles/healthcare-apis/dicom/get-started-with-dicom.md",
+       "redirect_url": "/azure/healthcare-apis/dicom/dicom-data-lake",
+       "redirect_document_id": true   
     },     
       {
           "source_path_from_root": "/articles/healthcare-apis/fhir/configure-azure-rbac-for-fhir.md",

articles/healthcare-apis/dicom/deploy-dicom-services-in-azure-data-lake.md

@@ -10,7 +10,7 @@ ms.author: mmitrik
 ms.custom: mode-api, devx-track-arm-template
 ---
 
-# Deploy the DICOM service with Data Lake Storage (Preview)
+# Deploy the DICOM service with Azure Data Lake Storage
 
 Deploying the [DICOM® service with Azure Data Lake Storage](dicom-data-lake.md) enables organizations to store and process imaging data in a standardized, secure, and scalable way.
 
@@ -25,7 +25,7 @@ After deployment completes, you can use the Azure portal to see the details abou
 > [!NOTE]
 > The Azure Data Lake Storage option is only available for new instances of the DICOM service. After the option becomes generally available, we plan to offer a migration path for existing DICOM service instances.
 
-## Deploy the DICOM service with Data Lake Storage using the Azure portal
+## Deploy the DICOM service with Azure Data Lake Storage by using the Azure portal
 
 1. On the **Resource group** page of the Azure portal, select the name of the **Azure Health Data Services workspace**.
 
@@ -41,9 +41,9 @@ After deployment completes, you can use the Azure portal to see the details abou
 
 1. Enter a name for the DICOM service.
 
-1. Select **External (preview)** for the Storage Location.  
+1. Select **Data Lake Storage (default)** for the storage location.  
 
-    :::image type="content" source="media/deploy-data-lake/dicom-deploy-options.png" alt-text="Screenshot showing the options in the Create DICOM service view." lightbox="media/deploy-data-lake/dicom-deploy-options.png":::
+    :::image type="content" source="media/deploy-data-lake/create-dicom-service-data-lake-sml.png" alt-text="Screenshot showing the storage location option." lightbox="media/deploy-data-lake/create-dicom-service-data-lake-lrg.png":::
 
 1. Select the **subscription** and **resource group** that contains the storage account.
 

articles/healthcare-apis/dicom/deploy-dicom-services-in-azure.md

@@ -4,19 +4,19 @@ description: This article describes how to deploy the DICOM service in the Azure
 author: mmitrik
 ms.service: healthcare-apis
 ms.topic: how-to
-ms.date: 10/06/2023
+ms.date: 03/11/2024
 ms.author: mmitrik
 ms.custom: mode-api
 ---
 
-# Deploy the DICOM service
+# Deploy the DICOM service by using the Azure portal
 
 In this quickstart, you learn how to deploy the DICOM® service by using the Azure portal.
 
 After deployment completes, you can use the Azure portal to see the details about the DICOM service, including the service URL. The service URL to access your DICOM service is ```https://<workspacename-dicomservicename>.dicom.azurehealthcareapis.com```. Make sure to specify the API version as part of the URL when you make requests. For more information, see [API versioning for the DICOM service](api-versioning-dicom-service.md).
 
 > [!NOTE]
-> A public preview of the DICOM service with Data Lake Storage is now available. This capability provides greater flexibility and control over your imaging data. Learn more: [Deploy the DICOM service with Data Lake Storage (Preview)](deploy-dicom-services-in-azure-data-lake.md)
+> The DICOM service with Azure Data Lake Storage is generally available. This capability provides greater flexibility and control over your imaging data. Learn more: [Deploy the DICOM service with Azure Data Lake Storage](deploy-dicom-services-in-azure-data-lake.md)
 
 ## Prerequisites
 
@@ -26,19 +26,23 @@ To deploy the DICOM service, you need a workspace created in the Azure portal. F
 
 1. On the **Resource group** page of the Azure portal, select the name of your **Azure Health Data Services workspace**.
 
-   [![Screenshot that shows selecting a workspace resource group.](media/select-workspace-resource-group.png) ](media/select-workspace-resource-group.png#lightbox)
+:::image type="content" source="media/select-workspace-resource-group.png" alt-text="Screenshot showing selecting a workspace resource group." lightbox="media/select-workspace-resource-group.png":::
+
 
 1. Select **Deploy DICOM service**.
 
-   [![Screenshot that shows deploying the DICOM service.](media/workspace-deploy-dicom-services.png) ](media/workspace-deploy-dicom-services.png#lightbox)
+:::image type="content" source="media/workspace-deploy-dicom-services.png" alt-text="Screenshot showing deployment of the DICOM service." lightbox="media/workspace-deploy-dicom-services.png":::
+
 
 1. Select **Add DICOM service**.
 
-   [![Screenshot that shows adding the DICOM service.](media/add-dicom-service.png) ](media/add-dicom-service.png#lightbox)
+:::image type="content" source="media/add-dicom-service.png" alt-text="Screenshot showing how to add the DICOM service." lightbox="media/add-dicom-service.png":::
+
 
 1. Enter a name for the DICOM service, and then select **Review + create**.
 
-    [![Screenshot that shows the DICOM service name.](media/enter-dicom-service-name.png) ](media/enter-dicom-service-name.png#lightbox)
+:::image type="content" source="media/enter-dicom-service-name.png" alt-text="Screenshot showing the DICOM service name." lightbox="media/enter-dicom-service-name.png":::
+
 
 1. (Optional) Select **Next: Tags**.
 
@@ -48,11 +52,11 @@ To deploy the DICOM service, you need a workspace created in the Azure portal. F
 
 1. After the deployment process is finished, select **Go to resource**.
 
-   [![Screenshot that shows Go to resource.](media/go-to-resource.png) ](media/go-to-resource.png#lightbox)
+:::image type="content" source="media/go-to-resource.png" alt-text="Screenshot showing Go to resource." lightbox="media/go-to-resource.png":::
 
    The result of the newly deployed DICOM service is shown here.
 
-   [![Screenshot that shows the DICOM finished deployment.](media/results-deployed-dicom-service.png) ](media/results-deployed-dicom-service.png#lightbox)
+:::image type="content" source="media/results-deployed-dicom-service.png" alt-text="Screenshot showing the DICOM finished deployment." lightbox="media/results-deployed-dicom-service.png":::
 
 ## Next steps
 

articles/healthcare-apis/dicom/dicom-data-lake.md

@@ -1,18 +1,18 @@
 ---
-title: Azure Data Lake Storage integration for the DICOM service in Azure Health Data Services
-description: Learn how to use Azure Data Lake Storage with the DICOM service to store, access, and analyze medical imaging data in the cloud. Explore the benefits, architecture, and data contracts of this integration.
+title: Manage medical imaging data with the DICOM service and Azure Data Lake Storage
+description: Learn how to use the DICOM service in Azure Health Data Services to store, access, and analyze medical imaging data in the cloud. Explore the benefits, architecture, and data contracts of the integration of the DICOM service with Azure Data Lake Storage.
 author: mmitrik
 ms.service: healthcare-apis
 ms.subservice: dicom
 ms.topic: how-to
-ms.date: 11/21/2023
+ms.date: 03/11/2024
 ms.author: mmitrik
 ms.custom: mode-api
 ---
 
-# Azure Data Lake Storage integration for the DICOM service (Preview)
+#  Manage medical imaging data with the DICOM service and Azure Data Lake Storage
 
-The [DICOM® service](overview.md) provides cloud-scale storage for medical imaging data using the DICOMweb standard. With the integration of Azure Data Lake Storage, you gain full control of your imaging data and increased flexibility for accessing and working with that data through the Azure storage ecosystem and APIs.  
+The [DICOM® service](overview.md) provides cloud-scale storage for medical imaging data using the DICOMweb standard. The integration of the DICOM service with Azure Data Lake Storage means you gain full control of your imaging data and increased flexibility for accessing and working with that data through the Azure storage ecosystem and APIs.  
 
 By using Azure Data Lake Storage with the DICOM service, organizations are able to:
 
@@ -49,9 +49,6 @@ AHDS/{workspace-name}/dicom/{dicom-service-name}/{partition-name}
 
 In addition to DICOM data, a small file to enable [health checks](#health-check) will be written to this location.
 
-> [!NOTE]
-> During public preview, the DICOM service writes data to the storage container and reads the data, but user-added data isn't read and indexed by the DICOM service. Similarly, if DICOM data written by the DICOM service is modified or removed, it may result in errors when accessing data with the DICOMweb APIs.
-
 ## Permissions
 
 The DICOM service is granted access to the data like any other service or application accessing data in a storage account. Access can be revoked at any time without affecting your organization's ability to access the data. The DICOM service needs the ability to read, write, and delete files in the provided file system. This can be provided by granting the [Storage Blob Data Contributor](/azure/role-based-access-control/built-in-roles#storage-blob-data-contributor) role to the system-assigned or user-assigned managed identity attached to the DICOM service.
@@ -69,18 +66,17 @@ If there is an issue with access, status and details are displayed by [Azure Res
 
 ## Limitations
 
-During public preview, the DICOM service with data lake storage has these limitations:  
+The DICOM service with data lake storage has these limitations:  
 
 - [Bulk Import](import-files.md) isn't supported.
 - UPS-RS work items aren't stored in the data lake storage account.  
 - User data added to the data lake storage account isn't read and indexed by the DICOM service. It's possible that a filename collision could occur, so we recommend that you don't write data to the folder structure used by the DICOM service.
 - If DICOM data written by the DICOM service is modified or removed, errors might result when accessing data with the DICOMweb APIs.
-- Configuration of customer-managed keys isn't supported during the creation of a DICOM service when you opt to use external storage.
 - The archive access tier isn't supported. Moving data to the archive tier will result in errors when accessing data with the DICOMweb APIs.
 
 ## Next steps
 
-[Deploy the DICOM service with Azure Data Lake Storage (Preview)](deploy-dicom-services-in-azure-data-lake.md)
+[Deploy the DICOM service with Azure Data Lake Storage](deploy-dicom-services-in-azure-data-lake.md)
 
 [Get started using DICOM data in analytics workloads](get-started-with-analytics-dicom.md)
 

articles/healthcare-apis/dicom/get-started-with-analytics-dicom.md

@@ -1,6 +1,6 @@
 ---
 title: Get started using DICOM data in analytics workloads - Azure Health Data Services
-description: This article demonstrates how to use Azure Data Factory and Microsoft Fabric to perform analytics on DICOM data.
+description: Learn how to use Azure Data Factory and Microsoft Fabric to perform analytics on DICOM data.
 services: healthcare-apis
 author: mmitrik
 ms.service: healthcare-apis
@@ -21,7 +21,7 @@ Before you get started, complete these steps:
 * Create a [storage account with Azure Data Lake Storage Gen2 capabilities](../../storage/blobs/create-data-lake-storage-account.md) by enabling a hierarchical namespace:
     * Create a container to store DICOM metadata, for example, named `dicom`.
 * Deploy an instance of the [DICOM service](deploy-dicom-services-in-azure.md).
-   * (_Optional_) Deploy the [DICOM service with Data Lake Storage (Preview)](deploy-dicom-services-in-azure-data-lake.md) to enable direct access to DICOM files.
+   * (_Optional_) Deploy the [DICOM service with Data Lake Storage](deploy-dicom-services-in-azure-data-lake.md) to enable direct access to DICOM files.
 * Create a [Data Factory](../../data-factory/quickstart-create-data-factory.md) instance:
     * Enable a [system-assigned managed identity](../../data-factory/data-factory-service-identity.md).
 * Create a [lakehouse](/fabric/data-engineering/tutorial-build-lakehouse) in Fabric.
@@ -105,15 +105,15 @@ Data Factory pipelines are a collection of _activities_ that perform a task, lik
 
 1. Select **Use this template** to create the new pipeline.
 
-### Create a pipeline for DICOM data (Preview)
+### Create a pipeline for DICOM data
 
-If you created the DICOM service with Azure Data Lake Storage (Preview), you need to use a custom template to include a new `fileName` parameter in the metadata pipeline.  Instead of using the template from the template gallery, follow these steps to configure the pipeline.
+If you created the DICOM service with Azure Data Lake Storage, you need to use a custom template to include a new `fileName` parameter in the metadata pipeline.  Instead of using the template from the template gallery, follow these steps to configure the pipeline.
 
-1. Download the [preview template](https://github.com/microsoft/dicom-server/blob/main/samples/templates/Copy%20DICOM%20Metadata%20Changes%20to%20ADLS%20Gen2%20in%20Delta%20Format.zip) from GitHub. The template file is a compressed (zipped) folder. You don't need to extract the files because they're already uploaded in compressed form.  
+1. Download the [template](https://github.com/microsoft/dicom-server/blob/main/samples/templates/Copy%20DICOM%20Metadata%20Changes%20to%20ADLS%20Gen2%20in%20Delta%20Format.zip) from GitHub. The template file is a compressed (zipped) folder. You don't need to extract the files because they're already uploaded in compressed form.  
 
 1. In Azure Data Factory, select **Author** from the left menu. On the **Factory Resources** pane, select the plus sign (+) to add a new resource. Select **Pipeline** and then select **Import from pipeline template**.
 
-1. In the **Open** window, select the preview template that you downloaded. Select **Open**.
+1. In the **Open** window, select the template that you downloaded. Select **Open**.
 
 1. In the **Inputs** section, select the linked services created for the DICOM service and Azure Data Lake Storage Gen2 account.
 
@@ -259,7 +259,7 @@ If you're using a [DICOM service with Data Lake Storage](dicom-data-lake.md), yo
 
 1. Enter a **Shortcut Name** that describes the DICOM data. For example, **contoso-dicom-files**.
 
-1. Enter the **Sub Path** that matches the name of the storage container and folder used by the DICOM service. For example, if you wanted to link to the root folder the Sub Path would be **/dicom/AHDS**.  Note, the root folder will always be `AHDS`, but you can optionally link to a child folder for a specific workspace or DICOM service instance.  
+1. Enter the **Sub Path** that matches the name of the storage container and folder used by the DICOM service. For example, if you wanted to link to the root folder the Sub Path would be **/dicom/AHDS**. Note that the root folder is always `AHDS`, but you can optionally link to a child folder for a specific workspace or DICOM service instance.  
 
 1. Select **Create** to create the shortcut.
 
@@ -289,7 +289,7 @@ After a few seconds, the results of the query appear in a table underneath the c
 
 #### Access DICOM file data in notebooks
 
-If you used the preview template to create the pipeline and created a shortcut to the DICOM file data, you can use the `filePath` column in the `instance` table to correlate instance metadata to file data.  
+If you used the template to create the pipeline and created a shortcut to the DICOM file data, you can use the `filePath` column in the `instance` table to correlate instance metadata to file data.  
 
 ``` SQL
 SELECT sopInstanceUid, filePath from instance
@@ -308,8 +308,6 @@ In this article, you learned how to:
 
 ## Next steps
 
-Learn more about Data Factory pipelines:
-
 * [Pipelines and activities in Data Factory](../../data-factory/concepts-pipelines-activities.md)
 * [Use Microsoft Fabric notebooks](/fabric/data-engineering/how-to-use-notebook)