initial commit

Author: josiahvinson

articles/healthcare-apis/deidentification/quickstart-arm.md

@@ -0,0 +1,75 @@
+---
+title: Create an Azure Health Data Services de-identification service by using Azure Resource Manager template (ARM template)
+description: Learn how to create an Azure Health Data Services de-identification service by using Azure Resource Manager template (ARM template).
+services: azure-resource-manager
+ms.service: azure-health-data-services
+ms.subservice: deidentification-service
+author: jovinson-ms
+ms.author: jovinson
+ms.topic: quickstart-arm
+ms.custom: subject-armqs
+ms.date: 11/04/2024
+
+# Customer intent: As a cloud administrator, I want a quick method to deploy an Azure resource for production environments or to evaluate the service's functionality.
+---
+
+# Quickstart: Create a de-identification service (preview) using an ARM template
+
+This quickstart describes how to use an Azure Resource Manager template (ARM template) to create
+an Azure Health Data Services de-identification service (preview).
+
+[!INCLUDE [About Azure Resource Manager](../../includes/resource-manager-quickstart-introduction.md)]
+
+If your environment meets the prerequisites and you're familiar with using ARM templates, select the
+**Deploy to Azure** button. The template will open in the Azure portal.
+
+:::image type="content" source="~/articles/reusable-content/ce-skilling/azure/media/template-deployments/deploy-to-azure-button.svg" alt-text="Button to deploy the Resource Manager template to Azure." border="false" link="https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.healthdataaiservices%2Fdeidentification-service-create%2Fazuredeploy.json":::
+
+## Prerequisites
+
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+
+[!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
+
+## Review the template
+
+The template used in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates).
+
+:::code language="json" source="~/quickstart-templates/quickstarts/microsoft.healthdataaiservices/deidentification-service-create/azuredeploy.json":::
+
+- [Microsoft.HealthDataAIServices/deidServices](/rest/api/health-controlplane/deid-services?view=rest-health-controlplane-2024-02-28-preview): Create a de-identification service.
+
+## Deploy the template
+
+Deploy the template using any standard method for [deploying an ARM template](../azure-resource-manager/templates/deploy-cli.md) such as the following example using Azure CLI.
+1. Save the template file as **azuredeploy.json** to your local computer.
+1. Create a resource group in one of the supported regions for the de-identificaation service, replacing **\<deid-service-name\>** with the name you choose for your de-identification service:
+    ```azurecli
+    az group create --name exampleRG --location westus3
+
+    az deployment group create --resource-group exampleRG --template-file azuredeploy.json --parameters deidServiceName="<deid-service-name>" 
+    ```
+
+When the deployment finishes, you should see a message indicating the deployment succeeded.
+
+## Review deployed resources
+
+Review your resource with Azure CLI, replacing **\<deid-service-name\>** with the name you choose for your de-identification service:
+```azurecli
+az resource show -g exampleRG -n <deid-service-name> --resource-type "Microsoft.HealthDataAIServices/deidServices"
+```
+
+## Clean up resources
+
+When no longer needed, delete the resource group. The resource group and all the resources in the
+resource group are deleted.
+```azurecli
+az group delete --name exampleRG
+```
+
+## Next steps
+
+For a step-by-step tutorial that guides you through the process of creating a template, see:
+
+> [!div class="nextstepaction"]
+> [Tutorial: Create and deploy your first ARM template](/azure/azure-resource-manager/templates/template-tutorial-create-first-template)

articles/healthcare-apis/deidentification/toc.yml

@@ -11,6 +11,9 @@ items:
     items:
       - name: Deploy the de-identification service
         href: quickstart.md
+      - name: ARM template
+        displayName: ARM, Resource Manager, Template, Bicep
+        href: quickstart-arm.md
       - name: Azure Health De-identification client library for .NET
         href: quickstart-sdk-net.md
   - name: How-to