快速入門：使用ARM範本來部署 Azure API for FHIR

發行項
03/08/2024

重要

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 API for FHIR 版本，可讓客戶管理 FHIR、DICOM 和 MedTech 服務，並整合至其他 Azure 服務。

在本快速入門中，您將瞭解如何使用 Azure Resource Manager 範本（ARM 範本）來部署適用於快速醫療保健互操作性資源的 Azure API。 ® 您可以透過 Azure 入口網站、PowerShell 或 CLI 來部署 Azure API for FHIR。

Azure Resource Manager 範本是 JavaScript 物件表示法（JSON）檔案，可定義專案的基礎結構和組態。範本使用宣告式語法。您不需要撰寫程式設計命令順序來建立部署，即可描述預定的部署。

如果您的環境符合必要條件，而且您很熟悉 ARM 範本，請選取 [部署至 Azure] 按鈕。登入后，範本會在 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 資源：

Microsoft.HealthcareApis/services

部署範本

選取下列連結，以使用 Azure 入口網站中的 ARM 範本來部署 Azure API for FHIR：

在 [ 部署 Azure API for FHIR ] 頁面上：

如果您想要，請將 [ 訂用帳戶 ] 從預設值變更為不同的訂用帳戶。
針對 [ 資源群組]，選取 [新建]，輸入新資源群組的名稱，然後選取 [ 確定]。
如果您已建立新的資源群組，請選取資源群組的區域。
輸入新的 服務名稱 ，然後選擇 Azure API for FHIR 的位置 。位置可以與資源群組的區域相同或不同。
選取 [檢閱 + 建立]。
閱讀條款和條件，然後選取 [ 建立]。

注意

如果您想要在本機執行 PowerShell 腳本，請先輸入 Connect-AzAccount 以設定您的 Azure 認證。

Microsoft.HealthcareApis如果資源提供者尚未為您的訂用帳戶註冊，您可以使用下列互動式程式代碼進行註冊。若要在 Azure Cloud Shell 中執行程式代碼，請選取任何程式代碼區塊右上角的 [試用]。

Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis

使用下列程序代碼，使用ARM範本部署 Azure API for FHIR 服務。程式代碼會提示您輸入新的 FHIR 服務名稱、新資源群組的名稱，以及每個資源群組的位置。

$serviceName = Read-Host -Prompt "Enter a name for the new Azure API for FHIR service"
$serviceLocation = Read-Host -Prompt "Enter an Azure region (for example, westus2) for the service"
$resourceGroupName = Read-Host -Prompt "Enter a name for the new resource group to contain the service"
$resourceGroupRegion = Read-Host -Prompt "Enter an Azure region (for example, centralus) for the resource group"

