Merge pull request #277643 from shellyhaverkamp/smh-ahds-quickstart

Fixed screenshots

Author: Stacyrch140

articles/healthcare-apis/health-data-services-get-started.md

@@ -1,82 +1,75 @@
 ---
-title: Deploy workspace in the Azure portal - Azure Health Data Services
-description: This document teaches users how to deploy a workspace in the Azure portal.
-author: chachachachami
+title: Create an Azure workspace in the Azure portal for Azure Health Data Services
+description: Learn how to create a workspace for Azure Health Data Services by using the Azure portal. The workspace is a centralized logical container for instances of the FHIR service, DICOM service, and MedTech service.
+author: msjasteppe
 ms.service: healthcare-apis
-ms.subservice: fhir
+ms.subservice: workspace
 ms.topic: quickstart
-ms.date: 06/06/2022
-ms.author: chrupa
+ms.date: 06/07/2024
+ms.author: jasteppe
 ms.custom: mode-api
 ---
 
-# Deploy Azure Health Data Services workspace using Azure portal
+# Create an Azure workspace for Azure Health Data Services
 
-In this article, you’ll learn how to create a workspace by deploying Azure Health Data Services through the Azure portal. The workspace is a centralized logical container for all your Azure Health Data services such as FHIR® services, DICOM® services, and MedTech services. It allows you to organize and manage certain configuration settings that are shared among all the underlying datasets and services where applicable.
+Follow the steps in this article to create a workspace before you deploy instances of Azure Health Data Services in the Azure portal. The workspace is a centralized logical container for Azure Health Data services such as FHIR® services, DICOM® services, and MedTech services. It allows you to organize and manage configuration settings that are shared among all the underlying datasets and services.
 
+## Prerequisites
 
