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 APIs, bulk import/export, de-identification, Synapse/ADF pipelines, or SMART on FHIR, and other Azure Health Data Services related development tasks. Not for Azure Health Bot (use azure-health-bot), Azure Data Factory (use azure-data-factory), Azure Synapse Analytics (use azure-synapse-analytics), Azure Machine Learning (use azure-machine-learning).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-08-02","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-L46	Diagnosing and fixing Azure Health Data Services issues: FHIR access tokens, event delivery problems, $convert-data failures, identity provider setup, and known platform limitations.
Best Practices	L47-L55	Best practices for securing and managing Azure Health Data Services: BCDR planning, CMK encryption for FHIR/DICOM, performance tuning, and safely running FHIR reindex jobs.
Decision Making	L56-L64	Planning and executing migrations from Azure API for FHIR and SMART on FHIR proxy to Azure Health Data Services, plus answers to common Azure API for FHIR questions.
Architecture & Design Patterns	L65-L71	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	L72-L77	Scaling and performance limits for Azure API for FHIR and DICOM: autoscale setup, throughput and request caps, storage and size constraints, and service-specific behavior under load.
Security	L78-L117	Configuring auth, RBAC, identities, keys, policies, network and client app security for Azure Health Data Services (FHIR, DICOM, de-identification) including tokens, CMK, Private Link, and SMART on FHIR.
Configuration	L118-L168	Configuring Azure Health Data Services (FHIR and DICOM): CORS, logging, bulk import/export, de-identification, profiles, search, history/versioning, events, and standards-specific integrations.
Integrations & Coding Patterns	L169-L206	Using FHIR and DICOM APIs with cURL/SDKs, bulk export/import, search, de-identification, events, and integrating with Synapse, ADF, Logic Apps, and Da Vinci/CARIN implementations
Deployment	L207-L220	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
Resolve common Azure Health Data Services event issues	https://learn.microsoft.com/en-us/azure/healthcare-apis/events/events-faqs
Troubleshoot event delivery in Azure Health Data Services	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 service identity provider setup	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
Plan BCDR for Azure Health Data Services workloads	https://learn.microsoft.com/en-us/azure/healthcare-apis/business-continuity-disaster-recovery
Apply customer-managed key best practices to DICOM service	https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/customer-managed-keys
Apply customer-managed key best practices for FHIR	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/customer-managed-keys
Apply performance best practices for Azure FHIR service	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-best-practices
Run reindex jobs safely in Azure FHIR service	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/how-to-run-a-reindex

Decision Making

Topic	URL
Answer common Azure API for FHIR questions	https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/fhir-faq
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 and execute migration from Azure API for FHIR	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
Plan migration from SMART on FHIR proxy to native	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/smart-on-fhir-proxy

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
Understand DICOM service requirements and limits	https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-services-faqs

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
Configure bulk delete operations for Azure FHIR	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
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
Bulk de-identify documents via asynchronous Python API	https://learn.microsoft.com/en-us/azure/healthcare-apis/deidentification/quickstart-asynchronous-python

Deployment

Topic	URL
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
Deploy FHIR service via Azure portal	https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/deploy-azure-portal