你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
重要
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 API for FHIR 的演化版本,可让客户管理 FHIR、DICOM 和医疗技术服务,并集成到其他 Azure 服务。
本文介绍如何使用 Azure CLI 获取 Azure API for FHIR® 的访问令牌。 预配 Azure API for FHIR 时,请配置一组有权访问该服务的用户或服务主体。 如果用户对象 ID 在允许的对象 ID 列表中,则可以使用通过 Azure CLI 获取的令牌来访问该服务。
先决条件
在 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 API for FHIR 使用resource
或Audience
,其 URI 等于 FHIR 服务器的 https://<FHIR ACCOUNT NAME>.azurehealthcareapis.com
URI。 可以使用以下命令获取令牌并将其存储在变量(命名 $token
)中。
$token=$(az account get-access-token --resource=https://<FHIR ACCOUNT NAME>.azurehealthcareapis.com --query accessToken --output tsv)
与 Azure API for FHIR 配合使用
curl -X GET --header "Authorization: Bearer $token" https://<FHIR ACCOUNT NAME>.azurehealthcareapis.com/Patient
后续步骤
本文介绍了如何使用 Azure CLI 获取 Azure API for FHIR 的访问令牌。 了解如何使用 REST 客户端访问 FHIR API:
注释
FHIR® 是 HL7 的注册商标,经 HL7 许可使用。