Guia de início rápido: implantar a API do Azure para FHIR usando o PowerShell
Importante
A API do Azure para FHIR será desativada em 30 de setembro de 2026. Siga as estratégias de migração para fazer a transição para o serviço FHIR® dos Serviços de Dados de Saúde do Azure até essa data. Devido à desativação da API do Azure para FHIR, novas implantações não serão permitidas a partir de 1 de abril de 2025. O serviço FHIR dos Serviços de Dados de Saúde do Azure é a versão evoluída da API do Azure para FHIR que permite aos clientes gerir serviços FHIR, DICOM e MedTech com integrações noutros serviços do Azure.
Neste início rápido, você aprenderá a implantar a API do Azure para FHIR usando o PowerShell.
Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
Azure Cloud Shell
O Azure aloja o Azure Cloud Shell, um ambiente de shell interativo que pode utilizar através do seu browser. Pode utilizar o Bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. Você pode usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada em seu ambiente local.
Para iniciar o Azure Cloud Shell:
| Opção | Exemplo/Ligação |
|---|---|
| Selecione Experimentar no canto superior direito de um código ou bloco de comandos. Selecionar Experimentar não copia automaticamente o código ou comando para o Cloud Shell. |  |
| Aceda a https://shell.azure.com ou selecione o botão Iniciar Cloud Shell para abrir o Cloud Shell no browser. |  |
| Selecione o botão Cloud Shell na barra de menus, na parte direita do portal do Azure. |  |
Para usar o Azure Cloud Shell:
Inicie o Cloud Shell.
Selecione o botão Copiar em um bloco de código (ou bloco de comando) para copiar o código ou comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e Linux ou selecionando Cmd+Shift+V no macOS.
Selecione Enter para executar o código ou comando.
Nota
Recomendamos que utilize o módulo Azure Az do PowerShell para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.
Registrar a API do Azure para provedor de recursos FHIR
Se o Microsoft.HealthcareApis provedor de recursos ainda não estiver registrado para sua assinatura, você poderá registrá-lo com o seguinte comando.
Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis
Criar grupo de recursos do Azure
New-AzResourceGroup -Name "myResourceGroupName" -Location westus2
Implementar o Azure API for FHIR
New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4
Nota
Dependendo da versão do módulo PowerShell que você instalou, o servidor FHIR provisionado pode ser configurado para usar o RBAC (controle de Az acesso baseado em função) local e ter o usuário atualmente conectado no PowerShell na lista de IDs de objeto de identidade permitidas para o serviço FHIR implantado. Recomendamos que você use o RBAC do Azure para atribuir funções de plano de dados. Talvez seja necessário excluir a ID de objeto desse usuário após a implantação para habilitar o modo RBAC do Azure.
Declaração de capacidade de busca
Você pode validar se a API do Azure para conta FHIR está em execução buscando uma instrução de capacidade FHIR com os seguintes comandos.
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
Clean up resources (Limpar recursos)
Se você não vai continuar usando este aplicativo, exclua o grupo de recursos com as etapas a seguir.
Remove-AzResourceGroup -Name myResourceGroupName
Próximos passos
Neste guia de início rápido, você implantou a API do Azure para FHIR em sua assinatura. Para obter mais informações sobre as configurações na API do Azure para FHIR e para começar a usar a API do Azure para FHIR, consulte
Nota
FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.