Skip to content

Commit ad6a2a8

Browse files
authored
Merge pull request #290137 from jovinson-ms/deid-bicep
Deid bicep
2 parents eee2589 + b31c8b4 commit ad6a2a8

File tree

4 files changed

+114
-8
lines changed

4 files changed

+114
-8
lines changed

articles/healthcare-apis/deidentification/overview.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ The de-identification service (preview) offers two ways to interact with the RES
4242

4343
## Input requirements and service limits
4444

45-
The de-identification service (preview) is designed to receive unstructured text. To de-identify data stored in the FHIR® service, see [Export deidentified data](/azure/healthcare-apis/fhir/deidentified-export).
45+
The de-identification service (preview) is designed to receive unstructured text. To de-identify data stored in the FHIR® service, see [Export de-identified data](/azure/healthcare-apis/fhir/deidentified-export).
4646

4747
The following service limits are applicable during preview:
4848
- Requests can't exceed 50 KB.
@@ -62,10 +62,10 @@ When you choose to store documents in Azure Blob Storage, you are charged based
6262

6363
An AI system includes the technology, the people who use it, the people affected by it, and the environment where you deploy it. Read the transparency note for the de-identification service (preview) to learn about responsible AI use and deployment in your systems.
6464

65-
## Related content
65+
## Next steps
6666

67-
[De-identification quickstart](quickstart.md)
67+
> [!div class="nextstepaction"]
68+
> [Quickstart: Deploy the de-identification service (preview)](quickstart.md)
6869
69-
[Integration and responsible use](/legal/cognitive-services/language-service/guidance-integration-responsible-use?context=%2Fazure%2Fai-services%2Flanguage-service%2Fcontext%2Fcontext)
70-
71-
[Data, privacy, and security](/legal/cognitive-services/language-service/data-privacy?context=%2Fazure%2Fai-services%2Flanguage-service%2Fcontext%2Fcontext)
70+
- [Integration and responsible use](/legal/cognitive-services/language-service/guidance-integration-responsible-use?context=%2Fazure%2Fai-services%2Flanguage-service%2Fcontext%2Fcontext)
71+
- [Data, privacy, and security](/legal/cognitive-services/language-service/data-privacy?context=%2Fazure%2Fai-services%2Flanguage-service%2Fcontext%2Fcontext)
Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
title: "Quickstart: deploy the Azure Health Data Services de-identification service with Bicep"
3+
description: "Quickstart: deploy the Azure Health Data Services de-identification service with Bicep."
4+
author: jovinson-ms
5+
ms.author: jovinson
6+
ms.service: azure-health-data-services
7+
ms.subservice: deidentification-service
8+
ms.topic: quickstart-bicep
9+
ms.custom: subject-bicepqs
10+
ms.date: 11/06/2024
11+
---
12+
13+
# Quickstart: Deploy the Azure Health Data Services de-identification service (preview) with Bicep
14+
15+
In this quickstart, you use a Bicep definition to deploy a de-identification service (preview).
16+
17+
[!INCLUDE [About Bicep](~/reusable-content/ce-skilling/azure/includes/resource-manager-quickstart-bicep-introduction.md)]
18+
19+
If your environment meets the prerequisites and you're familiar with using Bicep, select the
20+
**Deploy to Azure** button. The template opens in the Azure portal.
21+
22+
:::image type="content" source="~/reusable-content/ce-skilling/azure/media/template-deployments/deploy-to-azure-button.svg" alt-text="Button to deploy the Bicep definition 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":::
23+
24+
## Prerequisites
25+
26+
- If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
27+
[!INCLUDE [include](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
28+
[!INCLUDE [include](~/reusable-content//azure-powershell/azure-powershell-requirements-no-header.md)]
29+
30+
## Review the Bicep file
31+
32+
The Bicep file used in this quickstart is from
33+
[Azure Quickstart Templates](/samples/azure/azure-quickstart-templates/deidentification-service-create/).
34+
35+
:::code language="bicep" source="~/quickstart-templates/quickstarts/microsoft.healthdataaiservices/deidentification-service-create/main.bicep":::
36+
37+
The following Azure resources are defined in the Bicep file:
38+
39+
- [Microsoft.HealthDataAIServices/deidServices](/azure/templates)
40+
41+
## Deploy the Bicep file
42+
43+
1. Save the Bicep file as `main.bicep` to your local computer.
44+
45+
1. Deploy the Bicep file by using either Azure CLI or Azure PowerShell, replacing `<deid-service-name>` with a name for your de-identification service.
46+
47+
# [Azure CLI](#tab/azure-cli)
48+
49+
This command requires Azure CLI version 2.6 or later. You can check the currently installed version by running `az --version`.
50+
51+
```azurecli
52+
az group create --name exampleRG --location eastus
53+
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters deidServiceName=<deid-service-name>
54+
```
55+
56+
# [Azure PowerShell](#tab/azure-powershell)
57+
58+
```azurepowershell
59+
New-AzResourceGroup -Name exampleRG -Location eastus
60+
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -deidServiceName "<deid-service-name>"
61+
```
62+
---
63+
64+
## Review deployed resources
65+
66+
Use the Azure portal, the Azure CLI, or Azure PowerShell to list the deployed resources in the resource group.
67+
68+
# [Azure CLI](#tab/azure-cli)
69+
70+
```azurecli
71+
az resource list --resource-group exampleRG
72+
```
73+
74+
# [Azure PowerShell](#tab/azure-powershell)
75+
76+
```azurepowershell
77+
Get-AzResource -ResourceGroupName exampleRG
78+
```
79+
80+
---
81+
82+
## Clean up resources
83+
84+
When you no longer need the resources, use the Azure portal, the Azure CLI, or Azure PowerShell to delete the resource group.
85+
86+
# [Azure CLI](#tab/azure-cli)
87+
88+
```azurecli
89+
az group delete --name exampleRG
90+
```
91+
92+
# [Azure PowerShell](#tab/azure-powershell)
93+
94+
```azurepowershell
95+
Remove-AzResourceGroup -Name exampleRG
96+
```
97+
98+
---
99+
100+
## Next steps
101+
102+
> [!div class="nextstepaction"]
103+
> [Quickstart: Azure Health De-identification client library for .NET](quickstart-sdk-net.md)

articles/healthcare-apis/deidentification/quickstart.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ After you complete the configuration, you can deploy the de-identification servi
6767

6868
If you no longer need them, delete the resource group and de-identification service (preview). To do so, select the resource group and select **Delete**.
6969

70-
## Related content
70+
## Next steps
7171

7272
> [!div class="nextstepaction"]
7373
> [Tutorial: Configure Azure Storage to de-identify documents](configure-storage.md)

articles/healthcare-apis/deidentification/toc.yml

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,11 @@ items:
1111
- name: Quickstarts
1212
expanded: true
1313
items:
14-
- name: Deploy the de-identification service
14+
- name: Portal
1515
href: quickstart.md
16+
- name: Bicep
17+
href: quickstart-bicep.md
18+
displayName: Resource Manager,ARM,template
1619
- name: Azure Health De-identification client library for .NET
1720
href: quickstart-sdk-net.md
1821
- name: Tutorials

0 commit comments

Comments
 (0)