azure-health-data-services
Azure Health Data Services開発全般について、トラブルシューティングからセキュリティ、連携、デプロイまで、ベストプラクティスに基づき支援するSkill。
📜 元の英語説明(参考)
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, SMART on FHIR, Synapse/ADF pipelines, or CMK encryption, 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).
🇯🇵 日本人クリエイター向け解説
Azure Health Data Services開発全般について、トラブルシューティングからセキュリティ、連携、デプロイまで、ベストプラクティスに基づき支援するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-17
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Azure Health Data Services スキル
このスキルは、Azure Health Data Services に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツとリモートドキュメント取得機能を組み合わせています。
このスキルの使用方法
エージェントへの重要事項: 以下のカテゴリインデックスを使用して、関連するセクションを見つけてください。行範囲が指定されているカテゴリ（例:
L35-L120）については、指定された行でread_fileを使用してください。ファイルリンクが指定されているカテゴリ（例:[security.md](security.md)）については、リンクされた参照ファイルでread_fileを使用してください。
エージェントへの重要事項:
metadata.generated_atが3か月以上前の場合、ユーザーにリポジトリから最新バージョンをプルするように提案してください。mcp_microsoftdocsツールが利用できない場合、ユーザーにインストールを提案してください: インストールガイド
このスキルは、ドキュメントコンテンツを取得するためにネットワークアクセスを必要とします。
- 推奨: クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用してください。Markdown を返します。 - フォールバック: クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用してください。Markdown を返します。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L45 | Azure Health Data Services の問題の診断と修正: FHIR アクセストークンの問題、イベント配信の失敗、$convert-data エラー、ID プロバイダーの誤設定、既知のプラットフォーム制限。 |
| ベストプラクティス | L46-L53 | FHIR/DICOM で顧客管理キーを使用するためのガイダンス、FHIR パフォーマンスの最適化、FHIR 再インデックスジョブの安全な実行、監視、管理。 |
| 意思決定 | L54-L59 | Azure API for FHIR から FHIR サービスまたは Azure Health Data Services への移行の計画と実行に関するガイダンス。これには、廃止のタイムライン、アーキテクチャ、移行戦略が含まれます。 |
| アーキテクチャと設計パターン | L60-L66 | FHIR、DICOM、および匿名化のためのアーキテクチャパターン: ディザスターリカバリ設定、信頼性の高い匿名化サービス、DICOM + Data Lake 統合、デジタル病理ワークフロー設計。 |
| 制限とクォータ | L67-L72 | Azure API for FHIR/FHIR サービスの自動スケーリングとパフォーマンスチューニング、および Azure Health 匿名化サービスでサポートされている言語と制限。 |
| セキュリティ | L73-L113 | FHIR/DICOM/HDI へのセキュアなアクセス構成: Entra アプリ登録、認証フローとトークン、RBAC とポリシー、CMK 暗号化、ネットワーク/プライベートリンク、SMART on FHIR。 |
| 構成 | L114-L169 | FHIR、DICOM、および MedTech サービスの構成: バルク操作、プロファイル/検証、CORS、ログ/メトリック、匿名化、イベント、セキュリティ（プライベートリンク）、および標準（CARIN、Da Vinci）。 |
| 統合とコーディングパターン | L170-L202 | FHIR、DICOM、MedTech、および匿名化 API のコーディングパターンと統合ガイド。これには、REST/SDK の使用、バルク操作、データパイプライン、Synapse、ADF、AML、Power BI、Teams への接続が含まれます。 |
| デプロイ | L203-L219 | ポータル、ARM、Bicep、CLI、PowerShell を使用した Azure Health Data Services（FHIR、DICOM、匿名化、ワークスペース）のデプロイと移動方法、およびリージョン可用性の確認。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure API for FHIR アクセストークンの検証とトラブルシューティング | https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/azure-api-fhir-access-token-validation |
| Azure Health Data Services でのイベント配信のトラブルシューティング | https://learn.microsoft.com/en-us/azure/healthcare-apis/events/events-troubleshooting-guide |
| FHIR $convert-data 操作の失敗のトラブルシューティング | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/convert-data-troubleshoot |
| FHIR ID プロバイダー構成の問題のトラブルシューティング | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/troubleshoot-identity-provider-configuration |
| Azure Health Data Services の既知の問題の確認 | https://learn.microsoft.com/en-us/azure/healthcare-apis/known-issues |
ベストプラクティス
| トピック | URL |
|---|---|
| DICOM サービスに顧客管理キーのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/customer-managed-keys |
| FHIR サービスにおける CMK のベストプラクティス | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/customer-managed-keys |
| FHIR サービスのパフォーマンスに関するベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/fhir-best-practices |
| FHIR 再インデックスジョブを安全に実行および管理する | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/how-to-run-a-reindex |
意思決定
| トピック | URL |
|---|---|
| Azure API for FHIR から FHIR サービスへの移行を計画する | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/migration-faq |
| Azure API for FHIR から Health Data Services への移行を計画する | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/migration-strategies |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Azure API for FHIR のディザスターリカバリを構成する | https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/disaster-recovery |
| Azure Data Lake Storage を使用して DICOM サービスを設計する | https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-data-lake |
| DICOM サービスでデジタル病理ワークフローを実装する | https://learn.microsoft.com/en-us/azure/healthcare-apis/dicom/dicom-digital-pathology |
制限とクォータ
| トピック | URL |
|---|---|
| Azure API for FHIR で自動スケーリングを使用する | https://learn.microsoft.com/en-us/azure/healthcare-apis/azure-api-for-fhir/autoscale-azure-api-fhir |
| FHIR サービスのパフォーマンスと容量のために自動スケーリングを使用する | https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/autoscale |
セキュリティ
| トピック | URL |
|---|---|
| 認証と承認を構成する |
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=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 token problems, event delivery failures, $convert-data errors, identity provider misconfig, 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-L59 | 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 | L60-L66 | 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 | L67-L72 | Autoscaling and performance tuning for Azure API for FHIR/FHIR service, plus supported languages and limits for the Azure Health de-identification service. |
| Security | L73-L113 | 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 | L114-L169 | 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 | L170-L202 | 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 | L203-L219 | 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 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 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 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 |