다음을 통해 공유

빠른 시작: ARM 템플릿을 사용하여 Azure API for FHIR 배포

  • 아티클

Important

Azure API for FHIR은 2026년 9월 30일에 사용 중지됩니다. 해당 날짜까지 마이그레이션 전략에 따라 Azure Health Data Services FHIR 서비스로 전환합니다. Azure API for FHIR의 사용 중지로 인해 2025년 4월 1일부터 신규 배포가 허용되지 않습니다. Azure Health Data Services FHIR 서비스는 고객이 다른 Azure 서비스에 통합하여 FHIR, DICOM 및 MedTech 서비스를 관리할 수 있도록 하는 Azure API for FHIR의 진화된 버전입니다.

이 빠른 시작에서는 ARM 템플릿(Azure Resource Manager 템플릿)을 사용하여 Azure API for Fast Healthcare FHIR®(상호 운용성 리소스)을 배포하는 방법을 알아봅니다. Azure Portal, PowerShell 또는 CLI를 통해 Azure API for FHIR을 배포할 수 있습니다.

Azure Resource Manager 템플릿은 프로젝트에 대한 인프라 및 구성을 정의하는 JSON(JavaScript Object Notation) 파일입니다. 이 템플릿은 선언적 구문을 사용합니다. 배포를 만들기 위한 프로그래밍 명령의 시퀀스를 작성하지 않고 의도하는 배포를 설명합니다.

환경이 필수 구성 요소를 충족하고 ARM 템플릿 사용에 익숙한 경우 Azure에 배포 단추를 선택합니다. 로그인하면 Azure Portal에서 템플릿이 열립니다.

Resource Manager 템플릿을 Azure에 배포하는 단추

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정 만들기

템플릿 검토

이 빠른 시작에서 사용되는 템플릿은 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)]"
        }
      }
    }
  ]
}

템플릿에서 다음과 같은 하나의 Azure 리소스를 정의합니다.

  • Microsoft.HealthcareApis/services

템플릿 배포

다음 링크를 선택하여 Azure Portal에서 ARM 템플릿을 사용하여 Azure API for FHIR을 배포합니다.

Resource Manager 템플릿을 Azure에 배포하는 단추

Azure API for FHIR 배포 페이지에서 다음을 수행합니다.

  1. 원하는 경우 구독을 기본값에서 다른 구독으로 변경합니다.

  2. 리소스 그룹에 대해 새로 만들기를 선택하고, 새 리소스 그룹의 이름을 입력한 다음, 확인을 선택합니다.

  3. 새 리소스 그룹을 만든 경우 리소스 그룹에 대한 지역을 선택합니다.

  4. 새 서비스 이름을 입력하고 Azure API for FHIR의 위치를 선택합니다. 위치는 리소스 그룹의 지역과 같거나 다를 수 있습니다.

    Azure Portal에서 ARM 템플릿을 사용하여 Azure API for FHIR을 배포합니다.

  5. 검토 + 만들기를 선택합니다.

  6. 사용 약관을 읽은 다음, 만들기를 선택합니다.

참고 항목

배포를 완료하는 데 몇 분이 걸립니다. 나중에 배포된 리소스를 검토하는 데 사용하는 Azure API for FHIR 서비스 및 리소스 그룹의 이름을 확인합니다.

배포된 리소스 검토

다음 단계에 따라 새 Azure API for FHIR 서비스에 대한 개요를 확인합니다.

  1. Azure Portal에서 Azure API for FHIR을 검색하여 선택합니다.

  2. FHIR 목록에서 새 서비스를 선택합니다. 새 Azure API for FHIR에 대한 개요 페이지가 표시됩니다.

  3. 새 FHIR API 계정이 프로비저닝되었는지 확인하려면 FHIR 메타데이터 엔드포인트 옆에 있는 링크를 선택하여 FHIR API 기능 문을 가져옵니다. 링크의 형식은 https://<service-name>.azurehealthcareapis.com/metadata입니다. 계정이 프로비저닝되면 큰 JSON 파일이 표시됩니다.

리소스 정리

더 이상 필요하지 않은 경우 리소스 그룹을 삭제합니다. 그러면 리소스 그룹의 리소스도 삭제됩니다.

  1. Azure Portal에서 리소스 그룹을 검색하여 선택합니다.

  2. 리소스 그룹 목록에서 리소스 그룹의 이름을 선택합니다.

  3. 리소스 그룹의 개요 페이지에서 리소스 그룹 삭제를 선택합니다.

  4. 확인 대화 상자에서 리소스 그룹의 이름을 입력한 다음, 삭제를 선택합니다.

ARM 템플릿을 만드는 과정을 안내하는 단계별 자습서는 첫 번째 ARM 템플릿을 만들고 배포하기 위한 자습서를 참조하세요.

다음 단계

이 빠른 시작 가이드에서는 Azure API for FHIR을 구독에 배포했습니다. 애플리케이션 및 Azure API for FHIR 구성 설정을 등록하는 방법에 대한 자세한 내용은 다음을 참조하세요.

애플리케이션 등록 개요

Azure RBAC 구성

로컬 RBAC 구성

데이터베이스 설정 구성

고객 관리형 키 구성

CORS 구성

Private Link 구성

FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.