本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 分析同步狀態和錯誤
<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_tw/iot-twinmaker/latest/guide/images/synced-resources.png)

1. 如上述螢幕擷取畫面所示，任何持續發生錯誤的資源都會列在**錯誤**表格中。您可以使用此表格來追蹤和修正與特定資源相關的錯誤。

可能的錯誤包括下列項目：
+ 雖然 AWS IoT SiteWise 支援重複的資產名稱，但 AWS IoT TwinMaker 僅在 `ROOT`層級支援它們，而不是在相同的父實體下。如果您在 的父實體下有兩個同名資產 AWS IoT SiteWise，其中一個資產無法同步。若要修正此錯誤，請在同步 AWS IoT SiteWise 之前刪除其中一個資產，或在不同的父項資產下移動其中一個資產。
+ 如果您已有與資產 ID 具有相同 ID 的 AWS IoT SiteWise 實體，該資產會無法同步，直到您刪除現有的實體為止。