Write-Verbose "New-AzResourceGroup -Name $resourceGroupName -Location $resourceGroupRegion" -Verbose
New-AzResourceGroup -Name $resourceGroupName -Location $resourceGroupRegion
Write-Verbose "Run New-AzResourceGroupDeployment to create an Azure API for FHIR service using an ARM template" -Verbose
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName `
    -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/azure-api-for-fhir/azuredeploy.json `
    -serviceName $serviceName `
    -location $serviceLocation
Read-Host "Press [ENTER] to continue"

az extension add --name healthcareapis

使用下列程序代碼，使用ARM範本部署 Azure API for FHIR 服務。程式代碼會提示您輸入新的 FHIR 服務名稱、新資源群組的名稱，以及每個資源群組的位置。

read -p "Enter a name for the new Azure API for FHIR service: " serviceName &&
read -p "Enter an Azure region (for example, westus2) for the service: " serviceLocation &&
read -p "Enter a name for the new resource group to contain the service: " resourceGroupName &&
read -p "Enter an Azure region (for example, centralus) for the resource group: " resourceGroupRegion &&
params='serviceName='$serviceName' location='$serviceLocation &&
echo "CREATE RESOURCE GROUP:  az group create --name $resourceGroupName --location $resourceGroupRegion" &&
az group create --name $resourceGroupName --location $resourceGroupRegion &&
echo "RUN az deployment group create, which creates an Azure API for FHIR service using an ARM template" &&
az deployment group create --resource-group $resourceGroupName --parameters $params --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/azure-api-for-fhir/azuredeploy.json &&
read -p "Press [ENTER] to continue: "

注意

部署需要幾分鐘的時間才能完成。記下 Azure API for FHIR 服務和資源群組的名稱，您稍後會用來檢閱已部署的資源。

檢閱已部署的資源

請遵循下列步驟來查看新 Azure API for FHIR 服務的概觀：

在 Azure 入口網站中，搜尋並選取 [Azure API for FHIR]。
在 FHIR 清單中，選取您的新服務。新的 Azure API for FHIR 服務的 [ 概觀 ] 頁面隨即出現。
若要驗證已布建新的 FHIR API 帳戶，請選取 FHIR 元數據端點旁的連結以擷取 FHIR API 功能語句。連結的格式為 https://<service-name>.azurehealthcareapis.com/metadata。如果已布建帳戶，則會顯示大型 JSON 檔案。

執行下列交互式程序代碼，以檢視 Azure API for FHIR 服務的詳細數據。您必須輸入新服務和資源群組的名稱。

$serviceName = Read-Host -Prompt "Enter the name of your Azure API for FHIR service"
$resourceGroupName = Read-Host -Prompt "Enter the resource group name"
Write-Verbose "Get-AzHealthcareApisService -ResourceGroupName $resourceGroupName -Name $serviceName" -Verbose
Get-AzHealthcareApisService -ResourceGroupName $resourceGroupName -Name $serviceName
Read-Host "Press [ENTER] to fetch the FHIR API capability statement, which shows that the new service has been provisioned"

$requestUri="https://" + $serviceName + ".azurehealthcareapis.com/metadata"
$metadata = Invoke-WebRequest -Uri $requestUri
$metadata.RawContent
Read-Host "Press [ENTER] to continue"

執行下列交互式程序代碼，以檢視 Azure API for FHIR 服務的詳細數據。您必須輸入新服務和資源群組的名稱。

read -p "Enter the name of your Azure API for FHIR service: " serviceName &&
read -p "Enter the resource group name: " resourceGroupName &&
echo "SHOW SERVICE DETAILS:  az healthcareapis service show --resource-group $resourceGroupName --resource-name $serviceName" &&
az healthcareapis service show --resource-group $resourceGroupName --resource-name $serviceName &&
read -p "Press [ENTER] to fetch the FHIR API capability statement, which shows that the new service has been provisioned: " &&
requestUrl='https://'$serviceName'.azurehealthcareapis.com/metadata' &&
curl --url $requestUrl &&
read -p "Press [ENTER] to continue: "

清除資源

不再需要資源群組時，請刪除資源群組，以刪除資源群組中的資源。

在 Azure 入口網站中，搜尋並選取 [資源群組]。
在資源群組清單中，選擇資源群組的名稱。
在資源群組的 [ 概觀] 頁面中，選取 [ 刪除資源群組]。
在確認對話框中，輸入資源群組的名稱，然後選取 [ 刪除]。

$resourceGroupName = Read-Host -Prompt "Enter the name of the resource group to delete"
Write-Verbose "Remove-AzResourceGroup -Name $resourceGroupName" -Verbose
Remove-AzResourceGroup -Name $resourceGroupName
Read-Host "Press [ENTER] to continue"

read -p "Enter the name of the resource group to delete: " resourceGroupName &&
echo "DELETE A RESOURCE GROUP (AND ITS RESOURCES):  az group delete --name $resourceGroupName" &&
az group delete --name $resourceGroupName &&
read -p "Press [ENTER] to continue: "

如需逐步教學課程，引導您完成建立ARM範本的程式，請參閱建立和部署第一個ARM範本的教學課程