资产模型版本 - Amazon IoT SiteWise
检索资产模型或组件模型的活动版本（控制台）检索资产模型或组件模型的活动版本（Amazon CLI）
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

资产模型版本

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

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

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

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

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

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

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

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

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

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

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

提示

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

要检索资产模型或组件模型的活动版本（控制台），请执行以下步骤：

  1. 导航至 Amazon IoT SiteWise 控制台。

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

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

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

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

检索资产模型或组件模型的活动版本（Amazon CLI）

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

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

提示

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

要检索资产模型或组件模型的活动版本（Amazon CLI），请执行以下步骤：

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

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

    此操作将返回包含模型详细信息的响应。响应中包含具有以下结构的 assetModelStatus 对象。

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