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

排查医疗技术服务部署错误

重要

医疗技术服务的弃用已于 2025 年 5 月 3 日启动。 如果使用 MedTech 服务不再是优先级,请取消预配实例,可在 此处找到该实例。 以下区域中的活动实例的支持将于 2028 年 5 月 3 日结束:美国西部 2、英国南部、西欧、美国东部、澳大利亚东部、美国东部 2、印度中部、北欧。 可在 此处找到 MedTech 服务的开放源代码版本。

本文提供医疗技术服务部署错误的故障排除步骤和修补程序。

小窍门

访问医疗技术服务指标和日志对于排查和评估医疗技术服务的整体运行状况和性能至关重要。 请查看以下医疗技术服务文章,了解如何启用、配置和使用这些医疗技术服务监视功能:

如何使用医疗技术服务监视和运行状况检查选项卡

如何配置医疗技术服务指标

如何为医疗技术服务启用诊断设置

医疗技术服务资源错误和修复

以下是可以在 Azure 资源管理器 (ARM) API 或 Azure 门户中发现的错误列表以及针对这些错误的修复方法:

错误
已达到资源类型 iotconnectors 的最大数量
deviceMapping 映射无效。 验证错误:{LIST_OF_ERRORS}。
fullyQualifiedEventHubNamespace 为 null、空或格式不正确。
必须先完全预配上级资源,然后才能预配子资源。
子资源的位置属性必须与父资源的位置属性匹配。

已达到资源类型 iotconnectors 的最大数量

已显示:ARM API 和 Azure 门户

说明:达到医疗技术服务订阅配额(默认为每个工作区 10 个医疗技术服务,每个订阅 10 个工作区)。

修复:执行以下选项之一:

  • 删除医疗技术服务的现有实例之一。

  • 使用其他尚未达到订阅配额的订阅。

  • 请求增加订阅配额 - Azure 技术支持

deviceMapping 映射无效。 验证错误:{LIST_OF_ERRORS}

已显示:ARM API 和 Azure 门户

说明:医疗技术服务预配请求中提供的设备映射无效。

修复:

  • 如果要使用 ARM 模板部署医疗技术服务,请更正 properties.deviceMapping 属性中提供的映射 JSON 中的错误。
  • 如果使用 Azure 门户部署医疗技术服务,请更正“设备映射”选项卡中提供的映射 JSON 中的错误。

fullyQualifiedEventHubNamespace 为 null、空或格式不正确

已显示:ARM API

说明:预配请求中提供的医疗技术服务的事件中心命名空间无效。

修复:将医疗技术服务的 properties.ingestionEndpointConfiguration.fullyQualifiedEventHubNamespace 属性更新为 ARM 模板中的正确格式。 格式应为 {EVENTHUB_NAMESPACE}.servicebus.windows.net

必须先完全预配上级资源,然后才能预配子资源

已显示:ARM API

说明:父工作区仍在预配。

修复:等待父工作区预配完成并再次提交设置请求。

子资源的位置属性必须与父资源的位置属性匹配

已显示:ARM API

说明:设置请求中提供的医疗技术服务位置与父工作区的位置不同。

修复:将 ARM 模板中医疗技术服务的 location 属性设置为与父工作区 location 属性相同的值。

FHIR 目标资源错误和修复

以下是可以在 Azure 资源管理器 (ARM) API 或 Azure 门户中发现的错误列表以及针对这些错误的修复方法:

错误
已达到资源类型 iotconnectors/fhirdestinations 的最大数量。
提供的 fhirServiceResourceId 无效。
必须先完全预配上级资源,然后才能预配子资源。
子资源的位置属性必须与父资源的位置属性匹配。

已达到资源类型 iotconnectors/destinations 的最大数量

已显示:ARM API 和 Azure 门户

说明:已达到医疗技术服务的 FHIR® 目标资源配额(默认为每个医疗技术服务一个)。

修复:删除医疗技术服务的 FHIR 目标资源的现有实例。 每个医疗技术服务只支持一个 FHIR 目标资源。

提供的 fhirServiceResourceId 无效

已显示:ARM API

说明:预配请求中提供的 FHIR 目标资源 ID 不是 FHIR 服务的实例的有效资源 ID。

修复:确保 ARM 模板的 properties.fhirServiceResourceId 属性中的资源 ID 格式正确,并确保资源 ID 适用于 FHIR 服务实例。 格式应为:/subscriptions/{SUBSCRIPTION_ID}/resourceGroups/{RESOURCE_GROUP_NAME}/providers/Microsoft.HealthcareApis/workspaces/{WORKSPACE_NAME}/fhirservices/{FHIR_SERVICE_NAME}

必须先完全预配上级资源,然后才能预配子资源

已显示:ARM API

说明:父工作区或父医疗技术服务仍在预配中。

修复:等待父工作区或父医疗技术服务预配完成,然后再次提交设置请求。

子资源的位置属性必须与父资源的位置属性匹配

已显示:ARM API

说明:设置请求中提供的 FHIR 目标资源位置不同于父医疗技术服务的位置。

修复:将 ARM 模板中 FHIR 目标的 location 属性设置为与父医疗技术服务 location 属性相同的值。

注释

如果无法使用此故障排除指南修复医疗技术服务问题,可以开立 Azure 技术支持工单,将设备消息和设备以及 FHIR 目标映射的副本附加到请求,以更好地帮助确定问题。

后续步骤

有关医疗技术服务的常见问题解答

注释

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