更新資產模型和元件模型

導覽至 AWS IoT SiteWise 主控台。

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

選擇要更新的資產模型或元件模型。

選擇編輯。

在 Edit model (編輯模型) 頁面上，執行以下任一項操作：

• 在 Model details (模型詳細資料) 中，變更模型的 Name (名稱)。

• 變更任何 Attribute definitions (屬性定義)。您無法變更現有屬性的 Data type (資料類型)。如需詳細資訊，請參閱定義靜態資料 （屬性）。

• 變更任何 Measurement definitions (衡量值定義)。您無法變更現有衡量值的 Data type (資料類型)。如需詳細資訊，請參閱從設備定義資料串流 （測量）。

• 變更任何 Transform definitions (轉換定義)。如需詳細資訊，請參閱轉換資料 （轉換）。

• 變更任何 Metric definitions (指標定義)。您無法變更現有指標的 Time interval (時間間隔)。如需詳細資訊，請參閱從屬性和其他資產彙總資料 （指標）。

• （僅限資產模型） 變更任何階層定義。您無法變更現有階層的 Hierarchy model (階層模型)。如需詳細資訊，請參閱定義資產模型階層。

選擇 Save (儲存)。

執行下列命令來擷取現有的模型定義。將 asset-model-id 取代為要更新的資產模型或元件模型的 ID 或外部 ID。

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

上述命令會傳回對應至模型最新版本的模型定義。

對於資產模型處於 FAILED 狀態的使用案例，請擷取與其作用中版本對應的有效模型定義，以建置您的更新請求。如需詳細資訊，請參閱 資產模型版本。執行下列命令來擷取作用中模型定義：

aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE 

操作會傳回包含模型詳細資訊的回應。回應有以下結構。

{
    "assetModelId": "String",
    "assetModelArn": "String",
    "assetModelName": "String",
    "assetModelDescription": "String",
    "assetModelProperties": Array of AssetModelProperty,
    "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
    "assetModelCompositeModels": Array of AssetModelCompositeModel,
    "assetModelCompositeModelSummaries": Array of AssetModelCompositeModelSummary,
    "assetModelCreationDate": "String",
    "assetModelLastUpdateDate": "String",
    "assetModelStatus": {
      "state": "String",
      "error": {
        "code": "String",
        "message": "String"
      },
    "assetModelType": "String"
    },
    "assetModelVersion": "String",
    "eTag": "String"
}

如需詳細資訊，請參閱 DescribeAssetModel 操作。

建立名為 update-asset-model.json 的文件，並將前一個命令的回應複製到檔案中。

從 JSON 物件的 update-asset-model.json 中移除以下鍵值組：

UpdateAssetModel 操作預期承載具有下列結構：

{
  "assetModelName": "String",
  "assetModelDescription": "String",
  "assetModelProperties": Array of AssetModelProperty,
  "assetModelHierarchies": Array of AssetModelHierarchyDefinition,
  "assetModelCompositeModels": Array of AssetModelCompositeModel
}

在 update-asset-model.json 中，執行下列任何一項：

• 變更資產模型的名稱 (assetModelName)。

• 變更、新增或移除資產模型的描述 (assetModelDescription)。

• 變更、新增或移除任何資產模型的屬性 (assetModelProperties)。您無法變更現有屬性的 dataType 或現有指標的 window。如需詳細資訊，請參閱定義資料屬性。

• 變更、新增或移除任何資產模型的階層 (assetModelHierarchies)。您無法變更現有階層的 childAssetModelId。如需詳細資訊，請參閱定義資產模型階層。

• 變更、新增或移除任何 類型 AWS/ALARM() 的資產模型複合模型assetModelCompositeModels。警示會監控其他屬性，讓您可以識別設備或程序何時需要注意。每個警示定義都是複合模型，可標準化警示使用的屬性集。如需詳細資訊，請參閱 在 中使用警示監控資料 AWS IoT SiteWise 和 在 中定義資產模型的警示 AWS IoT SiteWise。

執行以下命令，使用儲存在 update-asset-model.json 中的定義更新資產模型。將 asset-model-id 取代為資產模型的 ID：

aws iotsitewise update-asset-model \
  --asset-model-id asset-model-id \
  --cli-input-json file://model-payload.json