次の方法で共有

クイック スタート: 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 に自動的にはコピーされません。 Azure Cloud Shell の [使ってみる] の例を示すスクリーンショット。
https://shell.azure.com に移動するか、[Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。 Azure Cloud Shell を起動するボタン。
Azure portal の右上にあるメニュー バーの [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) を使うように構成され、現在サインインしている PowerShell ユーザーがデプロイされた FHIR サービスの許可された ID オブジェクト ID の一覧に含まれる場合があります。 データ プレーンのロールの割り当てには、Azure RBAC を使うことをお勧めします。 Azure RBAC モードを有効にするには、デプロイ後にこのユーザーのオブジェクト ID の削除が必要な場合があります。

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

次のコマンドを使って FHIR 機能ステートメントをフェッチして、Azure API for 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 を構成する

Note

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