Quickstart: Deploy the MedTech service using an Azure Resource Manager template
In this quickstart, you'll learn how to:
- Open an ARM template in the Azure portal.
- Configure the ARM template for your deployment.
- Deploy the ARM template.
To learn more about ARM templates, see What are ARM templates?
To begin your deployment and complete the quickstart, you must have the following prerequisites:
An active Azure subscription account. If you don't have an Azure subscription, see Subscription decision guide.
Owner or Contributor and User Access Administrator role assignments in the Azure subscription. For more information, see What is Azure role-based access control (Azure RBAC)?
The Microsoft.HealthcareApis and Microsoft.EventHub resource providers registered with your Azure subscription. To learn more about registering resource providers, see Azure resource providers and types.
When you have these prerequisites, you're ready to configure the ARM template by using the Deploy to Azure button.
Review the ARM template - Optional
Use the Deploy to Azure button
To begin deployment in the Azure portal, select the Deploy to Azure button:
Configure the deployment
In the Azure portal, on the Basics tab of the Azure Quickstart Template, select or enter the following information for your deployment:
Subscription - The Azure subscription to use for the deployment.
Resource group - An existing resource group, or you can create a new resource group.
Region - The Azure region of the resource group that's used for the deployment. Region auto-fills by using the resource group region.
Basename - A value that's appended to the name of the Azure resources and services that are deployed.
Location - Use the drop-down list to select a supported Azure region for the Azure Health Data Services (the value could be the same or different region than your resource group).
Device Mapping - Don't change the default values for this quickstart.
Destination Mapping - Don't change the default values for this quickstart.
To validate your configuration, select Review + create.
In Review + create, check the template validation status. If validation is successful, the template displays Validation Passed. If validation fails, fix the detail that's indicated in the error message, and then select Review + create again.
After a successful validation, to begin the deployment, select Create.
In a few minutes, the Azure portal displays the message that your deployment is completed.
If you're going to allow access from multiple services to the device message event hub, it's required that each service has its own event hub consumer group.
Consumer groups enable multiple consuming applications to 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.
Two MedTech services accessing the same device message event hub.
A MedTech service and a storage writer application accessing the same device message event hub.
Review deployed resources and access permissions
When deployment is completed, the following resources and access roles are created in the ARM template deployment:
Azure Event Hubs namespace and device message event hub. In this deployment, the device message event hub is named devicedata.
An event hub consumer group. In this deployment, the consumer group is named $Default.
An Azure Event Hubs Data Sender role. In this deployment, the sender role is named devicedatasender and can be used to provide access to the device event hub using a shared access signature (SAS). To learn more about authorizing access using a SAS, see Authorizing access to Event Hubs resources using Shared Access Signatures.
A Health Data Services workspace.
A Health Data Services Fast Healthcare Interoperability Resources (FHIR®) service.
A Health Data Services MedTech service with the required system-assigned managed identity roles:
In this quickstart, the ARM template configures the MedTech service to operate in Create mode. A patient resource and a device resource are created for each device that sends data to your FHIR service.
To learn more about the MedTech service resolution types Create and Lookup, see Destination properties.
After you've successfully deployed an instance of the MedTech service, you'll still need to provide conforming and valid device and FHIR destination mappings.
To learn about device mappings, see How to configure device mappings.
To learn about FHIR destination mappings, see How to configure FHIR destination mappings.
In this quickstart, you learned how to deploy an instance of the MedTech service in the Azure portal using an ARM template with a Deploy to Azure button.
To learn about other methods for deploying the MedTech service, see
FHIR® is a registered trademark of Health Level Seven International, registered in the U.S. Trademark Office and is used with their permission.