本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 分析同步状态与错误
<a name="tm-sw-asset-sync-ts"></a>

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

**重要**  
有关自定义工作空间和默认工作区之间的区别的信息，请参阅[自定义工作空间和默认工作空间之间的区别](tm-sw-default-ws-diffs.md)。

## 同步任务状态
<a name="tm-sw-asset-sync-status"></a>

同步作业博山以下状态之一，具体取决于其状态。
+ 同步作业`CREATING`状态表示作业正在检查权限并从中加载数据 AWS IoT SiteWise 以准备同步。
+ 同步任务`INITIALIZING`状态意味着中的所有现有资源 AWS IoT SiteWise 都已同步到。 AWS IoT TwinMaker如果用户在 AWS IoT SiteWise中有大量资产和资产模型，则此步骤可能需要更长的时间才能完成。您可以通过在 [AWS IoT TwinMaker 控制台](https://console.aws.amazon.com/iottwinmaker/)中查看同步作业或调用 `ListSyncResources` API 监控已同步的资源数量。
+ 同步作业 `ACTIVE` 状态表示初始化步骤已完成。该任务现已准备就绪，可以同步来自 AWS IoT SiteWise的任何新更新。
+ 同步作业 `ERROR` 状态表示上述任何状态都存在错误。查看错误消息。IAM 角色设置可能存在问题。如果您想使用新的 IAM 角色，请删除出现错误的同步任务，然后使用新角色创建一个新任务。

同步错误在模型源页面中显示，可通过工作区中的**实体模型来源**表格访问该页面。模型来源页面显示同步失败的资源清单。同步作业会自动重试大多数错误，但是如果资源需要操作，则该资源将保持 `ERROR` 状态。您还可以使用 [ ListSyncResources](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListSyncResources.html)API 获取错误列表。

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

1. 在 [AWS IoT TwinMaker 控制台](https://console.aws.amazon.com/iottwinmaker/)中导航至工作区。

1. 选择 “**实体模型 AWS IoT SiteWise 来源” 模式中列出的来源**，打开资产同步详细信息页面。  
![\[AWS IoT SiteWise 源页面显示资产同步的详细信息，包括错误。\]](http://docs.aws.amazon.com/zh_cn/iot-twinmaker/latest/guide/images/synced-resources.png)

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

可能出现错误包括：
+ 虽然 AWS IoT SiteWise 支持重复的资源名称，但 AWS IoT TwinMaker 仅在`ROOT`关卡上支持它们，不支持在同一个父实体下。如果您在中的父实体下有两个同名的资产 AWS IoT SiteWise，则其中一个无法同步。要修复此错误，请在同步 AWS IoT SiteWise 之前删除其中一个资源或将一个资源移到另一个父资源下。
+ 如果您已经有一个与 AWS IoT SiteWise 资产 ID 相同的 ID 的实体，则在您删除现有实体之前，该资产将无法同步。