Inicio: Implementación de Azure API for FHIR mediante PowerShell
Importante
Azure API for FHIR se retirará el 30 de septiembre de 2026. Siga las estrategias de migración para realizar la transición a servicio FHIR® de Azure Health Data Services en esa fecha. Debido a la retirada de Azure API for FHIR, no se permitirán nuevas implementaciones a partir del 1 de abril de 2025. El servicio FHIR de Azure Health Data Services es la versión evolucionada de la API de Azure para FHIR que permite a los clientes administrar FHIR, DICOM y los servicios de tecnologías médicas con integraciones en otros servicios de Azure.
En este inicio rápido va a aprender a implementar Azure API for FHIR mediante PowerShell.
Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.
Azure Cloud Shell
En Azure se hospeda Azure Cloud Shell, un entorno de shell interactivo que puede utilizar mediante el explorador. Puede usar Bash o PowerShell con Cloud Shell para trabajar con los servicios de Azure. Puede usar los comandos preinstalados de Cloud Shell para ejecutar el código de este artículo sin tener que instalar nada en su entorno local.
Para iniciar Azure Cloud Shell:
| Opción | Ejemplo o vínculo |
|---|---|
| Seleccione Pruébelo en la esquina superior derecha de un bloque de código o de comandos. Solo con seleccionar Pruébelo no se copia automáticamente el código o comando en Cloud Shell. |  |
| Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador. |  |
| Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal. |  |
Para usar Azure Cloud Shell:
Inicie Cloud Shell.
Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.
Pegue el código o comando en la sesión de Cloud Shell. Para ello, seleccione Ctrl+Mayús+V en Windows y Linux, o bien seleccione Cmd+Mayús+V en macOS.
Seleccione Enter para ejecutar el código o comando.
Nota
Se recomienda usar el módulo Azure Az de PowerShell para interactuar con Azure. Para comenzar, consulte Instalación de Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.
Registro del proveedor de recursos de Azure API for FHIR
Si el proveedor de recursos Microsoft.HealthcareApis no se ha registrado en la suscripción, puede registrarlo con el comando siguiente.
Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis
Creación del grupo de recursos de Azure
New-AzResourceGroup -Name "myResourceGroupName" -Location westus2
Implementación de Azure API for FHIR
New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4
Nota:
Según la versión del Az módulo PowerShell que haya instalado, el servidor FHIR aprovisionado puede estar configurado para utilizar control de acceso basado en roles (RBAC) local y tener el usuario PowerShell actualmente registrado en la lista de ID de objetos de identidad permitidos para el servicio FHIR implementado. Se recomienda usar Azure RBAC para asignar roles de plano de datos. Es posible que tenga que eliminar el identificador de objeto de este usuario después de la implementación para habilitar el modo RBAC de Azure.
Captura de una instrucción de funcionalidad
Puede validar que la cuenta de Azure API for FHIR se está ejecutando mediante la captura de una instrucción de funcionalidad de FHIR con los siguientes comandos.
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
Limpieza de recursos
Si no va a seguir usando esta aplicación, elimine el grupo de recursos con los pasos siguientes.
Remove-AzResourceGroup -Name myResourceGroupName
Pasos siguientes
En este inicio rápido, ha implementado Azure API for FHIR en su suscripción. Para más información sobre la configuración de Azure API for FHIR y para empezar a usar Azure API for FHIR, consulte
Nota:
FHIR® es una marca registrada de HL7 y se usa con su permiso.