Skip to content

Commit 1f355f9

Browse files
authored
Merge pull request #312146 from cebundy-work/remove-medtech-refs-from-ahds-docs
remove medtech references from AHDS docs
2 parents ab1bfa1 + 44a108b commit 1f355f9

14 files changed

Lines changed: 42 additions & 228 deletions

articles/healthcare-apis/access-healthcare-apis.md

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
11
---
22
title: Access Azure Health Data Services
3-
description: Learn how to access the FHIR, DICOM, and MedTech services in Azure Health Data Services by using cURL, REST Client, and programming languages like Python and C# for efficient data management.
3+
description: Learn how to access the FHIR and DICOM services in Azure Health Data Services by using cURL, REST Client, and programming languages like Python and C# for efficient data management.
44
services: healthcare-apis
55
author: EXPEkesheth
66
ms.service: azure-health-data-services
7-
ms.subservice: fhir
87
ms.custom: devx-track-python
98
ms.topic: conceptual
10-
ms.date: 06/02/2025
9+
ms.date: 02/25/2026
1110
ms.author: kesheth
1211
---
1312

1413
# Access Azure Health Data Services
1514

16-
After you deploy a FHIR® service, DICOM® service, or MedTech service, you can then access it in your applications by using tools like cURL, REST Client in Visual Studio Code, or with programming languages such as Python or C#.
15+
After you deploy a FHIR® or DICOM® service, you can then access it in your applications by using tools like cURL, REST Client in Visual Studio Code, or with programming languages such as Python or C#.
1716

1817
## Access the FHIR service
1918

