빠른 시작: PowerShell을 사용하여 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의 진화된 버전입니다.

이 빠른 시작에서는 PowerShell을 사용하여 Azure API for FHIR을 배포하는 방법을 알아봅니다.

Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니다.

Azure Cloud Shell

Azure는 브라우저를 통해 사용할 수 있는 대화형 셸 환경인 Azure Cloud Shell을 호스트합니다. Cloud Shell에서 Bash 또는 PowerShell을 사용하여 Azure 서비스 작업을 수행할 수 있습니다. 로컬 환경에 아무 것도 설치할 필요 없이 Azure Cloud Shell의 미리 설치된 명령을 사용하여 이 문서의 코드를 실행할 수 있습니다.

Azure Cloud Shell을 시작하려면 다음을 수행합니다.

옵션 예제/링크
코드 또는 명령 블록의 오른쪽 상단에서 시도를 선택합니다. 시도를 선택해도 코드 또는 명령이 Cloud Shell에 자동으로 복사되지 않습니다. Screenshot that shows an example of Try It for Azure Cloud Shell.
https://shell.azure.com으로 이동하거나 Cloud Shell 시작 단추를 선택하여 브라우저에서 Cloud Shell을 엽니다. Button to launch Azure Cloud Shell.
Azure Portal의 오른쪽 위에 있는 메뉴 모음에서 Cloud Shell 단추를 선택합니다. Screenshot that shows the Cloud Shell button in the Azure portal

Azure Cloud Shell을 사용하려면:

  1. Cloud Shell을 시작합니다.

  2. 코드 블록(또는 명령 블록)에서 복사 단추를 선택하여 코드 또는 명령을 복사합니다.

  3. Windows 및 Linux에서 Ctrl+Shift+V를 선택하거나 macOS에서 Cmd+Shift+V를 선택하여 코드 또는 명령을 Cloud Shell 세션에 붙여넣습니다.

  4. Enter를 선택하여 코드 또는 명령을 실행합니다.

참고 항목

Azure Az PowerShell 모듈을 사용하여 Azure와 상호 작용하는 것이 좋습니다. 시작하려면 Azure PowerShell 설치를 참조하세요. Az PowerShell 모듈로 마이그레이션하는 방법에 대한 자세한 내용은 Azure PowerShell을 AzureRM에서 Azure로 마이그레이션을 참조하세요.

Azure API for FHIR 리소스 공급자 등록

리소스 공급자가 Microsoft.HealthcareApis 구독에 아직 등록되지 않은 경우 다음을 사용하여 등록할 수 있습니다.

Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis

Azure 리소스 그룹 만들기

New-AzResourceGroup -Name "myResourceGroupName" -Location westus2

Azure API for FHIR 배포

New-AzHealthcareApisService -Name nameoffhirservice -ResourceGroupName myResourceGroupName -Location westus2 -Kind fhir-R4

참고 항목

설치한 PowerShell 모듈의 Az 버전에 따라 프로비전된 FHIR 서버는 로컬 RBAC를 사용하도록 구성되고 현재 로그인한 PowerShell 사용자가 배포된 FHIR 서비스에 허용되는 ID 개체 ID 목록에 설정되도록 할 수 있습니다. 앞으로 데이터 평면 역할을 할당하기 위해 Azure RBAC를 사용하는 것이 좋습니다 . Azure RBAC 모드를 사용하도록 설정하려면 배포 후 이 사용자 개체 ID를 삭제해야 할 수 있습니다.

Fetch 기능 문

FHIR 기능 문을 가져와서 Azure API for FHIR 계정이 실행 중인지 확인할 수 있습니다.

$metadata = Invoke-WebRequest -Uri "https://nameoffhirservice.azurehealthcareapis.com/metadata"
$metadata.RawContent

리소스 정리

이 애플리케이션을 계속 사용하지 않으려면 다음 단계에 따라 리소스 그룹을 삭제합니다.

Remove-AzResourceGroup -Name myResourceGroupName

다음 단계

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

Azure API for FHIR의 추가 설정

애플리케이션 등록 개요

Azure RBAC 구성

로컬 RBAC 구성

데이터베이스 설정 구성

고객 관리형 키 구성

CORS 구성

Private Link 구성

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