資產和模型狀態 - AWS IoT SiteWise

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

資產和模型狀態

當您建立、更新或刪除資產或資產模型時,這些變更需要時間傳播。AWS IoT SiteWise 會以非同步方式解析這些操作,並更新每項資源的狀態。每項資產和資產模型都有狀態欄位,這包含資源狀態和任何錯誤訊息 (如適用)。狀態可以是下列其中一個值:

  • ACTIVE— 資產或資產模型處於作用中狀態。這是可讓您查詢並與資產和資產模型進行互動的唯一狀態。

  • CREATING— 資產或資產模型處於正在建立的狀態。

  • UPDATING— 資產或資產模型處於正在更新的狀態。

  • DELETING— 資產或資產模型處於正在刪除的狀態。

  • PROPAGATING— (僅限資產模型) 資產模型變更正傳播至其所有資產。

  • FAILED— 資產或資產模型在建立或更新操作期間無法驗證,可能是因為表達式中有循環參考。您可以刪除處於 FAILED 狀態的資產和資產模型。

AWS IoT SiteWise 中的某些建立、更新和刪除操作會在操作解析時,將資產或資產模型置於 ACTIVE 以外的狀態。如果您需要查詢或在執行其中一項操作後與資產或資產模型進行互動,您必須等到狀態變更為 ACTIVE 為止。否則,您的請求會失敗。

檢查資產的狀態

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

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

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

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

  1. 導覽至 AWS IoT SiteWise 主控台

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

  3. 選擇要檢查的資產。

    提示

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

    
        AWS IoT SiteWise 「資產」頁面螢幕擷取畫面,並已反白顯示資產階層。
  4. 尋找狀態中的資產詳細資訊面板。

    
                AWS IoT SiteWise 「資產」頁面螢幕擷取畫面,並已反白顯示資產狀態。

檢查資產的狀態 (CLI)

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

若要檢查資產狀態,請使用 DescribeAsset 操作搭配 assetId 參數。

檢查資產的狀態 (CLI)

  • 輸入以下命令以描述 Pod。將 asset-id 取代為資產的 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 IoT SiteWise 主控台中資產模型的狀態。

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

  1. 導覽至 AWS IoT SiteWise 主控台

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

  3. 選擇要檢查的資產模型。

  4. 尋找狀態中的詳細資訊面板。

    
                AWS IoT SiteWise 「資產模型」頁面螢幕擷取畫面,並已反白顯示資產模型狀態。

檢查資產模型的狀態 (CLI)

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

若要檢查資產模型狀態,請使用 DescribeAssetModel 操作搭配 assetModelId 參數。

檢查資產模型的狀態 (CLI)

  • 輸入以下命令以描述資產模型。將 asset-model-id 取代為資產模型的 ID。

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

    此操作會傳回包含資產模型詳細資料的回應。回應包含具有以下結構的 assetModelStatus 物件。

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

    資產模型的狀態在 JSON 物件的 assetModelStatus.state 中。