クイック スタート: PowerShell を使用して Azure API for FHIR をデプロイする

重要

Azure API for FHIR は、2026 年 9 月 30 日に廃止されます。 移行戦略 に従って、その日までに Azure Health Data Services FHIR サービス に移行します。 Azure API for FHIR が廃止されたため、2025 年 4 月 1 日以降、新しいデプロイは許可されません。 Azure Health Data Services FHIR サービス は、お客様が他の Azure サービスへの統合を使用して、FHIR、DICOM、および MedTech サービスを管理できるようにする、進化したバージョンの Azure API for FHIR です。

このクイックスタートでは、PowerShell を使用して Azure API for FHIR をデプロイする方法について説明します。

Azure サブスクリプションをお持ちでない場合は、開始する前に 無料アカウント を作成してください。

Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。 Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。 ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。

Azure Cloud Shell を開始するには、以下のようにします。

オプション	例とリンク
コードまたはコマンド ブロックの右上隅にある [使ってみる] を選択します。 [使ってみる] を選択しても、コードまたはコマンドは Cloud Shell に自動的にはコピーされません。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。
Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。

Azure Cloud Shell を使用するには、以下のようにします。

1. Cloud Shell を開始します。

2. コード ブロック (またはコマンド ブロック) の [コピー] ボタンを選択し、コードまたはコマンドをコピーします。

3. Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードまたはコマンドを Cloud Shell セッションに貼り付けます。

4. Enter キーを選択して、コードまたはコマンドを実行します。

注意

Azure を操作するには、Azure Az PowerShell モジュールを使用することをお勧めします。 作業を始めるには、「Azure PowerShell をインストールする」を参照してください。 Az PowerShell モジュールに移行する方法については、「AzureRM から Az への Azure PowerShell の移行」を参照してください。

Azure API for FHIR リソースプロバイダーを登録する

Microsoft.HealthcareApis リソース プロバイダーがまだサブスクリプションに登録されていない場合は、次で登録できます。

Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis

Azure リソース グループを作成する

New-AzResourceGroup -Name "myResourceGroupName" -Location westus2

Azure API for FHIR をデプロイする

New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4

Note

インストールした Az PowerShell モジュールのバージョンによっては、プロビジョニング済みの FHIR サーバーがローカル RBAC を使用するように構成され、デプロイされた FHIR サービスの許可された ID オブジェクト ID の一覧に、現在サインインしている PowerShell ユーザーが設定されている場合があります。 今後、データ プレーン ロールの割り当てには Azure RBAC の使用をお勧めします。また、デプロイ後は、Azure RBAC モードを有効にするために、このユーザー オブジェクト ID を削除しなければならない場合があります。

機能ステートメントをフェッチする

Azure API for FHIR アカウントが実行されていることは、FHIR 機能ステートメントをフェッチすることで確認できます。

$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent

リソースをクリーンアップする

このアプリケーションを引き続き使用しない場合は、次の手順でリソース グループ全体を削除します。

Remove-AzResourceGroup -Name myResourceGroupName

次のステップ

このクイックスタート ガイドでは、ご利用のサブスクリプションに Azure API for FHIR をデプロイしました。 Azure API for FHIR での設定と、Azure API for FHIR を使い始める方法について詳しくは、以下をご覧ください

Azure API for FHIR の追加設定

アプリケーションの登録の概要

Azure RBAC を構成する

ローカル RBAC を構成する

データベース設定を構成する

顧客管理キーの構成

CORS を構成する

Private Link を構成する

FHIR® は HL7 の登録商標であり、HL7 の許可を得て使用しています。