クイックスタート: ARM テンプレートを使用して 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 です。

このクイックスタートでは、Azure Resource Manager テンプレート (ARM テンプレート) を使用して Azure API for FHIR® (Fast Healthcare Interoperability Resources) をデプロイする方法について説明します。 Azure API for FHIR は、Azure portal、PowerShell、CLI のいずれかを使用してデプロイできます。

Azure Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。 このテンプレートでは、宣言型の構文が使用されています。 デプロイしようとしているものを、デプロイを作成する一連のプログラミング コマンドを記述しなくても記述できます。

環境が前提条件を満たしていて、ARM テンプレートの使用に慣れている場合は、 [Azure へのデプロイ] ボタンを選択します。 Azure portal にサインイン後、テンプレートが開きます。

Button to deploy the Resource Manager template to Azure.

前提条件

アクティブなサブスクリプションが含まれる Azure アカウント。 無料で作成できます。

テンプレートを確認する

このクイックスタートで使用されるテンプレートは Azure クイックスタート テンプレートからのものです。

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "9588053699595008971"
    }
  },
  "parameters": {
    "serviceName": {
      "type": "string",
      "metadata": {
        "description": "The name of the service."
      }
    },
    "location": {
      "type": "string",
      "allowedValues": [
        "australiaeast",
        "eastus",
        "eastus2",
        "japaneast",
        "northcentralus",
        "northeurope",
        "southcentralus",
        "southeastasia",
        "uksouth",
        "ukwest",
        "westcentralus",
        "westeurope",
        "westus2"
      ],
      "metadata": {
        "description": "Location of Azure API for FHIR"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.HealthcareApis/services",
      "apiVersion": "2021-11-01",
      "name": "[parameters('serviceName')]",
      "location": "[parameters('location')]",
      "kind": "fhir-R4",
      "properties": {
        "authenticationConfiguration": {
          "audience": "[format('https://{0}.azurehealthcareapis.com', parameters('serviceName'))]",
          "authority": "[uri(environment().authentication.loginEndpoint, subscription().tenantId)]"
        }
      }
    }
  ]
}

このテンプレートには、次の Azure リソースが 1 つ定義されています。

  • Microsoft.HealthcareApis/services

テンプレートのデプロイ

Azure portal から ARM テンプレートを使用して Azure API for FHIR をデプロイするには、次のリンクを選択します。

Button to deploy the Resource Manager template to Azure.

[Deploy Azure API for FHIR]\(Azure API for FHIR のデプロイ\) ページで、次の作業を行います。

  1. [サブスクリプション] が既定値になっているので、必要に応じて別のサブスクリプションに変更します。

  2. [リソース グループ] の [新規作成] を選択し、新しいリソース グループの名前を入力し、 [OK] を選択します。

  3. 新しいリソース グループを作成した場合は、リソース グループのリージョンを選択します。

  4. 新しいサービス名を入力し、Azure API for FHIR の場所を選択します。 この場所は、リソース グループのリージョンと同じでも異なっていてもかまいません。

    Deploy Azure API for FHIR using the ARM template in the Azure portal.

  5. [Review + create](レビュー + 作成) を選択します。

  6. 利用規約を読んで、 [作成] を選択します。

Note

デプロイが完了するまでに数分かかる場合があります。 Azure API for FHIR サービスの名前とリソース グループの名前は書き留めておいてください。デプロイしたリソースを後で確認する際に使用します。

デプロイされているリソースを確認する

新しい Azure API for FHIR サービスの概要を確認するには、次の手順に従います。

  1. Azure portal で、Azure API for FHIR を検索して選択します。

  2. FHIR の一覧から新しいサービスを選択します。 新しい Azure API for FHIR サービスの [概要] ページが表示されます。

  3. 新しい FHIR API アカウントがプロビジョニングされていることを確認するために、FHIR メタデータ エンドポイントの横にあるリンクを選択して、FHIR API 機能ステートメントをフェッチします。 このリンクは https://<service-name>.azurehealthcareapis.com/metadata という形式になっています。 アカウントがプロビジョニングされると、大きな JSON ファイルが表示されます。

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

不要になったら、リソース グループを削除してください。リソース グループを削除すれば、リソース グループ内のリソースが削除されます。

  1. Azure portal で、 [リソース グループ] を検索して選択します。

  2. リソース グループの一覧で、リソース グループの名前を選択します。

  3. リソース グループの [概要] ページで、 [リソース グループの削除] を選択します。

  4. 確認のダイアログ ボックスでリソース グループの名前を入力し、 [削除] を選択します。

ARM テンプレートの作成手順については、初めての ARM テンプレートを作成してデプロイするチュートリアルを参照してください。

次のステップ

このクイックスタート ガイドでは、ご利用のサブスクリプションに Azure API for FHIR をデプロイしました。 アプリケーションと Azure API for FHIR の構成設定を登録する方法については、以下を参照してください

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

Azure RBAC を構成する

ローカル RBAC を構成する

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

顧客管理キーの構成

CORS を構成する

Private Link を構成する

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