资产和模型状态 - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

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

资产和模型状态

创建、更新或删除资产、资产模型或组件模型时,更改需要一段时间才能传播。 Amazon IoT SiteWise 异步解析这些操作并更新每个资源的状态。每个资产、资产模型和组件模型都有一个状态字段,其中包含资源的状态和任何错误消息(如果适用)。状态可以是以下值之一:

  • ACTIVE— 资源处于活动状态。这是您可以查询资产、资产模型和组件模型并与之交互的唯一状态。

  • CREATING— 资源正在创建中。

  • UPDATING— 资源正在更新中。

  • DELETING— 资源正在被删除。

  • PROPAGATING—(仅限资产模型和组件模型)更改将传播到所有依赖资源(从资产模型传播到资产,或从组件模型传播到资产模型)。

  • FAILED— 资源在创建或更新操作期间未能验证,可能是由于表达式中存在循环引用。您可以删除处于FAILED状态的资源。

一些创建、更新和删除操作ACTIVE会将资产、资产模型或组件模型 Amazon IoT SiteWise 置于操作解析之外的状态。要在执行其中一个操作后查询资源或与之交互,必须等到状态变为ACTIVE。否则,您的请求将失败。

检查资产的状态

您可以使用 Amazon IoT SiteWise 控制台或 API 来检查资产的状态。

检查资产的状态(控制台)

使用以下过程可以在 Amazon IoT SiteWise 控制台中检查资产的状态。

检查资产的状态(控制台)
  1. 导航到 Amazon IoT SiteWise 控制台

  2. 在导航窗格中,选择 资产

  3. 选择要检查的资产。

    提示

    您可以选择箭头图标来展开资产层次结构以查找资产。

  4. 资源详细信息面板中查找 状态

    Amazon IoT SiteWise 资产详细信息面板,状态为激活。

检查资产的状态 (Amazon CLI)

您可以使用 Amazon Command Line Interface (Amazon CLI) 来检查资产的状态。

要检查资产的状态,请使用带assetId参数的DescribeAsset操作。

检查资产的状态 (Amazon CLI)
  • 运行以下命令以描述资产。将资产 ID 替换为资产的 ID 或外部 ID。外部 ID 是用户定义的 ID。有关更多信息,请参阅《Amazon IoT SiteWise 用户指南》中的 使用外部 ID 引用对象

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

    此操作将返回包含资产详细信息的响应。响应包含一个具有以下结构的assetStatus对象:

    { ... "assetStatus": { "state": "String", "error": { "code": "String", "message": "String" } } }

    资产的状态位于 JSON 对象的 assetStatus.state 中。

检查资产模型或组件模型的状态

您可以使用 Amazon IoT SiteWise 控制台或 API 来检查资产模型或组件模型的状态。

检查资产模型或组件模型的状态(控制台)

使用以下步骤在 Amazon IoT SiteWise 控制台中检查资产模型或组件模型的状态。

提示

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

检查资产模型或组件模型的状态(控制台)
  1. 导航到 Amazon IoT SiteWise 控制台

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

  3. 选择要检查的型号。

  4. 详细信息面板中查找状态

    Amazon IoT SiteWise “资产模型” 页面屏幕截图,突出显示了资产模型的状态。

检查资产模型或组件模型的状态 (Amazon CLI)

您可以使用 Amazon CLI 来检查资产模型或组件模型的状态。

要检查资产模型或组件模型的状态,请使用带assetModelId参数的DescribeAssetModel操作。

提示

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

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

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

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

    { ... "assetModelStatus": { "state": "String", "error": { "code": "String", "message": "String" } } }

    模型的状态assetModelStatus.state在 JSON 对象中。