本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
资产和模型状态
创建、更新或删除资产、资产模型或组件模型时,更改需要一段时间才能传播。 Amazon IoT SiteWise 异步解析这些操作并更新每个资源的状态。每个资产、资产模型和组件模型都有一个状态字段,其中包含资源的状态和任何错误消息(如果适用)。状态可以是以下值之一:
-
ACTIVE
— 资源处于活动状态。这是您可以查询资产、资产模型和组件模型并与之交互的唯一状态。 -
CREATING
— 资源正在创建中。 -
UPDATING
— 资源正在更新中。 -
DELETING
— 资源正在被删除。 -
PROPAGATING
—(仅限资产模型和组件模型)更改将传播到所有依赖资源(从资产模型传播到资产,或从组件模型传播到资产模型)。 -
FAILED
— 资源在创建或更新操作期间未能验证,可能是由于表达式中存在循环引用。您可以删除处于FAILED
状态的资源。
一些创建、更新和删除操作ACTIVE
会将资产、资产模型或组件模型 Amazon IoT SiteWise 置于操作解析之外的状态。要在执行其中一个操作后查询资源或与之交互,必须等到状态变为ACTIVE
。否则,您的请求将失败。
检查资产的状态
您可以使用 Amazon IoT SiteWise 控制台或 API 来检查资产的状态。
检查资产的状态(控制台)
使用以下过程可以在 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 控制台中检查资产模型或组件模型的状态。
提示
资产模型和组件模型均列在导航窗格的模型下。所选资源模型或组件模型的 “详细信息” 面板会显示其类型。
检查资产模型或组件模型的状态(控制台)
在导航窗格中,选择 模型。
-
选择要检查的型号。
-
在详细信息面板中查找状态。
检查资产模型或组件模型的状态 (Amazon CLI)
您可以使用 Amazon CLI 来检查资产模型或组件模型的状态。
要检查资产模型或组件模型的状态,请使用带assetModelId
参数的DescribeAssetModel操作。
提示
Amazon CLI 将组件模型定义为一种资产模型。因此,您可以对两种类型的模型使用相同的DescribeAssetModel操作。响应中的assetModelType
字段表示它是还ASSET_MODEL
是COMPONENT_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 对象中。