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 al 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. Screenshot that shows an example of Try It for Azure Cloud Shell.
Vaya a https://shell.azure.com o seleccione el botón Iniciar Cloud Shell para abrir Cloud Shell en el explorador. Button to launch Azure Cloud Shell.
Seleccione el botón Cloud Shell en la barra de menús de la esquina superior derecha de Azure Portal. Screenshot that shows the Cloud Shell button in the Azure portal

Para usar Azure Cloud Shell:

  1. Inicie Cloud Shell.

  2. Seleccione el botón Copiar en un bloque de código (o bloque de comandos) para copiar el código o comando.

  3. 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.

  4. Seleccione Enter para ejecutar el código o comando.

Nota

Se recomienda usar el módulo Azure Az de PowerShell para interactuar con Azure. Consulte Instalación de Azure PowerShell para empezar. 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:

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:

En función del módulo Az de PowerShell que haya instalado, el servidor de FHIR aprovisionado puede configurarse para que use el control de acceso basado en roles local y tenga el usuario de PowerShell con la sesión iniciada actualmente establecido en la lista de identificadores de objetos de identidad permitidos para el servicio FHIR implementado. En adelante, se recomienda usar el control de acceso basado en roles de Azure para asignar roles de plano de datos y es posible que tenga que eliminar este identificador de objeto de usuarios después de la implementación para habilitar el modo RBAC de Azure.

Captura de una instrucción de funcionalidad

Podrá comprobar que la cuenta de Azure API for FHIR se está ejecutando mediante la captura de una instrucción de funcionalidad de FHIR:

$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 mediante los siguientes pasos:

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

FHIR® es una marca registrada de HL7 y se usa con su permiso.