@@ -26,15 +25,6 @@ After you deploy a FHIR® service, DICOM® service, or MedTech service, yo
2625
- [Access the DICOM service by using cURL](dicom/dicomweb-standard-apis-curl.md)
2726
- [Access the DICOM service by using C#](dicom/dicomweb-standard-apis-c-sharp.md)
2827

29-
## Access the MedTech service
30-
31-
The MedTech service works with the IoT Hub and Event Hubs to receive message data, and works with the FHIR service to persist the data.
32-
33-
- [Receive device data through Azure IoT Hub](iot/device-data-through-iot-hub.md)
34-
- [Access the FHIR service by using cURL](fhir/using-curl.md)
35-
- [Access the FHIR service by using REST Client](fhir/using-rest-client.md)
36-
37-
3828
## Next steps
3929

4030
[Deploy Azure Health Data Services workspace using the Azure portal](healthcare-apis-quickstart.md)

articles/healthcare-apis/authentication-authorization.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: healthcare-apis
55
author: EXPEkesheth
66
ms.service: azure-health-data-services
77
ms.topic: overview
8-
ms.date: 05/24/2025
8+
ms.date: 02/25/2026
99
ms.author: kesheth
1010
---
1111

@@ -38,15 +38,12 @@ The DICOM® service in Azure Health Data Services provides the following role
3838
* **DICOM Data Owner**: Read, write, and delete DICOM data.
3939
* **DICOM Data Read**: Read DICOM data.
4040

41-
The MedTech service doesn't require application roles, but it does rely on **Azure Event Hubs Data Receiver** to retrieve data stored in the event hub of your organization's subscription.
42-
4341
## Authorization
4442

4543
After being granted with proper application roles, the authenticated users and client applications can access Azure Health Data Services by obtaining a valid access token issued by Microsoft Entra ID, and perform specific operations defined by the application roles.
4644

4745
* For the FHIR service, the access token is specific to the service or resource.
4846
* For the DICOM service, the access token is granted to the `dicom.healthcareapis.azure.com` resource, not a specific service.
49-
* For MedTech service, the access token isn’t required because it isn’t exposed to the users or client applications.
5047

5148
### Steps for authorization
5249

@@ -110,7 +107,6 @@ When you create a new service of Azure Health Data Services, your data is encryp
110107

111108
* FHIR service provides encryption of data at rest when data is persisted in the data store.
112109
* DICOM service provides encryption of data at rest when imaging data including embedded metadata is persisted in the data store. When metadata is extracted and persisted in the FHIR service, it’s encrypted automatically.
113-
* MedTech service, after data mapping and normalization, persists device messages to the FHIR service, which is encrypted automatically. In cases where device messages are sent to Azure Event Hubs, which use Azure Storage to store the data, data is automatically encrypted with Azure Storage Service Encryption (Azure SSE).
114110

115111
## Next steps
116112

articles/healthcare-apis/deploy-healthcare-apis-using-bicep.md

Lines changed: 8 additions & 114 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
---
2-
title: How to create Azure Health Data Services, workspaces, FHIR and DICOM service, and MedTech service using Azure Bicep
2+
title: How to create Azure Health Data Services, workspaces, and FHIR and DICOM services with BICEP
33
description: This document describes how to deploy Azure Health Data Services using Azure Bicep.
44
author: chachachachami
55
ms.service: azure-health-data-services
66
ms.subservice: fhir
77
ms.topic: quickstart
8-
ms.date: 06/02/2025
8+
ms.date: 02/25/2026
99
ms.author: chrupa
1010
ms.custom:
1111
- mode-api
@@ -15,7 +15,7 @@ ms.custom:
1515

1616
# Deploy Azure Health Data Services using Azure Bicep
1717

18-
In this article, you learn how to create Azure Health Data Services, including workspaces, Fast Healthcare Interoperability Resources (FHIR) services, Digital Imaging Communications in Medicine (DICOM) services, and MedTech service using Azure Bicep. You can view and download the Bicep scripts used in this article in [Azure Health Data Services samples](https://github.com/microsoft/healthcare-apis-samples/blob/main/src/templates/ahds.bicep).
18+
In this article, you learn how to create Azure Health Data Services, including workspaces, Fast Healthcare Interoperability Resources (FHIR) services, and Digital Imaging Communications in Medicine (DICOM) services, using Azure Bicep.
1919

2020
## What is Azure Bicep
2121

@@ -30,7 +30,7 @@ You can continue to work with JSON ARM templates, or use Bicep to develop your A
3030

3131
Using Bicep parameters and variables instead of hard coding names and other values allows you to debug and reuse your Bicep files.
3232

33-
We first define parameters with the keyword *param* for workspace, FHIR service, DICOM service, MedTech service. Also, we define parameters for Azure subscription and Microsoft Entra tenant. They’re used in the CLI command line with the "--parameters" option.
33+
We first define parameters with the keyword *param* for workspace, FHIR service, and DICOM service. Also, we define parameters for Azure subscription and Microsoft Entra tenant. They’re used in the CLI command line with the "--parameters" option.
3434

3535
We then define variables for resources with the keyword *var*. Also, we define variables for properties such as the authority and the audience for the FHIR service. They’re specified and used internally in the Bicep file and can be used in combination of parameters, Bicep functions, and other variables. Unlike parameters, they aren’t used in the CLI command line.
3636

@@ -41,15 +41,13 @@ It's important to note that one Bicep function and environment are required to s
4141
param workspaceName string
4242
param fhirName string
4343
param dicomName string
44-
param medtechName string
4544
param tenantId string
4645
param location string
4746
4847
//Define variables
4948
var fhirservicename = '${workspaceName}/${fhirName}'
5049
var dicomservicename = '${workspaceName}/${dicomName}'
51-
var medtechservicename = '${workspaceName}/${medtechName}'
52-
var medtechdestinationname = '${medtechservicename}/output1'
50+
5351
var loginURL = environment().authentication.loginEndpoint
5452
var authority = '${loginURL}${tenantId}'
5553
var audience = 'https://${workspaceName}-${fhirName}.fhir.azurehealthcareapis.com'
@@ -141,109 +139,6 @@ Similarly, you can use or reference an existing DICOM service using the keyword
141139
}
142140
```
143141

144-
## Create a MedTech service template
145-
146-
For the MedTech service resource, the required properties include the MedTech service name, location, managed identity, and the dependency on the workspace. For the MedTech service itself, required properties include Azure Event Hubs namespace, Event Hubs, Event Hubs consumer group, and the device mapping. As an example, the heart rate device mapping is used in the template.
147-
148-
```
149-
//Create IoT connector
150-
resource exampleIoT 'Microsoft.HealthcareApis/workspaces/iotconnectors@2021-11-01' = {
151-
name: iotconnectorname
152-
location: resourceGroup().location
153-
identity: {
154-
type: 'SystemAssigned'
155-
}
156-
dependsOn: [
157-
exampleWorkspace
158-
//exampleExistingWorkspace
159-
]
160-
properties: {
161-
ingestionEndpointConfiguration: {
162-
eventHubName: 'eventhubnamexxx'
163-
consumerGroup: 'eventhubconsumergroupxxx'
164-
fullyQualifiedEventHubNamespace: 'eventhubnamespacexxx.servicebus.windows.net'
165-
}
166-
deviceMapping: {
167-
content: {
168-
templateType: 'CollectionContent'
169-
template: [
170-
{
171-
templateType: 'JsonPathContent'
172-
template: {
173-
typeName: 'heartrate'
174-
typeMatchExpression: '$..[?(@heartrate)]'
175-
deviceIdExpression: '$.deviceid'
176-
timestampExpression: '$.measurementdatetime'
177-
values: [
178-
{
179-
required: 'true'
180-
valueExpression: '$.heartrate'
181-
valueName: 'Heart rate'
182-
}
183-
]
184-
}
185-
}
186-
]
187-
}
188-
}
189-
}
190-
}
191-
```
192-
193-
Similarly, you can use, or reference an existing MedTech service using the keyword *existing*.
194-
195-
```
196-
//Use an existing IoT
197-
resource exampleExistingIoT 'Microsoft.HealthcareApis/workspaces/iotconnectors/fhirdestinations@2021-11-01' existing = {
198-
name: iotconnectorname
199-
}
200-
```
201-
202-
The MedTech service requires a child resource, destination, and it currently supports the FHIR service destination only. For the MedTech service destination resource, the required properties include a name, location, and the dependency on the MedTech service. For the FHIR service destination, required properties include the resolution type, which takes a value of *Create* or *Lookup*, the FHIR service resource ID, and a FHIR resource type. For example, the heart rate mapping for the FHIR Observation resource is used in the template.
203-
204-
```
205-
//Create IoT destination
206-
resource exampleIoTDestination 'Microsoft.HealthcareApis/workspaces/iotconnectors/fhirdestinations@2021-11-01' = {
207-
name: iotdestinationname
208-
location: resourceGroup().location
209-
dependsOn: [
210-
exampleIoT
211-
//exampleExistingIoT
212-
]
213-
properties: {
214-
resourceIdentityResolutionType: 'Create'
215-
fhirServiceResourceId: exampleFHIR.id //exampleExistingFHIR.id
216-
fhirMapping: {
217-
content: {
218-
templateType: 'CollectionFhirTemplate'
219-
template: [
220-
{
221-
templateType: 'CodeValueFhir'
222-
template: {
223-
codes: [
224-
{
225-
code: '8867-4'
226-
system: 'http://loinc.org'
227-
display: 'Heart rate'
228-
}
229-
]
230-
periodInterval: 60
231-
typeName: 'heartrate'
232-
value: {
233-
defaultPeriod: 5000
234-
unit: 'count/min'
235-
valueName: 'hr'
236-
valueType: 'SampledData'
237-
}
238-
}
239-
}
240-
]
241-
}
242-
}
243-
}
244-
}
245-
```
246-
247142
## Deploy Azure Health Data Services
248143

249144
You can use the `az deployment group create` command to deploy individual Bicep file or combined templates, similar to the way you deploy Azure resources with JSON templates. Specify the resource group name, and include the parameters in the command line. With the "--parameters" option, specify the parameter and value pair as "parameter = value", and separate the parameter and value pairs by a space if more than one parameter is defined.
@@ -257,16 +152,15 @@ location=centralus
257152
workspacename=ws$deploymentname
258153
fhirname=fhir$deploymentname
259154
dicomname=dicom$deploymentname
260-
medtechname=medtech$deploymentname
261155
bicepfilename=ahds.bicep
262156
subscriptionid=$(az account show --query id --output tsv)
263157
tenantid=$(az account show --subscription $subscriptionid --query tenantId --output tsv)
264158
265159
az group create --name $resourcegroupname --location $location
266-
az deployment group create --resource-group $resourcegroupname --template-file $bicepfilename --parameters workspaceName=$workspacename fhirName=$fhirname dicomName=$dicomname medtechName=$medtechname tenantId=$tenantid location=$location
160+
az deployment group create --resource-group $resourcegroupname --template-file $bicepfilename --parameters workspaceName=$workspacename fhirName=$fhirname dicomName=$dicomname tenantId=$tenantid location=$location
267161
```
268162

269-
Note that the child resource name such as the FHIR service includes the parent resource name, and the "dependsOn" property is required. However, when the child resource is created within the parent resource, its name doesn't need to include the parent resource name, and the "dependsOn" property isn't required. For more info on nested resources, see [Set name and type for child resources in Bicep](../azure-resource-manager/bicep/child-resource-name-type.md).
163+
The child resource name such as the FHIR service includes the parent resource name, and the "dependsOn" property is required. However, when the child resource is created within the parent resource, its name doesn't need to include the parent resource name, and the "dependsOn" property isn't required. For more info on nested resources, see [Set name and type for child resources in Bicep](../azure-resource-manager/bicep/child-resource-name-type.md).
270164

271165
## Debugging Bicep files
272166

@@ -281,7 +175,7 @@ output stringOutput2 string = audience
281175

282176
## Next steps
283177

284-
In this article, you learned how to create Azure Health Data Services, including workspaces, FHIR services, DICOM services, and MedTech services using Bicep. You also learned how to create and debug Bicep files. For more information about Azure Health Data Services, see:
178+
In this article, you learned how to create Azure Health Data Services, including workspaces, FHIR services, and DICOM services using Bicep. You also learned how to create and debug Bicep files. For more information about Azure Health Data Services, see:
285179

286180
>[!div class="nextstepaction"]
287181
>[What is Azure Health Data Services?](healthcare-apis-overview.md)

0 commit comments

Comments
 (0)