资产模型版本 - AWS IoT SiteWise
检索资产模型或组件模型的活动版本（控制台）检索资产模型或组件模型的活动版本 (AWS CLI)

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

资产模型版本

AWS IoT SiteWise 支持对资产模型和组件模型的创建和更新操作进行异步处理。它还会更新模型的状态。

AWS IoT SiteWise 将有效模型在创建和更新请求中的更改传播到其依赖资源（从资产模型传播到资产，或者从组件模型传播到资产模型）。然后，它会将模型置于ACTIVE状态。

如果提供的模型定义无效，则将模型 AWS IoT SiteWise 置于FAILED状态。更改不会传播到依赖资源。依赖资源是指模型ACTIVE处于状态时传播的最后一个模型定义。

根据以上信息，模型定义有两种类型的模型版本：

  1. 最新版本- 作为创建或更新请求的一部分接受的最新定义。

  2. 活动版本- 最新定义已成功处理，模型状态为ACTIVE。

默认情况下，在资产模型或组件模型上调用 descri APIs be 时，会返回模型最新版本的详细信息。在某些情况下，需要资产模型或组件模型的活动版本。参见下面的示例场景：

  • 定义无效的更新操作会使您的资产模型处于FAILED状态。您必须通过检索资产模型的活动版本并创建另一个引用此有效定义的更新请求来恢复更改。

  • 上 AWS IoT SiteWise 有一个应用程序，客户可以在其中查看资产及其相应的资产模型。当用户引用与特定资产相对应的资产模型定义，并且该资产模型处于过渡UPDATINGFAILED状态或状态时，最新版本将返回尚未传播到其资产的资产模型定义。PROPAGATING在这种情况下，您必须向客户检索资产模型的有效版本。

检索资产模型或组件模型的活动版本（控制台）

按照以下步骤在 AWS IoT SiteWise 控制台中检索资产模型或组件模型的活动版本。

提示

资产模型和组件模型均列在导航窗格的模型下。所选资源模型或组件模型的 “详细信息” 面板会显示其类型。

检索资产模型或组件模型的活动版本（控制台）

  1. 导航到 AWS IoT SiteWise 控制台。

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

  3. 选择要检索其活动版本的模型。

    1. 如果模型处于ACTIVE状态，则表示您正在查看其活动版本。

    2. 如果模型处于暂时状态、或FAILED状态 UPDATINGPROPAGATING，请在详细信息面板的状态下找到 “查看活动版本”。

检索资产模型或组件模型的活动版本 (AWS CLI)

AWS CLI 使用检索资产模型或组件模型的活动版本。

要检索资产模型或组件模型的活动版本，请使用带assetModelVersion参数的DescribeAssetModel操作。

提示

AWS CLI 将组件模型定义为一种资产模型。因此，您可以对两种类型的模型使用相同的DescribeAssetModel操作。响应中的assetModelType字段表示它是还ASSET_MODEL是COMPONENT_MODEL。

检索资产模型或组件模型的活动版本 (AWS CLI)

  • 运行以下命令来描述模型。Replace（替换） asset-model-id 使用资产模型或组件模型的 ID 或外部 ID。外部 ID 是用户定义的 ID。有关更多信息，请参阅《AWS IoT SiteWise 用户指南》中的 使用外部引用对象 IDs。

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

    该操作会返回包含模型详细信息的响应。响应包含一个具有以下结构的assetModelStatus对象。

    {
    ...
    "assetModelName": "string",
    "assetModelProperties": [ ... ],
    ...,
    "assetModelVersion": "string"
}