分析同步状态与错误

本主题介绍了有关如何分析同步错误及状态。

重要

有关自定义工作空间和默认工作区之间的区别的信息，请参阅自定义工作空间和默认工作空间之间的区别。

同步任务状态

同步作业博山以下状态之一，具体取决于其状态。

• 同步作业CREATING状态表示作业正在检查权限并从中加载数据 AWS IoT SiteWise 以准备同步。

• 同步任务INITIALIZING状态意味着中的所有现有资源 AWS IoT SiteWise 都已同步到。 AWS IoT TwinMaker如果用户在 AWS IoT SiteWise中有大量资产和资产模型，则此步骤可能需要更长的时间才能完成。您可以通过在 AWS IoT TwinMaker 控制台中查看同步作业或调用 ListSyncResources API 监控已同步的资源数量。

• 同步作业 ACTIVE 状态表示初始化步骤已完成。该任务现已准备就绪，可以同步来自 AWS IoT SiteWise的任何新更新。

• 同步作业 ERROR 状态表示上述任何状态都存在错误。查看错误消息。IAM 角色设置可能存在问题。如果您想使用新的 IAM 角色，请删除出现错误的同步任务，然后使用新角色创建一个新任务。

同步错误在模型源页面中显示，可通过工作区中的实体模型来源表格访问该页面。模型来源页面显示同步失败的资源清单。同步作业会自动重试大多数错误，但是如果资源需要操作，则该资源将保持 ERROR 状态。您还可以使用 ListSyncResourcesAPI 获取错误列表。

要查看当前源的所有列出的错误，请使用以下程序。

1. 在 AWS IoT TwinMaker 控制台中导航至工作区。

2. 选择 “实体模型 AWS IoT SiteWise 来源” 模式中列出的来源，打开资产同步详细信息页面。

   

3. 如前述屏幕截图所示，错误表中列出了所有存在持续错误的资源。您可以使用此表跟踪和修复与特定资源相关的错误。

可能出现错误包括：

• 虽然 AWS IoT SiteWise 支持重复的资源名称，但 AWS IoT TwinMaker 仅在ROOT关卡上支持它们，不支持在同一个父实体下。如果您在中的父实体下有两个同名的资产 AWS IoT SiteWise，则其中一个无法同步。要修复此错误，请在同步 AWS IoT SiteWise 之前删除其中一个资源或将一个资源移到另一个父资源下。

• 如果您已经有一个与 AWS IoT SiteWise 资产 ID 相同的 ID 的实体，则在您删除现有实体之前，该资产将无法同步。