Skip to content

Commit 3c9eae3

Browse files
authored
Merge pull request #206690 from msjasteppe/iot-deploy-update
Adding banner and minor formatting.
2 parents 4418376 + 618bb14 commit 3c9eae3

File tree

1 file changed

+18
-10
lines changed

1 file changed

+18
-10
lines changed

articles/healthcare-apis/iot/deploy-iot-connector-in-azure.md

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ author: msjasteppe
55
ms.service: healthcare-apis
66
ms.subservice: fhir
77
ms.topic: quickstart
8-
ms.date: 07/19/2022
8+
ms.date: 08/02/2022
99
ms.author: jasteppe
1010
ms.custom: mode-api
1111
---
@@ -14,6 +14,10 @@ ms.custom: mode-api
1414

1515
In this quickstart, you'll learn how to deploy the MedTech service in the Azure portal using two different methods: with a [quickstart template](#deploy-the-medtech-service-with-a-quickstart-template) or [manually](#deploy-the-medtech-service-manually). The MedTech service will enable you to ingest data from Internet of Things (IoT) into your Fast Healthcare Interoperability Resources (FHIR®) service.
1616

17+
> [!IMPORTANT]
18+
>
19+
> You'll want to confirm that the **Microsoft.HealthcareApis** and **Microsoft.EventHub** resource providers have been registered with your Azure subscription for a successful deployment. To learn more about registering resource providers, see [Azure resource providers and types](/azure-resource-manager/management/resource-providers-and-types)
20+
1721
## Deploy the MedTech service with a quickstart template
1822

1923
If you already have an active Azure account, you can use this [![Deploy to Azure](https://aka.ms/deploytoazurebutton)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2Fquickstarts%2Fmicrosoft.healthcareapis%2Fworkspaces%2Fiotconnectors%2Fazuredeploy.json) button to deploy a MedTech service that will include the following resources and roles:
@@ -30,7 +34,7 @@ If you already have an active Azure account, you can use this [![Deploy to Azure
3034
> By using the drop down menus, you can find all the values that can be selected. You can also begin to type the value to begin the search for the resource, however, selecting the resource from the drop down menu will ensure that there are no typos.
3135
>
3236
> :::image type="content" source="media\iot-deploy-quickstart-in-portal\display-drop-down-box.png" alt-text="Screenshot of Azure portal page displaying drop down menu example." lightbox="media\iot-deploy-quickstart-in-portal\display-drop-down-box.png":::
33-
>
37+
3438

3539
1. When the Azure portal launches, the following fields must be filled out:
3640

@@ -55,14 +59,15 @@ If you already have an active Azure account, you can use this [![Deploy to Azure
5559
* Provide a working destination mapping file. For more information, see [How to use FHIR destination mappings](how-to-use-fhir-mappings.md).
5660
* Use the Shared access policies (SAS) key (**devicedatasender**) for connecting your device or application to the MedTech service device message event hub (**devicedata**). For more information, see [Connection string for a specific event hub in a namespace](../../event-hubs/event-hubs-get-connection-string.md#connection-string-for-a-specific-event-hub-in-a-namespace).
5761

58-
> [!IMPORTANT]
59-
> If you're going to allow access from multiple services to the device message event hub, it is highly recommended that each service has its own event hub consumer group.
60-
>
61-
> Consumer groups enable multiple consuming applications to each have a separate view of the event stream, and to read the stream independently at their own pace and with their own offsets. For more information, see [Consumer groups](../../event-hubs/event-hubs-features.md#consumer-groups).
62-
>
63-
> **Examples:**
64-
> * Two MedTech services accessing the same device message event hub.
65-
> * A MedTech service and a storage writer application accessing the same device message event hub.
62+
> [!IMPORTANT]
63+
>
64+
> If you're going to allow access from multiple services to the device message event hub, it is highly recommended that each service has its own event hub consumer group.
65+
>
66+
> Consumer groups enable multiple consuming applications to each have a separate view of the event stream, and to read the stream independently at their own pace and with their own offsets. For more information, see [Consumer groups](../../event-hubs/event-hubs-features.md#consumer-groups).
67+
>
68+
> **Examples:**
69+
> * Two MedTech services accessing the same device message event hub.
70+
> * A MedTech service and a storage writer application accessing the same device message event hub.
6671
6772
## Deploy the MedTech service manually
6873

@@ -110,6 +115,7 @@ It's important that you have the following prerequisites completed before you be
110115
The Event Hubs Namespace is the name of the **Event Hubs Namespace** that you've previously deployed. For this example, we'll use `eh-azuredocsdemo` for use with our MedTech service device messages.
111116

112117
> [!TIP]
118+
>
113119
> For information about deploying an Azure Event Hubs Namespace, see [Create an Event Hubs Namespace](../../event-hubs/event-hubs-create.md#create-an-event-hubs-namespace).
114120
>
115121
> For more information about Azure Event Hubs Namespaces, see [Namespace](../../event-hubs/event-hubs-features.md?WT.mc_id=Portal-Microsoft_Healthcare_APIs#namespace) in the Features and terminology in Azure Event Hubs document.
@@ -191,6 +197,7 @@ It's important that you have the following prerequisites completed before you be
191197
3. Select **Create** or **Lookup** for the **Resolution Type**.
192198

193199
> [!NOTE]
200+
>
194201
> For the MedTech service destination to create a valid observation resource in the FHIR service, a device resource and patient resource **must** exist in the FHIR service, so the observation can properly reference the device that created the data, and the patient the data was measured from. There are two modes the MedTech service can use to resolve the device and patient resources.
195202
196203
**Create**
@@ -291,6 +298,7 @@ To ensure that your MedTech service works properly, it's system-assigned managed
291298
The Azure Event Hubs Data Receiver role allows the MedTech service that's being assigned this role to receive device message data from this event hub.
292299

293300
> [!TIP]
301+
>
294302
> For more information about application roles, see [Authentication & Authorization for Azure Health Data Services](.././authentication-authorization.md).
295303
296304
7. Select the **Select role** button.

0 commit comments

Comments
 (0)