Краткое руководство. Развертывание API Azure для FHIR с помощью PowerShell

Внимание

Поддержка Azure API для FHIR будет прекращена 30 сентября 2026 г. Следуйте стратегиям миграции, чтобы перейти в службу FHIR служб azure Health Data Services к этой дате. Из-за прекращения поддержки Azure API для FHIR с 1 апреля 2025 г. новые развертывания будут невозможны. Служба FHIR служб работоспособности Azure — это развивающаяся версия Azure API для FHIR, которая позволяет клиентам управлять службами FHIR, DICOM и MedTech с интеграцией с другими службами Azure.

В этом кратком руководстве показано, как развернуть Azure API для FHIR с помощью PowerShell.

Если у вас нет подписки Azure, создайте бесплатную учетную запись, прежде чем приступить к работе.

Azure Cloud Shell

В Azure есть Azure Cloud Shell, интерактивная оболочка среды, с которой можно работать в браузере. Для работы со службами Azure можно использовать Bash или PowerShell с Cloud Shell. Для запуска кода из этой статьи можно использовать предварительно установленные команды Cloud Shell. Ничего дополнительного в локальной среде устанавливать не нужно.

Начало работы с Azure Cloud Shell

Вариант Пример и ссылка
Нажмите кнопку Попробовать в правом верхнем углу блока кода или команд. При нажатии кнопки Попробовать код или команда не копируется в Cloud Shell автоматически. Screenshot that shows an example of Try It for Azure Cloud Shell.
Чтобы открыть Cloud Shell в браузере, перейдите по адресу https://shell.azure.com или нажмите кнопку Запуск Cloud Shell. Button to launch Azure Cloud Shell.
Нажмите кнопку Cloud Shell в строке меню в правом верхнем углу окна портала Azure. Screenshot that shows the Cloud Shell button in the Azure portal

Чтобы использовать Azure Cloud Shell, выполните следующие действия:

  1. Запустите Cloud Shell.

  2. Нажмите кнопку Копировать в блоке кода (или блоке команд), чтобы скопировать код или команду.

  3. Вставьте код или команду в окно сеанса Cloud Shell, нажав клавиши CTRL+SHIFT+V в Windows и Linux или CMD+SHIFT+V в macOS.

  4. Нажмите клавишу ВВОД, чтобы запустить код или команду.

Примечание.

Мы рекомендуем использовать модуль Azure Az PowerShell для взаимодействия с Azure. Чтобы начать работу, см. статью Установка Azure PowerShell. Дополнительные сведения см. в статье Перенос Azure PowerShell с AzureRM на Az.

Регистрация поставщика ресурсов Azure API для FHIR

Microsoft.HealthcareApis Если поставщик ресурсов еще не зарегистрирован для подписки, его можно зарегистрировать с помощью:

Register-AzResourceProvider -ProviderNamespace Microsoft.HealthcareApis

Создание группы ресурсов Azure

New-AzResourceGroup -Name "myResourceGroupName" -Location westus2

Развертывание Azure API для FHIR

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

Примечание.

В зависимости от версии установленного модуля Az PowerShell подготовленный сервер FHIR можно настроить для использования локального механизма RBAC, чтобы вошедший в систему пользователь PowerShell был задан в списке допустимых идентификаторов объектов удостоверений для развернутой службы FHIR. В дальнейшем рекомендуется использовать Azure RBAC для назначения ролей плоскости данных. Возможно, после развертывания нужно будет удалить идентификатор объекта этого пользователя, чтобы включить режим Azure RBAC.

Получение выписки о возможностях

Вы сможете проверить, работает ли учетная запись API Azure для FHIR, получив выписку о возможностях FHIR:

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

Очистка ресурсов

Если вы не собираетесь использовать это приложение в дальнейшем, удалите группу ресурсов, выполнив следующие действия:

Remove-AzResourceGroup -Name myResourceGroupName

Следующие шаги

В этом кратком руководстве показано, как развернуть Azure API для FHIR в своей подписке. Дополнительные сведения о параметрах в AZURE API для FHIR и о начале использования AZURE API для FHIR см. в статье

FHIR® является зарегистрированным товарным знаком HL7 и используется с разрешением HL7 .