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 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 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.
Nesse início rápido, você aprenderá como 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. Para começar, consulte Instalar o Azure PowerShell. 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 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 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 Az módulo PowerShell instalado, o servidor FHIR provisionado pode ser configurado para usar o controle de acesso baseado em função local (RBAC) e ter o usuário do PowerShell conectado no momento na lista de IDs de objeto de identidade permitidas para o serviço FHIR implantado. Recomendamos que você use o Azure RBAC para atribuir funções de plano de dados. Talvez seja necessário excluir o ID do objeto desse usuário após a implantação para habilitar o modo RBAC do Azure.
Buscar instrução de funcionalidade
Você pode validar se a API do Azure para a conta FHIR está em execução buscando uma declaração de capacidade FHIR com os seguintes comandos.
$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent
Limpar os recursos
Se você não for continuar usando esse aplicativo, exclua o grupo de recursos seguindo as etapas a seguir.
Remove-AzResourceGroup -Name myResourceGroupName
Próximas etapas
Nesse 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
Observação
FHIR® é uma marca registrada da HL7 e é usado com a permissão da HL7.