-## Prerequisite
+Before you create a workspace in the Azure portal, you need an Azure account subscription. For more information, see [Create your free Azure account today](https://azure.microsoft.com/free/search/?OCID=AID2100131_SEM_c4b0772dc7df1f075552174a854fd4bc:G:s&ef_id=c4b0772dc7df1f075552174a854fd4bc:G:s&msclkid=c4b0772dc7df1f075552174a854fd4bc).
 
-Before you can create a workspace in the Azure portal, you must have an account subscription. If you 
-don’t have an Azure subscription, see [Create your free Azure account today](https://azure.microsoft.com/free/search/?OCID=AID2100131_SEM_c4b0772dc7df1f075552174a854fd4bc:G:s&ef_id=c4b0772dc7df1f075552174a854fd4bc:G:s&msclkid=c4b0772dc7df1f075552174a854fd4bc).
+## Create a resource
 
-## Create new Azure service
+1. In the Azure portal, select **Create a resource**.
 
-In the Azure portal, select **Create a resource**.
+   :::image type="content" source="media/healthcare-apis-quickstart/create-resource.png" alt-text="Screenshot showing resource creation." lightbox="media/healthcare-apis-quickstart/create-resource.png":::
 
-[ ![Screenshot of Create resource.](media/create-resource.png) ](media/create-resource.png#lightbox)
+1. In the search box, enter **Azure Health Data Services**.
 
-## Search for Azure Health Data Services
+   :::image type="content" source="media/healthcare-apis-quickstart/search-services-marketplace.png" alt-text="Screenshot showing how to search for Azure Health Data Services." lightbox="media/healthcare-apis-quickstart/search-services-marketplace.png":::
 
-In the search box, enter **Azure Health Data Services**.
+1. Choose **Create** to create an Azure Health Data Services account.
 
-[ ![Screenshot of Search for Azure Health Data Services](media/search-services-marketplace.png) ](media/search-services-marketplace.png#lightbox)
+   :::image type="content" source="media/healthcare-apis-quickstart/create-health-data-services-resource.png" alt-text="Screenshot showing how to create a new account." lightbox="media/healthcare-apis-quickstart/create-health-data-services-resource.png":::
 
-## Create Azure Health Data Services account
+1. On the **Basics** tab, under **Project details**, from the dropdown lists select a **Subscription** and **Resource group**.  
 
-Select **Create** to create a new Azure Health Data Services account.
+1. Choose **Create new** to create a new resource group.
 
-   [ ![Screenshot of create new account button.](media/create-azure-health-data-services-resource.png) ](media/create-azure-health-data-services-resource.png#lightbox)
+   :::image type="content" source="media/healthcare-apis-quickstart/create-health-data-services-workspace-basics-tab.png" alt-text="Screenshot showing the workspace settings on the Basics tab." lightbox="media/healthcare-apis-quickstart/create-health-data-services-workspace-basics-tab.png":::
+   
+1. Enter a **Name** for the workspace, and then select a **Region**. The name must be 3 to 24 alphanumeric characters, all lowercase. Don't use a hyphen "-" as it's an invalid character for the name. For information about regions and availability zones, see [Regions and Availability Zones in Azure](../availability-zones/az-overview.md).
 
-## Enter subscription and workspace details
+1. Select **Next: Networking >**. Connect a workspace publicly with the default **Public endpoint (all networks)** option selected. You can also connect a workspace using a private endpoint by selecting the **Private endpoint** option. For more information about accessing Azure Health Data Services over a private endpoint, see [Configure Private Link for Azure Health Data Services](healthcare-apis-configure-private-link.md).
 
-1. Under the **Project details** section of the **Basics** tab, select a **Subscription** and **Resource group** from their drop-down lists.  Select **Create new** to create a new resource group.
+   :::image type="content" source="media/healthcare-apis-quickstart/create-workspace-networking-tab.png" alt-text="Screenshot showing the Networking tab." lightbox="media/healthcare-apis-quickstart/create-workspace-networking-tab.png":::
+  
+1. Select **Next: Tags >** if you want to include name and value pairs to categorize resources and view consolidated billing by applying the same tag to multiple resources and resource groups. Enter a **Name** and **Value** for the workspace, and then select **Review + create** or **Next: Review + create**. For more information about tags, see [Use tags to organize your Azure resources and management hierarchy](.././azure-resource-manager/management/tag-resources.md).
 
-   [ ![Screenshot of create health data services workspace basics tab.](media/create-health-data-services-workspace-basics-tab.png) ](media/create-health-data-services-workspace-basics-tab.png#lightbox)
+   :::image type="content" source="media/healthcare-apis-quickstart/tags-new.png" alt-text="Screenshot showing the Tags tab." lightbox="media/healthcare-apis-quickstart/tags-new.png":::
 
-2. Enter a **Name** for the workspace, and then select a **Region**. The name must be 3 to 24 alphanumeric characters, all in lowercase. Don't use a hyphen "-" as it's an invalid character for the name. For information about regions and availability zones, see [Regions and Availability Zones in Azure](../availability-zones/az-overview.md).
+1. Review the details. Choose **Create** if you don't need to make any changes to the workspace project and instance details. If you need to make changes to the project and instance details, select **Previous**.
 
-3. Select **Next: Networking >**.  It's here that you can connect a workspace publicly with the default **Public endpoint (all networks)** option selected. You may also connect a workspace using a private endpoint by selecting the **Private endpoint** option. For more information about accessing Azure Health Data Services over a private endpoint, see [Configure Private Link for Azure Health Data Services](healthcare-apis-configure-private-link.md).
+   :::image type="content" source="media/healthcare-apis-quickstart/workspace-review-create-tab.png" alt-text="Screenshot showing details about the workspace." lightbox="media/healthcare-apis-quickstart/workspace-review-create-tab.png":::
 
-   [ ![Screenshot of create health data services workspace networking tab.](media/create-workspace-networking-tab.png) ](media/create-workspace-networking-tab.png#lightbox)
+      **Optional**: Select **Download a template for automation** of the newly created workspace.
 
-4.  Select **Next: Tags >** if you want to include name and value pairs to categorize resources and view consolidated billing by applying the same tag to multiple resources and resource groups. Enter a **Name** and **Value** for the workspace, and then select **Review + create** or **Next: Review + create**.  For more information about tags, see [Use tags to organize your Azure resources and management hierarchy](.././azure-resource-manager/management/tag-resources.md).
+1. After the workspace deployment process is complete, select **Go to resource**.
 
-   [ ![Screenshot of the health data services workspace tags tab.](media/tags-new.png) ](media/tags-new.png#lightbox)
+   :::image type="content" source="media/healthcare-apis-quickstart/workspace-deployment-details.png" alt-text="Screenshot showing the workspace and the Go to resource button." lightbox="media/healthcare-apis-quickstart/workspace-deployment-details.png":::
 
-5. Select **Create** if you don't need to make any changes to the workspace project and instance details.  If you must make changes to the project and instance details, select **Previous**.
-
-   [ ![Screenshot of the health data services workspace instance details.](media/workspace-review-create-tab.png) ](media/workspace-review-create-tab.png#lightbox)
-
-   **Optional**: You may select **Download a template for automation** of your newly created workspace.
-
-6. After the workspace deployment process is complete, select **Go to resource**.
-
-   [ ![Screenshot of the workspace and the go to resource button.](media/workspace-deployment-details.png) ](media/workspace-deployment-details.png#lightbox)
-
-    You now can create a FHIR service, DICOM service, and MedTech service from the newly deployed Azure Health Data Services workspace.
-
-   [ ![Screenshot of the newly deployed Azure Health Data Services workspace.](media/deploy-health-data-services-workspace.png) ](media/deploy-health-data-services-workspace.png#lightbox)
+1. Create instances of the FHIR service, DICOM service, and MedTech service in the newly created Azure Health Data Services workspace.
 
+   :::image type="content" source="media/healthcare-apis-quickstart/deploy-health-data-services-workspace.png" alt-text="Screenshot showing the newly created workspace." lightbox="media/healthcare-apis-quickstart/deploy-health-data-services-workspace.png":::
 
 ## Next steps
 
 [Deploy the FHIR service](./../healthcare-apis/fhir/fhir-portal-quickstart.md)
 
 [Deploy the DICOM service](./../healthcare-apis/dicom/deploy-dicom-services-in-azure.md)
 
-[Deploy a MedTech service and ingest data to your FHIR service](./../healthcare-apis/iot/deploy-iot-connector-in-azure.md)
+[Deploy the MedTech service and ingest data into the FHIR service](./../healthcare-apis/iot/deploy-iot-connector-in-azure.md)
 
-[Convert data to FHIR](./../healthcare-apis/fhir/convert-data-overview.md)
+[Convert data to FHIR format](./../healthcare-apis/fhir/convert-data-overview.md)
 
-[!INCLUDE [FHIR and DICOM trademark statement](./includes/healthcare-apis-fhir-dicom-trademark.md)]
+[!INCLUDE [FHIR and DICOM trademark statement](./includes/healthcare-apis-fhir-dicom-trademark.md)]