你当前正在访问 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 API for FHIR® 提供适用于 Azure 的 Microsoft FHIR 服务器的完全托管部署。 该服务器是 FHIR 标准的一种实现。 本文档提供有关 Azure API for FHIR 的功能和增强功能的详细信息。
2025 年 6 月
$export的增强错误日志记录：以前，如果导出没有关联的存储帐户，$export将返回 500 内部服务器错误。 现在，错误消息已得到改进，以向用户“找不到存储帐户”状态。
漏洞修复：
在基元类型“code”上添加了对独立扩展的支持：以前，无法单独上传基元类型“code”的扩展，并会导致 HTTP 400 错误的请求响应。 此 bug 已修复，用户现在可以上传扩展，而无需相应的“源”属性。
_summary CapabilityStatement 中现在包含的搜索参数：以前，CapabilityStatement 缺少_summary搜索参数。 我们修复了此问题，并将_summary搜索参数添加到 CapabilityStatement。
2025年5月
改进了$export的错误处理：以前，Cosmos DB 中的 409 和 412 个错误未重试，并且显示为 500 InternalServerError。 此问题已修复，现在会重试这些请求。
改进了缺少托管标识的导出或导入的错误处理：以前，导出或导入缺少托管标识的作业将导致未知服务器错误（HTTP 状态代码 500）。 我们改进了这种情况的错误处理，需要显示消息“无法获取访问令牌”。
支持多页包含结果进行批量删除：以前，使用_include批量删除，_revinclude无法删除包含的资源超过 100 个。 我们修复了通过支持多页包含结果来提升该限制，批量删除将能够删除超过 100 个包含的资源。
漏洞修复：
删除搜索参数后创建修复：以前，创建过去删除的同一搜索参数可能会失败，因为更新搜索参数定义管理器的缓存时出现问题。 此问题已修复，现在，缓存会在验证传入请求中的搜索参数之前同步。
导出重复项修复：以前，存在_isParallel = 打开且_maxCount设置为 1000 或更低版本的导出可能会导致导出资源重复的 bug。 现在已修复此问题。
2025 年 4 月
增强了对资源类型大小写错误的 READ作的错误处理：添加了对 READ作大小写错误的资源类型的验证（例如，GET /patient/ 而不是 GET /Patient/）。 过去，大小写资源类型错误的请求会导致 500 状态代码 （InternalServerError）。 进行此更改后，具有错误大小写资源类型的请求将被拒绝，并显示 400 状态代码 （ResourceNotSupported），因为任何请求中的资源类型都应以区分大小写的方式进行验证。
漏洞修复：
在不同资源类型上具有相同 “code” 值的自定义搜索参数修复：在运行 delete 或 update 搜索参数作时发现问题。 无论资源类型如何，都会删除同一 “code” 值上的所有其他匹配的相关搜索参数。 此问题已修复，用户现在可以更新和删除自定义搜索参数，而不会影响具有相同 “code” 值的其他搜索参数或资源类型。
修复删除和上传自定义搜索参数的问题：删除自定义搜索参数，然后使用 PUT作重新上传同一搜索参数时，可能会导致 424 Failed Dependency 错误。 此问题已修复。 添加了一项检查，以确保如果已删除 search 参数的先前版本，则会对其进行正确处理。 用户现在可以删除自定义搜索参数，然后使用 PUT 重新上传该搜索参数。
2025 年 3 月
改进了 $export 的错误处理：为以前不会重试的某些导出查询添加了重试逻辑。
API for FHIR 的计费：发现了一个问题，该问题可能导致多个区域（包括北欧、美国东部 2、澳大利亚东部、西欧、印度中部、东南亚和英国南部）的订阅计费不足。 我们于 2025 年 3 月 1 日更正了计费错误。 如果您受到此错误的影响，则无需为在 3 月份的账单之前错过的任何费用负责。
批量删除作的预览功能：添加了对条件删除和批量删除请求_include和_revinclude的支持。 用户现在可以在搜索条件中使用 _include 和 _revinclude 进行条件删除和批量删除。 请注意，这不会影响单个删除的当前行为，它不支持额外的参数。 在此处了解详细信息。
ValueSet 大小错误修复：最大 ValueSet 大小已减少到 500 个代码，从而阻止加载大型 ValueSet。 已修复此问题，限制现已增加到 20,000 个代码。
2025 年 2 月
日期搜索逻辑更新：搜索日期时，逻辑现在可确保结果中包含包含搜索日期的任何日期范围。 以前，仅当整个范围位于搜索日期内时，它才匹配日期。
运行状况检查以提高复原能力：添加了运行状况检查，以增强服务的复原能力，例如可重试的异常、增强的诊断日志记录和捕获超时异常。
2025 年 1 月
增强功能：改进了错误处理和验证
事务捆绑包请求的 HTTP 方法验证：添加了验证，以确保事务捆绑包的请求组件中的 HTTP 方法是有效的 HTTPVerb 枚举值。 如果 HTTP 方法无效或为 null， RequestNotValidException 则会引发状态 400 Bad Request ，向用户提供更清晰的错误消息。
分区大小错误处理：当分区超过 20GB 时，将引发 a PreconditionFailedException ，将之前的 HTTP 500 错误替换为 HTTP 400 错误。 这向客户表明，失败是由于其末尾的问题（分区大小）。
事务失败异常：引入了一种新的特定于 FHIR 的异常类型来处理 Cosmos DB 事务失败，取代了泛型 InvalidOperationExceptions.
CMK 错误处理：改进了依赖于客户管理的密钥的作的错误处理。 用户现在会看到更具体的错误消息，以及 指向Microsoft故障排除指南 的链接（如果出现与 CMK 相关的问题）。
相关内容
注意
FHIR® 是 HL7 的注册商标，经 HL7 许可使用。