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 dos Serviços de Dados de Saúde do Azure para serviço FHIR 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 dos Serviços de Dados de Saúde do Azure para serviço FHIR é a versão evoluída da API do Azure para FHIR que permite aos clientes gerenciar os serviços FHIR, DICOM e serviço de tecnologia médica com integrações a outros serviços do Azure.
Neste guia de início rápido, você aprenderá a implantar a API do Azure para FHIR usando o PowerShell.
Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Azure Cloud Shell
O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo, sem precisar instalar nada no seu ambiente local.
Para iniciar o Azure Cloud Shell:
| Opção | Exemplo/Link |
|---|---|
| Selecione Experimentar no canto superior direito de um bloco de código ou de comando. Selecionar Experimentar não copia automaticamente o código nem o comando para o Cloud Shell. |  |
| Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador. |  |
| Selecione o botão Cloud Shell na barra de menus no canto superior direito 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 o comando.
Cole o código ou comando na sessão do Cloud Shell selecionando Ctrl+Shift+V no Windows e no Linux, ou selecionando Cmd+Shift+V no macOS.
Pressione Enter para executar o código ou o comando.
Observação
Recomendamos que você use o módulo Az PowerShell do Azure para interagir com o Azure. Confira Instalar o Azure PowerShell para começar. Para saber como migrar para o módulo Az PowerShell, confira Migrar o Azure PowerShell do AzureRM para o Az.
Registrar o provedor de recursos da API do Azure para FHIR
Se o provedor de recursos Microsoft.HealthcareApis ainda não estiver registrado na sua assinatura, você poderá registrá-lo com:
Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis
Criar um grupo de recursos do Azure
New-AzResourceGroup -Name "myResourceGroupName" -Location westus2
Implantar a API do Azure para FHIR
New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4
Observação
Dependendo da versão do módulo Az do PowerShell que você instalou, o servidor FHIR provisionado pode ser configurado para usar RBAC local e ter o usuário atualmente conectado do PowerShell na lista de IDs de objeto de identidade permitidos para o serviço FHIR implantado. No futuro, recomendamos que você use o RBAC do Azure para atribuir funções de plano de dados e talvez seja necessário excluir essa ID de objeto de usuários após a implantação para habilitar o modo RBAC do Azure.
Buscar instrução de funcionalidade
Você poderá validar que a conta da API do Azure para FHIR está em execução buscando uma instrução de funcionalidade FHIR:
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
Limpar os recursos
Se você não quiser continuar usando este aplicativo, exclua o grupo de recursos por meio das seguintes etapas:
Remove-AzResourceGroup -Name myResourceGroupName
Próximas etapas
Neste guia de início rápido, você implantou a API do Azure para FHIR em sua assinatura. Para obter mais informações das configurações na API do Azure para FHIR e começar a usar a API do Azure para FHIR, consulte
FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.