Partager via

Démarrage rapide : déployer l’API Azure pour FHIR à l’aide de PowerShell

  • Article

Important

L’API Azure pour FHIR sera mise hors service le 30 septembre 2026. Suivez les stratégies de migration pour passer au service FHIR des Services de données de santé Azure d’ici cette date. En raison de la mise hors service de l’API Azure pour FHIR, les nouveaux déploiements ne seront plus autorisés à compter du 1er avril 2025. Le service FHIR des Services de données de santé Azure est la version évoluée de l’API Azure pour FHIR qui permet aux clients de gérer les services FHIR, DICOM et MedTech avec des intégrations dans d’autres services Azure.

Dans ce guide de démarrage rapide, vous allez apprendre à déployer l’API Azure pour FHIR à l’aide de PowerShell.

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Azure Cloud Shell

Azure héberge Azure Cloud Shell, un environnement d’interpréteur de commandes interactif que vous pouvez utiliser dans votre navigateur. Vous pouvez utiliser Bash ou PowerShell avec Cloud Shell pour utiliser les services Azure. Vous pouvez utiliser les commandes préinstallées Cloud Shell pour exécuter le code de cet article sans avoir à installer quoi que ce soit dans votre environnement local.

Pour démarrer Azure Cloud Shell :

Option Exemple/Lien
Sélectionnez Essayer dans le coin supérieur droite d’un bloc de codes ou de commandes. La sélection de Essayer ne copie pas automatiquement le code ni la commande dans Cloud Shell. Capture d’écran présentant un exemple d’essai pour Azure Cloud Shell.
Accédez à https://shell.azure.com ou sélectionnez le bouton Lancer Cloud Shell pour ouvrir Cloud Shell dans votre navigateur. Bouton permettant de lancer Azure Cloud Shell.
Sélectionnez le bouton Cloud Shell dans la barre de menus en haut à droite du portail Azure. Capture d’écran présentant le bouton Cloud Shell dans le portail Azure.

Pour utiliser Azure Cloud Shell :

  1. Démarrez Cloud Shell.

  2. Sélectionnez le bouton Copier sur un bloc de codes (ou un bloc de commandes) pour copier le code ou la commande.

  3. Collez le code ou la commande dans la session Cloud Shell en sélectionnant Ctrl+Maj+V sur Windows et Linux ou en sélectionnant Cmd+Maj+V sur macOS.

  4. Sélectionnez Entrer pour exécuter le code ou la commande.

Notes

Nous vous recommandons d’utiliser le module Azure Az PowerShell pour interagir avec Azure. Pour bien démarrer, consultez Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Inscrire le fournisseur de ressources d’API Azure pour FHIR

Si le fournisseur de ressources Microsoft.HealthcareApis n’est pas déjà inscrit pour votre abonnement, vous pouvez l’inscrire avec :

Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis

Créer un groupe de ressources Azure

New-AzResourceGroup -Name "myResourceGroupName" -Location westus2

Déployer l’API Azure pour FHIR

New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4

Remarque

En fonction de la version du module PowerShell Az que vous avez installée, le serveur FHIR provisionné peut être configuré pour utiliser l’authentification RBAC locale. De plus, il est possible qu’il comporte l’utilisateur PowerShell connecté dans la liste des ID d’objet d’identité autorisés pour le service FHIR déployé. À l’avenir, nous vous recommandons d’utiliser Azure RBAC pour attribuer des rôles de plan de données. Vous devrez peut-être supprimer cet ID d’objet utilisateur après le déploiement pour activer le mode Azure RBAC.

Récupérer la déclaration de capacité

Vous pourrez vérifier que le compte d’API Azure pour FHIR est en cours d’exécution en récupérant une déclaration de capacité FHIR :

$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent

Nettoyer les ressources

Si vous ne comptez pas continuer à utiliser cette application, supprimez le groupe de ressources en effectuant les étapes suivantes :

Remove-AzResourceGroup -Name myResourceGroupName

Étapes suivantes

Dans ce guide de démarrage rapide, vous avez déployé l’API Azure pour FHIR sur votre abonnement. Pour plus d’informations sur les paramètres dans l’API Azure pour FHIR et pour commencer à utiliser l’API Azure pour FHIR, consultez

Paramètres supplémentaires dans l’API Azure pour FHIR

Présentation de l’inscription d’applications

Configurer le RBAC Azure

Configurer un contrôle RBAC local

Configuration des paramètres de la base de données

Configurer les clés gérées par le client

Configuration de CORS

Configurer une liaison privée

FHIR® est une marque déposée de HL7 utilisé avec l’autorisation de HL7.