Guida introduttiva: Usare un modello di Resource Manager per distribuire l'API di Azure per FHIR
Importante
L'API di Azure per FHIR verrà ritirata il 30 settembre 2026. Seguire le strategie di migrazione per passare al servizio FHIR di Servizi dati di integrità di Azure entro tale data. A causa del ritiro dell'API di Azure per FHIR, le nuove distribuzioni non saranno consentite a partire dal 1° aprile 2025. Il servizio FHIR di Servizi dati di Integrità di Azure è la versione evoluta dell'API di Azure per FHIR che consente ai clienti di gestire i servizi FHIR, DICOM e MedTech con integrazioni in altri servizi di Azure.
Questo argomento di avvio rapido illustra come usare un modello di Azure Resource Manager (ARM) per distribuire l'API di Azure per Fast Healthcare Interoperability Resources (FHIR®). Per distribuire l'API di Azure per FHIR è possibile usare il portale di Azure, PowerShell o l'interfaccia della riga di comando.
Un modello di Azure Resource Manager è un file JSON (JavaScript Object Notation) che definisce l'infrastruttura e la configurazione per il progetto. Il modello utilizza la sintassi dichiarativa. Si descrive la distribuzione prevista senza scrivere la sequenza di comandi di programmazione per creare la distribuzione.
Se l'ambiente soddisfa i prerequisiti e si ha familiarità con l'uso dei modelli di Resource Manager, selezionare il pulsante Distribuisci in Azure. Il modello verrà aperto nel portale di Azure dopo l'accesso.
Prerequisiti
Un account Azure con una sottoscrizione attiva. Crearne una gratuitamente.
Rivedere il modello
Il modello usato in questo avvio rapido proviene dai modelli di avvio rapido di 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)]"
}
}
}
]
}
Il modello definisce una risorsa di Azure:
- Microsoft.HealthcareApis/services
Distribuire il modello
Selezionare il collegamento seguente per distribuire l'API di Azure per FHIR usando il modello di Resource Manager nel portale di Azure:
Nella pagina Deploy Azure API for FHIR (Distribuisci API di Azure per FHIR):
Se si vuole, in Sottoscrizione sostituire l'impostazione predefinita con un'altra sottoscrizione.
In Gruppo di risorse selezionare Crea nuovo, immettere un nome per il nuovo gruppo di risorse e quindi fare clic su OK.
Se è stato creato un nuovo gruppo di risorse, in Area selezionare un valore per il gruppo di risorse.
Immettere un nuovo nome del servizio e scegliere la località dell'API di Azure per FHIR. La località può corrispondere o meno all'area del gruppo di risorse.
Selezionare Rivedi e crea.
Leggere le condizioni e quindi selezionare Crea.
Nota
Il completamento della distribuzione richiede alcuni minuti. Prendere nota dei nomi del servizio API di Azure per FHIR e del gruppo di risorse, che verranno usati più avanti per verificare le risorse distribuite.
Esaminare le risorse distribuite
Seguire questa procedura per visualizzare una panoramica del nuovo servizio API di Azure per FHIR:
Nel portale di Azure cercare e selezionare API di Azure per FHIR.
Nell'elenco dei servizi FHIR selezionare il nuovo servizio. Verrà visualizzata la pagina Panoramica del nuovo servizio API di Azure per FHIR.
Per verificare che sia stato effettuato il provisioning del nuovo account API FHIR, selezionare il collegamento accanto a endpoint di metadati FHIR per recuperare la dichiarazione di funzionalità dell'API FHIR. Il collegamento è nel formato
https://<service-name>.azurehealthcareapis.com/metadata. Se è stato effettuato il provisioning dell'account, viene visualizzato un file JSON di grandi dimensioni.
Pulire le risorse
Quando non è più necessario, eliminare il gruppo di risorse per eliminare tutte le risorse contenute al suo interno.
Nel portale di Azure cercare e selezionare Gruppi di risorse.
Nell'elenco dei gruppi di risorse scegliere il nome del gruppo di risorse.
Nella pagina Panoramica del gruppo di risorse selezionare Elimina gruppo di risorse.
Nella finestra di dialogo di conferma, digitare il nome del gruppo di risorse e quindi selezionare Elimina.
Per un'esercitazione dettagliata che illustra il processo di creazione di un modello di Resource Manager, vedere Esercitazione: Creare e distribuire il primo modello di Azure Resource Manager
Passaggi successivi
In questa guida di avvio rapido è stata distribuita l'API di Azure per FHIR nella sottoscrizione. Per informazioni su come registrare le applicazioni e le impostazioni di configurazione dell'API di Azure per FHIR, vedere
FHIR® è un marchio registrato di HL7 e viene usato con l'autorizzazione di HL7.