Partilhar via

Guia de início rápido: usar um modelo ARM para implantar a API do Azure para FHIR

  • Artigo

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 guia de início rápido, você aprenderá a usar um modelo do Azure Resource Manager (modelo ARM) para implantar a API do Azure para FHIR® (Fast Healthcare Interoperability Resources). Você pode implantar a API do Azure para FHIR por meio do portal do Azure, PowerShell ou CLI.

Um modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo utiliza sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

Se o seu ambiente cumpre os pré-requisitos e se está familiarizado com a utilização de modelos ARM, selecione o botão Implementar no Azure. O modelo é aberto no portal do Azure assim que você entrar.

Botão para implantar o modelo do Gerenciador de Recursos no Azure.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie um gratuitamente.

Rever o modelo

O modelo utilizado neste início rápido pertence aos Modelos de Início Rápido do Azure.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "9588053699595008971"
    }
  },
  "parameters": {
    "serviceName": {
      "type": "string",
      "metadata": {
        "description": "The name of the service."
      }
    },
    "location": {
      "type": "string",
      "allowedValues": [
        "australiaeast",
        "eastus",
        "eastus2",
        "japaneast",
        "northcentralus",
        "northeurope",
        "southcentralus",
        "southeastasia",
        "uksouth",
        "ukwest",
        "westcentralus",
        "westeurope",
        "westus2"
      ],
      "metadata": {
        "description": "Location of Azure API for FHIR"
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.HealthcareApis/services",
      "apiVersion": "2021-11-01",
      "name": "[parameters('serviceName')]",
      "location": "[parameters('location')]",
      "kind": "fhir-R4",
      "properties": {
        "authenticationConfiguration": {
          "audience": "[format('https://{0}.azurehealthcareapis.com', parameters('serviceName'))]",
          "authority": "[uri(environment().authentication.loginEndpoint, subscription().tenantId)]"
        }
      }
    }
  ]
}

O modelo define um recurso do Azure.

  • Microsoft.HealthcareApis/services

Implementar o modelo

Selecione o link a seguir para implantar a API do Azure para FHIR usando o modelo ARM no portal do Azure:

Botão para implantar o modelo do Gerenciador de Recursos no Azure.

Na página Implantar a API do Azure para FHIR :

  1. Se desejar, altere a Assinatura do padrão para uma assinatura diferente.

  2. Em Grupo de recursos, selecione Criar novo, insira um nome para o novo grupo de recursos e selecione OK.

  3. Se você criou um novo grupo de recursos, selecione uma Região para o grupo de recursos.

  4. Insira um novo Nome de Serviço e escolha o Local da API do Azure para FHIR. O local pode ser igual ou diferente da região do grupo de recursos.

    Implante a API do Azure para FHIR usando o modelo ARM no portal do Azure.

  5. Selecione Rever + criar.

  6. Leia os termos e condições e selecione Criar.

Nota

A implantação leva alguns minutos para ser concluída. Observe os nomes da API do Azure para o serviço FHIR e o grupo de recursos, para uso na revisão de recursos implantados.

Rever os recursos implementados

Siga estas etapas para ver uma visão geral da sua nova API do Azure para serviço FHIR:

  1. No portal do Azure, procure e selecione API do Azure para FHIR.

  2. Na lista FHIR, selecione o novo serviço. A página Visão geral da nova API do Azure para o serviço FHIR é exibida.

  3. Para validar se a nova conta da API FHIR está provisionada, selecione o link ao lado do ponto de extremidade de metadados FHIR para buscar a instrução de capacidade da API FHIR. O link tem um formato de https://<service-name>.azurehealthcareapis.com/metadata. Se a conta for provisionada, um arquivo JSON será exibido.

Clean up resources (Limpar recursos)

Quando já não for necessário, elimine o grupo de recursos. Isso exclui os recursos no grupo de recursos.

  1. No portal do Azure, procure e selecione Grupos de recursos.

  2. Na lista de grupos de recursos, escolha o nome do seu grupo de recursos.

  3. Na página Visão geral do seu grupo de recursos, selecione Excluir grupo de recursos.

  4. Na caixa de diálogo de confirmação, digite o nome do grupo de recursos e selecione Excluir.

Para obter um tutorial passo a passo que o orienta pelo processo de criação de um modelo ARM, consulte o tutorial para criar e implantar seu primeiro modelo ARM

Próximos passos

Neste guia de início rápido, você implantou a API do Azure para FHIR em sua assinatura. Para obter informações sobre como registrar aplicativos e as definições de configuração da API do Azure para FHIR, consulte o seguinte.

Visão geral do Registrar Aplicativos

Configurar RBAC do Azure

Configurar RBAC local

Configurar as definições da base de dados

Configurar chaves geridas pelo cliente

Configurar CORS

Configurar o Private Link

Nota

FHIR® é uma marca registada da HL7 e é utilizada com a permissão da HL7.