Snabbstart: Använda en ARM-mall för att distribuera Azure API för FHIR
Artikel
Viktigt!
Azure API för FHIR avvecklas den 30 september 2026. Följ migreringsstrategierna för att övergå till Azure Health Data Services FHIR-tjänsten® senast det datumet. På grund av tillbakadragandet av Azure API för FHIR tillåts inte nya distributioner från och med den 1 april 2025.
Azure Health Data Services FHIR-tjänsten är den utvecklade versionen av Azure API för FHIR som gör det möjligt för kunder att hantera FHIR-, DICOM- och MedTech-tjänster med integreringar i andra Azure-tjänster.
I den här snabbstarten får du lära dig hur du använder en Azure Resource Manager-mall (ARM-mall) för att distribuera Azure API for Fast Healthcare Interoperability Resources (FHIR®). Du kan distribuera Azure API för FHIR via Azure Portal, PowerShell eller CLI.
En Azure Resource Manager-mall är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för projektet. Mallen använder deklarativ syntax. Du beskriver den avsedda distributionen utan att skriva sekvensen med programmeringskommandon för att skapa distributionen.
Om din miljö uppfyller förhandskraven och du är van att använda ARM-mallar väljer du knappen Distribuera till Azure. Mallen öppnas i Azure Portal när du loggar in.
Välj följande länk för att distribuera Azure API för FHIR med hjälp av ARM-mallen i Azure Portal:
På sidan Distribuera Azure API för FHIR :
Om du vill kan du ändra prenumerationen från standardvärdet till en annan prenumeration.
För Resursgrupp väljer du Skapa ny, anger ett namn för den nya resursgruppen och väljer OK.
Om du har skapat en ny resursgrupp väljer du en region för resursgruppen.
Ange ett nytt tjänstnamn och välj Platsen för Azure API för FHIR. Platsen kan vara samma som eller skilja sig från resursgruppens region.
Välj Granska + skapa.
Läs villkoren och välj sedan Skapa.
Kommentar
Om du vill köra PowerShell-skripten lokalt anger du Connect-AzAccount först för att konfigurera dina Azure-autentiseringsuppgifter.
Om resursprovidern Microsoft.HealthcareApis inte redan är registrerad för din prenumeration kan du registrera den med följande interaktiva kod. Om du vill köra koden i Azure Cloud Shell väljer du Prova i det övre hörnet i alla kodblock.
Använd följande kod för att distribuera Azure API för FHIR-tjänsten med hjälp av ARM-mallen. Koden frågar efter det nya FHIR-tjänstnamnet, namnet på en ny resursgrupp och platserna för var och en av dem.
$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"
Om resursprovidern Microsoft.HealthcareApis inte redan är registrerad för din prenumeration kan du registrera den med följande interaktiva kod. Om du vill köra koden i Azure Cloud Shell väljer du Prova i det övre hörnet i alla kodblock.
az extension add --name healthcareapis
Använd följande kod för att distribuera Azure API för FHIR-tjänsten med hjälp av ARM-mallen. Koden frågar efter det nya FHIR-tjänstnamnet, namnet på en ny resursgrupp och platserna för var och en av dem.
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: "
Kommentar
Distributionen tar några minuter att slutföra. Observera namnen på Azure API för FHIR-tjänsten och resursgruppen för att kunna granska distribuerade resurser.
Följ de här stegen för att se en översikt över ditt nya Azure API för FHIR-tjänsten:
I Azure Portal söker du efter och väljer Azure API för FHIR.
I FHIR-listan väljer du din nya tjänst. Sidan Översikt för det nya Azure API för FHIR-tjänsten visas.
Om du vill verifiera att det nya FHIR API-kontot har etablerats väljer du länken bredvid FHIR-metadataslutpunkten för att hämta FHIR API-funktionsuttryck. Länken har formatet https://<service-name>.azurehealthcareapis.com/metadata. Om kontot har etablerats visas en JSON-fil.
Kör följande interaktiva kod för att visa information om azure-API:et för FHIR-tjänsten. Du måste ange namnet och resursgruppen för den nya tjänsten.
$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"
Kör följande interaktiva kod för att visa information om azure-API:et för FHIR-tjänsten. Du måste ange namnet på den nya tjänsten och resursgruppen.
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: "
Rensa resurser
När den inte längre behövs tar du bort resursgruppen. Detta tar bort resurserna i resursgruppen.
I Azure Portal söker du efter och väljer Resursgrupper.
I resursgruppslistan väljer du namnet på resursgruppen.
På sidan Översikt för resursgruppen väljer du Ta bort resursgrupp.
I bekräftelsedialogrutan skriver du namnet på resursgruppen och väljer sedan Ta bort.
$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: "
I den här snabbstartsguiden har du distribuerat Azure API för FHIR till din prenumeration. Information om hur du registrerar program och Konfigurationsinställningar för Azure API för FHIR finns i följande.