빠른 시작: Azure CLI을 사용하여 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의 진화된 버전입니다.
이 빠른 시작에서는 Azure CLI를 사용하여 Azure에서 Azure API for FHIR을 배포하는 방법을 알아봅니다.
Azure를 구독하고 있지 않다면 시작하기 전에 Azure 체험 계정을 만듭니다.
필수 조건
Azure Cloud Shell에서 Bash 환경을 사용합니다. 자세한 내용은 Azure Cloud Shell의 Bash에 대한 빠른 시작을 참조하세요.
CLI 참조 명령을 로컬에서 실행하려면 Azure CLI를 설치합니다. Windows 또는 macOS에서 실행 중인 경우 Docker 컨테이너에서 Azure CLI를 실행하는 것이 좋습니다. 자세한 내용은 Docker 컨테이너에서 Azure CLI를 실행하는 방법을 참조하세요.
로컬 설치를 사용하는 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다. 인증 프로세스를 완료하려면 터미널에 표시되는 단계를 수행합니다. 다른 로그인 옵션은 Azure CLI를 사용하여 로그인을 참조하세요.
메시지가 표시되면 처음 사용할 때 Azure CLI 확장을 설치합니다. 확장에 대한 자세한 내용은 Azure CLI에서 확장 사용을 참조하세요.
az version을 실행하여 설치된 버전과 종속 라이브러리를 찾습니다. 최신 버전으로 업그레이드하려면 az upgrade를 실행합니다.
Azure Health Data Services(예: HealthcareAPIs) 확장 추가
az extension add --name healthcareapis
HealthcareAPIs에 대한 명령 목록을 얻으려면 다음을 수행합니다.
az healthcareapis --help
Azure Resource 그룹 만들기
Azure API for FHIR이 포함된 리소스 그룹의 이름을 선택하고 만듭니다.
az group create --name "myResourceGroup" --location westus2
Azure API for FHIR 배포
az healthcareapis create --resource-group myResourceGroup --name nameoffhiraccount --kind fhir-r4 --location westus2
Fetch FHIR API 기능 문
다음 명령을 사용하여 FHIR API에서 기능 문을 가져옵니다.
curl --url "https://nameoffhiraccount.azurehealthcareapis.com/metadata"
리소스 정리
이 애플리케이션을 계속 사용하지 않려면 다음 단계에 따라 리소스 그룹을 삭제합니다.
az group delete --name "myResourceGroup"
다음 단계
이 빠른 시작 가이드에서는 Azure API for FHIR을 구독에 배포했습니다. 애플리케이션을 등록하는 방법 및 Azure API for FHIR 구성 설정에 대한 자세한 내용은 다음을 참조하세요.
참고 항목
FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.