更新资产模型和组件模型

导航到 AWS IoT SiteWise 控制台。

在导航窗格中，选择 模型。

选择要更新的资产模型或组件模型。

选择编辑。

在 编辑模型 页面上，执行以下任何操作：

• 在 模型详细信息 中，更改模型的 名称。

• 更改任何 属性定义。您无法更改现有属性的 数据类型。有关更多信息，请参阅 定义静态数据（属性）。

• 更改任何 测量值定义。您无法更改现有测量值的 数据类型。有关更多信息，请参阅 定义来自设备的数据流（测量）。

• 更改任何 转换定义。有关更多信息，请参阅 转换数据（变换）。

• 更改任何 指标定义。您无法更改现有指标的 时间间隔。有关更多信息，请参阅 汇总来自房产和其他资产（指标）的数据。

• （仅限资产模型）更改任何层次结构定义。您无法更改现有层次结构的 层次结构模型。有关更多信息，请参阅 定义资产模型层次结构。

选择保存。

运行以下命令以检索现有模型定义。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 的文件，并将上一命令的响应复制到该文件中。

从中的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) 的复合模型。警报会监控其他特性，以便您可以识别何时需要注意设备或流程。每个警报定义都是一个复合模型，用于标准化警报使用的属性集。有关更多信息，请参阅使用警报监控数据 和在资产模型上定义警报。

运行以下命令，使用存储在 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