你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
功能
Azure API for FHIR 提供对 Microsoft FHIR Server for Azure 的完全托管部署。 该服务器是 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匹配 | 是 | 是 | |
| $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，则强制执行基于角色的访问控制 (RBAC)，且发送到 FHIR 服务器的所有请求（/metadata 除外）的 Authorization 请求标头必须设置为 Bearer <TOKEN>。 令牌必须包含 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 服务器实例。 如果每个订阅需要更多实例，请开具支持票证并提供详细需求信息。
资源大小 - 单个资源大小（包括历史记录）不应超过 20GB。
后续步骤
本文介绍了 Azure API for FHIR 中支持的 FHIR 功能。 有关部署 Azure API for FHIR 的信息，请参阅
FHIR® 是 HL7 的注册商标，经 HL7 许可使用。