資產和模型狀態

建立、更新或刪除資產、資產模型或元件模型時，變更會花費一些時間來傳播。 AWS IoT SiteWise 以非同步方式解析這些作業，並更新每個資源的狀態。每個資產、資產模型和元件模型都有一個狀態欄位，其中包含資源的狀態和任何錯誤訊息 (如果適用)。狀態可以是下列其中一個值：

• ACTIVE— 資源處於作用中狀態。這是您可以查詢資產、資產模型和元件模型並與之互動的唯一狀態。

• CREATING— 正在建立資源。

• UPDATING— 正在更新資源。

• DELETING— 正在刪除資源。

• PROPAGATING— (僅限資產模型和元件模型) 變更會傳播至所有相依資源 (從資產模型傳播至資產，或從元件模型傳播至資產模型)。

• FAILED— 在建立或更新作業期間驗證資源失敗，可能是因為運算式中的循環參照所致。您可以刪除處於此FAILED狀態的資源。

某些建立、更新和刪除作業會 AWS IoT SiteWise 將資產、資產模型或元件模型置於作業解析ACTIVE時以外的狀態。若要在執行這些作業之一後查詢資源或與資源互動，您必須等到狀態變更為ACTIVE。否則，您的請求會失敗。

檢查資產的狀態

您可以使用 AWS IoT SiteWise 主控台或 API 來檢查資產狀態。

主題

• 檢查資產的狀態 (主控台)
• 檢查資產狀態 (AWS CLI)

檢查資產的狀態 (主控台)

使用下列程序來檢查 AWS IoT SiteWise 主控台中資產的狀態。

檢查資產的狀態 (主控台)

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在導覽窗格中，選擇 Assets (資產)。

3. 選擇要檢查的資產。

   提示

   您可以選擇箭頭圖示來展開資產階層，以尋找您的資產。

4. 在資產詳細資料面板中尋找「狀態」。

   

檢查資產狀態 (AWS CLI)

您可以使用 AWS Command Line Interface (AWS CLI) 來檢查資產的狀態。

若要檢查資產的狀態，請將DescribeAsset作業與assetId參數搭配使用。

若要檢查資產狀態 (AWS CLI)

• 輸入以下命令以描述 Pod。以資產的 ID 或外部 ID 取代資產 ID。外部 ID 是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部 ID 參考物件。

  aws iotsitewise describe-asset --asset-id asset-id

  此操作會傳回包含資產詳細資料的回應。回應包含具有下列結構的assetStatus物件：

  {
      ...
      "assetStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }

  資產的狀態在 JSON 物件的 assetStatus.state 中。

檢查資產模型或元件模型的狀態

您可以使用 AWS IoT SiteWise 主控台或 API 來檢查資產模型或元件模型的狀態。

主題

• 檢查資產模型或元件模型的狀態 (主控台)
• 檢查資產模型或元件模型的狀態 (AWS CLI)

檢查資產模型或元件模型的狀態 (主控台)

使用下列程序在主控台中檢查資產模型或元件模型的 AWS IoT SiteWise 狀態。

提示

資產模型和元件模型都列在導覽窗格中的「模型」下。所選資產模型或元件模型的「詳細資料」面板會指出其類型。

若要檢查資產模型或元件模型 (主控台) 的狀態

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在導覽窗格中，選擇 Models (模型)。

3. 選擇要檢查的型號。

4. 在「詳細資料」面板中尋找狀態。

   

檢查資產模型或元件模型的狀態 (AWS CLI)

您可以使用檢 AWS CLI 查資產模型或元件模型的狀態。

若要檢查資產模型或元件模型的狀態，請搭配assetModelId參數使用「DescribeAsset模型」作業。

提示

將元件模型 AWS CLI 定義為資產模型類型。因此，兩種類型的DescribeAsset模型都使用相同的「模型」操作。響應中的assetModelType字段表示它是一個ASSET_MODEL還是COMPONENT_MODEL。

檢查資產模型或元件模型狀態的步驟 (AWS CLI)

• 執行下列指令來描述模型。以資產模型或元件模型的 ID 或外部 ID 取代資產模型 ID。外部 ID 是使用者定義的 ID。如需詳細資訊，請參閱《AWS IoT SiteWise 使用者指南》中的 使用外部 ID 參考物件。

  aws iotsitewise describe-asset-model --asset-model-id asset-model-id

  作業會傳回包含模型詳細資訊的回應。回應包含具有以下結構的 assetModelStatus 物件。

  {
      ...
      "assetModelStatus": {
        "state": "String",
        "error": {
           "code": "String",
           "message": "String"
        }
      }
    }

  模型的狀態位assetModelStatus.state於 JSON 物件中。