更新資產模型和元件模型

導覽至 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 (儲存)。

執行下列指令以擷取現有的模型定義。Replace (取代) 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 的文件，並將前一個命令的回應複製到檔案中。

從中update-asset-model.json的對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) 的資產模型複合模型。警報會監控其他屬性，以便您識別何時需要注意設備或流程。每個警報定義都是一個複合模型，可將警報使用的屬性集標準化。如需詳細資訊，請參閱 使用警報監控數據 和 定義資產模型上的警示。

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

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