azure-health-data-services

name	azure-health-data-services
description	Expert knowledge for Azure Health Data Services development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using FHIR, DICOM, MedTech, de-identification APIs, Synapse/ADF pipelines, or SMART on FHIR apps, and other Azure Health Data Services related development tasks. Not for Azure Health Bot (use azure-health-bot), Azure API Management (use azure-api-management), Azure Data Factory (use azure-data-factory), Azure Cosmos DB (use azure-cosmos-db).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-19","generator":"docs2skills/1.0.0"}

Azure Health Data Services Skill

This skill provides expert guidance for Azure Health Data Services. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L37-L45	Diagnosing and fixing Azure Health Data Services issues: FHIR access tokens, event delivery, $convert-data failures, identity provider setup, and known platform limitations.
Best Practices	L46-L53	Guidance on using customer-managed keys with FHIR/DICOM, optimizing FHIR performance, and safely running, monitoring, and managing FHIR reindex jobs.
Decision Making	L54-L60	Guidance on planning and executing migrations from Azure API for FHIR to FHIR service or Azure Health Data Services, including retirement timelines, architecture, and migration strategies.
Architecture & Design Patterns	L61-L67	Architectural patterns for FHIR, DICOM, and de-identification: disaster recovery setup, reliable anonymization services, DICOM + Data Lake integration, and digital pathology workflow design.
Limits & Quotas	L68-L73	Autoscaling and performance tuning for Azure API for FHIR/FHIR service, plus supported languages and limits for the Azure Health de-identification service.
Security	L74-L114	Configuring secure access to FHIR/DICOM/HDI: Entra app registration, auth flows and tokens, RBAC and policies, CMK encryption, network/Private Link, and SMART on FHIR.
Configuration	L115-L172	Configuring FHIR, DICOM, and MedTech services: bulk ops, profiles/validation, CORS, logging/metrics, de-identification, events, security (Private Link), and standards (CARIN, Da Vinci).
Integrations & Coding Patterns	L173-L205	Coding patterns and integration guides for FHIR, DICOM, MedTech, and de-identification APIs, including REST/SDK usage, bulk ops, data pipelines, and connections to Synapse, ADF, AML, Power BI, and Teams.
Deployment	L206-L222	How to deploy and move Azure Health Data Services (FHIR, DICOM, de-identification, workspaces) using portal, ARM, Bicep, CLI, PowerShell, and check regional availability

Troubleshooting

Topic	URL
Validate and troubleshoot Azure API for FHIR access tokens	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/azure-api-fhir-access-token-validation
Troubleshoot Azure Health Data Services events issues	https://learn.microsoft.com/en-us/azure/healthcare-apis/events/events-troubleshooting-guide
Troubleshoot FHIR $convert-data operation failures	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/convert-data-troubleshoot
Troubleshoot FHIR identity provider configuration issues	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/troubleshoot-identity-provider-configuration
Review known issues for Azure Health Data Services	https://learn.microsoft.com/en-us/azure/healthcare-apis/known-issues

Best Practices

Topic	URL
Apply customer-managed key best practices to DICOM service	https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/customer-managed-keys
Best practices for CMK in FHIR service	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/customer-managed-keys
Apply performance best practices for FHIR service	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-best-practices
Run and manage FHIR reindex jobs safely	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/how-to-run-a-reindex

Decision Making

Topic	URL
Plan migration from Azure API for FHIR retirement	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/release-notes-2026
Plan migration from Azure API for FHIR to FHIR service	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/migration-faq
Plan migration from Azure API for FHIR to Health Data Services	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/migration-strategies

Architecture & Design Patterns

Topic	URL
Configure disaster recovery for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/disaster-recovery
Architect DICOM service with Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-data-lake
Implement digital pathology workflows with DICOM service	https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-digital-pathology

Limits & Quotas

Topic	URL
Use autoscale with Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/autoscale-azure-api-fhir
Use autoscale for FHIR service performance and capacity	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/autoscale

Security

Topic	URL
Configure authentication and authorization for Health Data Services	https://learn.microsoft.com/en-us/azure/healthcare-apis/authentication-authorization
Configure Entra identity and auth for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/azure-active-directory-identity-configuration
Configure Azure RBAC for Azure API for FHIR data plane	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-azure-rbac
Configure local RBAC with secondary Entra tenant for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-local-rbac
Configure customer-managed keys for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/customer-managed-key
Register Microsoft Entra apps for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/fhir-app-registration
Locate identity object IDs for Azure API for FHIR auth	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/find-identity-object-ids
Get Azure API for FHIR access token via Azure CLI	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/get-healthcare-apis-access-token-cli
Apply built-in Azure Policy definitions to Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/policy-reference
Register confidential client apps for Azure API for FHIR

Configuration

Topic	URL
Bulk delete FHIR resources in Azure Health Data Services	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/bulk-delete-operation
Configure Azure API for FHIR for CARIN Blue Button	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/carin-implementation-guide-blue-button-tutorial
Configure CORS for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-cross-origin-resource-sharing
Configure database settings for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-database
Configure bulk export settings for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-export-data
Set up Private Link for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/configure-private-link
Configure Azure API for FHIR for Da Vinci Drug Formulary	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/davinci-drug-formulary-tutorial
Configure Azure API for FHIR for Da Vinci PDex	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/davinci-pdex-tutorial
Configure Azure API for FHIR for Da Vinci Plan Net	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/davinci-plan-net
Set up de-identified export for Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/de-identified-export

Integrations & Coding Patterns

Topic	URL
Access FHIR and DICOM APIs with cURL and SDKs	https://learn.microsoft.com/en-us/azure/healthcare-apis/access-healthcare-apis
Use $convert-data endpoint in Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/convert-data
Copy Azure API for FHIR data into Synapse	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/copy-to-synapse
Execute FHIR bulk $export with Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/export-data
Use FHIR REST API capabilities in Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/fhir-rest-api-capabilities
Use Patient-everything operation in Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/patient-everything
Use FHIR search examples with Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/search-samples
Enable SMART on FHIR apps with Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/smart-on-fhir
Use $member-match operation with Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/tutorial-member-match
Build a web app that calls Azure API for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/tutorial-web-app-write-web-app

Deployment

Topic	URL
Deploy Azure API for FHIR with ARM templates	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/azure-api-fhir-resource-manager-template
Move Azure API for FHIR between subscriptions or groups	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/move-fhir-service
Deploy de-identification service in Azure Health Data Services	https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart
Deploy de-identification service using ARM template	https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-arm
Deploy de-identification service using Azure CLI	https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-azure-cli
Deploy de-identification service with Bicep	https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-bicep
Deploy de-identification service using Azure PowerShell	https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-powershell
Deploy Azure Health Data Services workspace with Bicep	https://learn.microsoft.com/en-us/azure/healthcare-apis/deploy-healthcare-apis-using-bicep
Deploy DICOM service using Azure portal	https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/deploy-dicom-services-in-azure
Deploy DICOM service backed by Azure Data Lake Storage	https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/deploy-dicom-services-in-azure-data-lake