通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

功能

  • 项目

Azure API for FHIR® 提供适用于 Azure 的 Microsoft FHIR 服务器的完全托管部署。 该服务器是 FHIR 标准的一种实现。 本文档列出了 FHIR 服务器的主要功能。

FHIR 版本

支持的最新版本：4.0.1

目前还支持以前的版本，包括：3.0.2

REST API

下面是支持的 RESTful 功能的摘要。 有关这些功能的实现的详细信息，请参阅 FHIR REST API 功能。

API 适用于 FHIR 的 Azure API Azure Health Data Services 中的 FHIR 服务 评论
读取 是 是
vread 是 是
update 是 是
使用乐观锁定更新 是 是
更新（条件） 是 是
修补程序 是 是 仅支持 JSON 补丁和 FHIRPath 补丁。
补丁（有条件的） 是 是 仅支持 JSON 补丁和 FHIRPath 补丁。
history 是 是
create 是 是 支持 POST/PUT
创建（条件） 是 是 问题 #1382
search 部分 部分 请参阅 FHIR 搜索概述。
链式搜索 是 是 请参阅以下注释。
反向链式搜索 是 是 请参阅以下注释。
批处理 是 是
transaction 否 是
分页 部分 部分 支持 self 和 next
中介 否 否

注意

在 Azure API for FHIR 和由 Azure Cosmos DB 支持的开源 FHIR 服务器中，链式搜索和反向链式搜索均属于 MVP 实现。 为在 Azure Cosmos DB 上完成链式搜索，该实现会逐步执行搜索表达式并发出子查询，从而解析匹配的资源。 此操作将针对表达式的各个级别执行。 如果任何查询返回的结果超过 1000 个，则会引发错误。

扩展操作

支持扩展 REST API 的所有操作。

搜索参数类型 适用于 FHIR 的 Azure API Azure Health Data Services 中的 FHIR 服务 注释
$export 是 是 支持系统、组和患者。
$convert-data 是 是
$validate 是 是
$member-match 是 是
$patient-everything 是 是
$purge-history 是 是

持久性

Microsoft FHIR 服务器配备一个可插入持久性模块（请参阅 Microsoft.Health.Fhir.Core.Features.Persistence）。

目前，FHIR 服务器开源代码包括 Azure Cosmos DB 和 SQL 数据库的实现。

Azure Cosmos DB 是一个全球分布式多模型（NoSQL、MongoDB 等）数据库。 它支持不同的一致性级别。 默认部署模板配置具有 Strong 一致性的 FHIR 服务器，但可通过 x-ms-consistency-level 请求头按请求依次修改（通常较为宽松）。

基于角色的访问控制

FHIR 服务器使用 Microsoft Entra ID 进行访问控制。 具体而言，如果将FhirServer:Security:Enabled配置参数设置为 true，并且 FHIR 服务器的所有请求（除外/metadata）都必须将Bearer <TOKEN>请求标头设置为 ，则Authorization强制实施基于角色的访问控制 （RBAC）。 令牌必须包含 roles 声明中定义的一个或多个角色。 如果令牌包含允许对指定资源执行指定操作的角色，则允许请求。

目前，允许对给定角色执行的操作将在 API 中全局应用。

服务限制

  • 请求单位（RU） - 可以在 Azure API for FHIR 的门户中配置最多 100,000 RU。 需要至少 400 RU 或 40 RU/GB，取两者中的较大者。 如果需要 100,000 个 RU 以上，可以投入支持票证来增加 RU。 最大值为 1,000,000。 此外，我们支持 RU 的自动缩放。

  • 捆绑大小 - 每个捆绑限制为 500 个项。

  • 数据大小 - 数据/文档必须每个大小小于 2 MB。

  • 订阅限制 - 默认情况下，每个订阅限制为最多 10 个 FHIR 服务器实例。 如果每个订阅需要更多实例，请开具支持票证并提供详细需求信息。

  • 资源大小 - 单个资源大小（包括历史记录）不应超过 20 GB。

后续步骤

本文介绍 Azure API for FHIR 中支持的 FHIR 功能。 有关部署 Azure API for FHIR 的信息，请参阅

部署 Azure API for FHIR

注意

FHIR® 是 HL7 的注册商标，经 HL7 许可使用。